From ad2c2b1c8bbca21e100ab297f9953cbb9e95178f Mon Sep 17 00:00:00 2001 From: github-actions Date: Fri, 13 Aug 2021 10:31:27 +0000 Subject: [PATCH] Deployed a4319ee with MkDocs version: 1.1.2 --- 404.html | 112 + CODE_OF_CONDUCT/index.html | 112 + CONTRIBUTING/index.html | 114 +- index.html | 112 + level101/big_data/evolution/index.html | 112 + level101/big_data/intro/index.html | 112 + level101/big_data/tasks/index.html | 112 + .../further_reading/index.html | 112 + level101/databases_nosql/intro/index.html | 112 + .../databases_nosql/key_concepts/index.html | 112 + .../databases_sql/backup_recovery/index.html | 112 + level101/databases_sql/concepts/index.html | 112 + level101/databases_sql/conclusion/index.html | 112 + level101/databases_sql/innodb/index.html | 112 + level101/databases_sql/intro/index.html | 112 + level101/databases_sql/lab/index.html | 112 + level101/databases_sql/mysql/index.html | 112 + level101/databases_sql/operations/index.html | 112 + .../query_performance/index.html | 112 + level101/databases_sql/replication/index.html | 112 + .../databases_sql/select_query/index.html | 112 + level101/git/branches/index.html | 112 + level101/git/conclusion/index.html | 112 + level101/git/git-basics/index.html | 112 + level101/git/github-hooks/index.html | 112 + .../command_line_basics/index.html | 112 + level101/linux_basics/conclusion/index.html | 112 + level101/linux_basics/intro/index.html | 112 + .../linux_server_administration/index.html | 112 + .../linux_networking/conclusion/index.html | 112 + level101/linux_networking/dns/index.html | 112 + level101/linux_networking/http/index.html | 112 + level101/linux_networking/intro/index.html | 112 + level101/linux_networking/ipr/index.html | 112 + level101/linux_networking/tcp/index.html | 112 + level101/linux_networking/udp/index.html | 112 + .../metrics_and_monitoring/alerts/index.html | 112 + .../best_practices/index.html | 112 + .../command-line_tools/index.html | 112 + .../conclusion/index.html | 112 + .../introduction/index.html | 112 + .../observability/index.html | 112 + .../third-party_monitoring/index.html | 112 + level101/python_web/intro/index.html | 112 + .../python_web/python-concepts/index.html | 112 + .../python_web/python-web-flask/index.html | 112 + level101/python_web/sre-conclusion/index.html | 112 + .../python_web/url-shorten-app/index.html | 112 + level101/security/conclusion/index.html | 112 + level101/security/fundamentals/index.html | 112 + level101/security/intro/index.html | 112 + level101/security/network_security/index.html | 112 + .../threats_attacks_defences/index.html | 112 + .../security/writing_secure_code/index.html | 112 + .../systems_design/availability/index.html | 112 + level101/systems_design/conclusion/index.html | 112 + .../systems_design/fault-tolerance/index.html | 112 + level101/systems_design/intro/index.html | 112 + .../systems_design/scalability/index.html | 112 + .../conclusion/index.html | 112 + .../containerization_with_docker/index.html | 112 + .../intro/index.html | 112 + .../intro_to_containers/index.html | 112 + .../orchestration_with_kubernetes/index.html | 112 + .../cicd_brief_history/index.html | 2221 +++++++++++++++ .../conclusion/index.html | 2241 +++++++++++++++ .../index.html | 2142 ++++++++++++++ .../index.html | 2144 +++++++++++++++ .../images/CD_Image1.JPG | Bin 0 -> 31663 bytes .../images/CI_Image1.JPG | Bin 0 -> 22476 bytes .../images/CI_Image2.JPG | Bin 0 -> 36081 bytes .../images/Jenkins1.png | Bin 0 -> 38043 bytes .../images/Jenkins2.png | Bin 0 -> 119718 bytes .../images/Jenkins3.png | Bin 0 -> 41367 bytes .../images/Jenkins4.png | Bin 0 -> 51843 bytes .../images/Jenkins5.png | Bin 0 -> 72024 bytes .../images/Jenkins6.png | Bin 0 -> 56068 bytes .../introduction/index.html | 2258 +++++++++++++++ .../introduction_to_cicd/index.html | 2213 +++++++++++++++ .../index.html | 2450 +++++++++++++++++ .../archiving_backup/index.html | 112 + .../bashscripting/index.html | 112 + .../linux_intermediate/conclusion/index.html | 112 + .../introduction/index.html | 112 + .../linux_intermediate/introvim/index.html | 112 + .../package_management/index.html | 112 + .../storage_media/index.html | 112 + level102/networking/conclusion/index.html | 112 + .../infrastructure-features/index.html | 112 + level102/networking/introduction/index.html | 112 + level102/networking/rtt/index.html | 112 + level102/networking/scale/index.html | 112 + level102/networking/security/index.html | 112 + .../conclusion/index.html | 112 + .../system_calls_and_signals/intro/index.html | 112 + .../signals/index.html | 112 + .../system_calls/index.html | 112 + level102/system_design/conclusion/index.html | 112 + level102/system_design/intro/index.html | 112 + .../large-system-design/index.html | 112 + level102/system_design/resiliency/index.html | 112 + .../scaling-beyond-the-datacenter/index.html | 112 + level102/system_design/scaling/index.html | 112 + .../conclusion/index.html | 116 +- .../important-tools/index.html | 112 + .../introduction/index.html | 112 + .../performance-improvements/index.html | 112 + .../troubleshooting-example/index.html | 112 + .../troubleshooting/index.html | 112 + search/search_index.json | 2 +- sitemap.xml | 28 + sitemap.xml.gz | Bin 1071 -> 1168 bytes sre_community/index.html | 112 + 113 files changed, 26229 insertions(+), 4 deletions(-) create mode 100644 level102/continuous_integration_and_continuous_delivery/cicd_brief_history/index.html create mode 100644 level102/continuous_integration_and_continuous_delivery/conclusion/index.html create mode 100644 level102/continuous_integration_and_continuous_delivery/continuous_delivery_release_pipeline/index.html create mode 100644 level102/continuous_integration_and_continuous_delivery/continuous_integration_build_pipeline/index.html create mode 100644 level102/continuous_integration_and_continuous_delivery/images/CD_Image1.JPG create mode 100644 level102/continuous_integration_and_continuous_delivery/images/CI_Image1.JPG create mode 100644 level102/continuous_integration_and_continuous_delivery/images/CI_Image2.JPG create mode 100644 level102/continuous_integration_and_continuous_delivery/images/Jenkins1.png create mode 100644 level102/continuous_integration_and_continuous_delivery/images/Jenkins2.png create mode 100644 level102/continuous_integration_and_continuous_delivery/images/Jenkins3.png create mode 100644 level102/continuous_integration_and_continuous_delivery/images/Jenkins4.png create mode 100644 level102/continuous_integration_and_continuous_delivery/images/Jenkins5.png create mode 100644 level102/continuous_integration_and_continuous_delivery/images/Jenkins6.png create mode 100644 level102/continuous_integration_and_continuous_delivery/introduction/index.html create mode 100644 level102/continuous_integration_and_continuous_delivery/introduction_to_cicd/index.html create mode 100644 level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/index.html diff --git a/404.html b/404.html index fc0dc6b..8358eba 100644 --- a/404.html +++ b/404.html @@ -1844,6 +1844,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/CODE_OF_CONDUCT/index.html b/CODE_OF_CONDUCT/index.html index 1685655..1627529 100644 --- a/CODE_OF_CONDUCT/index.html +++ b/CODE_OF_CONDUCT/index.html @@ -1851,6 +1851,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/CONTRIBUTING/index.html b/CONTRIBUTING/index.html index 97275f1..3cdecf1 100644 --- a/CONTRIBUTING/index.html +++ b/CONTRIBUTING/index.html @@ -1851,6 +1851,118 @@ + + + + + +
  • + + + + + + +
    • + + + @@ -2049,7 +2161,7 @@ mkdocs serve
    diff --git a/level101/big_data/evolution/index.html b/level101/big_data/evolution/index.html index a51f4d0..1dbb9aa 100644 --- a/level101/big_data/evolution/index.html +++ b/level101/big_data/evolution/index.html @@ -1866,6 +1866,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/big_data/intro/index.html b/level101/big_data/intro/index.html index f580d6a..7609bea 100644 --- a/level101/big_data/intro/index.html +++ b/level101/big_data/intro/index.html @@ -1916,6 +1916,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/big_data/tasks/index.html b/level101/big_data/tasks/index.html index d00aa93..222647d 100644 --- a/level101/big_data/tasks/index.html +++ b/level101/big_data/tasks/index.html @@ -1902,6 +1902,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_nosql/further_reading/index.html b/level101/databases_nosql/further_reading/index.html index 101c5f7..f37f188 100644 --- a/level101/databases_nosql/further_reading/index.html +++ b/level101/databases_nosql/further_reading/index.html @@ -1866,6 +1866,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_nosql/intro/index.html b/level101/databases_nosql/intro/index.html index 534d2e1..edb7ecd 100644 --- a/level101/databases_nosql/intro/index.html +++ b/level101/databases_nosql/intro/index.html @@ -1957,6 +1957,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_nosql/key_concepts/index.html b/level101/databases_nosql/key_concepts/index.html index 31d54f7..296ccab 100644 --- a/level101/databases_nosql/key_concepts/index.html +++ b/level101/databases_nosql/key_concepts/index.html @@ -1936,6 +1936,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/backup_recovery/index.html b/level101/databases_sql/backup_recovery/index.html index 8dd6ac6..e430ce3 100644 --- a/level101/databases_sql/backup_recovery/index.html +++ b/level101/databases_sql/backup_recovery/index.html @@ -1918,6 +1918,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/concepts/index.html b/level101/databases_sql/concepts/index.html index 867059e..84a85c5 100644 --- a/level101/databases_sql/concepts/index.html +++ b/level101/databases_sql/concepts/index.html @@ -1891,6 +1891,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/conclusion/index.html b/level101/databases_sql/conclusion/index.html index 5fa9108..1b399c1 100644 --- a/level101/databases_sql/conclusion/index.html +++ b/level101/databases_sql/conclusion/index.html @@ -1895,6 +1895,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/innodb/index.html b/level101/databases_sql/innodb/index.html index 706b9d0..ef7c99f 100644 --- a/level101/databases_sql/innodb/index.html +++ b/level101/databases_sql/innodb/index.html @@ -1905,6 +1905,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/intro/index.html b/level101/databases_sql/intro/index.html index 9c50088..5673e69 100644 --- a/level101/databases_sql/intro/index.html +++ b/level101/databases_sql/intro/index.html @@ -1930,6 +1930,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/lab/index.html b/level101/databases_sql/lab/index.html index f59b19a..d9bab7a 100644 --- a/level101/databases_sql/lab/index.html +++ b/level101/databases_sql/lab/index.html @@ -1859,6 +1859,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/mysql/index.html b/level101/databases_sql/mysql/index.html index 9f3bbb3..2be31a5 100644 --- a/level101/databases_sql/mysql/index.html +++ b/level101/databases_sql/mysql/index.html @@ -1891,6 +1891,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/operations/index.html b/level101/databases_sql/operations/index.html index 6a331d8..11d4063 100644 --- a/level101/databases_sql/operations/index.html +++ b/level101/databases_sql/operations/index.html @@ -1846,6 +1846,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/query_performance/index.html b/level101/databases_sql/query_performance/index.html index fb5f6d9..ba7522c 100644 --- a/level101/databases_sql/query_performance/index.html +++ b/level101/databases_sql/query_performance/index.html @@ -1920,6 +1920,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/replication/index.html b/level101/databases_sql/replication/index.html index 4761f2b..37afc52 100644 --- a/level101/databases_sql/replication/index.html +++ b/level101/databases_sql/replication/index.html @@ -1911,6 +1911,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/databases_sql/select_query/index.html b/level101/databases_sql/select_query/index.html index b3c43da..8fdb921 100644 --- a/level101/databases_sql/select_query/index.html +++ b/level101/databases_sql/select_query/index.html @@ -1913,6 +1913,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/git/branches/index.html b/level101/git/branches/index.html index 1dd41be..979fd03 100644 --- a/level101/git/branches/index.html +++ b/level101/git/branches/index.html @@ -1895,6 +1895,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/git/conclusion/index.html b/level101/git/conclusion/index.html index 34d1a3a..7cbdc37 100644 --- a/level101/git/conclusion/index.html +++ b/level101/git/conclusion/index.html @@ -1891,6 +1891,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/git/git-basics/index.html b/level101/git/git-basics/index.html index be7f8e4..2bff47c 100644 --- a/level101/git/git-basics/index.html +++ b/level101/git/git-basics/index.html @@ -1992,6 +1992,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/git/github-hooks/index.html b/level101/git/github-hooks/index.html index 3f693f1..45f41d8 100644 --- a/level101/git/github-hooks/index.html +++ b/level101/git/github-hooks/index.html @@ -1895,6 +1895,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_basics/command_line_basics/index.html b/level101/linux_basics/command_line_basics/index.html index f9d86a2..6e87377 100644 --- a/level101/linux_basics/command_line_basics/index.html +++ b/level101/linux_basics/command_line_basics/index.html @@ -2080,6 +2080,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_basics/conclusion/index.html b/level101/linux_basics/conclusion/index.html index 91177ce..14fd38c 100644 --- a/level101/linux_basics/conclusion/index.html +++ b/level101/linux_basics/conclusion/index.html @@ -1902,6 +1902,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_basics/intro/index.html b/level101/linux_basics/intro/index.html index a796800..b8f29e1 100644 --- a/level101/linux_basics/intro/index.html +++ b/level101/linux_basics/intro/index.html @@ -1971,6 +1971,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_basics/linux_server_administration/index.html b/level101/linux_basics/linux_server_administration/index.html index 4d5a260..96b5490 100644 --- a/level101/linux_basics/linux_server_administration/index.html +++ b/level101/linux_basics/linux_server_administration/index.html @@ -2174,6 +2174,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_networking/conclusion/index.html b/level101/linux_networking/conclusion/index.html index 7357a3a..e54fcd8 100644 --- a/level101/linux_networking/conclusion/index.html +++ b/level101/linux_networking/conclusion/index.html @@ -1866,6 +1866,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_networking/dns/index.html b/level101/linux_networking/dns/index.html index d8b1877..aa86060 100644 --- a/level101/linux_networking/dns/index.html +++ b/level101/linux_networking/dns/index.html @@ -1895,6 +1895,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_networking/http/index.html b/level101/linux_networking/http/index.html index a4c9ba5..dbab82e 100644 --- a/level101/linux_networking/http/index.html +++ b/level101/linux_networking/http/index.html @@ -1866,6 +1866,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_networking/intro/index.html b/level101/linux_networking/intro/index.html index 2c1ba5e..2ad9f8b 100644 --- a/level101/linux_networking/intro/index.html +++ b/level101/linux_networking/intro/index.html @@ -1923,6 +1923,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_networking/ipr/index.html b/level101/linux_networking/ipr/index.html index cb012d6..58bea40 100644 --- a/level101/linux_networking/ipr/index.html +++ b/level101/linux_networking/ipr/index.html @@ -1895,6 +1895,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_networking/tcp/index.html b/level101/linux_networking/tcp/index.html index 21cb99a..a10138e 100644 --- a/level101/linux_networking/tcp/index.html +++ b/level101/linux_networking/tcp/index.html @@ -1895,6 +1895,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/linux_networking/udp/index.html b/level101/linux_networking/udp/index.html index f253cf4..89a0885 100644 --- a/level101/linux_networking/udp/index.html +++ b/level101/linux_networking/udp/index.html @@ -1895,6 +1895,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/metrics_and_monitoring/alerts/index.html b/level101/metrics_and_monitoring/alerts/index.html index 814ee6c..2f8afca 100644 --- a/level101/metrics_and_monitoring/alerts/index.html +++ b/level101/metrics_and_monitoring/alerts/index.html @@ -1864,6 +1864,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/metrics_and_monitoring/best_practices/index.html b/level101/metrics_and_monitoring/best_practices/index.html index 7c9f6f9..c829de0 100644 --- a/level101/metrics_and_monitoring/best_practices/index.html +++ b/level101/metrics_and_monitoring/best_practices/index.html @@ -1864,6 +1864,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/metrics_and_monitoring/command-line_tools/index.html b/level101/metrics_and_monitoring/command-line_tools/index.html index 9821e83..d737d9c 100644 --- a/level101/metrics_and_monitoring/command-line_tools/index.html +++ b/level101/metrics_and_monitoring/command-line_tools/index.html @@ -1864,6 +1864,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/metrics_and_monitoring/conclusion/index.html b/level101/metrics_and_monitoring/conclusion/index.html index 2a03922..f881781 100644 --- a/level101/metrics_and_monitoring/conclusion/index.html +++ b/level101/metrics_and_monitoring/conclusion/index.html @@ -1893,6 +1893,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/metrics_and_monitoring/introduction/index.html b/level101/metrics_and_monitoring/introduction/index.html index d02258c..fe96872 100644 --- a/level101/metrics_and_monitoring/introduction/index.html +++ b/level101/metrics_and_monitoring/introduction/index.html @@ -1864,6 +1864,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/metrics_and_monitoring/observability/index.html b/level101/metrics_and_monitoring/observability/index.html index cf4383d..e783745 100644 --- a/level101/metrics_and_monitoring/observability/index.html +++ b/level101/metrics_and_monitoring/observability/index.html @@ -1864,6 +1864,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/metrics_and_monitoring/third-party_monitoring/index.html b/level101/metrics_and_monitoring/third-party_monitoring/index.html index d880f33..cb36d5d 100644 --- a/level101/metrics_and_monitoring/third-party_monitoring/index.html +++ b/level101/metrics_and_monitoring/third-party_monitoring/index.html @@ -1864,6 +1864,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/python_web/intro/index.html b/level101/python_web/intro/index.html index 44ca097..4006323 100644 --- a/level101/python_web/intro/index.html +++ b/level101/python_web/intro/index.html @@ -1948,6 +1948,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/python_web/python-concepts/index.html b/level101/python_web/python-concepts/index.html index 40eb531..9799835 100644 --- a/level101/python_web/python-concepts/index.html +++ b/level101/python_web/python-concepts/index.html @@ -1927,6 +1927,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/python_web/python-web-flask/index.html b/level101/python_web/python-web-flask/index.html index 3e7100f..464bc24 100644 --- a/level101/python_web/python-web-flask/index.html +++ b/level101/python_web/python-web-flask/index.html @@ -1900,6 +1900,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/python_web/sre-conclusion/index.html b/level101/python_web/sre-conclusion/index.html index 878df57..5c24d48 100644 --- a/level101/python_web/sre-conclusion/index.html +++ b/level101/python_web/sre-conclusion/index.html @@ -1921,6 +1921,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/python_web/url-shorten-app/index.html b/level101/python_web/url-shorten-app/index.html index cd9a089..d884efc 100644 --- a/level101/python_web/url-shorten-app/index.html +++ b/level101/python_web/url-shorten-app/index.html @@ -1934,6 +1934,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/security/conclusion/index.html b/level101/security/conclusion/index.html index d21eac0..d5d2d44 100644 --- a/level101/security/conclusion/index.html +++ b/level101/security/conclusion/index.html @@ -1900,6 +1900,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/security/fundamentals/index.html b/level101/security/fundamentals/index.html index 089aa67..b091709 100644 --- a/level101/security/fundamentals/index.html +++ b/level101/security/fundamentals/index.html @@ -1988,6 +1988,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/security/intro/index.html b/level101/security/intro/index.html index 536b25b..446f9f1 100644 --- a/level101/security/intro/index.html +++ b/level101/security/intro/index.html @@ -1914,6 +1914,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/security/network_security/index.html b/level101/security/network_security/index.html index 955a34f..69059fa 100644 --- a/level101/security/network_security/index.html +++ b/level101/security/network_security/index.html @@ -2099,6 +2099,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/security/threats_attacks_defences/index.html b/level101/security/threats_attacks_defences/index.html index f5440b9..2cdfa0c 100644 --- a/level101/security/threats_attacks_defences/index.html +++ b/level101/security/threats_attacks_defences/index.html @@ -2147,6 +2147,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/security/writing_secure_code/index.html b/level101/security/writing_secure_code/index.html index 9f11b4c..6000c4a 100644 --- a/level101/security/writing_secure_code/index.html +++ b/level101/security/writing_secure_code/index.html @@ -1969,6 +1969,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/systems_design/availability/index.html b/level101/systems_design/availability/index.html index b2bf7fd..b75e4ad 100644 --- a/level101/systems_design/availability/index.html +++ b/level101/systems_design/availability/index.html @@ -1974,6 +1974,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/systems_design/conclusion/index.html b/level101/systems_design/conclusion/index.html index 16be1c1..f18aea4 100644 --- a/level101/systems_design/conclusion/index.html +++ b/level101/systems_design/conclusion/index.html @@ -1864,6 +1864,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/systems_design/fault-tolerance/index.html b/level101/systems_design/fault-tolerance/index.html index 1790651..823b87e 100644 --- a/level101/systems_design/fault-tolerance/index.html +++ b/level101/systems_design/fault-tolerance/index.html @@ -1947,6 +1947,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/systems_design/intro/index.html b/level101/systems_design/intro/index.html index 2515b93..be17d72 100644 --- a/level101/systems_design/intro/index.html +++ b/level101/systems_design/intro/index.html @@ -1928,6 +1928,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level101/systems_design/scalability/index.html b/level101/systems_design/scalability/index.html index cf147ec..f5fc035 100644 --- a/level101/systems_design/scalability/index.html +++ b/level101/systems_design/scalability/index.html @@ -2069,6 +2069,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/containerization_and_orchestration/conclusion/index.html b/level102/containerization_and_orchestration/conclusion/index.html index 1d1ee34..59ef559 100644 --- a/level102/containerization_and_orchestration/conclusion/index.html +++ b/level102/containerization_and_orchestration/conclusion/index.html @@ -1866,6 +1866,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/containerization_and_orchestration/containerization_with_docker/index.html b/level102/containerization_and_orchestration/containerization_with_docker/index.html index b7ac62f..7e5f9c7 100644 --- a/level102/containerization_and_orchestration/containerization_with_docker/index.html +++ b/level102/containerization_and_orchestration/containerization_with_docker/index.html @@ -1919,6 +1919,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/containerization_and_orchestration/intro/index.html b/level102/containerization_and_orchestration/intro/index.html index 72e44bc..0a313fd 100644 --- a/level102/containerization_and_orchestration/intro/index.html +++ b/level102/containerization_and_orchestration/intro/index.html @@ -1929,6 +1929,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/containerization_and_orchestration/intro_to_containers/index.html b/level102/containerization_and_orchestration/intro_to_containers/index.html index b19b92c..a01ac42 100644 --- a/level102/containerization_and_orchestration/intro_to_containers/index.html +++ b/level102/containerization_and_orchestration/intro_to_containers/index.html @@ -1959,6 +1959,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/containerization_and_orchestration/orchestration_with_kubernetes/index.html b/level102/containerization_and_orchestration/orchestration_with_kubernetes/index.html index 1e2b000..c470486 100644 --- a/level102/containerization_and_orchestration/orchestration_with_kubernetes/index.html +++ b/level102/containerization_and_orchestration/orchestration_with_kubernetes/index.html @@ -1959,6 +1959,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/continuous_integration_and_continuous_delivery/cicd_brief_history/index.html b/level102/continuous_integration_and_continuous_delivery/cicd_brief_history/index.html new file mode 100644 index 0000000..12bf590 --- /dev/null +++ b/level102/continuous_integration_and_continuous_delivery/cicd_brief_history/index.html @@ -0,0 +1,2221 @@ + + + + + + + + + + + + + + + + + + + Brief History - School Of SRE + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + Skip to content + + +
    +
    + +
    + + + + + + + +
    + +
    + +
    + + + + +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    +
    + + +
    +
    + + + +

    Brief History

    + +

    The Evolution of the CI/CD

    +

    Traditional development approaches have been around for a very long time. The waterfall model has been widely used in both large and small projects and has been successful. Despite the success, it has a lot of drawbacks like longer cycle times or delivery.

    +

    While multiple team members are working on the project, the code changes get accumulated and never integrated until the planned build date. The build usually happens on agreed cycles that range from a month to a quarter. This results in several integration issues and build failures as the developers were working on their features in silos.

    +

    It was a nightmare situation for the operations teams/for anyone to deploy the new builds/releases to the production environment because of lack of proper documentation on every change and the configuration requirements. So, to deploy successfully, often it required hot fixes and immediate patches.

    +

    Another big challenge was collaboration. It is rare that the developer meets the operation engineers and does not have a full understanding of the production environment. All these challenges have given rise to longer cycle times for the delivery of the code changes.

    +

    Agile methodology prescribes the delivery of incremental delivery of features in multiple iterations. So, the developers commit their code changes in smaller increments and roll out more frequently. Every code commit triggers a new build, and the integration issues are identified much early. This has improved the build process and thereby reduced the cycle time. This process is known as continuous integration or CI.

    +

    The big barrier between the developers and the operation teams has been shrunken with the emergence of the trend where organizations are adapting to the DevOps and SRE disciplines. The collaboration between the developers and the operation teams is improved. Moreover, the use of the same tools and processes by both the teams has improved coordination and avoided conflicting understanding of the process. One of the main drivers in this regard is the continuous delivery (CD) process that ensures the incremental deployment of smaller changes. There are multiple pre-production environments also called the staging environments before deploying to production environments.

    +

    CI/CD and DevOps

    +

    The term DevOps represents the combination of Development (Dev) and Operations (Ops) teams. That is bringing developers and operations teams together for more collaboration. The development team often wants to introduce more features and more changes while the operation teams are more focused on the stability of the application in production. A change is always taken as a threat by the operations team as it can shake the stability of the environment. DevOps is termed as a culture that introduces the processes to reduce the barriers between developers and operations.

    +

    The collaboration between Dev and Ops allows better follow-up of end-to-end production deployments and more frequent deployments. So, thus CI/CD is a key element in the DevOps processes.

    + + + + + + + +
    +
    +
    +
    + + + + +
    + + + + + + + + + \ No newline at end of file diff --git a/level102/continuous_integration_and_continuous_delivery/conclusion/index.html b/level102/continuous_integration_and_continuous_delivery/conclusion/index.html new file mode 100644 index 0000000..51246a5 --- /dev/null +++ b/level102/continuous_integration_and_continuous_delivery/conclusion/index.html @@ -0,0 +1,2241 @@ + + + + + + + + + + + + + + + + + + + Conclusion - School Of SRE + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + Skip to content + + +
    +
    + +
    + + + + + + + +
    + +
    + +
    + + + + +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    +
    + + +
    +
    + + + +

    Conclusion

    + +

    Applications in SRE Role

    +

    The Monitoring, Automation and Eliminating the toil are some of the core pillars of the SRE discipline. As an SRE, you may require spending about 50% of time on automating the repetitive tasks and to eliminate the toil. CI/CD pipelines are one of the crucial tools for the SRE. They help in delivering the quality application with the smaller and regular and more frequent builds. Additionally, the CI/CD metrics such as Deployment time, Success rate, Cycle time and Automated test success rate etc. are the key things to watch to improve the quality of the product thus improving the reliability of the applications.

    +
      +
    • Infrastructure-as-code is one of the standard practices followed in SRE for automating the repetitive configuration tasks. Every configuration is maintained as code, so it can be deployed using CI/CD pipelines. It is important to deliver the configuration changes to the production environments through CI/CD pipelines to maintain the versioning, consistency of the changes across environments and to avoid manual errors.
      • +
    • Often, as an SRE, you are required to review the application CI/CD pipelines and recommend additional stages such as static code analysis and the security and privacy checks in the code to improve the security and reliability of the product.
      • +
    +

    Conclusion

    +

    In this chapter, we have studied the CI/CD pipelines with brief history on the challenges with the traditional build practices. We have also looked at how the CI/CD pipelines augments the SRE discipline. Use of CI/CD pipelines in software development life cycle is a modern approach in the SRE realm that helps achieve greater efficiency.

    +

    We have also performed a hands-on lab activity on creating the CI/CD pipeline using Jenkins.

    +

    References

    +
      +
    1. Continuous Integration(martinfowler.com)
      2. +
    2. CI/CD for microservices - Azure Architecture Center | Microsoft Docs
      3. +
    3. SREFoundationBlueprint_2 (devopsinstitute.com)
      4. +
    4. Jenkins User Documentation
      5. +
    + + + + + + + +
    +
    +
    +
    + + + + +
    + + + + + + + + + \ No newline at end of file diff --git a/level102/continuous_integration_and_continuous_delivery/continuous_delivery_release_pipeline/index.html b/level102/continuous_integration_and_continuous_delivery/continuous_delivery_release_pipeline/index.html new file mode 100644 index 0000000..b3a9c84 --- /dev/null +++ b/level102/continuous_integration_and_continuous_delivery/continuous_delivery_release_pipeline/index.html @@ -0,0 +1,2142 @@ + + + + + + + + + + + + + + + + + + + Continuous Delivery and Deployment - School Of SRE + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    + +
    + + + + + + + +
    + +
    + +
    + + + + +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + +

    Continuous Delivery and Deployment

    + +

    Continuous Delivery means deploying the application builds more frequently in the non-production environments such as SIT, UAT, INT and performing the integration tests and the acceptance tests automatically.

    +

    In the CD, the tests are performed on the integrated application instead of the single microservice in the cases of microservice based application. The tests must include all the functional tests and the acceptance tests that may contain the UI tests. The build must be immutable in nature, that is the same package must be deployed across all the environments including the Production.

    +

    The deployment to the Production is often manual after performing additional acceptance tests such as performance tests etc. So, the fully automated deployment to the Production environments is called the Continuous Deployment (whereas CD – Continuous delivery doesn’t automatically deploy to Production). The continuous deployment must have a feature toggle so that a feature can be toggled off without the need for redeploying the code.

    +

    Often, the deployment involves more than one production environment, for example in blue-green environments the application is first deployed to the blue environment and then to the green environment so that the downtime is not required.

    +

    +

    Fig 3: Continuous Delivery Pipeline

    + + + + + + + +
    +
    +
    +
    + + + + +
    + + + + + + + + + \ No newline at end of file diff --git a/level102/continuous_integration_and_continuous_delivery/continuous_integration_build_pipeline/index.html b/level102/continuous_integration_and_continuous_delivery/continuous_integration_build_pipeline/index.html new file mode 100644 index 0000000..6d33889 --- /dev/null +++ b/level102/continuous_integration_and_continuous_delivery/continuous_integration_build_pipeline/index.html @@ -0,0 +1,2144 @@ + + + + + + + + + + + + + + + + + + + Continuous Integration - School Of SRE + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    +
    + +
    + + + + + + + +
    + +
    + +
    + + + + +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + +

    Continuous Integration

    + +

    CI is a software development practice where members of a team integrate their work frequently. Each integration is verified by an automated build (including test) to detect integration errors as quickly as possible.

    +

    Continuous integration requires that all the code changes be maintained in a single code repository where all the members can push the changes to their feature branches regularly. The code changes must be quickly integrated with the rest of the code and automated builds should happen and feedback to the member to resolve them early.

    +

    There should be a CI server where it can trigger a build as soon as the code is pushed by a member. The build typically involves compiling the code and transforming it to an executable file such as JARs or DLLs etc. called packaging. It must also perform unit tests with code coverage. Optionally, the build process can have additional stages such as static code analysis and vulnerability checks etc.

    +

    Jenkins, Bamboo, Travis CI, GitLab, Azure DevOps etc. are the few popular CI tools. These tools provide various plugins and integration such as ant, maven etc. for building and packaging, and Junit, selenium etc. are for performing the unit tests. SonarQube can be used for static code analysis and code security.

    +

    +

    Fig 1: Continuous Integration Pipeline

    +

    +

    Fig 2: Continuous Integration Process

    + + + + + + + +
    +
    +
    +
    + + + + +
    + + + + + + + + + \ No newline at end of file diff --git a/level102/continuous_integration_and_continuous_delivery/images/CD_Image1.JPG b/level102/continuous_integration_and_continuous_delivery/images/CD_Image1.JPG new file mode 100644 index 0000000000000000000000000000000000000000..cc7a90cb81ba48d50c7ab100d142ff6bf2481f70 GIT binary patch literal 31663 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 z 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 literal 0 HcmV?d00001 diff --git a/level102/continuous_integration_and_continuous_delivery/images/Jenkins1.png b/level102/continuous_integration_and_continuous_delivery/images/Jenkins1.png new file mode 100644 index 0000000000000000000000000000000000000000..0db37d394cd0845fbe409c4c898d1cf5024b40d4 GIT binary patch literal 38043 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
    VVpU=tAN6Z*um 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�L#`mqY|R}q2kVu1@Kny6=H0@cP- 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�@UU?Zla48KtKmS6!0lqXsJDV!W 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 literal 0 HcmV?d00001 diff --git a/level102/continuous_integration_and_continuous_delivery/images/Jenkins4.png b/level102/continuous_integration_and_continuous_delivery/images/Jenkins4.png new file mode 100644 index 0000000000000000000000000000000000000000..1d3147f93f247f3c89427c740fa7fedf78e516f3 GIT binary patch literal 51843 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 literal 0 HcmV?d00001 diff --git a/level102/continuous_integration_and_continuous_delivery/images/Jenkins5.png b/level102/continuous_integration_and_continuous_delivery/images/Jenkins5.png new file mode 100644 index 0000000000000000000000000000000000000000..d77587662d888986f849fbdfe4bcf4801bac7c1a GIT binary patch literal 72024 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

    GB`}Gvr?pm) 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 literal 0 HcmV?d00001 diff --git a/level102/continuous_integration_and_continuous_delivery/introduction/index.html b/level102/continuous_integration_and_continuous_delivery/introduction/index.html new file mode 100644 index 0000000..652a042 --- /dev/null +++ b/level102/continuous_integration_and_continuous_delivery/introduction/index.html @@ -0,0 +1,2258 @@ + + + + + + + + + + + + + + + + + + + Introduction - School Of SRE + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    +
    + +
    + + + + + + + +
    + +
    + +
    + + + + +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    +
    + + +
    +
    + + + +

    Introduction

    + +

    Prerequisites

    +
      +
    1. Software Development and Maintenance
      2. +
    2. Git
      3. +
    3. Docker
      4. +
    +

    What to expect from this course?

    +

    In this course, you will learn the basics of CI/CD and how it helps drive the SRE discipline in an organization. It also discusses the various DevOps tools in CI/CD practice and a hands-on lab session on Jenkins based pipeline. Finally, it will conclude by explaining the role in the growing SRE philosophy.

    +

    What is not covered under this course?

    +

    The course does not cover DevOps elements such as Infrastructure as a code, continuous monitoring applications and infrastructure comprehensively.

    +

    Table of Contents

    + + + + + + + + +
    +
    +
    +
    + + + + +
    + + + + + + + + + \ No newline at end of file diff --git a/level102/continuous_integration_and_continuous_delivery/introduction_to_cicd/index.html b/level102/continuous_integration_and_continuous_delivery/introduction_to_cicd/index.html new file mode 100644 index 0000000..021af52 --- /dev/null +++ b/level102/continuous_integration_and_continuous_delivery/introduction_to_cicd/index.html @@ -0,0 +1,2213 @@ + + + + + + + + + + + + + + + + + + + What is CI/CD? - School Of SRE + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + + +
    + +
    + +
    + + + + +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    +
    + + +
    +
    + + + +

    What is CI/CD?

    + +

    Continuous Integration and Continuous Delivery, also known as CI/CD, is a set of processes that helps in faster integration of software code changes and deployment to the end user in a reliable manner. The more frequent integrations and deployments helps reduce the software development lifecycle. +There are three practices in CI/CD:

    +
      +
    • Continuous Integration
      • +
    • Continuous Delivery
      • +
    • Continuous Deployment +Let’s look in detail at each of these in the coming sections.
      • +
    +

    The Benefits of CI/CD

    +
      +
    1. Significant reduction in integration problems.
      2. +
    2. Teams can develop cohesive software more rapidly.
      3. +
    3. Improved Collaboration between developers and operation teams can reduce the production integration issues.
      4. +
    4. Faster delivery of new features with less friction
      5. +
    5. Better debugging the production issues and fixing them in the next release/patch.
      6. +
    + + + + + + + +
    +
    +
    +
    + + + + +
    + + + + + + + + + \ No newline at end of file diff --git a/level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/index.html b/level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/index.html new file mode 100644 index 0000000..c1052b8 --- /dev/null +++ b/level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/index.html @@ -0,0 +1,2450 @@ + + + + + + + + + + + + + + + + + + + CI/CD Pipeline - Hands-on - School Of SRE + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + + +
    + +
    + +
    + + + + +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + +
    +
    +
    + + +
    +
    + + + +

    CI/CD Pipeline - Hands-on

    + +

    Jenkins based CI/CD Pipeline

    +

    Jenkins is an open-source continuous integration server for orchestrating the CI/CD pipelines. It supports integration with several components, infrastructure such as git, cloud etc. that helps in complete software development life cycle.

    +

    In this hands-on lab, let us: +* Create a build pipeline (CI) for a simple java application. +* Adding Test stage to build pipeline

    +

    This hands-on is based on the Jenkins running on docker on your local workstation, designed for Windows OS. For Linux OS, please follow the demo

    +

    Note: The hands-on lab is designed with Jenkins on the docker. However, the steps are applicable for the direct docker installation on your windows workstation as well.

    +

    Installing Git, Docker and Jenkins:

    +
      +
    • Install git command line tool on your workstation. (Follow this to install Git Locally·)
      • +
    • Docker Desktop for windows is installed on the workstation. Follow the instructions to install docker.
      • +
    • Ensure that your Docker for Windows installation is configured to run Linux Containers rather than Windows Containers. See the Docker documentation for instructions to switch to Linux containers.
      • +
    • Refer this to run and setup the Jenkins on docker.
      • +
    • Configure Jenkins with initial steps such as create an admin user etc. Follow Setup wizard.
      • +
    • If you have installed the Jenkins on your local workstation, make sure the maven tool is installed. Follow this to installl maven.
      • +
    +

    Forking Sample java application:

    +

    For this hands-on, let us fork a simple java application from the GitHub simple-java-maven-app. +1. Sign up for the GitHub account Join GitHub · GitHub. Once signed up, proceed to login. +2. Open the simple-java-maven-app by clicking on this link +3. On the top right corner, click on the ‘Fork’ to create a copy of the project to your GitHub account. (Refer Fork A Repo) +4. Once forked, clone this repository to your local workstation.

    +

    Create Jenkins Project:

    +
      +
    1. Login to the Jenkins portal at http://localhost:8080 using the admin account created earlier during Jenkins’s setup.
      2. +
    2. On your first login, the following screen will appear. Click on “Create a Job”.
      3. +
    +

    +

    Fig 4: Jenkins - Create a Job

    +
      +
    1. On the next screen, type simple-java-pipeline in the Enter an Item Name field. Select Pipeline from the list of items and click OK.
      2. +
    +

    +

    Fig 5: Jenkins - Create Pipeline

    +
      +
    1. Click the Pipeline tab at the top of the page to scroll down to the Pipeline section.
      2. +
    2. From the Definition field, choose the Pipeline script from SCM option. This option instructs Jenkins to obtain your Pipeline from Source Control Management (SCM), which will be your locally cloned Git repository.
      3. +
    3. From the SCM field, choose Git.
      4. +
    4. In the Repository URL field, specify the directory path of your locally cloned repository from the Forking Sample Java application section above.
      5. +
    +

    Screen looks like below after entering the details.

    +

    +

    Fig 6: Jenkins - Pipeline Configuration

    +

    Create Build pipeline using the Jenkinsfile:

    +

    Jenkinsfile is a script file containing the pipeline configuration and the stages and other instructions to Jenkins to create a pipeline from the file. This file will be saved at the root of the code repository. +1. Using your favorite text editor or IDE, create and save a new text file with the name Jenkinsfile at the root of your local simple-java-maven-app Git repository. +2. Copy the following declarative pipeline code and paste it into the empty Jenkinsfile.

    +
    pipeline {
+    agent {
+        docker {
+            image 'maven:3.8.1-adoptopenjdk-11' 
+            args '-v /root/.m2:/root/.m2' 
+        }
+    }
+    stages {
+        stage('Build') { 
+            steps {
+                sh 'mvn -B -DskipTests clean package' 
+            }
+        }
+    }
+}
+
    +

    Note: If you are running Jenkins on your local workstation without the docker, please change the agent to any as shown below so that it runs on the localhost. Please ensure that the maven tool is installed on your local workstation.

    +
    pipeline {
+    agent any
+
+    stages {
+        stage('Build') { 
+            steps {
+                sh 'mvn -B -DskipTests clean package' 
+            }
+        }
+    }
+}
+
    +

    In the above Jenkinsfile: +* We specified an agent where the pipeline should run. 'docker’ in the agent section indicates to run a new docker container with the specified image. +* In the stages section, we can define multiple steps as different stages. Here, we have a stage called ‘Build’, with the maven command for building the java application.

    +
      +
    1. Save your Jenkinsfile and commit and push to your forked repository. Run the following commands from the command prompt.
      2. +
    +
    cd <your local simple-java-maven-app repo cloned folder>
+git add .
+git commit -m "Add initial Jenkinsfile"
+git push origin master
+
    +
      +
    1. Go to Jenkins portal on your browser and click on the Dashboard. Open the simple-java-pipeline and from the left-menu, click on Build Now.
      2. +
    +

    +

    Fig 7: Jenkins - Building the Pipeline

    +
      +
    1. Notice the build running under the Build History menu. Click on the build number and it shows the stages.
      2. +
    +

    +

    Fig 8: Jenkins - View Running Builds

    +
      +
    1. We have successfully created a build pipeline with single stage and ran it. We can check the logs by clicking on the Console Output menu.
      2. +
    +

    Additional stages in the build pipeline:

    +

    In the previous section, we have created the pipeline with a single stage. Typically, your CI pipeline contains multiple stages such as Build, Test and other optional stages such Code scanning etc. In this section, let us add a Test stage to the build pipeline and run.

    +
      +
    1. Go back to your text editor/IDE and open Jenkinsfile and the Test stage shown below.
      2. +
    +
    stage('Test') {
+            steps {
+                sh 'mvn test'
+            }
+            post {
+                always {
+                    junit 'target/surefire-reports/*.xml'
+                }
+            }
+        }
+
    +

    The Jenkinsfile looks like below after adding the Test stage.

    +
    pipeline {
+    agent {
+        docker {
+            image 'maven:3.8.1-adoptopenjdk-11' 
+            args '-v /root/.m2:/root/.m2' 
+        }
+    }
+    stages {
+        stage('Build') { 
+            steps {
+                sh 'mvn -B -DskipTests clean package' 
+            }
+        }
+        stage('Test') {
+            steps {
+                sh 'mvn test'
+            }
+            post {
+                always {
+                    junit 'target/surefire-reports/*.xml'
+                }
+            }
+        }
+    }
+}
+
    +
      +
    • Here the stage ‘Test’ is added which runs the maven command test.
      • +
    • The post -> always section ensures that this step is executed always after the steps are completed. The test report is available through Jenkins’s interface.
      • +
    +

    Note: If you are running Jenkins on your local workstation without the docker, please change the agent to any so that it runs on the localhost. Please ensure that the maven tool is installed on your local workstation.

    +
    pipeline {
+    agent any
+
+    stages {…
+
+    }
+}
+
    +
      +
    1. Save your Jenkinsfile and commit and push to your forked repository. Run the following commands from the command prompt.
      2. +
    +
    cd <your local simple-java-maven-app repo cloned folder>
+git add .
+git commit -m "Test stage is added to Jenkinsfile"
+git push origin master
+
    +
      +
    1. Go to Jenkins portal on your browser and click on the Dashboard. Open the simple-java-pipeline and from the left-menu, click on Build Now.
      2. +
    2. Notice the Build and Test stages are showing in the Build screen.
      3. +
    +

    +

    Fig 9: Jenkins - Viewing the Running Builds with Test stage Included

    +

    We have now successfully created CI pipeline with two stages: Build and Test stages.

    + + + + + + + +
    +
    +
    +
    + + + + +
    + + + + + + + + + \ No newline at end of file diff --git a/level102/linux_intermediate/archiving_backup/index.html b/level102/linux_intermediate/archiving_backup/index.html index 49d6fad..1cb5b81 100644 --- a/level102/linux_intermediate/archiving_backup/index.html +++ b/level102/linux_intermediate/archiving_backup/index.html @@ -1982,6 +1982,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/linux_intermediate/bashscripting/index.html b/level102/linux_intermediate/bashscripting/index.html index a35693a..9e61a2e 100644 --- a/level102/linux_intermediate/bashscripting/index.html +++ b/level102/linux_intermediate/bashscripting/index.html @@ -1935,6 +1935,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/linux_intermediate/conclusion/index.html b/level102/linux_intermediate/conclusion/index.html index d860c87..522403e 100644 --- a/level102/linux_intermediate/conclusion/index.html +++ b/level102/linux_intermediate/conclusion/index.html @@ -1864,6 +1864,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/linux_intermediate/introduction/index.html b/level102/linux_intermediate/introduction/index.html index 121ddeb..45f3d32 100644 --- a/level102/linux_intermediate/introduction/index.html +++ b/level102/linux_intermediate/introduction/index.html @@ -1921,6 +1921,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/linux_intermediate/introvim/index.html b/level102/linux_intermediate/introvim/index.html index c58f22c..942b3d7 100644 --- a/level102/linux_intermediate/introvim/index.html +++ b/level102/linux_intermediate/introvim/index.html @@ -1914,6 +1914,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/linux_intermediate/package_management/index.html b/level102/linux_intermediate/package_management/index.html index 4bb38de..71a661c 100644 --- a/level102/linux_intermediate/package_management/index.html +++ b/level102/linux_intermediate/package_management/index.html @@ -1921,6 +1921,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/linux_intermediate/storage_media/index.html b/level102/linux_intermediate/storage_media/index.html index 26685f9..c5eea02 100644 --- a/level102/linux_intermediate/storage_media/index.html +++ b/level102/linux_intermediate/storage_media/index.html @@ -2011,6 +2011,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/networking/conclusion/index.html b/level102/networking/conclusion/index.html index 9efde56..dcaacae 100644 --- a/level102/networking/conclusion/index.html +++ b/level102/networking/conclusion/index.html @@ -1857,6 +1857,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/networking/infrastructure-features/index.html b/level102/networking/infrastructure-features/index.html index 92d5a54..d58d360 100644 --- a/level102/networking/infrastructure-features/index.html +++ b/level102/networking/infrastructure-features/index.html @@ -1957,6 +1957,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/networking/introduction/index.html b/level102/networking/introduction/index.html index b54d56e..0da488c 100644 --- a/level102/networking/introduction/index.html +++ b/level102/networking/introduction/index.html @@ -1864,6 +1864,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/networking/rtt/index.html b/level102/networking/rtt/index.html index bbbaf7a..da1ff3e 100644 --- a/level102/networking/rtt/index.html +++ b/level102/networking/rtt/index.html @@ -1889,6 +1889,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/networking/scale/index.html b/level102/networking/scale/index.html index 833d335..126ab3c 100644 --- a/level102/networking/scale/index.html +++ b/level102/networking/scale/index.html @@ -1963,6 +1963,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/networking/security/index.html b/level102/networking/security/index.html index 07a7ff2..a4a8583 100644 --- a/level102/networking/security/index.html +++ b/level102/networking/security/index.html @@ -1957,6 +1957,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_calls_and_signals/conclusion/index.html b/level102/system_calls_and_signals/conclusion/index.html index 4eb2520..fd6f4a3 100644 --- a/level102/system_calls_and_signals/conclusion/index.html +++ b/level102/system_calls_and_signals/conclusion/index.html @@ -1866,6 +1866,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_calls_and_signals/intro/index.html b/level102/system_calls_and_signals/intro/index.html index c04ac21..47e94e4 100644 --- a/level102/system_calls_and_signals/intro/index.html +++ b/level102/system_calls_and_signals/intro/index.html @@ -1916,6 +1916,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_calls_and_signals/signals/index.html b/level102/system_calls_and_signals/signals/index.html index 83498f7..5eab59d 100644 --- a/level102/system_calls_and_signals/signals/index.html +++ b/level102/system_calls_and_signals/signals/index.html @@ -1919,6 +1919,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_calls_and_signals/system_calls/index.html b/level102/system_calls_and_signals/system_calls/index.html index 2d5ea5a..d04d1be 100644 --- a/level102/system_calls_and_signals/system_calls/index.html +++ b/level102/system_calls_and_signals/system_calls/index.html @@ -1919,6 +1919,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_design/conclusion/index.html b/level102/system_design/conclusion/index.html index ca3f3d4..bc163fc 100644 --- a/level102/system_design/conclusion/index.html +++ b/level102/system_design/conclusion/index.html @@ -1857,6 +1857,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_design/intro/index.html b/level102/system_design/intro/index.html index 6fe1748..eb53404 100644 --- a/level102/system_design/intro/index.html +++ b/level102/system_design/intro/index.html @@ -1921,6 +1921,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_design/large-system-design/index.html b/level102/system_design/large-system-design/index.html index 3393400..48d5f78 100644 --- a/level102/system_design/large-system-design/index.html +++ b/level102/system_design/large-system-design/index.html @@ -1917,6 +1917,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_design/resiliency/index.html b/level102/system_design/resiliency/index.html index 031e854..dbce294 100644 --- a/level102/system_design/resiliency/index.html +++ b/level102/system_design/resiliency/index.html @@ -1931,6 +1931,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_design/scaling-beyond-the-datacenter/index.html b/level102/system_design/scaling-beyond-the-datacenter/index.html index b3f26ef..c7b0e24 100644 --- a/level102/system_design/scaling-beyond-the-datacenter/index.html +++ b/level102/system_design/scaling-beyond-the-datacenter/index.html @@ -1917,6 +1917,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_design/scaling/index.html b/level102/system_design/scaling/index.html index 27dd85a..12882c2 100644 --- a/level102/system_design/scaling/index.html +++ b/level102/system_design/scaling/index.html @@ -1937,6 +1937,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_troubleshooting_and_performance/conclusion/index.html b/level102/system_troubleshooting_and_performance/conclusion/index.html index a211e06..de40d45 100644 --- a/level102/system_troubleshooting_and_performance/conclusion/index.html +++ b/level102/system_troubleshooting_and_performance/conclusion/index.html @@ -1889,6 +1889,118 @@ + + + + + +
  • + + + + + + +
    • + + + @@ -2027,13 +2139,13 @@ -
  • +
    • + + + diff --git a/level102/system_troubleshooting_and_performance/introduction/index.html b/level102/system_troubleshooting_and_performance/introduction/index.html index b0560b0..1783cf8 100644 --- a/level102/system_troubleshooting_and_performance/introduction/index.html +++ b/level102/system_troubleshooting_and_performance/introduction/index.html @@ -1934,6 +1934,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_troubleshooting_and_performance/performance-improvements/index.html b/level102/system_troubleshooting_and_performance/performance-improvements/index.html index 7fe3669..37875bd 100644 --- a/level102/system_troubleshooting_and_performance/performance-improvements/index.html +++ b/level102/system_troubleshooting_and_performance/performance-improvements/index.html @@ -1910,6 +1910,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_troubleshooting_and_performance/troubleshooting-example/index.html b/level102/system_troubleshooting_and_performance/troubleshooting-example/index.html index bc5aec9..3f35981 100644 --- a/level102/system_troubleshooting_and_performance/troubleshooting-example/index.html +++ b/level102/system_troubleshooting_and_performance/troubleshooting-example/index.html @@ -1889,6 +1889,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/level102/system_troubleshooting_and_performance/troubleshooting/index.html b/level102/system_troubleshooting_and_performance/troubleshooting/index.html index a3b75ee..7750987 100644 --- a/level102/system_troubleshooting_and_performance/troubleshooting/index.html +++ b/level102/system_troubleshooting_and_performance/troubleshooting/index.html @@ -1903,6 +1903,118 @@ + + + + + +
  • + + + + + + +
    • + + + diff --git a/search/search_index.json b/search/search_index.json index 8fc3abe..cee05bb 100644 --- a/search/search_index.json +++ b/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"School of SRE Site Reliability Engineers (SREs) sits at the intersection of software engineering and systems engineering. While there are potentially infinite permutations and combinations of how infrastructure and software components can be put together to achieve an objective, focusing on foundational skills allows SREs to work with complex systems and software, regardless of whether these systems are proprietary, 3rd party, open systems, run on cloud/on-prem infrastructure, etc. Particularly important is to gain a deep understanding of how these areas of systems and infrastructure relate to each other and interact with each other. The combination of software and systems engineering skills is rare and is generally built over time with exposure to a wide variety of infrastructure, systems, and software. SREs bring in engineering practices to keep the site up. Each distributed system is an agglomeration of many components. SREs validate business requirements, convert them to SLAs for each of the components that constitute the distributed system, monitor and measure adherence to SLAs, re-architect or scale out to mitigate or avoid SLA breaches, add these learnings as feedback to new systems or projects and thereby reduce operational toil. Hence SREs play a vital role right from the day 0 design of the system. In early 2019, we started visiting campuses across India to recruit the best and brightest minds to make sure LinkedIn, and all the services that make up its complex technology stack are always available for everyone. This critical function at LinkedIn falls under the purview of the Site Engineering team and Site Reliability Engineers (SREs) who are Software Engineers, specialized in reliability. As we continued on this journey we started getting a lot of questions from these campuses on what exactly the site reliability engineering role entails? And, how could someone learn the skills and the disciplines involved to become a successful site reliability engineer? Fast forward a few months, and a few of these campus students had joined LinkedIn either as interns or as full-time engineers to become a part of the Site Engineering team; we also had a few lateral hires who joined our organization who were not from a traditional SRE background. That's when a few of us got together and started to think about how we can onboard new graduate engineers to the Site Engineering team. There are very few resources out there guiding someone on the basic skill sets one has to acquire as a beginner SRE. Because of the lack of these resources, we felt that individuals have a tough time getting into open positions in the industry. We created the School Of SRE as a starting point for anyone wanting to build their career as an SRE. In this course, we are focusing on building strong foundational skills. The course is structured in a way to provide more real life examples and how learning each of these topics can play an important role in day to day job responsibilities of an SRE. Currently we are covering the following topics under the School Of SRE: Level 101 Fundamentals Series Linux Basics Git Linux Networking Python and Web Data Relational databases(MySQL) NoSQL concepts Big Data Systems Design Metrics and Monitoring Security Level 102 Linux Intermediate Linux Advanced Containers and orchestration System Calls and Signals Networking System Design System troubleshooting and performance improvements We believe continuous learning will help in acquiring deeper knowledge and competencies in order to expand your skill sets, every module has added references that could be a guide for further learning. Our hope is that by going through these modules we should be able to build the essential skills required for a Site Reliability Engineer. At LinkedIn, we are using this curriculum for onboarding our non-traditional hires and new college grads into the SRE role. We had multiple rounds of successful onboarding experiences with new employees and the course helped them be productive in a very short period of time. This motivated us to open source the content for helping other organizations in onboarding new engineers into the role and provide guidance for aspiring individuals to get into the role. We realize that the initial content we created is just a starting point and we hope that the community can help in the journey of refining and expanding the content. Check out the contributing guide to get started.","title":"Home"},{"location":"#school-of-sre","text":"Site Reliability Engineers (SREs) sits at the intersection of software engineering and systems engineering. While there are potentially infinite permutations and combinations of how infrastructure and software components can be put together to achieve an objective, focusing on foundational skills allows SREs to work with complex systems and software, regardless of whether these systems are proprietary, 3rd party, open systems, run on cloud/on-prem infrastructure, etc. Particularly important is to gain a deep understanding of how these areas of systems and infrastructure relate to each other and interact with each other. The combination of software and systems engineering skills is rare and is generally built over time with exposure to a wide variety of infrastructure, systems, and software. SREs bring in engineering practices to keep the site up. Each distributed system is an agglomeration of many components. SREs validate business requirements, convert them to SLAs for each of the components that constitute the distributed system, monitor and measure adherence to SLAs, re-architect or scale out to mitigate or avoid SLA breaches, add these learnings as feedback to new systems or projects and thereby reduce operational toil. Hence SREs play a vital role right from the day 0 design of the system. In early 2019, we started visiting campuses across India to recruit the best and brightest minds to make sure LinkedIn, and all the services that make up its complex technology stack are always available for everyone. This critical function at LinkedIn falls under the purview of the Site Engineering team and Site Reliability Engineers (SREs) who are Software Engineers, specialized in reliability. As we continued on this journey we started getting a lot of questions from these campuses on what exactly the site reliability engineering role entails? And, how could someone learn the skills and the disciplines involved to become a successful site reliability engineer? Fast forward a few months, and a few of these campus students had joined LinkedIn either as interns or as full-time engineers to become a part of the Site Engineering team; we also had a few lateral hires who joined our organization who were not from a traditional SRE background. That's when a few of us got together and started to think about how we can onboard new graduate engineers to the Site Engineering team. There are very few resources out there guiding someone on the basic skill sets one has to acquire as a beginner SRE. Because of the lack of these resources, we felt that individuals have a tough time getting into open positions in the industry. We created the School Of SRE as a starting point for anyone wanting to build their career as an SRE. In this course, we are focusing on building strong foundational skills. The course is structured in a way to provide more real life examples and how learning each of these topics can play an important role in day to day job responsibilities of an SRE. Currently we are covering the following topics under the School Of SRE: Level 101 Fundamentals Series Linux Basics Git Linux Networking Python and Web Data Relational databases(MySQL) NoSQL concepts Big Data Systems Design Metrics and Monitoring Security Level 102 Linux Intermediate Linux Advanced Containers and orchestration System Calls and Signals Networking System Design System troubleshooting and performance improvements We believe continuous learning will help in acquiring deeper knowledge and competencies in order to expand your skill sets, every module has added references that could be a guide for further learning. Our hope is that by going through these modules we should be able to build the essential skills required for a Site Reliability Engineer. At LinkedIn, we are using this curriculum for onboarding our non-traditional hires and new college grads into the SRE role. We had multiple rounds of successful onboarding experiences with new employees and the course helped them be productive in a very short period of time. This motivated us to open source the content for helping other organizations in onboarding new engineers into the role and provide guidance for aspiring individuals to get into the role. We realize that the initial content we created is just a starting point and we hope that the community can help in the journey of refining and expanding the content. Check out the contributing guide to get started.","title":"School of SRE"},{"location":"CODE_OF_CONDUCT/","text":"This code of conduct outlines expectations for participation in LinkedIn-managed open source communities, as well as steps for reporting unacceptable behavior. We are committed to providing a welcoming and inspiring community for all. People violating this code of conduct may be banned from the community. Our open source communities strive to: Be friendly and patient: Remember you might not be communicating in someone else's primary spoken or programming language, and others may not have your level of understanding. Be welcoming: Our communities welcome and support people of all backgrounds and identities. This includes, but is not limited to members of any race, ethnicity, culture, national origin, color, immigration status, social and economic class, educational level, sex, sexual orientation, gender identity and expression, age, size, family status, political belief, religion, and mental and physical ability. Be respectful: We are a world-wide community of professionals, and we conduct ourselves professionally. Disagreement is no excuse for poor behavior and poor manners. Disrespectful and unacceptable behavior includes, but is not limited to: Violent threats or language. Discriminatory or derogatory jokes and language. Posting sexually explicit or violent material. Posting, or threatening to post, people's personally identifying information (\"doxing\"). Insults, especially those using discriminatory terms or slurs. Behavior that could be perceived as sexual attention. Advocating for or encouraging any of the above behaviors. Understand disagreements: Disagreements, both social and technical, are useful learning opportunities. Seek to understand the other viewpoints and resolve differences constructively. This code is not exhaustive or complete. It serves to capture our common understanding of a productive, collaborative environment. We expect the code to be followed in spirit as much as in the letter. Scope This code of conduct applies to all repos and communities for LinkedIn-managed open source projects regardless of whether or not the repo explicitly calls out its use of this code. The code also applies in public spaces when an individual is representing a project or its community. Examples include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. Note: Some LinkedIn-managed communities have codes of conduct that pre-date this document and issue resolution process. While communities are not required to change their code, they are expected to use the resolution process outlined here. The review team will coordinate with the communities involved to address your concerns. Reporting Code of Conduct Issues We encourage all communities to resolve issues on their own whenever possible. This builds a broader and deeper understanding and ultimately a healthier interaction. In the event that an issue cannot be resolved locally, please feel free to report your concerns by contacting oss@linkedin.com . In your report please include: Your contact information. Names (real, usernames or pseudonyms) of any individuals involved. If there are additional witnesses, please include them as well. Your account of what occurred, and if you believe the incident is ongoing. If there is a publicly available record (e.g. a mailing list archive or a public chat log), please include a link or attachment. Any additional information that may be helpful. All reports will be reviewed by a multi-person team and will result in a response that is deemed necessary and appropriate to the circumstances. Where additional perspectives are needed, the team may seek insight from others with relevant expertise or experience. The confidentiality of the person reporting the incident will be kept at all times. Involved parties are never part of the review team. Anyone asked to stop unacceptable behavior is expected to comply immediately. If an individual engages in unacceptable behavior, the review team may take any action they deem appropriate, including a permanent ban from the community. This code of conduct is based on the Microsoft Open Source Code of Conduct which was based on the template established by the TODO Group and used by numerous other large communities (e.g., Facebook , Yahoo , Twitter , GitHub ) and the Scope section from the Contributor Covenant version 1.4 .","title":"Code of Conduct"},{"location":"CODE_OF_CONDUCT/#scope","text":"This code of conduct applies to all repos and communities for LinkedIn-managed open source projects regardless of whether or not the repo explicitly calls out its use of this code. The code also applies in public spaces when an individual is representing a project or its community. Examples include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. Note: Some LinkedIn-managed communities have codes of conduct that pre-date this document and issue resolution process. While communities are not required to change their code, they are expected to use the resolution process outlined here. The review team will coordinate with the communities involved to address your concerns.","title":"Scope"},{"location":"CODE_OF_CONDUCT/#reporting-code-of-conduct-issues","text":"We encourage all communities to resolve issues on their own whenever possible. This builds a broader and deeper understanding and ultimately a healthier interaction. In the event that an issue cannot be resolved locally, please feel free to report your concerns by contacting oss@linkedin.com . In your report please include: Your contact information. Names (real, usernames or pseudonyms) of any individuals involved. If there are additional witnesses, please include them as well. Your account of what occurred, and if you believe the incident is ongoing. If there is a publicly available record (e.g. a mailing list archive or a public chat log), please include a link or attachment. Any additional information that may be helpful. All reports will be reviewed by a multi-person team and will result in a response that is deemed necessary and appropriate to the circumstances. Where additional perspectives are needed, the team may seek insight from others with relevant expertise or experience. The confidentiality of the person reporting the incident will be kept at all times. Involved parties are never part of the review team. Anyone asked to stop unacceptable behavior is expected to comply immediately. If an individual engages in unacceptable behavior, the review team may take any action they deem appropriate, including a permanent ban from the community. This code of conduct is based on the Microsoft Open Source Code of Conduct which was based on the template established by the TODO Group and used by numerous other large communities (e.g., Facebook , Yahoo , Twitter , GitHub ) and the Scope section from the Contributor Covenant version 1.4 .","title":"Reporting Code of Conduct Issues"},{"location":"CONTRIBUTING/","text":"We realise that the initial content we created is just a starting point and our hope is that the community can help in the journey refining and extending the contents. As a contributor, you represent that the content you submit is not plagiarised. By submitting the content, you (and, if applicable, your employer) are licensing the submitted content to LinkedIn and the open source community subject to the Creative Commons Attribution 4.0 International Public License. Repository URL : https://github.com/linkedin/school-of-sre Contributing Guidelines Ensure that you adhere to the following guidelines: Should be about principles and concepts that can be applied in any company or individual project. Do not focus on particular tools or tech stack(which usually change over time). Adhere to the Code of Conduct . Should be relevant to the roles and responsibilities of an SRE. Should be locally tested (see steps for testing) and well formatted. It is good practice to open an issue first and discuss your changes before submitting a pull request. This way, you can incorporate ideas from others before you even start. Building and testing locally Run the following commands to build and view the site locally before opening a PR. python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt mkdocs build mkdocs serve Opening a PR Follow the GitHub PR workflow for your contributions. Fork this repo, create a feature branch, commit your changes and open a PR to this repo.","title":"Contribute"},{"location":"CONTRIBUTING/#contributing-guidelines","text":"Ensure that you adhere to the following guidelines: Should be about principles and concepts that can be applied in any company or individual project. Do not focus on particular tools or tech stack(which usually change over time). Adhere to the Code of Conduct . Should be relevant to the roles and responsibilities of an SRE. Should be locally tested (see steps for testing) and well formatted. It is good practice to open an issue first and discuss your changes before submitting a pull request. This way, you can incorporate ideas from others before you even start.","title":"Contributing Guidelines"},{"location":"CONTRIBUTING/#building-and-testing-locally","text":"Run the following commands to build and view the site locally before opening a PR. python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt mkdocs build mkdocs serve","title":"Building and testing locally"},{"location":"CONTRIBUTING/#opening-a-pr","text":"Follow the GitHub PR workflow for your contributions. Fork this repo, create a feature branch, commit your changes and open a PR to this repo.","title":"Opening a PR"},{"location":"sre_community/","text":"We are having an active LinkedIn community for School of SRE. Please join the group via : https://www.linkedin.com/groups/12493545/ The group has members with different levels of experience in site reliability engineering. There are active conversation on different technical topics centered around site reliability engineering. We encourage everyone to join the conversation and learn from each other and build a successful career in the SRE space.","title":"SRE Community"},{"location":"level101/big_data/evolution/","text":"Evolution of Hadoop Architecture of Hadoop HDFS The Hadoop Distributed File System (HDFS) is a distributed file system designed to run on commodity hardware. It has many similarities with existing distributed file systems. However, the differences from other distributed file systems are significant. HDFS is highly fault-tolerant and is designed to be deployed on low-cost hardware. HDFS provides high throughput access to application data and is suitable for applications that have large data sets. HDFS is part of the Apache Hadoop Core project . NameNode: is the arbitrator and central repository of file namespace in the cluster. The NameNode executes the operations such as opening, closing, and renaming files and directories. DataNode: manages the storage attached to the node on which it runs. It is responsible for serving all the read and writes requests. It performs operations on instructions on NameNode such as creation, deletion, and replications of blocks. Client: Responsible for getting the required metadata from the namenode and then communicating with the datanodes for reads and writes. YARN YARN stands for \u201cYet Another Resource Negotiator\u201c. It was introduced in Hadoop 2.0 to remove the bottleneck on Job Tracker which was present in Hadoop 1.0. YARN was described as a \u201cRedesigned Resource Manager\u201d at the time of its launching, but it has now evolved to be known as a large-scale distributed operating system used for Big Data processing. The main components of YARN architecture include: Client: It submits map-reduce(MR) jobs to the resource manager. Resource Manager: It is the master daemon of YARN and is responsible for resource assignment and management among all the applications. Whenever it receives a processing request, it forwards it to the corresponding node manager and allocates resources for the completion of the request accordingly. It has two major components: Scheduler: It performs scheduling based on the allocated application and available resources. It is a pure scheduler, which means that it does not perform other tasks such as monitoring or tracking and does not guarantee a restart if a task fails. The YARN scheduler supports plugins such as Capacity Scheduler and Fair Scheduler to partition the cluster resources. Application manager: It is responsible for accepting the application and negotiating the first container from the resource manager. It also restarts the Application Manager container if a task fails. Node Manager: It takes care of individual nodes on the Hadoop cluster and manages application and workflow and that particular node. Its primary job is to keep up with the Node Manager. It monitors resource usage, performs log management, and also kills a container based on directions from the resource manager. It is also responsible for creating the container process and starting it at the request of the Application master. Application Master: An application is a single job submitted to a framework. The application manager is responsible for negotiating resources with the resource manager, tracking the status, and monitoring the progress of a single application. The application master requests the container from the node manager by sending a Container Launch Context(CLC) which includes everything an application needs to run. Once the application is started, it sends the health report to the resource manager from time-to-time. Container: It is a collection of physical resources such as RAM, CPU cores, and disk on a single node. The containers are invoked by Container Launch Context(CLC) which is a record that contains information such as environment variables, security tokens, dependencies, etc. MapReduce framework The term MapReduce represents two separate and distinct tasks Hadoop programs perform-Map Job and Reduce Job. Map jobs take data sets as input and process them to produce key-value pairs. Reduce job takes the output of the Map job i.e. the key-value pairs and aggregates them to produce desired results. Hadoop MapReduce (Hadoop Map/Reduce) is a software framework for distributed processing of large data sets on computing clusters. Mapreduce helps to split the input data set into a number of parts and run a program on all data parts parallel at once. Please find the below Word count example demonstrating the usage of the MapReduce framework: Other tooling around Hadoop Hive Uses a language called HQL which is very SQL like. Gives non-programmers the ability to query and analyze data in Hadoop. Is basically an abstraction layer on top of map-reduce. Ex. HQL query: SELECT pet.name, comment FROM pet JOIN event ON (pet.name = event.name); In mysql: SELECT pet.name, comment FROM pet, event WHERE pet.name = event.name; Pig Uses a scripting language called Pig Latin, which is more workflow driven. Don't need to be an expert Java programmer but need a few coding skills. Is also an abstraction layer on top of map-reduce. Here is a quick question for you: What is the output of running the pig queries in the right column against the data present in the left column in the below image? Output: 7,Komal,Nayak,24,9848022334,trivendram 8,Bharathi,Nambiayar,24,9848022333,Chennai 5,Trupthi,Mohanthy,23,9848022336,Bhuwaneshwar 6,Archana,Mishra,23,9848022335,Chennai Spark Spark provides primitives for in-memory cluster computing that allows user programs to load data into a cluster\u2019s memory and query it repeatedly, making it well suited to machine learning algorithms. Presto Presto is a high performance, distributed SQL query engine for Big Data. Its architecture allows users to query a variety of data sources such as Hadoop, AWS S3, Alluxio, MySQL, Cassandra, Kafka, and MongoDB. Example presto query: use studentDB; show tables; SELECT roll_no, name FROM studentDB.studentDetails where section=\u2019A\u2019 limit 5; Data Serialisation and storage In order to transport the data over the network or to store on some persistent storage, we use the process of translating data structures or objects state into binary or textual form. We call this process serialization.. Avro data is stored in a container file (a .avro file) and its schema (the .avsc file) is stored with the data file. Apache Hive provides support to store a table as Avro and can also query data in this serialisation format.","title":"Evolution and Architecture of Hadoop"},{"location":"level101/big_data/evolution/#evolution-of-hadoop","text":"","title":"Evolution of Hadoop"},{"location":"level101/big_data/evolution/#architecture-of-hadoop","text":"HDFS The Hadoop Distributed File System (HDFS) is a distributed file system designed to run on commodity hardware. It has many similarities with existing distributed file systems. However, the differences from other distributed file systems are significant. HDFS is highly fault-tolerant and is designed to be deployed on low-cost hardware. HDFS provides high throughput access to application data and is suitable for applications that have large data sets. HDFS is part of the Apache Hadoop Core project . NameNode: is the arbitrator and central repository of file namespace in the cluster. The NameNode executes the operations such as opening, closing, and renaming files and directories. DataNode: manages the storage attached to the node on which it runs. It is responsible for serving all the read and writes requests. It performs operations on instructions on NameNode such as creation, deletion, and replications of blocks. Client: Responsible for getting the required metadata from the namenode and then communicating with the datanodes for reads and writes. YARN YARN stands for \u201cYet Another Resource Negotiator\u201c. It was introduced in Hadoop 2.0 to remove the bottleneck on Job Tracker which was present in Hadoop 1.0. YARN was described as a \u201cRedesigned Resource Manager\u201d at the time of its launching, but it has now evolved to be known as a large-scale distributed operating system used for Big Data processing. The main components of YARN architecture include: Client: It submits map-reduce(MR) jobs to the resource manager. Resource Manager: It is the master daemon of YARN and is responsible for resource assignment and management among all the applications. Whenever it receives a processing request, it forwards it to the corresponding node manager and allocates resources for the completion of the request accordingly. It has two major components: Scheduler: It performs scheduling based on the allocated application and available resources. It is a pure scheduler, which means that it does not perform other tasks such as monitoring or tracking and does not guarantee a restart if a task fails. The YARN scheduler supports plugins such as Capacity Scheduler and Fair Scheduler to partition the cluster resources. Application manager: It is responsible for accepting the application and negotiating the first container from the resource manager. It also restarts the Application Manager container if a task fails. Node Manager: It takes care of individual nodes on the Hadoop cluster and manages application and workflow and that particular node. Its primary job is to keep up with the Node Manager. It monitors resource usage, performs log management, and also kills a container based on directions from the resource manager. It is also responsible for creating the container process and starting it at the request of the Application master. Application Master: An application is a single job submitted to a framework. The application manager is responsible for negotiating resources with the resource manager, tracking the status, and monitoring the progress of a single application. The application master requests the container from the node manager by sending a Container Launch Context(CLC) which includes everything an application needs to run. Once the application is started, it sends the health report to the resource manager from time-to-time. Container: It is a collection of physical resources such as RAM, CPU cores, and disk on a single node. The containers are invoked by Container Launch Context(CLC) which is a record that contains information such as environment variables, security tokens, dependencies, etc.","title":"Architecture of Hadoop"},{"location":"level101/big_data/evolution/#mapreduce-framework","text":"The term MapReduce represents two separate and distinct tasks Hadoop programs perform-Map Job and Reduce Job. Map jobs take data sets as input and process them to produce key-value pairs. Reduce job takes the output of the Map job i.e. the key-value pairs and aggregates them to produce desired results. Hadoop MapReduce (Hadoop Map/Reduce) is a software framework for distributed processing of large data sets on computing clusters. Mapreduce helps to split the input data set into a number of parts and run a program on all data parts parallel at once. Please find the below Word count example demonstrating the usage of the MapReduce framework:","title":"MapReduce framework"},{"location":"level101/big_data/evolution/#other-tooling-around-hadoop","text":"Hive Uses a language called HQL which is very SQL like. Gives non-programmers the ability to query and analyze data in Hadoop. Is basically an abstraction layer on top of map-reduce. Ex. HQL query: SELECT pet.name, comment FROM pet JOIN event ON (pet.name = event.name); In mysql: SELECT pet.name, comment FROM pet, event WHERE pet.name = event.name; Pig Uses a scripting language called Pig Latin, which is more workflow driven. Don't need to be an expert Java programmer but need a few coding skills. Is also an abstraction layer on top of map-reduce. Here is a quick question for you: What is the output of running the pig queries in the right column against the data present in the left column in the below image? Output: 7,Komal,Nayak,24,9848022334,trivendram 8,Bharathi,Nambiayar,24,9848022333,Chennai 5,Trupthi,Mohanthy,23,9848022336,Bhuwaneshwar 6,Archana,Mishra,23,9848022335,Chennai Spark Spark provides primitives for in-memory cluster computing that allows user programs to load data into a cluster\u2019s memory and query it repeatedly, making it well suited to machine learning algorithms. Presto Presto is a high performance, distributed SQL query engine for Big Data. Its architecture allows users to query a variety of data sources such as Hadoop, AWS S3, Alluxio, MySQL, Cassandra, Kafka, and MongoDB. Example presto query: use studentDB; show tables; SELECT roll_no, name FROM studentDB.studentDetails where section=\u2019A\u2019 limit 5;","title":"Other tooling around Hadoop"},{"location":"level101/big_data/evolution/#data-serialisation-and-storage","text":"In order to transport the data over the network or to store on some persistent storage, we use the process of translating data structures or objects state into binary or textual form. We call this process serialization.. Avro data is stored in a container file (a .avro file) and its schema (the .avsc file) is stored with the data file. Apache Hive provides support to store a table as Avro and can also query data in this serialisation format.","title":"Data Serialisation and storage"},{"location":"level101/big_data/intro/","text":"Big Data Prerequisites Basics of Linux File systems. Basic understanding of System Design. What to expect from this course This course covers the basics of Big Data and how it has evolved to become what it is today. We will take a look at a few realistic scenarios where Big Data would be a perfect fit. An interesting assignment on designing a Big Data system is followed by understanding the architecture of Hadoop and the tooling around it. What is not covered under this course Writing programs to draw analytics from data. Course Contents Overview of Big Data Usage of Big Data techniques Evolution of Hadoop Architecture of hadoop HDFS Yarn MapReduce framework Other tooling around hadoop Hive Pig Spark Presto Data Serialisation and storage Overview of Big Data Big Data is a collection of large datasets that cannot be processed using traditional computing techniques. It is not a single technique or a tool, rather it has become a complete subject, which involves various tools, techniques, and frameworks. Big Data could consist of Structured data Unstructured data Semi-structured data Characteristics of Big Data: Volume Variety Velocity Variability Examples of Big Data generation include stock exchanges, social media sites, jet engines, etc. Usage of Big Data Techniques Take the example of the traffic lights problem. There are more than 300,000 traffic lights in the US as of 2018. Let us assume that we placed a device on each of them to collect metrics and send it to a central metrics collection system. If each of the IoT devices sends 10 events per minute, we have 300000x10x60x24 = 432x10^7 events per day. How would you go about processing that and telling me how many of the signals were \u201cgreen\u201d at 10:45 am on a particular day? Consider the next example on Unified Payments Interface (UPI) transactions: We had about 1.15 billion UPI transactions in the month of October 2019 in India. If we try to extrapolate this data to about a year and try to find out some common payments that were happening through a particular UPI ID, how do you suggest we go about that?","title":"Introduction"},{"location":"level101/big_data/intro/#big-data","text":"","title":"Big Data"},{"location":"level101/big_data/intro/#prerequisites","text":"Basics of Linux File systems. Basic understanding of System Design.","title":"Prerequisites"},{"location":"level101/big_data/intro/#what-to-expect-from-this-course","text":"This course covers the basics of Big Data and how it has evolved to become what it is today. We will take a look at a few realistic scenarios where Big Data would be a perfect fit. An interesting assignment on designing a Big Data system is followed by understanding the architecture of Hadoop and the tooling around it.","title":"What to expect from this course"},{"location":"level101/big_data/intro/#what-is-not-covered-under-this-course","text":"Writing programs to draw analytics from data.","title":"What is not covered under this course"},{"location":"level101/big_data/intro/#course-contents","text":"Overview of Big Data Usage of Big Data techniques Evolution of Hadoop Architecture of hadoop HDFS Yarn MapReduce framework Other tooling around hadoop Hive Pig Spark Presto Data Serialisation and storage","title":"Course Contents"},{"location":"level101/big_data/intro/#overview-of-big-data","text":"Big Data is a collection of large datasets that cannot be processed using traditional computing techniques. It is not a single technique or a tool, rather it has become a complete subject, which involves various tools, techniques, and frameworks. Big Data could consist of Structured data Unstructured data Semi-structured data Characteristics of Big Data: Volume Variety Velocity Variability Examples of Big Data generation include stock exchanges, social media sites, jet engines, etc.","title":"Overview of Big Data"},{"location":"level101/big_data/intro/#usage-of-big-data-techniques","text":"Take the example of the traffic lights problem. There are more than 300,000 traffic lights in the US as of 2018. Let us assume that we placed a device on each of them to collect metrics and send it to a central metrics collection system. If each of the IoT devices sends 10 events per minute, we have 300000x10x60x24 = 432x10^7 events per day. How would you go about processing that and telling me how many of the signals were \u201cgreen\u201d at 10:45 am on a particular day? Consider the next example on Unified Payments Interface (UPI) transactions: We had about 1.15 billion UPI transactions in the month of October 2019 in India. If we try to extrapolate this data to about a year and try to find out some common payments that were happening through a particular UPI ID, how do you suggest we go about that?","title":"Usage of Big Data Techniques"},{"location":"level101/big_data/tasks/","text":"Tasks and conclusion Post-training tasks: Try setting up your own 3 node Hadoop cluster. A VM based solution can be found here Write a simple spark/MR job of your choice and understand how to generate analytics from data. Sample dataset can be found here References: Hadoop documentation HDFS Architecture YARN Architecture Google GFS paper","title":"Conclusion"},{"location":"level101/big_data/tasks/#tasks-and-conclusion","text":"","title":"Tasks and conclusion"},{"location":"level101/big_data/tasks/#post-training-tasks","text":"Try setting up your own 3 node Hadoop cluster. A VM based solution can be found here Write a simple spark/MR job of your choice and understand how to generate analytics from data. Sample dataset can be found here","title":"Post-training tasks:"},{"location":"level101/big_data/tasks/#references","text":"Hadoop documentation HDFS Architecture YARN Architecture Google GFS paper","title":"References:"},{"location":"level101/databases_nosql/further_reading/","text":"Conclusion We have covered basic concepts of NoSQL databases. There is much more to learn and do. We hope this course gives you a good start and inspires you to explore further. Further reading NoSQL: https://hostingdata.co.uk/nosql-database/ https://www.mongodb.com/nosql-explained https://www.mongodb.com/nosql-explained/nosql-vs-sql Cap Theorem http://www.julianbrowne.com/article/brewers-cap-theorem Scalability http://www.slideshare.net/jboner/scalability-availability-stability-patterns Eventual Consistency https://www.allthingsdistributed.com/2008/12/eventually_consistent.html https://www.toptal.com/big-data/consistent-hashing https://web.stanford.edu/class/cs244/papers/chord_TON_2003.pdf","title":"Conclusion"},{"location":"level101/databases_nosql/further_reading/#conclusion","text":"We have covered basic concepts of NoSQL databases. There is much more to learn and do. We hope this course gives you a good start and inspires you to explore further.","title":"Conclusion"},{"location":"level101/databases_nosql/further_reading/#further-reading","text":"NoSQL: https://hostingdata.co.uk/nosql-database/ https://www.mongodb.com/nosql-explained https://www.mongodb.com/nosql-explained/nosql-vs-sql Cap Theorem http://www.julianbrowne.com/article/brewers-cap-theorem Scalability http://www.slideshare.net/jboner/scalability-availability-stability-patterns Eventual Consistency https://www.allthingsdistributed.com/2008/12/eventually_consistent.html https://www.toptal.com/big-data/consistent-hashing https://web.stanford.edu/class/cs244/papers/chord_TON_2003.pdf","title":"Further reading"},{"location":"level101/databases_nosql/intro/","text":"NoSQL Concepts Prerequisites Relational Databases What to expect from this course At the end of training, you will have an understanding of what a NoSQL database is, what kind of advantages or disadvantages it has over traditional RDBMS, learn about different types of NoSQL databases and understand some of the underlying concepts & trade offs w.r.t to NoSQL. What is not covered under this course We will not be deep diving into any specific NoSQL Database. Course Contents Introduction to NoSQL CAP Theorem Data versioning Partitioning Hashing Quorum Introduction When people use the term \u201cNoSQL database\u201d, they typically use it to refer to any non-relational database. Some say the term \u201cNoSQL\u201d stands for \u201cnon SQL\u201d while others say it stands for \u201cnot only SQL.\u201d Either way, most agree that NoSQL databases are databases that store data in a format other than relational tables. A common misconception is that NoSQL databases or non-relational databases don\u2019t store relationship data well. NoSQL databases can store relationship data\u2014they just store it differently than relational databases do. In fact, when compared with SQL databases, many find modeling relationship data in NoSQL databases to be easier , because related data doesn\u2019t have to be split between tables. Such databases have existed since the late 1960s, but the name \"NoSQL\" was only coined in the early 21st century. NASA used a NoSQL database to track inventory for the Apollo mission. NoSQL databases emerged in the late 2000s as the cost of storage dramatically decreased. Gone were the days of needing to create a complex, difficult-to-manage data model simply for the purposes of reducing data duplication. Developers (rather than storage) were becoming the primary cost of software development, so NoSQL databases optimized for developer productivity. With the rise of Agile development methodology, NoSQL databases were developed with a focus on scaling, fast performance and at the same time allowed for frequent application changes and made programming easier. Types of NoSQL databases: Over time due to the way these NoSQL databases were developed to suit requirements at different companies, we ended up with quite a few types of them. However, they can be broadly classified into 4 types. Some of the databases can overlap between different types. They are Document databases: They store data in documents similar to JSON (JavaScript Object Notation) objects. Each document contains pairs of fields and values. The values can typically be a variety of types including things like strings, numbers, booleans, arrays, or objects, and their structures typically align with objects developers are working with in code. The advantages include intuitive data model & flexible schemas. Because of their variety of field value types and powerful query languages, document databases are great for a wide variety of use cases and can be used as a general purpose database. They can horizontally scale-out to accomodate large data volumes. Ex: MongoDB, Couchbase Key-Value databases: These are a simpler type of databases where each item contains keys and values. A value can typically only be retrieved by referencing its key, so learning how to query for a specific key-value pair is typically simple. Key-value databases are great for use cases where you need to store large amounts of data but you don\u2019t need to perform complex queries to retrieve it. Common use cases include storing user preferences or caching. Ex: Redis , DynamoDB , Voldemort / Venice (Linkedin), Wide-Column stores: They store data in tables, rows, and dynamic columns. Wide-column stores provide a lot of flexibility over relational databases because each row is not required to have the same columns. Many consider wide-column stores to be two-dimensional key-value databases. Wide-column stores are great for when you need to store large amounts of data and you can predict what your query patterns will be. Wide-column stores are commonly used for storing Internet of Things data and user profile data. Cassandra and HBase are two of the most popular wide-column stores. Graph Databases: These databases store data in nodes and edges. Nodes typically store information about people, places, and things while edges store information about the relationships between the nodes. The underlying storage mechanism of graph databases can vary. Some depend on a relational engine and \u201cstore\u201d the graph data in a table (although a table is a logical element, therefore this approach imposes another level of abstraction between the graph database, the graph database management system and the physical devices where the data is actually stored). Others use a key-value store or document-oriented database for storage, making them inherently NoSQL structures. Graph databases excel in use cases where you need to traverse relationships to look for patterns such as social networks, fraud detection, and recommendation engines. Ex: Neo4j Comparison Performance Scalability Flexibility Complexity Functionality Key Value high high high none Variable Document stores high Variable (high) high low Variable (low) Column DB high high moderate low minimal Graph Variable Variable high high Graph theory Differences between SQL and NoSQL The table below summarizes the main differences between SQL and NoSQL databases. SQL Databases NoSQL Databases Data Storage Model Tables with fixed rows and columns Document: JSON documents, Key-value: key-value pairs, Wide-column: tables with rows and dynamic columns, Graph: nodes and edges Primary Purpose General purpose Document: general purpose, Key-value: large amounts of data with simple lookup queries, Wide-column: large amounts of data with predictable query patterns, Graph: analyzing and traversing relationships between connected data Schemas Rigid Flexible Scaling Vertical (scale-up with a larger server) Horizontal (scale-out across commodity servers) Multi-Record ACID Transactions Supported Most do not support multi-record ACID transactions. However, some\u2014like MongoDB\u2014do. Joins Typically required Typically not required Data to Object Mapping Requires ORM (object-relational mapping) Many do not require ORMs. Document DB documents map directly to data structures in most popular programming languages. Advantages Flexible Data Models Most NoSQL systems feature flexible schemas. A flexible schema means you can easily modify your database schema to add or remove fields to support for evolving application requirements. This facilitates with continuous application development of new features without database operation overhead. Horizontal Scaling Most NoSQL systems allow you to scale horizontally, which means you can add in cheaper & commodity hardware, whenever you want to scale a system. On the other hand SQL systems generally scale Vertically (a more powerful server). NoSQL systems can also host huge data sets when compared to traditional SQL systems. Fast Queries NoSQL can generally be a lot faster than traditional SQL systems due to data denormalization and horizontal scaling. Most NoSQL systems also tend to store similar data together facilitating faster query responses. Developer productivity NoSQL systems tend to map data based on the programming data structures. As a result developers need to perform fewer data transformations leading to increased productivity & fewer bugs.","title":"Introduction"},{"location":"level101/databases_nosql/intro/#nosql-concepts","text":"","title":"NoSQL Concepts"},{"location":"level101/databases_nosql/intro/#prerequisites","text":"Relational Databases","title":"Prerequisites"},{"location":"level101/databases_nosql/intro/#what-to-expect-from-this-course","text":"At the end of training, you will have an understanding of what a NoSQL database is, what kind of advantages or disadvantages it has over traditional RDBMS, learn about different types of NoSQL databases and understand some of the underlying concepts & trade offs w.r.t to NoSQL.","title":"What to expect from this course"},{"location":"level101/databases_nosql/intro/#what-is-not-covered-under-this-course","text":"We will not be deep diving into any specific NoSQL Database.","title":"What is not covered under this course"},{"location":"level101/databases_nosql/intro/#course-contents","text":"Introduction to NoSQL CAP Theorem Data versioning Partitioning Hashing Quorum","title":"Course Contents"},{"location":"level101/databases_nosql/intro/#introduction","text":"When people use the term \u201cNoSQL database\u201d, they typically use it to refer to any non-relational database. Some say the term \u201cNoSQL\u201d stands for \u201cnon SQL\u201d while others say it stands for \u201cnot only SQL.\u201d Either way, most agree that NoSQL databases are databases that store data in a format other than relational tables. A common misconception is that NoSQL databases or non-relational databases don\u2019t store relationship data well. NoSQL databases can store relationship data\u2014they just store it differently than relational databases do. In fact, when compared with SQL databases, many find modeling relationship data in NoSQL databases to be easier , because related data doesn\u2019t have to be split between tables. Such databases have existed since the late 1960s, but the name \"NoSQL\" was only coined in the early 21st century. NASA used a NoSQL database to track inventory for the Apollo mission. NoSQL databases emerged in the late 2000s as the cost of storage dramatically decreased. Gone were the days of needing to create a complex, difficult-to-manage data model simply for the purposes of reducing data duplication. Developers (rather than storage) were becoming the primary cost of software development, so NoSQL databases optimized for developer productivity. With the rise of Agile development methodology, NoSQL databases were developed with a focus on scaling, fast performance and at the same time allowed for frequent application changes and made programming easier.","title":"Introduction"},{"location":"level101/databases_nosql/intro/#types-of-nosql-databases","text":"Over time due to the way these NoSQL databases were developed to suit requirements at different companies, we ended up with quite a few types of them. However, they can be broadly classified into 4 types. Some of the databases can overlap between different types. They are Document databases: They store data in documents similar to JSON (JavaScript Object Notation) objects. Each document contains pairs of fields and values. The values can typically be a variety of types including things like strings, numbers, booleans, arrays, or objects, and their structures typically align with objects developers are working with in code. The advantages include intuitive data model & flexible schemas. Because of their variety of field value types and powerful query languages, document databases are great for a wide variety of use cases and can be used as a general purpose database. They can horizontally scale-out to accomodate large data volumes. Ex: MongoDB, Couchbase Key-Value databases: These are a simpler type of databases where each item contains keys and values. A value can typically only be retrieved by referencing its key, so learning how to query for a specific key-value pair is typically simple. Key-value databases are great for use cases where you need to store large amounts of data but you don\u2019t need to perform complex queries to retrieve it. Common use cases include storing user preferences or caching. Ex: Redis , DynamoDB , Voldemort / Venice (Linkedin), Wide-Column stores: They store data in tables, rows, and dynamic columns. Wide-column stores provide a lot of flexibility over relational databases because each row is not required to have the same columns. Many consider wide-column stores to be two-dimensional key-value databases. Wide-column stores are great for when you need to store large amounts of data and you can predict what your query patterns will be. Wide-column stores are commonly used for storing Internet of Things data and user profile data. Cassandra and HBase are two of the most popular wide-column stores. Graph Databases: These databases store data in nodes and edges. Nodes typically store information about people, places, and things while edges store information about the relationships between the nodes. The underlying storage mechanism of graph databases can vary. Some depend on a relational engine and \u201cstore\u201d the graph data in a table (although a table is a logical element, therefore this approach imposes another level of abstraction between the graph database, the graph database management system and the physical devices where the data is actually stored). Others use a key-value store or document-oriented database for storage, making them inherently NoSQL structures. Graph databases excel in use cases where you need to traverse relationships to look for patterns such as social networks, fraud detection, and recommendation engines. Ex: Neo4j","title":"Types of NoSQL databases:"},{"location":"level101/databases_nosql/intro/#comparison","text":"Performance Scalability Flexibility Complexity Functionality Key Value high high high none Variable Document stores high Variable (high) high low Variable (low) Column DB high high moderate low minimal Graph Variable Variable high high Graph theory","title":"Comparison"},{"location":"level101/databases_nosql/intro/#differences-between-sql-and-nosql","text":"The table below summarizes the main differences between SQL and NoSQL databases. SQL Databases NoSQL Databases Data Storage Model Tables with fixed rows and columns Document: JSON documents, Key-value: key-value pairs, Wide-column: tables with rows and dynamic columns, Graph: nodes and edges Primary Purpose General purpose Document: general purpose, Key-value: large amounts of data with simple lookup queries, Wide-column: large amounts of data with predictable query patterns, Graph: analyzing and traversing relationships between connected data Schemas Rigid Flexible Scaling Vertical (scale-up with a larger server) Horizontal (scale-out across commodity servers) Multi-Record ACID Transactions Supported Most do not support multi-record ACID transactions. However, some\u2014like MongoDB\u2014do. Joins Typically required Typically not required Data to Object Mapping Requires ORM (object-relational mapping) Many do not require ORMs. Document DB documents map directly to data structures in most popular programming languages.","title":"Differences between SQL and NoSQL"},{"location":"level101/databases_nosql/intro/#advantages","text":"Flexible Data Models Most NoSQL systems feature flexible schemas. A flexible schema means you can easily modify your database schema to add or remove fields to support for evolving application requirements. This facilitates with continuous application development of new features without database operation overhead. Horizontal Scaling Most NoSQL systems allow you to scale horizontally, which means you can add in cheaper & commodity hardware, whenever you want to scale a system. On the other hand SQL systems generally scale Vertically (a more powerful server). NoSQL systems can also host huge data sets when compared to traditional SQL systems. Fast Queries NoSQL can generally be a lot faster than traditional SQL systems due to data denormalization and horizontal scaling. Most NoSQL systems also tend to store similar data together facilitating faster query responses. Developer productivity NoSQL systems tend to map data based on the programming data structures. As a result developers need to perform fewer data transformations leading to increased productivity & fewer bugs.","title":"Advantages"},{"location":"level101/databases_nosql/key_concepts/","text":"Key Concepts Lets looks at some of the key concepts when we talk about NoSQL or distributed systems CAP Theorem In a keynote titled \u201c Towards Robust Distributed Systems \u201d at ACM\u2019s PODC symposium in 2000 Eric Brewer came up with the so-called CAP-theorem which is widely adopted today by large web companies as well as in the NoSQL community. The CAP acronym stands for C onsistency, A vailability & P artition Tolerance. Consistency It refers to how consistent a system is after an execution. A distributed system is called consistent when a write made by a source is available for all readers of that shared data. Different NoSQL systems support different levels of consistency. Availability It refers to how a system responds to loss of functionality of different systems due to hardware and software failures. A high availability implies that a system is still available to handle operations (reads and writes) when a certain part of the system is down due to a failure or upgrade. Partition Tolerance It is the ability of the system to continue operations in the event of a network partition. A network partition occurs when a failure causes two or more islands of networks where the systems can\u2019t talk to each other across the islands temporarily or permanently. Brewer alleges that one can at most choose two of these three characteristics in a shared-data system. The CAP-theorem states that a choice can only be made for two options out of consistency, availability and partition tolerance. A growing number of use cases in large scale applications tend to value reliability implying that availability & redundancy are more valuable than consistency. As a result these systems struggle to meet ACID properties. They attain this by loosening on the consistency requirement i.e Eventual Consistency. Eventual Consistency means that all readers will see writes, as time goes on: \u201cIn a steady state, the system will eventually return the last written value\u201d. Clients therefore may face an inconsistent state of data as updates are in progress. For instance, in a replicated database updates may go to one node which replicates the latest version to all other nodes that contain a replica of the modified dataset so that the replica nodes eventually will have the latest version. NoSQL systems support different levels of eventual consistency models. For example: Read Your Own Writes Consistency Clients will see their updates immediately after they are written. The reads can hit nodes other than the one where it was written. However they might not see updates by other clients immediately. Session Consistency Clients will see the updates to their data within a session scope. This generally indicates that reads & writes occur on the same server. Other clients using the same nodes will receive the same updates. Casual Consistency A system provides causal consistency if the following condition holds: write operations that are related by potential causality are seen by each process of the system in order. Different processes may observe concurrent writes in different orders Eventual consistency is useful if concurrent updates of the same partitions of data are unlikely and if clients do not immediately depend on reading updates issued by themselves or by other clients. Depending on what consistency model was chosen for the system (or parts of it), determines where the requests are routed, ex: replicas. CAP alternatives illustration Choice Traits Examples Consistency + Availability (Forfeit Partitions) 2-phase commits Cache invalidation protocols Single-site databases Cluster databases LDAP xFS file system Consistency + Partition tolerance (Forfeit Availability) Pessimistic locking Make minority partitions unavailable Distributed databases Distributed locking Majority protocols Availability + Partition tolerance (Forfeit Consistency) expirations/leases conflict resolution optimistic DNS Web caching Versioning of Data in distributed systems When data is distributed across nodes, it can be modified on different nodes at the same time (assuming strict consistency is enforced). Questions arise on conflict resolution for concurrent updates. Some of the popular conflict resolution mechanism are Timestamps This is the most obvious solution. You sort updates based on chronological order and choose the latest update. However this relies on clock synchronization across different parts of the infrastructure. This gets even more complicated when parts of systems are spread across different geographic locations. Optimistic Locking You associate a unique value like a clock or counter with every data update. When a client wants to update data, it has to specify which version of data needs to be updated. This would mean you need to keep track of history of the data versions. Vector Clocks A vector clock is defined as a tuple of clock values from each node. In a distributed environment, each node maintains a tuple of such clock values which represent the state of the nodes itself and its peers/replicas. A clock value may be real timestamps derived from local clock or version no. Vector clocks illustration Vector clocks have the following advantages over other conflict resolution mechanism No dependency on synchronized clocks No total ordering of revision nos required for casual reasoning No need to store and maintain multiple versions of the data on different nodes. Partitioning When the amount of data crosses the capacity of a single node, we need to think of splitting data, creating replicas for load balancing & disaster recovery. Depending on how dynamic the infrastructure is, we have a few approaches that we can take. Memory cached These are partitioned in-memory databases that are primarily used for transient data. These databases are generally used as a front for traditional RDBMS. Most frequently used data is replicated from a rdbms into a memory database to facilitate fast queries and to take the load off from backend DB\u2019s. A very common example is memcached or couchbase. Clustering Traditional cluster mechanisms abstract away the cluster topology from clients. A client need not know where the actual data is residing and which node it is talking to. Clustering is very commonly used in traditional RDBMS where it can help scaling the persistent layer to a certain extent. Separating reads from writes In this method, you will have multiple replicas hosting the same data. The incoming writes are typically sent to a single node (Leader) or multiple nodes (multi-Leader), while the rest of the replicas (Follower) handle reads requests. The leader replicates writes asynchronously to all followers. However the write lag can\u2019t be completely avoided. Sometimes a leader can crash before it replicates all the data to a follower. When this happens, a follower with the most consistent data can be turned into a leader. As you can realize now, it is hard to enforce full consistency in this model. You also need to consider the ratio of read vs write traffic. This model won\u2019t make sense when writes are higher than reads. The replication methods can also vary widely. Some systems do a complete transfer of state periodically, while others use a delta state transfer approach. You could also transfer the state by transferring the operations in order. The followers can then apply the same operations as the leader to catch up. Sharding Sharing refers to dividing data in such a way that data is distributed evenly (both in terms of storage & processing power) across a cluster of nodes. It can also imply data locality, which means similar & related data is stored together to facilitate faster access. A shard in turn can be further replicated to meet load balancing or disaster recovery requirements. A single shard replica might take in all writes (single leader) or multiple replicas can take writes (multi-leader). Reads can be distributed across multiple replicas. Since data is now distributed across multiple nodes, clients should be able to consistently figure out where data is hosted. We will look at some of the common techniques below. The downside of sharding is that joins between shards is not possible. So an upstream/downstream application has to aggregate the results from multiple shards. Sharding example Hashing A hash function is a function that maps one piece of data\u2014typically describing some kind of object, often of arbitrary size\u2014to another piece of data, typically an integer, known as hash code , or simply hash . In a partitioned database, it is important to consistently map a key to a server/replica. For ex: you can use a very simple hash as a modulo function. _p = k mod n_ Where p -> partition, k -> primary key n -> no of nodes The downside of this simple hash is that, whenever the cluster topology changes, the data distribution also changes. When you are dealing with memory caches, it will be easy to distribute partitions around. Whenever a node joins/leaves a topology, partitions can reorder themselves, a cache miss can be re-populated from backend DB. However when you look at persistent data, it is not possible as the new node doesn\u2019t have the data needed to serve it. This brings us to consistent hashing. Consistent Hashing Consistent hashing is a distributed hashing scheme that operates independently of the number of servers or objects in a distributed hash table by assigning them a position on an abstract circle, or hash ring . This allows servers and objects to scale without affecting the overall system. Say that our hash function h() generates a 32-bit integer. Then, to determine to which server we will send a key k, we find the server s whose hash h(s) is the smallest integer that is larger than h(k). To make the process simpler, we assume the table is circular, which means that if we cannot find a server with a hash larger than h(k), we wrap around and start looking from the beginning of the array. Consistent hashing illustration In consistent hashing when a server is removed or added then only the keys from that server are relocated. For example, if server S3 is removed then, all keys from server S3 will be moved to server S4 but keys stored on server S4 and S2 are not relocated. But there is one problem, when server S3 is removed then keys from S3 are not equally distributed among remaining servers S4 and S2. They are only assigned to server S4 which increases the load on server S4. To evenly distribute the load among servers when a server is added or removed, it creates a fixed number of replicas ( known as virtual nodes) of each server and distributes it along the circle. So instead of server labels S1, S2 and S3, we will have S10 S11\u2026S19, S20 S21\u2026S29 and S30 S31\u2026S39. The factor for a number of replicas is also known as weight , depending on the situation. All keys which are mapped to replicas Sij are stored on server Si. To find a key we do the same thing, find the position of the key on the circle and then move forward until you find a server replica. If the server replica is Sij then the key is stored in server Si. Suppose server S3 is removed, then all S3 replicas with labels S30 S31 \u2026 S39 must be removed. Now the objects keys adjacent to S3X labels will be automatically re-assigned to S1X, S2X and S4X. All keys originally assigned to S1, S2 & S4 will not be moved. Similar things happen if we add a server. Suppose we want to add a server S5 as a replacement of S3 then we need to add labels S50 S51 \u2026 S59. In the ideal case, one-fourth of keys from S1, S2 and S4 will be reassigned to S5. When applied to persistent storages, further issues arise: if a node has left the scene, data stored on this node becomes unavailable, unless it has been replicated to other nodes before; in the opposite case of a new node joining the others, adjacent nodes are no longer responsible for some pieces of data which they still store but not get asked for anymore as the corresponding objects are no longer hashed to them by requesting clients. In order to address this issue, a replication factor (r) can be introduced. Introducing replicas in a partitioning scheme\u2014besides reliability benefits\u2014also makes it possible to spread workload for read requests that can go to any physical node responsible for a requested piece of data. Scalability doesn\u2019t work if the clients have to decide between multiple versions of the dataset, because they need to read from a quorum of servers which in turn reduces the efficiency of load balancing. Quorum Quorum is the minimum number of nodes in a cluster that must be online and be able to communicate with each other. If any additional node failure occurs beyond this threshold, the cluster will stop running. To attain a quorum, you need a majority of the nodes. Commonly it is (N/2 + 1), where N is the total no of nodes in the system. For ex, In a 3 node cluster, you need 2 nodes for a majority, In a 5 node cluster, you need 3 nodes for a majority, In a 6 node cluster, you need 4 nodes for a majority. Quorum example Network problems can cause communication failures among cluster nodes. One set of nodes might be able to communicate together across a functioning part of a network but not be able to communicate with a different set of nodes in another part of the network. This is known as split brain in cluster or cluster partitioning. Now the partition which has quorum is allowed to continue running the application. The other partitions are removed from the cluster. Eg: In a 5 node cluster, consider what happens if nodes 1, 2, and 3 can communicate with each other but not with nodes 4 and 5. Nodes 1, 2, and 3 constitute a majority, and they continue running as a cluster. Nodes 4 and 5, being a minority, stop running as a cluster. If node 3 loses communication with other nodes, all nodes stop running as a cluster. However, all functioning nodes will continue to listen for communication, so that when the network begins working again, the cluster can form and begin to run. Below diagram demonstrates Quorum selection on a cluster partitioned into two sets. Cluster Quorum example","title":"Key Concepts"},{"location":"level101/databases_nosql/key_concepts/#key-concepts","text":"Lets looks at some of the key concepts when we talk about NoSQL or distributed systems","title":"Key Concepts"},{"location":"level101/databases_nosql/key_concepts/#cap-theorem","text":"In a keynote titled \u201c Towards Robust Distributed Systems \u201d at ACM\u2019s PODC symposium in 2000 Eric Brewer came up with the so-called CAP-theorem which is widely adopted today by large web companies as well as in the NoSQL community. The CAP acronym stands for C onsistency, A vailability & P artition Tolerance. Consistency It refers to how consistent a system is after an execution. A distributed system is called consistent when a write made by a source is available for all readers of that shared data. Different NoSQL systems support different levels of consistency. Availability It refers to how a system responds to loss of functionality of different systems due to hardware and software failures. A high availability implies that a system is still available to handle operations (reads and writes) when a certain part of the system is down due to a failure or upgrade. Partition Tolerance It is the ability of the system to continue operations in the event of a network partition. A network partition occurs when a failure causes two or more islands of networks where the systems can\u2019t talk to each other across the islands temporarily or permanently. Brewer alleges that one can at most choose two of these three characteristics in a shared-data system. The CAP-theorem states that a choice can only be made for two options out of consistency, availability and partition tolerance. A growing number of use cases in large scale applications tend to value reliability implying that availability & redundancy are more valuable than consistency. As a result these systems struggle to meet ACID properties. They attain this by loosening on the consistency requirement i.e Eventual Consistency. Eventual Consistency means that all readers will see writes, as time goes on: \u201cIn a steady state, the system will eventually return the last written value\u201d. Clients therefore may face an inconsistent state of data as updates are in progress. For instance, in a replicated database updates may go to one node which replicates the latest version to all other nodes that contain a replica of the modified dataset so that the replica nodes eventually will have the latest version. NoSQL systems support different levels of eventual consistency models. For example: Read Your Own Writes Consistency Clients will see their updates immediately after they are written. The reads can hit nodes other than the one where it was written. However they might not see updates by other clients immediately. Session Consistency Clients will see the updates to their data within a session scope. This generally indicates that reads & writes occur on the same server. Other clients using the same nodes will receive the same updates. Casual Consistency A system provides causal consistency if the following condition holds: write operations that are related by potential causality are seen by each process of the system in order. Different processes may observe concurrent writes in different orders Eventual consistency is useful if concurrent updates of the same partitions of data are unlikely and if clients do not immediately depend on reading updates issued by themselves or by other clients. Depending on what consistency model was chosen for the system (or parts of it), determines where the requests are routed, ex: replicas. CAP alternatives illustration Choice Traits Examples Consistency + Availability (Forfeit Partitions) 2-phase commits Cache invalidation protocols Single-site databases Cluster databases LDAP xFS file system Consistency + Partition tolerance (Forfeit Availability) Pessimistic locking Make minority partitions unavailable Distributed databases Distributed locking Majority protocols Availability + Partition tolerance (Forfeit Consistency) expirations/leases conflict resolution optimistic DNS Web caching","title":"CAP Theorem"},{"location":"level101/databases_nosql/key_concepts/#versioning-of-data-in-distributed-systems","text":"When data is distributed across nodes, it can be modified on different nodes at the same time (assuming strict consistency is enforced). Questions arise on conflict resolution for concurrent updates. Some of the popular conflict resolution mechanism are Timestamps This is the most obvious solution. You sort updates based on chronological order and choose the latest update. However this relies on clock synchronization across different parts of the infrastructure. This gets even more complicated when parts of systems are spread across different geographic locations. Optimistic Locking You associate a unique value like a clock or counter with every data update. When a client wants to update data, it has to specify which version of data needs to be updated. This would mean you need to keep track of history of the data versions. Vector Clocks A vector clock is defined as a tuple of clock values from each node. In a distributed environment, each node maintains a tuple of such clock values which represent the state of the nodes itself and its peers/replicas. A clock value may be real timestamps derived from local clock or version no. Vector clocks illustration Vector clocks have the following advantages over other conflict resolution mechanism No dependency on synchronized clocks No total ordering of revision nos required for casual reasoning No need to store and maintain multiple versions of the data on different nodes.","title":"Versioning of Data in distributed systems"},{"location":"level101/databases_nosql/key_concepts/#partitioning","text":"When the amount of data crosses the capacity of a single node, we need to think of splitting data, creating replicas for load balancing & disaster recovery. Depending on how dynamic the infrastructure is, we have a few approaches that we can take. Memory cached These are partitioned in-memory databases that are primarily used for transient data. These databases are generally used as a front for traditional RDBMS. Most frequently used data is replicated from a rdbms into a memory database to facilitate fast queries and to take the load off from backend DB\u2019s. A very common example is memcached or couchbase. Clustering Traditional cluster mechanisms abstract away the cluster topology from clients. A client need not know where the actual data is residing and which node it is talking to. Clustering is very commonly used in traditional RDBMS where it can help scaling the persistent layer to a certain extent. Separating reads from writes In this method, you will have multiple replicas hosting the same data. The incoming writes are typically sent to a single node (Leader) or multiple nodes (multi-Leader), while the rest of the replicas (Follower) handle reads requests. The leader replicates writes asynchronously to all followers. However the write lag can\u2019t be completely avoided. Sometimes a leader can crash before it replicates all the data to a follower. When this happens, a follower with the most consistent data can be turned into a leader. As you can realize now, it is hard to enforce full consistency in this model. You also need to consider the ratio of read vs write traffic. This model won\u2019t make sense when writes are higher than reads. The replication methods can also vary widely. Some systems do a complete transfer of state periodically, while others use a delta state transfer approach. You could also transfer the state by transferring the operations in order. The followers can then apply the same operations as the leader to catch up. Sharding Sharing refers to dividing data in such a way that data is distributed evenly (both in terms of storage & processing power) across a cluster of nodes. It can also imply data locality, which means similar & related data is stored together to facilitate faster access. A shard in turn can be further replicated to meet load balancing or disaster recovery requirements. A single shard replica might take in all writes (single leader) or multiple replicas can take writes (multi-leader). Reads can be distributed across multiple replicas. Since data is now distributed across multiple nodes, clients should be able to consistently figure out where data is hosted. We will look at some of the common techniques below. The downside of sharding is that joins between shards is not possible. So an upstream/downstream application has to aggregate the results from multiple shards. Sharding example","title":"Partitioning"},{"location":"level101/databases_nosql/key_concepts/#hashing","text":"A hash function is a function that maps one piece of data\u2014typically describing some kind of object, often of arbitrary size\u2014to another piece of data, typically an integer, known as hash code , or simply hash . In a partitioned database, it is important to consistently map a key to a server/replica. For ex: you can use a very simple hash as a modulo function. _p = k mod n_ Where p -> partition, k -> primary key n -> no of nodes The downside of this simple hash is that, whenever the cluster topology changes, the data distribution also changes. When you are dealing with memory caches, it will be easy to distribute partitions around. Whenever a node joins/leaves a topology, partitions can reorder themselves, a cache miss can be re-populated from backend DB. However when you look at persistent data, it is not possible as the new node doesn\u2019t have the data needed to serve it. This brings us to consistent hashing.","title":"Hashing"},{"location":"level101/databases_nosql/key_concepts/#consistent-hashing","text":"Consistent hashing is a distributed hashing scheme that operates independently of the number of servers or objects in a distributed hash table by assigning them a position on an abstract circle, or hash ring . This allows servers and objects to scale without affecting the overall system. Say that our hash function h() generates a 32-bit integer. Then, to determine to which server we will send a key k, we find the server s whose hash h(s) is the smallest integer that is larger than h(k). To make the process simpler, we assume the table is circular, which means that if we cannot find a server with a hash larger than h(k), we wrap around and start looking from the beginning of the array. Consistent hashing illustration In consistent hashing when a server is removed or added then only the keys from that server are relocated. For example, if server S3 is removed then, all keys from server S3 will be moved to server S4 but keys stored on server S4 and S2 are not relocated. But there is one problem, when server S3 is removed then keys from S3 are not equally distributed among remaining servers S4 and S2. They are only assigned to server S4 which increases the load on server S4. To evenly distribute the load among servers when a server is added or removed, it creates a fixed number of replicas ( known as virtual nodes) of each server and distributes it along the circle. So instead of server labels S1, S2 and S3, we will have S10 S11\u2026S19, S20 S21\u2026S29 and S30 S31\u2026S39. The factor for a number of replicas is also known as weight , depending on the situation. All keys which are mapped to replicas Sij are stored on server Si. To find a key we do the same thing, find the position of the key on the circle and then move forward until you find a server replica. If the server replica is Sij then the key is stored in server Si. Suppose server S3 is removed, then all S3 replicas with labels S30 S31 \u2026 S39 must be removed. Now the objects keys adjacent to S3X labels will be automatically re-assigned to S1X, S2X and S4X. All keys originally assigned to S1, S2 & S4 will not be moved. Similar things happen if we add a server. Suppose we want to add a server S5 as a replacement of S3 then we need to add labels S50 S51 \u2026 S59. In the ideal case, one-fourth of keys from S1, S2 and S4 will be reassigned to S5. When applied to persistent storages, further issues arise: if a node has left the scene, data stored on this node becomes unavailable, unless it has been replicated to other nodes before; in the opposite case of a new node joining the others, adjacent nodes are no longer responsible for some pieces of data which they still store but not get asked for anymore as the corresponding objects are no longer hashed to them by requesting clients. In order to address this issue, a replication factor (r) can be introduced. Introducing replicas in a partitioning scheme\u2014besides reliability benefits\u2014also makes it possible to spread workload for read requests that can go to any physical node responsible for a requested piece of data. Scalability doesn\u2019t work if the clients have to decide between multiple versions of the dataset, because they need to read from a quorum of servers which in turn reduces the efficiency of load balancing.","title":"Consistent Hashing"},{"location":"level101/databases_nosql/key_concepts/#quorum","text":"Quorum is the minimum number of nodes in a cluster that must be online and be able to communicate with each other. If any additional node failure occurs beyond this threshold, the cluster will stop running. To attain a quorum, you need a majority of the nodes. Commonly it is (N/2 + 1), where N is the total no of nodes in the system. For ex, In a 3 node cluster, you need 2 nodes for a majority, In a 5 node cluster, you need 3 nodes for a majority, In a 6 node cluster, you need 4 nodes for a majority. Quorum example Network problems can cause communication failures among cluster nodes. One set of nodes might be able to communicate together across a functioning part of a network but not be able to communicate with a different set of nodes in another part of the network. This is known as split brain in cluster or cluster partitioning. Now the partition which has quorum is allowed to continue running the application. The other partitions are removed from the cluster. Eg: In a 5 node cluster, consider what happens if nodes 1, 2, and 3 can communicate with each other but not with nodes 4 and 5. Nodes 1, 2, and 3 constitute a majority, and they continue running as a cluster. Nodes 4 and 5, being a minority, stop running as a cluster. If node 3 loses communication with other nodes, all nodes stop running as a cluster. However, all functioning nodes will continue to listen for communication, so that when the network begins working again, the cluster can form and begin to run. Below diagram demonstrates Quorum selection on a cluster partitioned into two sets. Cluster Quorum example","title":"Quorum"},{"location":"level101/databases_sql/backup_recovery/","text":"Backup and Recovery Backups are a very crucial part of any database setup. They are generally a copy of the data that can be used to reconstruct the data in case of any major or minor crisis with the database. In general terms backups can be of two types:- Physical Backup - the data directory as it is on the disk Logical Backup - the table structure and records in it Both the above kinds of backups are supported by MySQL with different tools. It is the job of the SRE to identify which should be used when. Mysqldump This utility is available with MySQL installation. It helps in getting the logical backup of the database. It outputs a set of SQL statements to reconstruct the data. It is not recommended to use mysqldump for large tables as it might take a lot of time and the file size will be huge. However, for small tables it is the best and the quickest option. mysqldump [options] > dump_output.sql There are certain options that can be used with mysqldump to get an appropriate dump of the database. To dump all the databases mysqldump -u -p --all-databases > all_dbs.sql To dump specific databases mysqldump -u -p --databases db1 db2 db3 > dbs.sql To dump a single database mysqldump -u -p --databases db1 > db1.sql OR mysqldump -u -p db1 > db1.sql The difference between the above two commands is that the latter one does not contain the CREATE DATABASE command in the backup output. To dump specific tables in a database mysqldump -u -p db1 table1 table2 > db1_tables.sql To dump only table structures and no data mysqldump -u -p --no-data db1 > db1_structure.sql To dump only table data and no CREATE statements mysqldump -u -p --no-create-info db1 > db1_data.sql To dump only specific records from a table mysqldump -u -p --no-create-info db1 table1 --where=\u201dsalary>80000\u201d > db1_table1_80000.sql Mysqldump can also provide output in CSV, other delimited text or XML format to support use-cases if any. The backup from mysqldump utility is offline i.e. when the backup finishes it will not have the changes to the database which were made when the backup was going on. For example, if the backup started at 3 PM and finished at 4 PM, it will not have the changes made to the database between 3 and 4 PM. Restoring from mysqldump can be done in the following two ways:- From shell mysql -u -p < all_dbs.sql OR From shell if the database is already created mysql -u -p db1 < db1.sql From within MySQL shell mysql> source all_dbs.sql Percona Xtrabackup This utility is installed separately from the MySQL server and is open source, provided by Percona. It helps in getting the full or partial physical backup of the database. It provides online backup of the database i.e. it will have the changes made to the database when the backup was going on as explained at the end of the previous section. Full Backup - the complete backup of the database. Partial Backup - Incremental Cumulative - After one full backup, the next backups will have changes post the full backup. For example, we took a full backup on Sunday, from Monday onwards every backup will have changes after Sunday; so, Tuesday\u2019s backup will have Monday\u2019s changes as well, Wednesday\u2019s backup will have changes of Monday and Tuesday as well and so on. Differential - After one full backup, the next backups will have changes post the previous incremental backup. For example, we took a full backup on Sunday, Monday will have changes done after Sunday, Tuesday will have changes done after Monday, and so on. Percona xtrabackup allows us to get both full and incremental backups as we desire. However, incremental backups take less space than a full backup (if taken per day) but the restore time of incremental backups is more than that of full backups. Creating a full backup xtrabackup --defaults-file= --user= --password= --backup --target-dir= Example xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/ Some other options --stream - can be used to stream the backup files to standard output in a specified format. xbstream is the only option for now. --tmp-dir - set this to a tmp directory to be used for temporary files while taking backups. --parallel - set this to the number of threads that can be used to parallely copy data files to target directory. --compress - by default - quicklz is used. Set this to have the backup in compressed format. Each file is a .qp compressed file and can be extracted by qpress file archiver. --decompress - decompresses all the files which were compressed with the .qp extension. It will not delete the .qp files after decompression. To do that, use --remove-original along with this. Please note that the decompress option should be run separately from the xtrabackup command that used the compress option. Preparing a backup Once the backup is done with the --backup option, we need to prepare it in order to restore it. This is done to make the datafiles consistent with point-in-time. There might have been some transactions going on while the backup was being executed and those have changed the data files. When we prepare a backup, all those transactions are applied to the data files. xtrabackup --prepare --target-dir= Example xtrabackup --prepare --target-dir=/mnt/data/backup/ It is not recommended to halt a process which is preparing the backup as that might cause data file corruption and backup cannot be used further. The backup will have to be taken again. Restoring a Full Backup To restore the backup which is created and prepared from above commands, just copy everything from the backup target-dir to the data-dir of MySQL server, change the ownership of all files to mysql user (the linux user used by MySQL server) and start mysql. Or the below command can be used as well, xtrabackup --defaults-file=/etc/my.cnf --copy-back --target-dir=/mnt/data/backups/ Note - the backup has to be prepared in order to restore it. Creating Incremental backups Percona Xtrabackup helps create incremental backups, i.e only the changes can be backed up since the last backup. Every InnoDB page contains a log sequence number or LSN that is also mentioned as one of the last lines of backup and prepare commands. xtrabackup: Transaction log of lsn to was copied. OR InnoDB: Shutdown completed; log sequence number completed OK! This indicates that the backup has been taken till the log sequence number mentioned. This is a key information in understanding incremental backups and working towards automating one. Incremental backups do not compare data files for changes, instead, they go through the InnoDB pages and compare their LSN to the last backup\u2019s LSN. So, without one full backup, the incremental backups are useless. The xtrabackup command creates a xtrabackup_checkpoint file which has the information about the LSN of the backup. Below are the key contents of the file:- backup_type = full-backuped | incremental from_lsn = 0 (full backup) | to_lsn of last backup to_lsn = last_lsn = There is a difference between to_lsn and last_lsn . When the last_lsn is more than to_lsn that means there are transactions that ran while we took the backup and are yet to be applied. That is what --prepare is used for. To take incremental backups, first, we require one full backup. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/full/ Let\u2019s assume the contents of the xtrabackup_checkpoint file to be as follows. backup_type = full-backuped from_lsn = 0 to_lsn = 1000 last_lsn = 1000 Now that we have one full backup, we can have an incremental backup that takes the changes. We will go with differential incremental backups. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/incr1/ --incremental-basedir=/mnt/data/backup/full/ There are delta files created in the incr1 directory like, ibdata1.delta , db1/tbl1.ibd.delta with the changes from the full directory. The xtrabackup_checkpoint file will thus have the following contents. backup_type = incremental from_lsn = 1000 to_lsn = 1500 last_lsn = 1500 Hence, the from_lsn here is equal to the to_lsn of the last backup or the basedir provided for the incremental backups. For the next incremental backup we can use this incremental backup as the basedir. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/incr2/ --incremental-basedir=/mnt/data/backup/incr1/ The xtrabackup_checkpoint file will thus have the following contents. backup_type = incremental from_lsn = 1500 to_lsn = 2000 last_lsn = 2200 Preparing Incremental backups Preparing incremental backups is not the same as preparing a full backup. When prepare runs, two operations are performed - committed transactions are applied on the data files and uncommitted transactions are rolled back . While preparing incremental backups, we have to skip rollback of uncommitted transactions as it is likely that they might get committed in the next incremental backup. If we rollback uncommitted transactions the further incremental backups cannot be applied. We use --apply-log-only option along with --prepare to avoid the rollback phase. From the last section, we had the following directories with complete backup /mnt/data/backup/full /mnt/data/backup/incr1 /mnt/data/backup/incr2 First, we prepare the full backup, but only with the --apply-log-only option. xtrabackup --prepare --apply-log-only --target-dir=/mnt/data/backup/full The output of the command will contain the following at the end. InnoDB: Shutdown complete; log sequence number 1000 Completed OK! Note the LSN mentioned at the end is the same as the to_lsn from the xtrabackup_checkpoint created for full backup. Next, we apply the changes from the first incremental backup to the full backup. xtrabackup --prepare --apply-log-only --target-dir=/mnt/data/backup/full --incremental-dir=/mnt/data/backup/incr1 This applies the delta files in the incremental directory to the full backup directory. It rolls the data files in the full backup directory forward to the time of incremental backup and applies the redo logs as usual. Lastly, we apply the last incremental backup same as the previous one with just a small change. xtrabackup --prepare --target-dir=/mnt/data/backup/full --incremental-dir=/mnt/data/backup/incr1 We do not have to use the --apply-log-only option with it. It applies the incr2 delta files to the full backup data files taking them forward, applies redo logs on them and finally rollbacks the uncommitted transactions to produce the final result. The data now present in the full backup directory can now be used to restore. Note - To create cumulative incremental backups, the incremental-basedir should always be the full backup directory for every incremental backup. While preparing, we can start with the full backup with the --apply-log-only option and use just the last incremental backup for the final --prepare as that has all the changes since the full backup. Restoring Incremental backups Once all the above steps are completed, restoring is the same as done for a full backup. Further Reading MySQL Point-In-Time-Recovery Another MySQL backup tool - mysqlpump Another MySQL backup tool - mydumper A comparison between mysqldump, mysqlpump and mydumper Backup Best Practices","title":"Backup and Recovery"},{"location":"level101/databases_sql/backup_recovery/#backup-and-recovery","text":"Backups are a very crucial part of any database setup. They are generally a copy of the data that can be used to reconstruct the data in case of any major or minor crisis with the database. In general terms backups can be of two types:- Physical Backup - the data directory as it is on the disk Logical Backup - the table structure and records in it Both the above kinds of backups are supported by MySQL with different tools. It is the job of the SRE to identify which should be used when.","title":"Backup and Recovery"},{"location":"level101/databases_sql/backup_recovery/#mysqldump","text":"This utility is available with MySQL installation. It helps in getting the logical backup of the database. It outputs a set of SQL statements to reconstruct the data. It is not recommended to use mysqldump for large tables as it might take a lot of time and the file size will be huge. However, for small tables it is the best and the quickest option. mysqldump [options] > dump_output.sql There are certain options that can be used with mysqldump to get an appropriate dump of the database. To dump all the databases mysqldump -u -p --all-databases > all_dbs.sql To dump specific databases mysqldump -u -p --databases db1 db2 db3 > dbs.sql To dump a single database mysqldump -u -p --databases db1 > db1.sql OR mysqldump -u -p db1 > db1.sql The difference between the above two commands is that the latter one does not contain the CREATE DATABASE command in the backup output. To dump specific tables in a database mysqldump -u -p db1 table1 table2 > db1_tables.sql To dump only table structures and no data mysqldump -u -p --no-data db1 > db1_structure.sql To dump only table data and no CREATE statements mysqldump -u -p --no-create-info db1 > db1_data.sql To dump only specific records from a table mysqldump -u -p --no-create-info db1 table1 --where=\u201dsalary>80000\u201d > db1_table1_80000.sql Mysqldump can also provide output in CSV, other delimited text or XML format to support use-cases if any. The backup from mysqldump utility is offline i.e. when the backup finishes it will not have the changes to the database which were made when the backup was going on. For example, if the backup started at 3 PM and finished at 4 PM, it will not have the changes made to the database between 3 and 4 PM. Restoring from mysqldump can be done in the following two ways:- From shell mysql -u -p < all_dbs.sql OR From shell if the database is already created mysql -u -p db1 < db1.sql From within MySQL shell mysql> source all_dbs.sql","title":"Mysqldump"},{"location":"level101/databases_sql/backup_recovery/#percona-xtrabackup","text":"This utility is installed separately from the MySQL server and is open source, provided by Percona. It helps in getting the full or partial physical backup of the database. It provides online backup of the database i.e. it will have the changes made to the database when the backup was going on as explained at the end of the previous section. Full Backup - the complete backup of the database. Partial Backup - Incremental Cumulative - After one full backup, the next backups will have changes post the full backup. For example, we took a full backup on Sunday, from Monday onwards every backup will have changes after Sunday; so, Tuesday\u2019s backup will have Monday\u2019s changes as well, Wednesday\u2019s backup will have changes of Monday and Tuesday as well and so on. Differential - After one full backup, the next backups will have changes post the previous incremental backup. For example, we took a full backup on Sunday, Monday will have changes done after Sunday, Tuesday will have changes done after Monday, and so on. Percona xtrabackup allows us to get both full and incremental backups as we desire. However, incremental backups take less space than a full backup (if taken per day) but the restore time of incremental backups is more than that of full backups. Creating a full backup xtrabackup --defaults-file= --user= --password= --backup --target-dir= Example xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/ Some other options --stream - can be used to stream the backup files to standard output in a specified format. xbstream is the only option for now. --tmp-dir - set this to a tmp directory to be used for temporary files while taking backups. --parallel - set this to the number of threads that can be used to parallely copy data files to target directory. --compress - by default - quicklz is used. Set this to have the backup in compressed format. Each file is a .qp compressed file and can be extracted by qpress file archiver. --decompress - decompresses all the files which were compressed with the .qp extension. It will not delete the .qp files after decompression. To do that, use --remove-original along with this. Please note that the decompress option should be run separately from the xtrabackup command that used the compress option. Preparing a backup Once the backup is done with the --backup option, we need to prepare it in order to restore it. This is done to make the datafiles consistent with point-in-time. There might have been some transactions going on while the backup was being executed and those have changed the data files. When we prepare a backup, all those transactions are applied to the data files. xtrabackup --prepare --target-dir= Example xtrabackup --prepare --target-dir=/mnt/data/backup/ It is not recommended to halt a process which is preparing the backup as that might cause data file corruption and backup cannot be used further. The backup will have to be taken again. Restoring a Full Backup To restore the backup which is created and prepared from above commands, just copy everything from the backup target-dir to the data-dir of MySQL server, change the ownership of all files to mysql user (the linux user used by MySQL server) and start mysql. Or the below command can be used as well, xtrabackup --defaults-file=/etc/my.cnf --copy-back --target-dir=/mnt/data/backups/ Note - the backup has to be prepared in order to restore it. Creating Incremental backups Percona Xtrabackup helps create incremental backups, i.e only the changes can be backed up since the last backup. Every InnoDB page contains a log sequence number or LSN that is also mentioned as one of the last lines of backup and prepare commands. xtrabackup: Transaction log of lsn to was copied. OR InnoDB: Shutdown completed; log sequence number completed OK! This indicates that the backup has been taken till the log sequence number mentioned. This is a key information in understanding incremental backups and working towards automating one. Incremental backups do not compare data files for changes, instead, they go through the InnoDB pages and compare their LSN to the last backup\u2019s LSN. So, without one full backup, the incremental backups are useless. The xtrabackup command creates a xtrabackup_checkpoint file which has the information about the LSN of the backup. Below are the key contents of the file:- backup_type = full-backuped | incremental from_lsn = 0 (full backup) | to_lsn of last backup to_lsn = last_lsn = There is a difference between to_lsn and last_lsn . When the last_lsn is more than to_lsn that means there are transactions that ran while we took the backup and are yet to be applied. That is what --prepare is used for. To take incremental backups, first, we require one full backup. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/full/ Let\u2019s assume the contents of the xtrabackup_checkpoint file to be as follows. backup_type = full-backuped from_lsn = 0 to_lsn = 1000 last_lsn = 1000 Now that we have one full backup, we can have an incremental backup that takes the changes. We will go with differential incremental backups. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/incr1/ --incremental-basedir=/mnt/data/backup/full/ There are delta files created in the incr1 directory like, ibdata1.delta , db1/tbl1.ibd.delta with the changes from the full directory. The xtrabackup_checkpoint file will thus have the following contents. backup_type = incremental from_lsn = 1000 to_lsn = 1500 last_lsn = 1500 Hence, the from_lsn here is equal to the to_lsn of the last backup or the basedir provided for the incremental backups. For the next incremental backup we can use this incremental backup as the basedir. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/incr2/ --incremental-basedir=/mnt/data/backup/incr1/ The xtrabackup_checkpoint file will thus have the following contents. backup_type = incremental from_lsn = 1500 to_lsn = 2000 last_lsn = 2200 Preparing Incremental backups Preparing incremental backups is not the same as preparing a full backup. When prepare runs, two operations are performed - committed transactions are applied on the data files and uncommitted transactions are rolled back . While preparing incremental backups, we have to skip rollback of uncommitted transactions as it is likely that they might get committed in the next incremental backup. If we rollback uncommitted transactions the further incremental backups cannot be applied. We use --apply-log-only option along with --prepare to avoid the rollback phase. From the last section, we had the following directories with complete backup /mnt/data/backup/full /mnt/data/backup/incr1 /mnt/data/backup/incr2 First, we prepare the full backup, but only with the --apply-log-only option. xtrabackup --prepare --apply-log-only --target-dir=/mnt/data/backup/full The output of the command will contain the following at the end. InnoDB: Shutdown complete; log sequence number 1000 Completed OK! Note the LSN mentioned at the end is the same as the to_lsn from the xtrabackup_checkpoint created for full backup. Next, we apply the changes from the first incremental backup to the full backup. xtrabackup --prepare --apply-log-only --target-dir=/mnt/data/backup/full --incremental-dir=/mnt/data/backup/incr1 This applies the delta files in the incremental directory to the full backup directory. It rolls the data files in the full backup directory forward to the time of incremental backup and applies the redo logs as usual. Lastly, we apply the last incremental backup same as the previous one with just a small change. xtrabackup --prepare --target-dir=/mnt/data/backup/full --incremental-dir=/mnt/data/backup/incr1 We do not have to use the --apply-log-only option with it. It applies the incr2 delta files to the full backup data files taking them forward, applies redo logs on them and finally rollbacks the uncommitted transactions to produce the final result. The data now present in the full backup directory can now be used to restore. Note - To create cumulative incremental backups, the incremental-basedir should always be the full backup directory for every incremental backup. While preparing, we can start with the full backup with the --apply-log-only option and use just the last incremental backup for the final --prepare as that has all the changes since the full backup. Restoring Incremental backups Once all the above steps are completed, restoring is the same as done for a full backup.","title":"Percona Xtrabackup"},{"location":"level101/databases_sql/backup_recovery/#further-reading","text":"MySQL Point-In-Time-Recovery Another MySQL backup tool - mysqlpump Another MySQL backup tool - mydumper A comparison between mysqldump, mysqlpump and mydumper Backup Best Practices","title":"Further Reading"},{"location":"level101/databases_sql/concepts/","text":"Relational DBs are used for data storage. Even a file can be used to store data, but relational DBs are designed with specific goals: Efficiency Ease of access and management Organized Handle relations between data (represented as tables) Transaction: a unit of work that can comprise multiple statements, executed together ACID properties Set of properties that guarantee data integrity of DB transactions Atomicity: Each transaction is atomic (succeeds or fails completely) Consistency: Transactions only result in valid state (which includes rules, constraints, triggers etc.) Isolation: Each transaction is executed independently of others safely within a concurrent system Durability: Completed transactions will not be lost due to any later failures Let\u2019s take some examples to illustrate the above properties. Account A has a balance of \u20b9200 & B has \u20b9400. Account A is transferring \u20b9100 to Account B. This transaction has a deduction from sender and an addition into the recipient\u2019s balance. If the first operation passes successfully while the second fails, A\u2019s balance would be \u20b9100 while B would be having \u20b9400 instead of \u20b9500. Atomicity in a DB ensures this partially failed transaction is rolled back. If the second operation above fails, it leaves the DB inconsistent (sum of balance of accounts before and after the operation is not the same). Consistency ensures that this does not happen. There are three operations, one to calculate interest for A\u2019s account, another to add that to A\u2019s account, then transfer \u20b9100 from B to A. Without isolation guarantees, concurrent execution of these 3 operations may lead to a different outcome every time. What happens if the system crashes before the transactions are written to disk? Durability ensures that the changes are applied correctly during recovery. Relational data Tables represent relations Columns (fields) represent attributes Rows are individual records Schema describes the structure of DB SQL A query language to interact with and manage data. CRUD operations - create, read, update, delete queries Management operations - create DBs/tables/indexes etc, backup, import/export, users, access controls Exercise: Classify the below queries into the four types - DDL (definition), DML(manipulation), DCL(control) and TCL(transactions) and explain in detail. insert, create, drop, delete, update, commit, rollback, truncate, alter, grant, revoke You can practise these in the lab section . Constraints Rules for data that can be stored. Query fails if you violate any of these defined on a table. Primary key: one or more columns that contain UNIQUE values, and cannot contain NULL values. A table can have only ONE primary key. An index on it is created by default. Foreign key: links two tables together. Its value(s) match a primary key in a different table \\ Not null: Does not allow null values \\ Unique: Value of column must be unique across all rows \\ Default: Provides a default value for a column if none is specified during insert Check: Allows only particular values (like Balance >= 0) Indexes Most indexes use B+ tree structure. Why use them: Speeds up queries (in large tables that fetch only a few rows, min/max queries, by eliminating rows from consideration etc) Types of indexes: unique, primary key, fulltext, secondary Write-heavy loads, mostly full table scans or accessing large number of rows etc. do not benefit from indexes Joins Allows you to fetch related data from multiple tables, linking them together with some common field. Powerful but also resource-intensive and makes scaling databases difficult. This is the cause of many slow performing queries when run at scale, and the solution is almost always to find ways to reduce the joins. Access control DBs have privileged accounts for admin tasks, and regular accounts for clients. There are finegrained controls on what actions(DDL, DML etc. discussed earlier )are allowed for these accounts. DB first verifies the user credentials (authentication), and then examines whether this user is permitted to perform the request (authorization) by looking up these information in some internal tables. Other controls include activity auditing that allows examining the history of actions done by a user, and resource limits which define the number of queries, connections etc. allowed. Popular databases Commercial, closed source - Oracle, Microsoft SQL Server, IBM DB2 Open source with optional paid support - MySQL, MariaDB, PostgreSQL Individuals and small companies have always preferred open source DBs because of the huge cost associated with commercial software. In recent times, even large organizations have moved away from commercial software to open source alternatives because of the flexibility and cost savings associated with it. Lack of support is no longer a concern because of the paid support available from the developer and third parties. MySQL is the most widely used open source DB, and it is widely supported by hosting providers, making it easy for anyone to use. It is part of the popular Linux-Apache-MySQL-PHP ( LAMP ) stack that became popular in the 2000s. We have many more choices for a programming language, but the rest of that stack is still widely used.","title":"Key Concepts"},{"location":"level101/databases_sql/concepts/#popular-databases","text":"Commercial, closed source - Oracle, Microsoft SQL Server, IBM DB2 Open source with optional paid support - MySQL, MariaDB, PostgreSQL Individuals and small companies have always preferred open source DBs because of the huge cost associated with commercial software. In recent times, even large organizations have moved away from commercial software to open source alternatives because of the flexibility and cost savings associated with it. Lack of support is no longer a concern because of the paid support available from the developer and third parties. MySQL is the most widely used open source DB, and it is widely supported by hosting providers, making it easy for anyone to use. It is part of the popular Linux-Apache-MySQL-PHP ( LAMP ) stack that became popular in the 2000s. We have many more choices for a programming language, but the rest of that stack is still widely used.","title":"Popular databases"},{"location":"level101/databases_sql/conclusion/","text":"Conclusion We have covered basic concepts of SQL databases. We have also covered some of the tasks that an SRE may be responsible for - there is so much more to learn and do. We hope this course gives you a good start and inspires you to explore further. Further reading More practice with online resources like this one Normalization Routines , triggers Views Transaction isolation levels Sharding Setting up HA , monitoring , backups","title":"Conclusion"},{"location":"level101/databases_sql/conclusion/#conclusion","text":"We have covered basic concepts of SQL databases. We have also covered some of the tasks that an SRE may be responsible for - there is so much more to learn and do. We hope this course gives you a good start and inspires you to explore further.","title":"Conclusion"},{"location":"level101/databases_sql/conclusion/#further-reading","text":"More practice with online resources like this one Normalization Routines , triggers Views Transaction isolation levels Sharding Setting up HA , monitoring , backups","title":"Further reading"},{"location":"level101/databases_sql/innodb/","text":"Why should you use this? General purpose, row level locking, ACID support, transactions, crash recovery and multi-version concurrency control etc. Architecture Key components: Memory: Buffer pool: LRU cache of frequently used data(table and index) to be processed directly from memory, which speeds up processing. Important for tuning performance. Change buffer: Caches changes to secondary index pages when those pages are not in the buffer pool and merges it when they are fetched. Merging may take a long time and impact live queries. It also takes up part of the buffer pool. Avoids the extra I/O to read secondary indexes in. Adaptive hash index: Supplements InnoDB\u2019s B-Tree indexes with fast hash lookup tables like a cache. Slight performance penalty for misses, also adds maintenance overhead of updating it. Hash collisions cause AHI rebuilding for large DBs. Log buffer: Holds log data before flush to disk. Size of each above memory is configurable, and impacts performance a lot. Requires careful analysis of workload, available resources, benchmarking and tuning for optimal performance. Disk: Tables: Stores data within rows and columns. Indexes: Helps find rows with specific column values quickly, avoids full table scans. Redo Logs: all transactions are written to them, and after a crash, the recovery process corrects data written by incomplete transactions and replays any pending ones. Undo Logs: Records associated with a single transaction that contains information about how to undo the latest change by a transaction.","title":"InnoDB"},{"location":"level101/databases_sql/innodb/#why-should-you-use-this","text":"General purpose, row level locking, ACID support, transactions, crash recovery and multi-version concurrency control etc.","title":"Why should you use this?"},{"location":"level101/databases_sql/innodb/#architecture","text":"","title":"Architecture"},{"location":"level101/databases_sql/innodb/#key-components","text":"Memory: Buffer pool: LRU cache of frequently used data(table and index) to be processed directly from memory, which speeds up processing. Important for tuning performance. Change buffer: Caches changes to secondary index pages when those pages are not in the buffer pool and merges it when they are fetched. Merging may take a long time and impact live queries. It also takes up part of the buffer pool. Avoids the extra I/O to read secondary indexes in. Adaptive hash index: Supplements InnoDB\u2019s B-Tree indexes with fast hash lookup tables like a cache. Slight performance penalty for misses, also adds maintenance overhead of updating it. Hash collisions cause AHI rebuilding for large DBs. Log buffer: Holds log data before flush to disk. Size of each above memory is configurable, and impacts performance a lot. Requires careful analysis of workload, available resources, benchmarking and tuning for optimal performance. Disk: Tables: Stores data within rows and columns. Indexes: Helps find rows with specific column values quickly, avoids full table scans. Redo Logs: all transactions are written to them, and after a crash, the recovery process corrects data written by incomplete transactions and replays any pending ones. Undo Logs: Records associated with a single transaction that contains information about how to undo the latest change by a transaction.","title":"Key components:"},{"location":"level101/databases_sql/intro/","text":"Relational Databases Prerequisites Complete Linux course Install Docker (for lab section) What to expect from this course You will have an understanding of what relational databases are, their advantages, and some MySQL specific concepts. What is not covered under this course In depth implementation details Advanced topics like normalization, sharding Specific tools for administration Introduction The main purpose of database systems is to manage data. This includes storage, adding new data, deleting unused data, updating existing data, retrieving data within a reasonable response time, other maintenance tasks to keep the system running etc. Pre-reads RDBMS Concepts Course Contents Key Concepts MySQL Architecture InnoDB Backup and Recovery MySQL Replication Operational Concepts SELECT Query Query Performance Lab Further Reading","title":"Introduction"},{"location":"level101/databases_sql/intro/#relational-databases","text":"","title":"Relational Databases"},{"location":"level101/databases_sql/intro/#prerequisites","text":"Complete Linux course Install Docker (for lab section)","title":"Prerequisites"},{"location":"level101/databases_sql/intro/#what-to-expect-from-this-course","text":"You will have an understanding of what relational databases are, their advantages, and some MySQL specific concepts.","title":"What to expect from this course"},{"location":"level101/databases_sql/intro/#what-is-not-covered-under-this-course","text":"In depth implementation details Advanced topics like normalization, sharding Specific tools for administration","title":"What is not covered under this course"},{"location":"level101/databases_sql/intro/#introduction","text":"The main purpose of database systems is to manage data. This includes storage, adding new data, deleting unused data, updating existing data, retrieving data within a reasonable response time, other maintenance tasks to keep the system running etc.","title":"Introduction"},{"location":"level101/databases_sql/intro/#pre-reads","text":"RDBMS Concepts","title":"Pre-reads"},{"location":"level101/databases_sql/intro/#course-contents","text":"Key Concepts MySQL Architecture InnoDB Backup and Recovery MySQL Replication Operational Concepts SELECT Query Query Performance Lab Further Reading","title":"Course Contents"},{"location":"level101/databases_sql/lab/","text":"Prerequisites Install Docker Setup Create a working directory named sos or something similar, and cd into it. Enter the following into a file named my.cnf under a directory named custom. sos $ cat custom/my.cnf [mysqld] # These settings apply to MySQL server # You can set port, socket path, buffer size etc. # Below, we are configuring slow query settings slow_query_log=1 slow_query_log_file=/var/log/mysqlslow.log long_query_time=1 Start a container and enable slow query log with the following: sos $ docker run --name db -v custom:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=realsecret -d mysql:8 sos $ docker cp custom/my.cnf $(docker ps -qf \"name=db\"):/etc/mysql/conf.d/custom.cnf sos $ docker restart $(docker ps -qf \"name=db\") Import a sample database sos $ git clone git@github.com:datacharmer/test_db.git sos $ docker cp test_db $(docker ps -qf \"name=db\"):/home/test_db/ sos $ docker exec -it $(docker ps -qf \"name=db\") bash root@3ab5b18b0c7d:/# cd /home/test_db/ root@3ab5b18b0c7d:/# mysql -uroot -prealsecret mysql < employees.sql root@3ab5b18b0c7d:/etc# touch /var/log/mysqlslow.log root@3ab5b18b0c7d:/etc# chown mysql:mysql /var/log/mysqlslow.log Workshop 1: Run some sample queries Run the following $ mysql -uroot -prealsecret mysql mysql> # inspect DBs and tables # the last 4 are MySQL internal DBs mysql> show databases; +--------------------+ | Database | +--------------------+ | employees | | information_schema | | mysql | | performance_schema | | sys | +--------------------+ > use employees; mysql> show tables; +----------------------+ | Tables_in_employees | +----------------------+ | current_dept_emp | | departments | | dept_emp | | dept_emp_latest_date | | dept_manager | | employees | | salaries | | titles | +----------------------+ # read a few rows mysql> select * from employees limit 5; # filter data by conditions mysql> select count(*) from employees where gender = 'M' limit 5; # find count of particular data mysql> select count(*) from employees where first_name = 'Sachin'; Workshop 2: Use explain and explain analyze to profile a query, identify and add indexes required for improving performance # View all indexes on table #(\\G is to output horizontally, replace it with a ; to get table output) mysql> show index from employees from employees\\G *************************** 1. row *************************** Table: employees Non_unique: 0 Key_name: PRIMARY Seq_in_index: 1 Column_name: emp_no Collation: A Cardinality: 299113 Sub_part: NULL Packed: NULL Null: Index_type: BTREE Comment: Index_comment: Visible: YES Expression: NULL # This query uses an index, idenitfied by 'key' field # By prefixing explain keyword to the command, # we get query plan (including key used) mysql> explain select * from employees where emp_no < 10005\\G *************************** 1. row *************************** id: 1 select_type: SIMPLE table: employees partitions: NULL type: range possible_keys: PRIMARY key: PRIMARY key_len: 4 ref: NULL rows: 4 filtered: 100.00 Extra: Using where # Compare that to the next query which does not utilize any index mysql> explain select first_name, last_name from employees where first_name = 'Sachin'\\G *************************** 1. row *************************** id: 1 select_type: SIMPLE table: employees partitions: NULL type: ALL possible_keys: NULL key: NULL key_len: NULL ref: NULL rows: 299113 filtered: 10.00 Extra: Using where # Let's see how much time this query takes mysql> explain analyze select first_name, last_name from employees where first_name = 'Sachin'\\G *************************** 1. row *************************** EXPLAIN: -> Filter: (employees.first_name = 'Sachin') (cost=30143.55 rows=29911) (actual time=28.284..3952.428 rows=232 loops=1) -> Table scan on employees (cost=30143.55 rows=299113) (actual time=0.095..1996.092 rows=300024 loops=1) # Cost(estimated by query planner) is 30143.55 # actual time=28.284ms for first row, 3952.428 for all rows # Now lets try adding an index and running the query again mysql> create index idx_firstname on employees(first_name); Query OK, 0 rows affected (1.25 sec) Records: 0 Duplicates: 0 Warnings: 0 mysql> explain analyze select first_name, last_name from employees where first_name = 'Sachin'; +--------------------------------------------------------------------------------------------------------------------------------------------+ | EXPLAIN | +--------------------------------------------------------------------------------------------------------------------------------------------+ | -> Index lookup on employees using idx_firstname (first_name='Sachin') (cost=81.20 rows=232) (actual time=0.551..2.934 rows=232 loops=1) | +--------------------------------------------------------------------------------------------------------------------------------------------+ 1 row in set (0.01 sec) # Actual time=0.551ms for first row # 2.934ms for all rows. A huge improvement! # Also notice that the query involves only an index lookup, # and no table scan (reading all rows of table) # ..which vastly reduces load on the DB. Workshop 3: Identify slow queries on a MySQL server # Run the command below in two terminal tabs to open two shells into the container. docker exec -it $(docker ps -qf \"name=db\") bash # Open a mysql prompt in one of them and execute this command # We have configured to log queries that take longer than 1s, # so this sleep(3) will be logged mysql -uroot -prealsecret mysql mysql> select sleep(3); # Now, in the other terminal, tail the slow log to find details about the query root@62c92c89234d:/etc# tail -f /var/log/mysqlslow.log /usr/sbin/mysqld, Version: 8.0.21 (MySQL Community Server - GPL). started with: Tcp port: 3306 Unix socket: /var/run/mysqld/mysqld.sock Time Id Command Argument # Time: 2020-11-26T14:53:44.822348Z # User@Host: root[root] @ localhost [] Id: 9 # Query_time: 5.404938 Lock_time: 0.000000 Rows_sent: 1 Rows_examined: 1 use employees; # Time: 2020-11-26T14:53:58.015736Z # User@Host: root[root] @ localhost [] Id: 9 # Query_time: 10.000225 Lock_time: 0.000000 Rows_sent: 1 Rows_examined: 1 SET timestamp=1606402428; select sleep(3); These were simulated examples with minimal complexity. In real life, the queries would be much more complex and the explain/analyze and slow query logs would have more details.","title":"Lab"},{"location":"level101/databases_sql/mysql/","text":"MySQL architecture MySQL architecture enables you to select the right storage engine for your needs, and abstracts away all implementation details from the end users (application engineers and DBA ) who only need to know a consistent stable API. Application layer: Connection handling - each client gets its own connection which is cached for the duration of access) Authentication - server checks (username,password,host) info of client and allows/rejects connection Security: server determines whether the client has privileges to execute each query (check with show privileges command) Server layer: Services and utilities - backup/restore, replication, cluster etc SQL interface - clients run queries for data access and manipulation SQL parser - creates a parse tree from the query (lexical/syntactic/semantic analysis and code generation) Optimizer - optimizes queries using various algorithms and data available to it(table level stats), modifies queries, order of scanning, indexes to use etc. (check with explain command) Caches and buffers - cache stores query results, buffer pool(InnoDB) stores table and index data in LRU fashion Storage engine options: InnoDB: most widely used, transaction support, ACID compliant, supports row-level locking, crash recovery and multi-version concurrency control. Default since MySQL 5.5+. MyISAM: fast, does not support transactions, provides table-level locking, great for read-heavy workloads, mostly in web and data warehousing. Default upto MySQL 5.1. Archive: optimised for high speed inserts, compresses data as it is inserted, does not support transactions, ideal for storing and retrieving large amounts of seldom referenced historical, archived data Memory: tables in memory. Fastest engine, supports table-level locking, does not support transactions, ideal for creating temporary tables or quick lookups, data is lost after a shutdown CSV: stores data in CSV files, great for integrating into other applications that use this format \u2026 etc. It is possible to migrate from one storage engine to another. But this migration locks tables for all operations and is not online, as it changes the physical layout of the data. It takes a long time and is generally not recommended. Hence, choosing the right storage engine at the beginning is important. General guideline is to use InnoDB unless you have a specific need for one of the other storage engines. Running mysql> SHOW ENGINES; shows you the supported engines on your MySQL server.","title":"MySQL"},{"location":"level101/databases_sql/mysql/#mysql-architecture","text":"MySQL architecture enables you to select the right storage engine for your needs, and abstracts away all implementation details from the end users (application engineers and DBA ) who only need to know a consistent stable API. Application layer: Connection handling - each client gets its own connection which is cached for the duration of access) Authentication - server checks (username,password,host) info of client and allows/rejects connection Security: server determines whether the client has privileges to execute each query (check with show privileges command) Server layer: Services and utilities - backup/restore, replication, cluster etc SQL interface - clients run queries for data access and manipulation SQL parser - creates a parse tree from the query (lexical/syntactic/semantic analysis and code generation) Optimizer - optimizes queries using various algorithms and data available to it(table level stats), modifies queries, order of scanning, indexes to use etc. (check with explain command) Caches and buffers - cache stores query results, buffer pool(InnoDB) stores table and index data in LRU fashion Storage engine options: InnoDB: most widely used, transaction support, ACID compliant, supports row-level locking, crash recovery and multi-version concurrency control. Default since MySQL 5.5+. MyISAM: fast, does not support transactions, provides table-level locking, great for read-heavy workloads, mostly in web and data warehousing. Default upto MySQL 5.1. Archive: optimised for high speed inserts, compresses data as it is inserted, does not support transactions, ideal for storing and retrieving large amounts of seldom referenced historical, archived data Memory: tables in memory. Fastest engine, supports table-level locking, does not support transactions, ideal for creating temporary tables or quick lookups, data is lost after a shutdown CSV: stores data in CSV files, great for integrating into other applications that use this format \u2026 etc. It is possible to migrate from one storage engine to another. But this migration locks tables for all operations and is not online, as it changes the physical layout of the data. It takes a long time and is generally not recommended. Hence, choosing the right storage engine at the beginning is important. General guideline is to use InnoDB unless you have a specific need for one of the other storage engines. Running mysql> SHOW ENGINES; shows you the supported engines on your MySQL server.","title":"MySQL architecture"},{"location":"level101/databases_sql/operations/","text":"Explain and explain+analyze EXPLAIN analyzes query plans from the optimizer, including how tables are joined, which tables/rows are scanned etc. Explain analyze shows the above and additional info like execution cost, number of rows returned, time taken etc. This knowledge is useful to tweak queries and add indexes. Watch this performance tuning tutorial video . Checkout the lab section for a hands-on about indexes. Slow query logs Used to identify slow queries (configurable threshold), enabled in config or dynamically with a query Checkout the lab section about identifying slow queries. User management This includes creation and changes to users, like managing privileges, changing password etc. Backup and restore strategies, pros and cons Logical backup using mysqldump - slower but can be done online Physical backup (copy data directory or use xtrabackup) - quick backup/recovery. Copying data directory requires locking or shut down. xtrabackup is an improvement because it supports backups without shutting down (hot backup). Others - PITR, snapshots etc. Crash recovery process using redo logs After a crash, when you restart server it reads redo logs and replays modifications to recover Monitoring MySQL Key MySQL metrics: reads, writes, query runtime, errors, slow queries, connections, running threads, InnoDB metrics Key OS metrics: CPU, load, memory, disk I/O, network Replication Copies data from one instance to one or more instances. Helps in horizontal scaling, data protection, analytics and performance. Binlog dump thread on primary, replication I/O and SQL threads on secondary. Strategies include the standard async, semi async or group replication. High Availability Ability to cope with failure at software, hardware and network level. Essential for anyone who needs 99.9%+ uptime. Can be implemented with replication or clustering solutions from MySQL, Percona, Oracle etc. Requires expertise to setup and maintain. Failover can be manual, scripted or using tools like Orchestrator. Data directory Data is stored in a particular directory, with nested directories for the data contained in each database. There are also MySQL log files, InnoDB log files, server process ID file and some other configs. The data directory is configurable. MySQL configuration This can be done by passing parameters during startup , or in a file . There are a few standard paths where MySQL looks for config files, /etc/my.cnf is one of the commonly used paths. These options are organized under headers (mysqld for server and mysql for client), you can explore them more in the lab that follows. Logs MySQL has logs for various purposes - general query log, errors, binary logs (for replication), slow query log. Only error log is enabled by default (to reduce I/O and storage requirement), the others can be enabled when required - by specifying config parameters at startup or running commands at runtime. Log destination can also be tweaked with config parameters.","title":"Operations"},{"location":"level101/databases_sql/query_performance/","text":"Query Performance Improvement Query Performance is a very crucial aspect of relational databases. If not tuned correctly, the select queries can become slow and painful for the application, and for the MySQL server as well. The important task is to identify the slow queries and try to improve their performance by either rewriting them or creating proper indexes on the tables involved in it. The Slow Query Log The slow query log contains SQL statements that take a longer time to execute then set in the config parameter long_query_time. These queries are the candidates for optimization. There are some good utilities to summarize the slow query logs like, mysqldumpslow (provided by MySQL itself), pt-query-digest (provided by Percona), etc. Following are the config parameters that are used to enable and effectively catch slow queries Variable Explanation Example value slow_query_log Enables or disables slow query logs ON slow_query_log_file The location of the slow query log /var/lib/mysql/mysql-slow.log long_query_time Threshold time. The query that takes longer than this time is logged in slow query log 5 log_queries_not_using_indexes When enabled with the slow query log, the queries which do not make use of any index are also logged in the slow query log even though they take less time than long_query_time. ON So, for this section, we will be enabling slow_query_log , long_query_time will be kept to 0.3 (300 ms) , and log_queries_not_using index will be enabled as well. Below are the queries that we will execute on the employees database. select * from employees where last_name = 'Koblick'; select * from salaries where salary >= 100000; select * from titles where title = 'Manager'; select * from employees where year(hire_date) = 1995; select year(e.hire_date), max(s.salary) from employees e join salaries s on e.emp_no=s.emp_no group by year(e.hire_date); Now, queries 1 , 3 and 4 executed under 300 ms but if we check the slow query logs, we will find these queries logged as they are not using any of the index. Queries 2 and 5 are taking longer than 300ms and also not using any index. Use the following command to get the summary of the slow query log mysqldumpslow /var/lib/mysql/mysql-slow.log There are some more queries in the snapshot that were along with the queries mentioned. Mysqldumpslow replaces actual values that were used by N (in case of numbers) and S (in case of strings). That can be overridden by -a option, however that will increase the output lines if different values are used in similar queries. The EXPLAIN Plan The EXPLAIN command is used with any query that we want to analyze. It describes the query execution plan, how MySQL sees and executes the query. EXPLAIN works with Select, Insert, Update and Delete statements. It tells about different aspects of the query like, how tables are joined, indexes used or not, etc. The important thing here is to understand the basic Explain plan output of a query to determine its performance. Let's take the following query as an example, mysql> explain select * from salaries where salary = 100000; +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ | 1 | SIMPLE | salaries | NULL | ALL | NULL | NULL | NULL | NULL | 2838426 | 10.00 | Using where | +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) The key aspects to understand in the above output are:- Partitions - the number of partitions considered while executing the query. It is only valid if the table is partitioned. Possible_keys - the list of indexes that were considered during creation of the execution plan. Key - the index that will be used while executing the query. Rows - the number of rows examined during the execution. Filtered - the percentage of rows that were filtered out of the rows examined. The maximum and most optimized result will have 100 in this field. Extra - this tells some extra information on how MySQL evaluates, whether the query is using only where clause to match target rows, any index or temporary table, etc. So, for the above query, we can determine that there are no partitions, there are no candidate indexes to be used and so no index is used at all, over 2M rows are examined and only 10% of them are included in the result, and lastly, only a where clause is used to match the target rows. Creating an Index Indexes are used to speed up selecting relevant rows for a given column value. Without an index, MySQL starts with the first row and goes through the entire table to find matching rows. If the table has too many rows, the operation becomes costly. With indexes, MySQL determines the position to start looking for the data without reading the full table. A primary key is also an index which is also the fastest and is stored along with the table data. Secondary indexes are stored outside of the table data and are used to further enhance the performance of SQL statements. Indexes are mostly stored as B-Trees, with some exceptions like spatial indexes use R-Trees and memory tables use hash indexes. There are 2 ways to create indexes:- While creating a table - if we know beforehand the columns that will drive the most number of where clauses in select queries, then we can put an index over them while creating a table. Altering a Table - To improve the performance of a troubling query, we create an index on a table which already has data in it using ALTER or CREATE INDEX command. This operation does not block the table but might take some time to complete depending on the size of the table. Let\u2019s look at the query that we discussed in the previous section. It\u2019s clear that scanning over 2M records is not a good idea when only 10% of those records are actually in the resultset. Hence, we create an index on the salary column of the salaries table. create index idx_salary on salaries(salary) OR alter table salaries add index idx_salary(salary) And the same explain plan now looks like this mysql> explain select * from salaries where salary = 100000; +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ | 1 | SIMPLE | salaries | NULL | ref | idx_salary | idx_salary | 4 | const | 13 | 100.00 | NULL | +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) Now the index used is idx_salary, the one we recently created. The index actually helped examine only 13 records and all of them are in the resultset. Also, the query execution time is also reduced from over 700ms to almost negligible. Let\u2019s look at another example. Here we are searching for a specific combination of first_name and last_name. But, we might also search based on last_name only. mysql> explain select * from employees where last_name = 'Dredge' and first_name = 'Yinghua'; +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | 1 | SIMPLE | employees | NULL | ALL | NULL | NULL | NULL | NULL | 299468 | 1.00 | Using where | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) Now only 1% record out of almost 300K is the resultset. Although the query time is particularly quick as we have only 300K records, this will be a pain if the number of records are over millions. In this case, we create an index on last_name and first_name, not separately, but a composite index including both the columns. create index idx_last_first on employees(last_name, first_name) mysql> explain select * from employees where last_name = 'Dredge' and first_name = 'Yinghua'; +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ | 1 | SIMPLE | employees | NULL | ref | idx_last_first | idx_last_first | 124 | const,const | 1 | 100.00 | NULL | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) We chose to put last_name before first_name while creating the index as the optimizer starts from the leftmost prefix of the index while evaluating the query. For example, if we have a 3-column index like idx(c1, c2, c3), then the search capability of the index follows - (c1), (c1, c2) or (c1, c2, c3) i.e. if your where clause has only first_name this index won\u2019t work. mysql> explain select * from employees where first_name = 'Yinghua'; +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | 1 | SIMPLE | employees | NULL | ALL | NULL | NULL | NULL | NULL | 299468 | 10.00 | Using where | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) But, if you have only the last_name in the where clause, it will work as expected. mysql> explain select * from employees where last_name = 'Dredge'; +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ | 1 | SIMPLE | employees | NULL | ref | idx_last_first | idx_last_first | 66 | const | 200 | 100.00 | NULL | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) For another example, use the following queries:- create table employees_2 like employees; create table salaries_2 like salaries; alter table salaries_2 drop primary key; We made copies of employees and salaries tables without the Primary Key of salaries table to understand an example of Select with Join. When you have queries like the below, it becomes tricky to identify the pain point of the query. mysql> select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; 1860 rows in set (4.44 sec) This query is taking about 4.5 seconds to complete with 1860 rows in the resultset. Let\u2019s look at the Explain plan. There will be 2 records in the Explain plan as 2 tables are used in the query. mysql> explain select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ | 1 | SIMPLE | s | NULL | ALL | NULL | NULL | NULL | NULL | 2837194 | 100.00 | NULL | | 1 | SIMPLE | e | NULL | eq_ref | PRIMARY,idx_last_first | PRIMARY | 4 | employees.s.emp_no | 1 | 5.00 | Using where | +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ 2 rows in set, 1 warning (0.00 sec) These are in order of evaluation i.e. salaries_2 will be evaluated first and then employees_2 will be joined to it. As it looks like, it scans almost all the rows of salaries_2 table and tries to match the employees_2 rows as per the join condition. Though where clause is used in fetching the final resultset, but the index corresponding to the where clause is not used for the employees_2 table. If the join is done on two indexes which have the same data-types, it will always be faster. So, let\u2019s create an index on the emp_no column of salaries_2 table and analyze the query again. create index idx_empno on salaries_2(emp_no); mysql> explain select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ | 1 | SIMPLE | e | NULL | ref | PRIMARY,idx_last_first | idx_last_first | 66 | const | 200 | 100.00 | NULL | | 1 | SIMPLE | s | NULL | ref | idx_empno | idx_empno | 4 | employees.e.emp_no | 9 | 100.00 | NULL | +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ 2 rows in set, 1 warning (0.00 sec) Now, not only did the index help the optimizer to examine only a few rows in both tables, it reversed the order of the tables in evaluation. The employees_2 table is evaluated first and rows are selected as per the index respective to the where clause. Then the records are joined to salaries_2 table as per the index used due to the join condition. The execution time of the query came down from 4.5s to 0.02s . mysql> select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'\\G 1860 rows in set (0.02 sec)","title":"Query Performance"},{"location":"level101/databases_sql/query_performance/#query-performance-improvement","text":"Query Performance is a very crucial aspect of relational databases. If not tuned correctly, the select queries can become slow and painful for the application, and for the MySQL server as well. The important task is to identify the slow queries and try to improve their performance by either rewriting them or creating proper indexes on the tables involved in it.","title":"Query Performance Improvement"},{"location":"level101/databases_sql/query_performance/#the-slow-query-log","text":"The slow query log contains SQL statements that take a longer time to execute then set in the config parameter long_query_time. These queries are the candidates for optimization. There are some good utilities to summarize the slow query logs like, mysqldumpslow (provided by MySQL itself), pt-query-digest (provided by Percona), etc. Following are the config parameters that are used to enable and effectively catch slow queries Variable Explanation Example value slow_query_log Enables or disables slow query logs ON slow_query_log_file The location of the slow query log /var/lib/mysql/mysql-slow.log long_query_time Threshold time. The query that takes longer than this time is logged in slow query log 5 log_queries_not_using_indexes When enabled with the slow query log, the queries which do not make use of any index are also logged in the slow query log even though they take less time than long_query_time. ON So, for this section, we will be enabling slow_query_log , long_query_time will be kept to 0.3 (300 ms) , and log_queries_not_using index will be enabled as well. Below are the queries that we will execute on the employees database. select * from employees where last_name = 'Koblick'; select * from salaries where salary >= 100000; select * from titles where title = 'Manager'; select * from employees where year(hire_date) = 1995; select year(e.hire_date), max(s.salary) from employees e join salaries s on e.emp_no=s.emp_no group by year(e.hire_date); Now, queries 1 , 3 and 4 executed under 300 ms but if we check the slow query logs, we will find these queries logged as they are not using any of the index. Queries 2 and 5 are taking longer than 300ms and also not using any index. Use the following command to get the summary of the slow query log mysqldumpslow /var/lib/mysql/mysql-slow.log There are some more queries in the snapshot that were along with the queries mentioned. Mysqldumpslow replaces actual values that were used by N (in case of numbers) and S (in case of strings). That can be overridden by -a option, however that will increase the output lines if different values are used in similar queries.","title":"The Slow Query Log"},{"location":"level101/databases_sql/query_performance/#the-explain-plan","text":"The EXPLAIN command is used with any query that we want to analyze. It describes the query execution plan, how MySQL sees and executes the query. EXPLAIN works with Select, Insert, Update and Delete statements. It tells about different aspects of the query like, how tables are joined, indexes used or not, etc. The important thing here is to understand the basic Explain plan output of a query to determine its performance. Let's take the following query as an example, mysql> explain select * from salaries where salary = 100000; +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ | 1 | SIMPLE | salaries | NULL | ALL | NULL | NULL | NULL | NULL | 2838426 | 10.00 | Using where | +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) The key aspects to understand in the above output are:- Partitions - the number of partitions considered while executing the query. It is only valid if the table is partitioned. Possible_keys - the list of indexes that were considered during creation of the execution plan. Key - the index that will be used while executing the query. Rows - the number of rows examined during the execution. Filtered - the percentage of rows that were filtered out of the rows examined. The maximum and most optimized result will have 100 in this field. Extra - this tells some extra information on how MySQL evaluates, whether the query is using only where clause to match target rows, any index or temporary table, etc. So, for the above query, we can determine that there are no partitions, there are no candidate indexes to be used and so no index is used at all, over 2M rows are examined and only 10% of them are included in the result, and lastly, only a where clause is used to match the target rows.","title":"The EXPLAIN Plan"},{"location":"level101/databases_sql/query_performance/#creating-an-index","text":"Indexes are used to speed up selecting relevant rows for a given column value. Without an index, MySQL starts with the first row and goes through the entire table to find matching rows. If the table has too many rows, the operation becomes costly. With indexes, MySQL determines the position to start looking for the data without reading the full table. A primary key is also an index which is also the fastest and is stored along with the table data. Secondary indexes are stored outside of the table data and are used to further enhance the performance of SQL statements. Indexes are mostly stored as B-Trees, with some exceptions like spatial indexes use R-Trees and memory tables use hash indexes. There are 2 ways to create indexes:- While creating a table - if we know beforehand the columns that will drive the most number of where clauses in select queries, then we can put an index over them while creating a table. Altering a Table - To improve the performance of a troubling query, we create an index on a table which already has data in it using ALTER or CREATE INDEX command. This operation does not block the table but might take some time to complete depending on the size of the table. Let\u2019s look at the query that we discussed in the previous section. It\u2019s clear that scanning over 2M records is not a good idea when only 10% of those records are actually in the resultset. Hence, we create an index on the salary column of the salaries table. create index idx_salary on salaries(salary) OR alter table salaries add index idx_salary(salary) And the same explain plan now looks like this mysql> explain select * from salaries where salary = 100000; +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ | 1 | SIMPLE | salaries | NULL | ref | idx_salary | idx_salary | 4 | const | 13 | 100.00 | NULL | +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) Now the index used is idx_salary, the one we recently created. The index actually helped examine only 13 records and all of them are in the resultset. Also, the query execution time is also reduced from over 700ms to almost negligible. Let\u2019s look at another example. Here we are searching for a specific combination of first_name and last_name. But, we might also search based on last_name only. mysql> explain select * from employees where last_name = 'Dredge' and first_name = 'Yinghua'; +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | 1 | SIMPLE | employees | NULL | ALL | NULL | NULL | NULL | NULL | 299468 | 1.00 | Using where | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) Now only 1% record out of almost 300K is the resultset. Although the query time is particularly quick as we have only 300K records, this will be a pain if the number of records are over millions. In this case, we create an index on last_name and first_name, not separately, but a composite index including both the columns. create index idx_last_first on employees(last_name, first_name) mysql> explain select * from employees where last_name = 'Dredge' and first_name = 'Yinghua'; +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ | 1 | SIMPLE | employees | NULL | ref | idx_last_first | idx_last_first | 124 | const,const | 1 | 100.00 | NULL | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) We chose to put last_name before first_name while creating the index as the optimizer starts from the leftmost prefix of the index while evaluating the query. For example, if we have a 3-column index like idx(c1, c2, c3), then the search capability of the index follows - (c1), (c1, c2) or (c1, c2, c3) i.e. if your where clause has only first_name this index won\u2019t work. mysql> explain select * from employees where first_name = 'Yinghua'; +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | 1 | SIMPLE | employees | NULL | ALL | NULL | NULL | NULL | NULL | 299468 | 10.00 | Using where | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) But, if you have only the last_name in the where clause, it will work as expected. mysql> explain select * from employees where last_name = 'Dredge'; +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ | 1 | SIMPLE | employees | NULL | ref | idx_last_first | idx_last_first | 66 | const | 200 | 100.00 | NULL | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) For another example, use the following queries:- create table employees_2 like employees; create table salaries_2 like salaries; alter table salaries_2 drop primary key; We made copies of employees and salaries tables without the Primary Key of salaries table to understand an example of Select with Join. When you have queries like the below, it becomes tricky to identify the pain point of the query. mysql> select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; 1860 rows in set (4.44 sec) This query is taking about 4.5 seconds to complete with 1860 rows in the resultset. Let\u2019s look at the Explain plan. There will be 2 records in the Explain plan as 2 tables are used in the query. mysql> explain select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ | 1 | SIMPLE | s | NULL | ALL | NULL | NULL | NULL | NULL | 2837194 | 100.00 | NULL | | 1 | SIMPLE | e | NULL | eq_ref | PRIMARY,idx_last_first | PRIMARY | 4 | employees.s.emp_no | 1 | 5.00 | Using where | +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ 2 rows in set, 1 warning (0.00 sec) These are in order of evaluation i.e. salaries_2 will be evaluated first and then employees_2 will be joined to it. As it looks like, it scans almost all the rows of salaries_2 table and tries to match the employees_2 rows as per the join condition. Though where clause is used in fetching the final resultset, but the index corresponding to the where clause is not used for the employees_2 table. If the join is done on two indexes which have the same data-types, it will always be faster. So, let\u2019s create an index on the emp_no column of salaries_2 table and analyze the query again. create index idx_empno on salaries_2(emp_no); mysql> explain select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ | 1 | SIMPLE | e | NULL | ref | PRIMARY,idx_last_first | idx_last_first | 66 | const | 200 | 100.00 | NULL | | 1 | SIMPLE | s | NULL | ref | idx_empno | idx_empno | 4 | employees.e.emp_no | 9 | 100.00 | NULL | +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ 2 rows in set, 1 warning (0.00 sec) Now, not only did the index help the optimizer to examine only a few rows in both tables, it reversed the order of the tables in evaluation. The employees_2 table is evaluated first and rows are selected as per the index respective to the where clause. Then the records are joined to salaries_2 table as per the index used due to the join condition. The execution time of the query came down from 4.5s to 0.02s . mysql> select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'\\G 1860 rows in set (0.02 sec)","title":"Creating an Index"},{"location":"level101/databases_sql/replication/","text":"MySQL Replication Replication enables data from one MySQL host (termed as Primary) to be copied to another MySQL host (termed as Replica). MySQL Replication is asynchronous in nature by default, but it can be changed to semi-synchronous with some configurations. Some common applications of MySQL replication are:- Read-scaling - as multiple hosts can replicate the data from a single primary host, we can set up as many replicas as we need and scale reads through them, i.e. application writes will go to a single primary host and the reads can balance between all the replicas that are there. Such a setup can improve the write performance as well, as the primary is dedicated to only updates and not reads. Backups using replicas - the backup process can sometimes be a little heavy. But if we have replicas configured, then we can use one of them to get the backup without affecting the primary data at all. Disaster Recovery - a replica in some other geographical region paves a proper path to configure disaster recovery. MySQL supports different types of synchronizations as well:- Asynchronous - this is the default synchronization method. It is one-way, i.e. one host serves as primary and one or more hosts as replica. We will discuss this method throughout the replication topic. Semi-Synchronous - in this type of synchronization, a commit performed on the primary host is blocked until at least one replica acknowledges it. Post the acknowledgement from any one replica, the control is returned to the session that performed the transaction. This ensures strong consistency but the replication is slower than asynchronous. Delayed - we can deliberately lag the replica in a typical MySQL replication by the number of seconds desired by the use case. This type of replication safeguards from severe human errors of dropping or corrupting the data on the primary, for example, in the above diagram for Delayed Replication, if a DROP DATABASE is executed by mistake on the primary, we still have 30 minutes to recover the data from R2 as that command has not been replicated on R2 yet. Pre-Requisites Before we dive into setting up replication, we should know about the binary logs. Binary logs play a very important role in MySQL replication. Binary logs, or commonly known as binlogs contain events about the changes done to the database, like table structure changes, data changes via DML operations, etc. They are not used to log SELECT statements. For replication, the primary sends the information to the replicas using its binlogs about the changes done to the database, and the replicas make the same data changes. With respect to MySQL replication, the binary log format can be of two types that decides the main type of replication:- - Statement-Based Replication or SBR - Row-Based Replication or RBR Statement Based Binlog Format Originally, the replication in MySQL was based on SQL statements getting replicated and executed on the replica from the primary. This is called statement based logging. The binlog contains the exact SQL statement run by the session. So If we run the above statements to insert 3 records and the update 3 in a single update statement, they will be logged exactly the same as when we executed them. Row Based Binlog Format The Row based is the default one in the latest MySQL releases. This is a lot different from the Statement format as here, row events are logged instead of statements. By that we mean, in the above example one update statement affected 3 records, but binlog had only one update statement; if it is a row based format, binlog will have an event for each record updated. Statement Based v/s Row Based binlogs Let\u2019s have a look at the operational differences between statement-based and row-based binlogs. Statement Based Row Based Logs SQL statements as executed Logs row events based on SQL statements executed Takes lesser disk space Takes more disk space Restoring using binlogs is faster Restoring using binlogs is slower When used for replication, if any statement has a predefined function that has its own value, like sysdate(), uuid() etc, the output could be different on the replica which makes it inconsistent. Whatever is executed becomes a row event with values, so there will be no problem if such functions are used in SQL statements. Only statements are logged so no other row events are generated. A lot of events are generated when a table is copied into another using INSERT INTO SELECT. Note - There is another type of binlog format called Mixed . With mixed logging, statement based is used by default but it switches to row based in certain cases. If MySQL cannot guarantee that statement based logging is safe for the statements executed, it issues a warning and switches to row based for those statements. We will be using binary log format as Row for the entire replication topic. Replication in Motion The above figure indicates how a typical MySQL replication works. Replica_IO_Thread is responsible to fetch the binlog events from the primary binary logs to the replica On the Replica host, relay logs are created which are exact copies of the binary logs. If the binary logs on primary are in row format, the relay logs will be the same. Replica_SQL_Thread applies the relay logs on the replica MySQL server. If log-bin is enabled on the replica, then the replica will have its own binary logs as well. If log-slave-updates is enabled, then it will have the updates from the primary logged in the binlogs as well. Setting up Replication In this section, we will set up a simple asynchronous replication. The binlogs will be in row based format. The replication will be set up on two fresh hosts with no prior data present. There are two different ways in which we can set up replication. Binlog based - Each replica keeps a record of the binlog coordinates on the primary - current binlog and position in the binlog till where it has read and processed. So, at a time different replicas might be reading different parts of the same binlog. GTID based - Every transaction gets an identifier called global transaction identifier or GTID. There is no need to keep the record of binlog coordinates, as long as the replica has all the GTIDs executed on the primary, it is consistent with the primary. A typical GTID is the server_uuid:# positive integer. We will set up a GTID based replication in the following section but will also discuss binlog based replication setup as well. Primary Host Configurations The following config parameters should be present in the primary my.cnf file for setting up GTID based replication. server-id - a unique ID for the mysql server log-bin - the binlog location binlog-format - ROW | STATEMENT (we will use ROW) gtid-mode - ON enforce-gtid-consistency - ON (allows execution of only those statements which can be logged using GTIDs) Replica Host Configurations The following config parameters should be present in the replica my.cnf file for setting up replication. server-id - different than the primary host log-bin - (optional, if you want replica to log its own changes as well) binlog-format - depends on the above gtid-mode - ON enforce-gtid-consistency - ON log-slave-updates - ON (if binlog is enabled, then we can enable this. This enables the replica to log the changes coming from the primary along with its own changes. Helps in setting up chain replication) Replication User Every replica connects to the primary using a mysql user for replicating. So there must be a mysql user account for the same on the primary host. Any user can be used for this purpose provided it has REPLICATION SLAVE privilege. If the sole purpose is replication then we can have a user with only the required privilege. On the primary host mysql> create user repl_user@ identified by 'xxxxx'; mysql> grant replication slave on *.* to repl_user@''; Obtaining Starting position from Primary Run the following command on the primary host mysql> show master status\\G *************************** 1. row *************************** File: mysql-bin.000001 Position: 73 Binlog_Do_DB: Binlog_Ignore_DB: Executed_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 1 row in set (0.00 sec) If we are working with binary log based replication, the top two output lines are the most important ones. That tells the current binlog on the primary host and till what position it has written. For fresh hosts we know that no data is written so we can directly set up replication using the very first binlog file and position 4. If we are setting up a replication from a backup, then that changes the way we obtain the starting position. For GTIDs, the executed_gtid_set is the value where primary is right now. Again, for a fresh setup, we don\u2019t have to specify anything about the starting point and it will start from the transaction id 1, but when we set up from a backup, the backup will contain the GTID positions till where backup has been taken. Setting up Replica The replication setup must know about the primary host, the user and password to connect, the binlog coordinates (for binlog based replication) or the GTID auto-position parameter. The following command is used for setting up change master to master_host = '', master_port = , master_user = 'repl_user', master_password = 'xxxxx', master_auto_position = 1; Note - the Change Master To command has been replaced with Change Replication Source To from Mysql 8.0.23 onwards, also all the master and slave keywords are replaced with source and replica . If it is binlog based replication, then instead of master_auto_position, we need to specify the binlog coordinates. master_log_file = 'mysql-bin.000001', master_log_pos = 4 Starting Replication and Check Status Now that everything is configured, we just need to start the replication on the replica via the following command start slave; OR from MySQL 8.0.23 onwards, start replica; Whether or not the replication is running successfully, we can determine by running the following command show slave status\\G OR from MySQL 8.0.23 onwards, show replica status\\G mysql> show replica status\\G *************************** 1. row *************************** Replica_IO_State: Waiting for master to send event Source_Host: Source_User: repl_user Source_Port: Connect_Retry: 60 Source_Log_File: mysql-bin.000001 Read_Source_Log_Pos: 852 Relay_Log_File: mysql-relay-bin.000002 Relay_Log_Pos: 1067 Relay_Source_Log_File: mysql-bin.000001 Replica_IO_Running: Yes Replica_SQL_Running: Yes Replicate_Do_DB: Replicate_Ignore_DB: Replicate_Do_Table: Replicate_Ignore_Table: Replicate_Wild_Do_Table: Replicate_Wild_Ignore_Table: Last_Errno: 0 Last_Error: Skip_Counter: 0 Exec_Source_Log_Pos: 852 Relay_Log_Space: 1283 Until_Condition: None Until_Log_File: Until_Log_Pos: 0 Source_SSL_Allowed: No Source_SSL_CA_File: Source_SSL_CA_Path: Source_SSL_Cert: Source_SSL_Cipher: Source_SSL_Key: Seconds_Behind_Source: 0 Source_SSL_Verify_Server_Cert: No Last_IO_Errno: 0 Last_IO_Error: Last_SQL_Errno: 0 Last_SQL_Error: Replicate_Ignore_Server_Ids: Source_Server_Id: 1 Source_UUID: e17d0920-d00e-11eb-a3e6-000d3aa00f87 Source_Info_File: mysql.slave_master_info SQL_Delay: 0 SQL_Remaining_Delay: NULL Replica_SQL_Running_State: Slave has read all relay log; waiting for more updates Source_Retry_Count: 86400 Source_Bind: Last_IO_Error_Timestamp: Last_SQL_Error_Timestamp: Source_SSL_Crl: Source_SSL_Crlpath: Retrieved_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 Executed_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 Auto_Position: 1 Replicate_Rewrite_DB: Channel_Name: Source_TLS_Version: Source_public_key_path: Get_Source_public_key: 0 Network_Namespace: 1 row in set (0.00 sec) Some of the parameters are explained below:- Relay_Source_Log_File - the primary\u2019s file where replica is currently reading from Execute_Source_Log_Pos - for the above file on which position is the replica reading currently from. These two parameters are of utmost importance when binlog based replication is used. Replica_IO_Running - IO thread of replica is running or not Replica_SQL_Running - SQL thread of replica is running or not Seconds_Behind_Source - the difference of seconds when a statement was executed on Primary and then on Replica. This indicates how much replication lag is there. Source_UUID - the uuid of the primary host Retrieved_Gtid_Set - the GTIDs fetched from the primary host by the replica to be executed. Executed_Gtid_Set - the GTIDs executed on the replica. This set remains the same for the entire cluster if the replicas are in sync. Auto_Position - it directs the replica to fetch the next GTID automatically Create a Replica for the already setup cluster The steps discussed in the previous section talks about the setting up replication on two fresh hosts. When we have to set up a replica for a host which is already serving applications, then the backup of the primary is used, either fresh backup taken for the replica (should only be done if the traffic it is serving is less) or use a recently taken backup. If the size of the databases on the MySQL primary server is small, less than 100G recommended, then mysqldump can be used to take backup along with the following options. mysqldump -uroot -p -hhost_ip -P3306 --all-databases --single-transaction --master-data=1 > primary_host.bkp --single-transaction - this option starts a transaction before taking the backup which ensures it is consistent. As transactions are isolated from each other, so no other writes affect the backup. --master-data - this option is required if binlog based replication is desired to be set up. It includes the binary log file and log file position in the backup file. When GTID mode is enabled and mysqldump is executed, it includes the GTID executed to be used to start the replica after the backup position. The contents of the mysqldump output file will have the following It is recommended to comment these before restoring otherwise they could throw errors. Also, using master-data=2 will automatically comment the master_log_file line. Similarly, when taking backup of the host using xtrabackup , the file xtrabckup_info file contains the information about binlog file and file position, as well as the GTID executed set. server_version = 8.0.25 start_time = 2021-06-22 03:45:17 end_time = 2021-06-22 03:45:20 lock_time = 0 binlog_pos = filename 'mysql-bin.000007', position '196', GTID of the last change 'e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-5' innodb_from_lsn = 0 innodb_to_lsn = 18153149 partial = N incremental = N format = file compressed = N encrypted = N Now, after setting MySQL server on the desired host, restore the backup taken from any one of the above methods. If the intended way is binlog based replication, then use the binlog file and position info in the following command change Replication Source to source_host = \u2018primary_ip\u2019, source_port = 3306, source_user = \u2018repl_user\u2019, source_password = \u2018xxxxx\u2019, source_log_file = \u2018mysql-bin.000007\u2019, source_log_pos = \u2018196\u2019; If the replication needs to be set via GITDs, then run the below command to tell the replica about the GTIDs already executed. On the Replica host, run th following commands reset master; set global gtid_purged = \u2018e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-5\u2019 change replication source to source_host = \u2018primary_ip\u2019, source_port = 3306, source_user = \u2018repl_user\u2019, source_password = \u2018xxxxx\u2019, source_auto_position = 1 The reset master command resets the position of the binary log to initial. It can be skipped if the host is a freshly installed MySQL, but we restored a backup so it is necessary. The gtid_purged global variable lets the replica know the GTIDs that have already been executed, so that the replication can start after that. Then in the change source command, we set the auto-position to 1 which automatically gets the next GTID to proceed. Further Reading More applications of Replication Automtaed Failovers using MySQL Orchestrator","title":"MySQL Replication"},{"location":"level101/databases_sql/replication/#mysql-replication","text":"Replication enables data from one MySQL host (termed as Primary) to be copied to another MySQL host (termed as Replica). MySQL Replication is asynchronous in nature by default, but it can be changed to semi-synchronous with some configurations. Some common applications of MySQL replication are:- Read-scaling - as multiple hosts can replicate the data from a single primary host, we can set up as many replicas as we need and scale reads through them, i.e. application writes will go to a single primary host and the reads can balance between all the replicas that are there. Such a setup can improve the write performance as well, as the primary is dedicated to only updates and not reads. Backups using replicas - the backup process can sometimes be a little heavy. But if we have replicas configured, then we can use one of them to get the backup without affecting the primary data at all. Disaster Recovery - a replica in some other geographical region paves a proper path to configure disaster recovery. MySQL supports different types of synchronizations as well:- Asynchronous - this is the default synchronization method. It is one-way, i.e. one host serves as primary and one or more hosts as replica. We will discuss this method throughout the replication topic. Semi-Synchronous - in this type of synchronization, a commit performed on the primary host is blocked until at least one replica acknowledges it. Post the acknowledgement from any one replica, the control is returned to the session that performed the transaction. This ensures strong consistency but the replication is slower than asynchronous. Delayed - we can deliberately lag the replica in a typical MySQL replication by the number of seconds desired by the use case. This type of replication safeguards from severe human errors of dropping or corrupting the data on the primary, for example, in the above diagram for Delayed Replication, if a DROP DATABASE is executed by mistake on the primary, we still have 30 minutes to recover the data from R2 as that command has not been replicated on R2 yet. Pre-Requisites Before we dive into setting up replication, we should know about the binary logs. Binary logs play a very important role in MySQL replication. Binary logs, or commonly known as binlogs contain events about the changes done to the database, like table structure changes, data changes via DML operations, etc. They are not used to log SELECT statements. For replication, the primary sends the information to the replicas using its binlogs about the changes done to the database, and the replicas make the same data changes. With respect to MySQL replication, the binary log format can be of two types that decides the main type of replication:- - Statement-Based Replication or SBR - Row-Based Replication or RBR Statement Based Binlog Format Originally, the replication in MySQL was based on SQL statements getting replicated and executed on the replica from the primary. This is called statement based logging. The binlog contains the exact SQL statement run by the session. So If we run the above statements to insert 3 records and the update 3 in a single update statement, they will be logged exactly the same as when we executed them. Row Based Binlog Format The Row based is the default one in the latest MySQL releases. This is a lot different from the Statement format as here, row events are logged instead of statements. By that we mean, in the above example one update statement affected 3 records, but binlog had only one update statement; if it is a row based format, binlog will have an event for each record updated. Statement Based v/s Row Based binlogs Let\u2019s have a look at the operational differences between statement-based and row-based binlogs. Statement Based Row Based Logs SQL statements as executed Logs row events based on SQL statements executed Takes lesser disk space Takes more disk space Restoring using binlogs is faster Restoring using binlogs is slower When used for replication, if any statement has a predefined function that has its own value, like sysdate(), uuid() etc, the output could be different on the replica which makes it inconsistent. Whatever is executed becomes a row event with values, so there will be no problem if such functions are used in SQL statements. Only statements are logged so no other row events are generated. A lot of events are generated when a table is copied into another using INSERT INTO SELECT. Note - There is another type of binlog format called Mixed . With mixed logging, statement based is used by default but it switches to row based in certain cases. If MySQL cannot guarantee that statement based logging is safe for the statements executed, it issues a warning and switches to row based for those statements. We will be using binary log format as Row for the entire replication topic. Replication in Motion The above figure indicates how a typical MySQL replication works. Replica_IO_Thread is responsible to fetch the binlog events from the primary binary logs to the replica On the Replica host, relay logs are created which are exact copies of the binary logs. If the binary logs on primary are in row format, the relay logs will be the same. Replica_SQL_Thread applies the relay logs on the replica MySQL server. If log-bin is enabled on the replica, then the replica will have its own binary logs as well. If log-slave-updates is enabled, then it will have the updates from the primary logged in the binlogs as well.","title":"MySQL Replication"},{"location":"level101/databases_sql/replication/#setting-up-replication","text":"In this section, we will set up a simple asynchronous replication. The binlogs will be in row based format. The replication will be set up on two fresh hosts with no prior data present. There are two different ways in which we can set up replication. Binlog based - Each replica keeps a record of the binlog coordinates on the primary - current binlog and position in the binlog till where it has read and processed. So, at a time different replicas might be reading different parts of the same binlog. GTID based - Every transaction gets an identifier called global transaction identifier or GTID. There is no need to keep the record of binlog coordinates, as long as the replica has all the GTIDs executed on the primary, it is consistent with the primary. A typical GTID is the server_uuid:# positive integer. We will set up a GTID based replication in the following section but will also discuss binlog based replication setup as well. Primary Host Configurations The following config parameters should be present in the primary my.cnf file for setting up GTID based replication. server-id - a unique ID for the mysql server log-bin - the binlog location binlog-format - ROW | STATEMENT (we will use ROW) gtid-mode - ON enforce-gtid-consistency - ON (allows execution of only those statements which can be logged using GTIDs) Replica Host Configurations The following config parameters should be present in the replica my.cnf file for setting up replication. server-id - different than the primary host log-bin - (optional, if you want replica to log its own changes as well) binlog-format - depends on the above gtid-mode - ON enforce-gtid-consistency - ON log-slave-updates - ON (if binlog is enabled, then we can enable this. This enables the replica to log the changes coming from the primary along with its own changes. Helps in setting up chain replication) Replication User Every replica connects to the primary using a mysql user for replicating. So there must be a mysql user account for the same on the primary host. Any user can be used for this purpose provided it has REPLICATION SLAVE privilege. If the sole purpose is replication then we can have a user with only the required privilege. On the primary host mysql> create user repl_user@ identified by 'xxxxx'; mysql> grant replication slave on *.* to repl_user@''; Obtaining Starting position from Primary Run the following command on the primary host mysql> show master status\\G *************************** 1. row *************************** File: mysql-bin.000001 Position: 73 Binlog_Do_DB: Binlog_Ignore_DB: Executed_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 1 row in set (0.00 sec) If we are working with binary log based replication, the top two output lines are the most important ones. That tells the current binlog on the primary host and till what position it has written. For fresh hosts we know that no data is written so we can directly set up replication using the very first binlog file and position 4. If we are setting up a replication from a backup, then that changes the way we obtain the starting position. For GTIDs, the executed_gtid_set is the value where primary is right now. Again, for a fresh setup, we don\u2019t have to specify anything about the starting point and it will start from the transaction id 1, but when we set up from a backup, the backup will contain the GTID positions till where backup has been taken. Setting up Replica The replication setup must know about the primary host, the user and password to connect, the binlog coordinates (for binlog based replication) or the GTID auto-position parameter. The following command is used for setting up change master to master_host = '', master_port = , master_user = 'repl_user', master_password = 'xxxxx', master_auto_position = 1; Note - the Change Master To command has been replaced with Change Replication Source To from Mysql 8.0.23 onwards, also all the master and slave keywords are replaced with source and replica . If it is binlog based replication, then instead of master_auto_position, we need to specify the binlog coordinates. master_log_file = 'mysql-bin.000001', master_log_pos = 4 Starting Replication and Check Status Now that everything is configured, we just need to start the replication on the replica via the following command start slave; OR from MySQL 8.0.23 onwards, start replica; Whether or not the replication is running successfully, we can determine by running the following command show slave status\\G OR from MySQL 8.0.23 onwards, show replica status\\G mysql> show replica status\\G *************************** 1. row *************************** Replica_IO_State: Waiting for master to send event Source_Host: Source_User: repl_user Source_Port: Connect_Retry: 60 Source_Log_File: mysql-bin.000001 Read_Source_Log_Pos: 852 Relay_Log_File: mysql-relay-bin.000002 Relay_Log_Pos: 1067 Relay_Source_Log_File: mysql-bin.000001 Replica_IO_Running: Yes Replica_SQL_Running: Yes Replicate_Do_DB: Replicate_Ignore_DB: Replicate_Do_Table: Replicate_Ignore_Table: Replicate_Wild_Do_Table: Replicate_Wild_Ignore_Table: Last_Errno: 0 Last_Error: Skip_Counter: 0 Exec_Source_Log_Pos: 852 Relay_Log_Space: 1283 Until_Condition: None Until_Log_File: Until_Log_Pos: 0 Source_SSL_Allowed: No Source_SSL_CA_File: Source_SSL_CA_Path: Source_SSL_Cert: Source_SSL_Cipher: Source_SSL_Key: Seconds_Behind_Source: 0 Source_SSL_Verify_Server_Cert: No Last_IO_Errno: 0 Last_IO_Error: Last_SQL_Errno: 0 Last_SQL_Error: Replicate_Ignore_Server_Ids: Source_Server_Id: 1 Source_UUID: e17d0920-d00e-11eb-a3e6-000d3aa00f87 Source_Info_File: mysql.slave_master_info SQL_Delay: 0 SQL_Remaining_Delay: NULL Replica_SQL_Running_State: Slave has read all relay log; waiting for more updates Source_Retry_Count: 86400 Source_Bind: Last_IO_Error_Timestamp: Last_SQL_Error_Timestamp: Source_SSL_Crl: Source_SSL_Crlpath: Retrieved_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 Executed_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 Auto_Position: 1 Replicate_Rewrite_DB: Channel_Name: Source_TLS_Version: Source_public_key_path: Get_Source_public_key: 0 Network_Namespace: 1 row in set (0.00 sec) Some of the parameters are explained below:- Relay_Source_Log_File - the primary\u2019s file where replica is currently reading from Execute_Source_Log_Pos - for the above file on which position is the replica reading currently from. These two parameters are of utmost importance when binlog based replication is used. Replica_IO_Running - IO thread of replica is running or not Replica_SQL_Running - SQL thread of replica is running or not Seconds_Behind_Source - the difference of seconds when a statement was executed on Primary and then on Replica. This indicates how much replication lag is there. Source_UUID - the uuid of the primary host Retrieved_Gtid_Set - the GTIDs fetched from the primary host by the replica to be executed. Executed_Gtid_Set - the GTIDs executed on the replica. This set remains the same for the entire cluster if the replicas are in sync. Auto_Position - it directs the replica to fetch the next GTID automatically Create a Replica for the already setup cluster The steps discussed in the previous section talks about the setting up replication on two fresh hosts. When we have to set up a replica for a host which is already serving applications, then the backup of the primary is used, either fresh backup taken for the replica (should only be done if the traffic it is serving is less) or use a recently taken backup. If the size of the databases on the MySQL primary server is small, less than 100G recommended, then mysqldump can be used to take backup along with the following options. mysqldump -uroot -p -hhost_ip -P3306 --all-databases --single-transaction --master-data=1 > primary_host.bkp --single-transaction - this option starts a transaction before taking the backup which ensures it is consistent. As transactions are isolated from each other, so no other writes affect the backup. --master-data - this option is required if binlog based replication is desired to be set up. It includes the binary log file and log file position in the backup file. When GTID mode is enabled and mysqldump is executed, it includes the GTID executed to be used to start the replica after the backup position. The contents of the mysqldump output file will have the following It is recommended to comment these before restoring otherwise they could throw errors. Also, using master-data=2 will automatically comment the master_log_file line. Similarly, when taking backup of the host using xtrabackup , the file xtrabckup_info file contains the information about binlog file and file position, as well as the GTID executed set. server_version = 8.0.25 start_time = 2021-06-22 03:45:17 end_time = 2021-06-22 03:45:20 lock_time = 0 binlog_pos = filename 'mysql-bin.000007', position '196', GTID of the last change 'e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-5' innodb_from_lsn = 0 innodb_to_lsn = 18153149 partial = N incremental = N format = file compressed = N encrypted = N Now, after setting MySQL server on the desired host, restore the backup taken from any one of the above methods. If the intended way is binlog based replication, then use the binlog file and position info in the following command change Replication Source to source_host = \u2018primary_ip\u2019, source_port = 3306, source_user = \u2018repl_user\u2019, source_password = \u2018xxxxx\u2019, source_log_file = \u2018mysql-bin.000007\u2019, source_log_pos = \u2018196\u2019; If the replication needs to be set via GITDs, then run the below command to tell the replica about the GTIDs already executed. On the Replica host, run th following commands reset master; set global gtid_purged = \u2018e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-5\u2019 change replication source to source_host = \u2018primary_ip\u2019, source_port = 3306, source_user = \u2018repl_user\u2019, source_password = \u2018xxxxx\u2019, source_auto_position = 1 The reset master command resets the position of the binary log to initial. It can be skipped if the host is a freshly installed MySQL, but we restored a backup so it is necessary. The gtid_purged global variable lets the replica know the GTIDs that have already been executed, so that the replication can start after that. Then in the change source command, we set the auto-position to 1 which automatically gets the next GTID to proceed.","title":"Setting up Replication"},{"location":"level101/databases_sql/replication/#further-reading","text":"More applications of Replication Automtaed Failovers using MySQL Orchestrator","title":"Further Reading"},{"location":"level101/databases_sql/select_query/","text":"SELECT Query The most commonly used command while working with MySQL is SELECT. It is used to fetch the result set from one or more tables. The general form of a typical select query looks like:- SELECT expr FROM table1 [WHERE condition] [GROUP BY column_list HAVING condition] [ORDER BY column_list ASC|DESC] [LIMIT #] The above general form contains some commonly used clauses of a SELECT query:- expr - comma-separated column list or * (for all columns) WHERE - a condition is provided, if true, directs the query to select only those records. GROUP BY - groups the entire result set based on the column list provided. An aggregate function is recommended to be present in the select expression of the query. HAVING supports grouping by putting a condition on the selected or any other aggregate function. ORDER BY - sorts the result set based on the column list in ascending or descending order. LIMIT - commonly used to limit the number of records. Let\u2019s have a look at some examples for a better understanding of the above. The dataset used for the examples below is available here and is free to use. Select all records mysql> select * from employees limit 5; +--------+------------+------------+-----------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-----------+--------+------------+ | 10001 | 1953-09-02 | Georgi | Facello | M | 1986-06-26 | | 10002 | 1964-06-02 | Bezalel | Simmel | F | 1985-11-21 | | 10003 | 1959-12-03 | Parto | Bamford | M | 1986-08-28 | | 10004 | 1954-05-01 | Chirstian | Koblick | M | 1986-12-01 | | 10005 | 1955-01-21 | Kyoichi | Maliniak | M | 1989-09-12 | +--------+------------+------------+-----------+--------+------------+ 5 rows in set (0.00 sec) Select specific fields for all records mysql> select first_name, last_name, gender from employees limit 5; +------------+-----------+--------+ | first_name | last_name | gender | +------------+-----------+--------+ | Georgi | Facello | M | | Bezalel | Simmel | F | | Parto | Bamford | M | | Chirstian | Koblick | M | | Kyoichi | Maliniak | M | +------------+-----------+--------+ 5 rows in set (0.00 sec) Select all records Where hire_date >= January 1, 1990 mysql> select * from employees where hire_date >= '1990-01-01' limit 5; +--------+------------+------------+-------------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-------------+--------+------------+ | 10008 | 1958-02-19 | Saniya | Kalloufi | M | 1994-09-15 | | 10011 | 1953-11-07 | Mary | Sluis | F | 1990-01-22 | | 10012 | 1960-10-04 | Patricio | Bridgland | M | 1992-12-18 | | 10016 | 1961-05-02 | Kazuhito | Cappelletti | M | 1995-01-27 | | 10017 | 1958-07-06 | Cristinel | Bouloucos | F | 1993-08-03 | +--------+------------+------------+-------------+--------+------------+ 5 rows in set (0.01 sec) Select first_name and last_name from all records Where birth_date >= 1960 AND gender = \u2018F\u2019 mysql> select first_name, last_name from employees where year(birth_date) >= 1960 and gender='F' limit 5; +------------+-----------+ | first_name | last_name | +------------+-----------+ | Bezalel | Simmel | | Duangkaew | Piveteau | | Divier | Reistad | | Jeong | Reistad | | Mingsen | Casley | +------------+-----------+ 5 rows in set (0.00 sec) Display the total number of records mysql> select count(*) from employees; +----------+ | count(*) | +----------+ | 300024 | +----------+ 1 row in set (0.05 sec) Display gender-wise count of all records mysql> select gender, count(*) from employees group by gender; +--------+----------+ | gender | count(*) | +--------+----------+ | M | 179973 | | F | 120051 | +--------+----------+ 2 rows in set (0.14 sec) Display the year of hire_date and number of employees hired that year, also only those years where more than 20k employees were hired mysql> select year(hire_date), count(*) from employees group by year(hire_date) having count(*) > 20000; +-----------------+----------+ | year(hire_date) | count(*) | +-----------------+----------+ | 1985 | 35316 | | 1986 | 36150 | | 1987 | 33501 | | 1988 | 31436 | | 1989 | 28394 | | 1990 | 25610 | | 1991 | 22568 | | 1992 | 20402 | +-----------------+----------+ 8 rows in set (0.14 sec) Display all records ordered by their hire_date in descending order. If hire_date is the same then in order of their birth_date ascending order mysql> select * from employees order by hire_date desc, birth_date asc limit 5; +--------+------------+------------+-----------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-----------+--------+------------+ | 463807 | 1964-06-12 | Bikash | Covnot | M | 2000-01-28 | | 428377 | 1957-05-09 | Yucai | Gerlach | M | 2000-01-23 | | 499553 | 1954-05-06 | Hideyuki | Delgrande | F | 2000-01-22 | | 222965 | 1959-08-07 | Volkmar | Perko | F | 2000-01-13 | | 47291 | 1960-09-09 | Ulf | Flexer | M | 2000-01-12 | +--------+------------+------------+-----------+--------+------------+ 5 rows in set (0.12 sec) SELECT - JOINS JOIN statement is used to produce a combined result set from two or more tables based on certain conditions. It can be also used with Update and Delete statements but we will be focussing on the select query. Following is a basic general form for joins SELECT table1.col1, table2.col1, ... (any combination) FROM table1 table2 ON (or USING depends on join_type) table1.column_for_joining = table2.column_for_joining WHERE \u2026 Any number of columns can be selected, but it is recommended to select only those which are relevant to increase the readability of the resultset. All other clauses like where, group by are not mandatory. Let\u2019s discuss the types of JOINs supported by MySQL Syntax. Inner Join This joins table A with table B on a condition. Only the records where the condition is True are selected in the resultset. Display some details of employees along with their salary mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e join salaries s on e.emp_no=s.emp_no limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Similar result can be achieved by mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e join salaries s using (emp_no) limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) And also by mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e natural join salaries s limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Outer Join Majorly of two types:- - LEFT - joining complete table A with table B on a condition. All the records from table A are selected, but from table B, only those records are selected where the condition is True. - RIGHT - Exact opposite of the left join. Let us assume the below tables for understanding left join better. mysql> select * from dummy1; +----------+------------+ | same_col | diff_col_1 | +----------+------------+ | 1 | A | | 2 | B | | 3 | C | +----------+------------+ mysql> select * from dummy2; +----------+------------+ | same_col | diff_col_2 | +----------+------------+ | 1 | X | | 3 | Y | +----------+------------+ A simple select join will look like the one below. mysql> select * from dummy1 d1 left join dummy2 d2 on d1.same_col=d2.same_col; +----------+------------+----------+------------+ | same_col | diff_col_1 | same_col | diff_col_2 | +----------+------------+----------+------------+ | 1 | A | 1 | X | | 3 | C | 3 | Y | | 2 | B | NULL | NULL | +----------+------------+----------+------------+ 3 rows in set (0.00 sec) Which can also be written as mysql> select * from dummy1 d1 left join dummy2 d2 using(same_col); +----------+------------+------------+ | same_col | diff_col_1 | diff_col_2 | +----------+------------+------------+ | 1 | A | X | | 3 | C | Y | | 2 | B | NULL | +----------+------------+------------+ 3 rows in set (0.00 sec) And also as mysql> select * from dummy1 d1 natural left join dummy2 d2; +----------+------------+------------+ | same_col | diff_col_1 | diff_col_2 | +----------+------------+------------+ | 1 | A | X | | 3 | C | Y | | 2 | B | NULL | +----------+------------+------------+ 3 rows in set (0.00 sec) Cross Join This does a cross product of table A and table B without any condition. It doesn\u2019t have a lot of applications in the real world. A Simple Cross Join looks like this mysql> select * from dummy1 cross join dummy2; +----------+------------+----------+------------+ | same_col | diff_col_1 | same_col | diff_col_2 | +----------+------------+----------+------------+ | 1 | A | 3 | Y | | 1 | A | 1 | X | | 2 | B | 3 | Y | | 2 | B | 1 | X | | 3 | C | 3 | Y | | 3 | C | 1 | X | +----------+------------+----------+------------+ 6 rows in set (0.01 sec) One use case that can come in handy is when you have to fill in some missing entries. For example, all the entries from dummy1 must be inserted into a similar table dummy3, with each record must have 3 entries with statuses 1, 5 and 7. mysql> desc dummy3; +----------+----------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +----------+----------+------+-----+---------+-------+ | same_col | int | YES | | NULL | | | value | char(15) | YES | | NULL | | | status | smallint | YES | | NULL | | +----------+----------+------+-----+---------+-------+ 3 rows in set (0.02 sec) Either you create an insert query script with as many entries as in dummy1 or use cross join to produce the required resultset. mysql> select * from dummy1 cross join (select 1 union select 5 union select 7) T2 order by same_col; +----------+------------+---+ | same_col | diff_col_1 | 1 | +----------+------------+---+ | 1 | A | 1 | | 1 | A | 5 | | 1 | A | 7 | | 2 | B | 1 | | 2 | B | 5 | | 2 | B | 7 | | 3 | C | 1 | | 3 | C | 5 | | 3 | C | 7 | +----------+------------+---+ 9 rows in set (0.00 sec) The T2 section in the above query is called a sub-query . We will discuss the same in the next section. Natural Join This implicitly selects the common column from table A and table B and performs an inner join. mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e natural join salaries s limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Notice how natural join and using takes care that the common column is displayed only once if you are not explicitly selecting columns for the query. Some More Examples Display emp_no, salary, title and dept of the employees where salary > 80000 mysql> select e.emp_no, s.salary, t.title, d.dept_no from employees e join salaries s using (emp_no) join titles t using (emp_no) join dept_emp d using (emp_no) where s.salary > 80000 limit 5; +--------+--------+--------------+---------+ | emp_no | salary | title | dept_no | +--------+--------+--------------+---------+ | 10017 | 82163 | Senior Staff | d001 | | 10017 | 86157 | Senior Staff | d001 | | 10017 | 89619 | Senior Staff | d001 | | 10017 | 91985 | Senior Staff | d001 | | 10017 | 96122 | Senior Staff | d001 | +--------+--------+--------------+---------+ 5 rows in set (0.00 sec) Display title-wise count of employees in each department order by dept_no mysql> select d.dept_no, t.title, count(*) from titles t left join dept_emp d using (emp_no) group by d.dept_no, t.title order by d.dept_no limit 10; +---------+--------------------+----------+ | dept_no | title | count(*) | +---------+--------------------+----------+ | d001 | Manager | 2 | | d001 | Senior Staff | 13940 | | d001 | Staff | 16196 | | d002 | Manager | 2 | | d002 | Senior Staff | 12139 | | d002 | Staff | 13929 | | d003 | Manager | 2 | | d003 | Senior Staff | 12274 | | d003 | Staff | 14342 | | d004 | Assistant Engineer | 6445 | +---------+--------------------+----------+ 10 rows in set (1.32 sec) SELECT - Subquery A subquery is generally a smaller resultset that can be used to power a select query in many ways. It can be used in a \u2018where\u2019 condition, can be used in place of join mostly where a join could be an overkill. These subqueries are also termed as derived tables. They must have a table alias in the select query. Let\u2019s look at some examples of subqueries. Here we got the department name from the departments table by a subquery which used dept_no from dept_emp table. mysql> select e.emp_no, (select dept_name from departments where dept_no=d.dept_no) dept_name from employees e join dept_emp d using (emp_no) limit 5; +--------+-----------------+ | emp_no | dept_name | +--------+-----------------+ | 10001 | Development | | 10002 | Sales | | 10003 | Production | | 10004 | Production | | 10005 | Human Resources | +--------+-----------------+ 5 rows in set (0.01 sec) Here, we used the \u2018avg\u2019 query above (which got the avg salary) as a subquery to list the employees whose latest salary is more than the average. mysql> select avg(salary) from salaries; +-------------+ | avg(salary) | +-------------+ | 63810.7448 | +-------------+ 1 row in set (0.80 sec) mysql> select e.emp_no, max(s.salary) from employees e natural join salaries s group by e.emp_no having max(s.salary) > (select avg(salary) from salaries) limit 10; +--------+---------------+ | emp_no | max(s.salary) | +--------+---------------+ | 10001 | 88958 | | 10002 | 72527 | | 10004 | 74057 | | 10005 | 94692 | | 10007 | 88070 | | 10009 | 94443 | | 10010 | 80324 | | 10013 | 68901 | | 10016 | 77935 | | 10017 | 99651 | +--------+---------------+ 10 rows in set (0.56 sec)","title":"Select Query"},{"location":"level101/databases_sql/select_query/#select-query","text":"The most commonly used command while working with MySQL is SELECT. It is used to fetch the result set from one or more tables. The general form of a typical select query looks like:- SELECT expr FROM table1 [WHERE condition] [GROUP BY column_list HAVING condition] [ORDER BY column_list ASC|DESC] [LIMIT #] The above general form contains some commonly used clauses of a SELECT query:- expr - comma-separated column list or * (for all columns) WHERE - a condition is provided, if true, directs the query to select only those records. GROUP BY - groups the entire result set based on the column list provided. An aggregate function is recommended to be present in the select expression of the query. HAVING supports grouping by putting a condition on the selected or any other aggregate function. ORDER BY - sorts the result set based on the column list in ascending or descending order. LIMIT - commonly used to limit the number of records. Let\u2019s have a look at some examples for a better understanding of the above. The dataset used for the examples below is available here and is free to use. Select all records mysql> select * from employees limit 5; +--------+------------+------------+-----------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-----------+--------+------------+ | 10001 | 1953-09-02 | Georgi | Facello | M | 1986-06-26 | | 10002 | 1964-06-02 | Bezalel | Simmel | F | 1985-11-21 | | 10003 | 1959-12-03 | Parto | Bamford | M | 1986-08-28 | | 10004 | 1954-05-01 | Chirstian | Koblick | M | 1986-12-01 | | 10005 | 1955-01-21 | Kyoichi | Maliniak | M | 1989-09-12 | +--------+------------+------------+-----------+--------+------------+ 5 rows in set (0.00 sec) Select specific fields for all records mysql> select first_name, last_name, gender from employees limit 5; +------------+-----------+--------+ | first_name | last_name | gender | +------------+-----------+--------+ | Georgi | Facello | M | | Bezalel | Simmel | F | | Parto | Bamford | M | | Chirstian | Koblick | M | | Kyoichi | Maliniak | M | +------------+-----------+--------+ 5 rows in set (0.00 sec) Select all records Where hire_date >= January 1, 1990 mysql> select * from employees where hire_date >= '1990-01-01' limit 5; +--------+------------+------------+-------------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-------------+--------+------------+ | 10008 | 1958-02-19 | Saniya | Kalloufi | M | 1994-09-15 | | 10011 | 1953-11-07 | Mary | Sluis | F | 1990-01-22 | | 10012 | 1960-10-04 | Patricio | Bridgland | M | 1992-12-18 | | 10016 | 1961-05-02 | Kazuhito | Cappelletti | M | 1995-01-27 | | 10017 | 1958-07-06 | Cristinel | Bouloucos | F | 1993-08-03 | +--------+------------+------------+-------------+--------+------------+ 5 rows in set (0.01 sec) Select first_name and last_name from all records Where birth_date >= 1960 AND gender = \u2018F\u2019 mysql> select first_name, last_name from employees where year(birth_date) >= 1960 and gender='F' limit 5; +------------+-----------+ | first_name | last_name | +------------+-----------+ | Bezalel | Simmel | | Duangkaew | Piveteau | | Divier | Reistad | | Jeong | Reistad | | Mingsen | Casley | +------------+-----------+ 5 rows in set (0.00 sec) Display the total number of records mysql> select count(*) from employees; +----------+ | count(*) | +----------+ | 300024 | +----------+ 1 row in set (0.05 sec) Display gender-wise count of all records mysql> select gender, count(*) from employees group by gender; +--------+----------+ | gender | count(*) | +--------+----------+ | M | 179973 | | F | 120051 | +--------+----------+ 2 rows in set (0.14 sec) Display the year of hire_date and number of employees hired that year, also only those years where more than 20k employees were hired mysql> select year(hire_date), count(*) from employees group by year(hire_date) having count(*) > 20000; +-----------------+----------+ | year(hire_date) | count(*) | +-----------------+----------+ | 1985 | 35316 | | 1986 | 36150 | | 1987 | 33501 | | 1988 | 31436 | | 1989 | 28394 | | 1990 | 25610 | | 1991 | 22568 | | 1992 | 20402 | +-----------------+----------+ 8 rows in set (0.14 sec) Display all records ordered by their hire_date in descending order. If hire_date is the same then in order of their birth_date ascending order mysql> select * from employees order by hire_date desc, birth_date asc limit 5; +--------+------------+------------+-----------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-----------+--------+------------+ | 463807 | 1964-06-12 | Bikash | Covnot | M | 2000-01-28 | | 428377 | 1957-05-09 | Yucai | Gerlach | M | 2000-01-23 | | 499553 | 1954-05-06 | Hideyuki | Delgrande | F | 2000-01-22 | | 222965 | 1959-08-07 | Volkmar | Perko | F | 2000-01-13 | | 47291 | 1960-09-09 | Ulf | Flexer | M | 2000-01-12 | +--------+------------+------------+-----------+--------+------------+ 5 rows in set (0.12 sec)","title":"SELECT Query"},{"location":"level101/databases_sql/select_query/#select-joins","text":"JOIN statement is used to produce a combined result set from two or more tables based on certain conditions. It can be also used with Update and Delete statements but we will be focussing on the select query. Following is a basic general form for joins SELECT table1.col1, table2.col1, ... (any combination) FROM table1 table2 ON (or USING depends on join_type) table1.column_for_joining = table2.column_for_joining WHERE \u2026 Any number of columns can be selected, but it is recommended to select only those which are relevant to increase the readability of the resultset. All other clauses like where, group by are not mandatory. Let\u2019s discuss the types of JOINs supported by MySQL Syntax. Inner Join This joins table A with table B on a condition. Only the records where the condition is True are selected in the resultset. Display some details of employees along with their salary mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e join salaries s on e.emp_no=s.emp_no limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Similar result can be achieved by mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e join salaries s using (emp_no) limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) And also by mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e natural join salaries s limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Outer Join Majorly of two types:- - LEFT - joining complete table A with table B on a condition. All the records from table A are selected, but from table B, only those records are selected where the condition is True. - RIGHT - Exact opposite of the left join. Let us assume the below tables for understanding left join better. mysql> select * from dummy1; +----------+------------+ | same_col | diff_col_1 | +----------+------------+ | 1 | A | | 2 | B | | 3 | C | +----------+------------+ mysql> select * from dummy2; +----------+------------+ | same_col | diff_col_2 | +----------+------------+ | 1 | X | | 3 | Y | +----------+------------+ A simple select join will look like the one below. mysql> select * from dummy1 d1 left join dummy2 d2 on d1.same_col=d2.same_col; +----------+------------+----------+------------+ | same_col | diff_col_1 | same_col | diff_col_2 | +----------+------------+----------+------------+ | 1 | A | 1 | X | | 3 | C | 3 | Y | | 2 | B | NULL | NULL | +----------+------------+----------+------------+ 3 rows in set (0.00 sec) Which can also be written as mysql> select * from dummy1 d1 left join dummy2 d2 using(same_col); +----------+------------+------------+ | same_col | diff_col_1 | diff_col_2 | +----------+------------+------------+ | 1 | A | X | | 3 | C | Y | | 2 | B | NULL | +----------+------------+------------+ 3 rows in set (0.00 sec) And also as mysql> select * from dummy1 d1 natural left join dummy2 d2; +----------+------------+------------+ | same_col | diff_col_1 | diff_col_2 | +----------+------------+------------+ | 1 | A | X | | 3 | C | Y | | 2 | B | NULL | +----------+------------+------------+ 3 rows in set (0.00 sec) Cross Join This does a cross product of table A and table B without any condition. It doesn\u2019t have a lot of applications in the real world. A Simple Cross Join looks like this mysql> select * from dummy1 cross join dummy2; +----------+------------+----------+------------+ | same_col | diff_col_1 | same_col | diff_col_2 | +----------+------------+----------+------------+ | 1 | A | 3 | Y | | 1 | A | 1 | X | | 2 | B | 3 | Y | | 2 | B | 1 | X | | 3 | C | 3 | Y | | 3 | C | 1 | X | +----------+------------+----------+------------+ 6 rows in set (0.01 sec) One use case that can come in handy is when you have to fill in some missing entries. For example, all the entries from dummy1 must be inserted into a similar table dummy3, with each record must have 3 entries with statuses 1, 5 and 7. mysql> desc dummy3; +----------+----------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +----------+----------+------+-----+---------+-------+ | same_col | int | YES | | NULL | | | value | char(15) | YES | | NULL | | | status | smallint | YES | | NULL | | +----------+----------+------+-----+---------+-------+ 3 rows in set (0.02 sec) Either you create an insert query script with as many entries as in dummy1 or use cross join to produce the required resultset. mysql> select * from dummy1 cross join (select 1 union select 5 union select 7) T2 order by same_col; +----------+------------+---+ | same_col | diff_col_1 | 1 | +----------+------------+---+ | 1 | A | 1 | | 1 | A | 5 | | 1 | A | 7 | | 2 | B | 1 | | 2 | B | 5 | | 2 | B | 7 | | 3 | C | 1 | | 3 | C | 5 | | 3 | C | 7 | +----------+------------+---+ 9 rows in set (0.00 sec) The T2 section in the above query is called a sub-query . We will discuss the same in the next section. Natural Join This implicitly selects the common column from table A and table B and performs an inner join. mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e natural join salaries s limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Notice how natural join and using takes care that the common column is displayed only once if you are not explicitly selecting columns for the query. Some More Examples Display emp_no, salary, title and dept of the employees where salary > 80000 mysql> select e.emp_no, s.salary, t.title, d.dept_no from employees e join salaries s using (emp_no) join titles t using (emp_no) join dept_emp d using (emp_no) where s.salary > 80000 limit 5; +--------+--------+--------------+---------+ | emp_no | salary | title | dept_no | +--------+--------+--------------+---------+ | 10017 | 82163 | Senior Staff | d001 | | 10017 | 86157 | Senior Staff | d001 | | 10017 | 89619 | Senior Staff | d001 | | 10017 | 91985 | Senior Staff | d001 | | 10017 | 96122 | Senior Staff | d001 | +--------+--------+--------------+---------+ 5 rows in set (0.00 sec) Display title-wise count of employees in each department order by dept_no mysql> select d.dept_no, t.title, count(*) from titles t left join dept_emp d using (emp_no) group by d.dept_no, t.title order by d.dept_no limit 10; +---------+--------------------+----------+ | dept_no | title | count(*) | +---------+--------------------+----------+ | d001 | Manager | 2 | | d001 | Senior Staff | 13940 | | d001 | Staff | 16196 | | d002 | Manager | 2 | | d002 | Senior Staff | 12139 | | d002 | Staff | 13929 | | d003 | Manager | 2 | | d003 | Senior Staff | 12274 | | d003 | Staff | 14342 | | d004 | Assistant Engineer | 6445 | +---------+--------------------+----------+ 10 rows in set (1.32 sec)","title":"SELECT - JOINS"},{"location":"level101/databases_sql/select_query/#select-subquery","text":"A subquery is generally a smaller resultset that can be used to power a select query in many ways. It can be used in a \u2018where\u2019 condition, can be used in place of join mostly where a join could be an overkill. These subqueries are also termed as derived tables. They must have a table alias in the select query. Let\u2019s look at some examples of subqueries. Here we got the department name from the departments table by a subquery which used dept_no from dept_emp table. mysql> select e.emp_no, (select dept_name from departments where dept_no=d.dept_no) dept_name from employees e join dept_emp d using (emp_no) limit 5; +--------+-----------------+ | emp_no | dept_name | +--------+-----------------+ | 10001 | Development | | 10002 | Sales | | 10003 | Production | | 10004 | Production | | 10005 | Human Resources | +--------+-----------------+ 5 rows in set (0.01 sec) Here, we used the \u2018avg\u2019 query above (which got the avg salary) as a subquery to list the employees whose latest salary is more than the average. mysql> select avg(salary) from salaries; +-------------+ | avg(salary) | +-------------+ | 63810.7448 | +-------------+ 1 row in set (0.80 sec) mysql> select e.emp_no, max(s.salary) from employees e natural join salaries s group by e.emp_no having max(s.salary) > (select avg(salary) from salaries) limit 10; +--------+---------------+ | emp_no | max(s.salary) | +--------+---------------+ | 10001 | 88958 | | 10002 | 72527 | | 10004 | 74057 | | 10005 | 94692 | | 10007 | 88070 | | 10009 | 94443 | | 10010 | 80324 | | 10013 | 68901 | | 10016 | 77935 | | 10017 | 99651 | +--------+---------------+ 10 rows in set (0.56 sec)","title":"SELECT - Subquery"},{"location":"level101/git/branches/","text":"Working With Branches Coming back to our local repo which has two commits. So far, what we have is a single line of history. Commits are chained in a single line. But sometimes you may have a need to work on two different features in parallel in the same repo. Now one option here could be making a new folder/repo with the same code and use that for another feature development. But there's a better way. Use branches. Since git follows tree like structure for commits, we can use branches to work on different sets of features. From a commit, two or more branches can be created and branches can also be merged. Using branches, there can exist multiple lines of histories and we can checkout to any of them and work on it. Checking out, as we discussed earlier, would simply mean replacing contents of the directory (repo) with the snapshot at the checked out version. Let's create a branch and see how it looks like: $ git branch b1 $ git log --oneline --graph * 7f3b00e (HEAD -> master, b1) adding file 2 * df2fb7a adding file 1 We create a branch called b1 . Git log tells us that b1 also points to the last commit (7f3b00e) but the HEAD is still pointing to master. If you remember, HEAD points to the commit/reference wherever you are checkout to. So if we checkout to b1 , HEAD should point to that. Let's confirm: $ git checkout b1 Switched to branch 'b1' $ git log --oneline --graph * 7f3b00e (HEAD -> b1, master) adding file 2 * df2fb7a adding file 1 b1 still points to the same commit but HEAD now points to b1 . Since we create a branch at commit 7f3b00e , there will be two lines of histories starting this commit. Depending on which branch you are checked out on, the line of history will progress. At this moment, we are checked out on branch b1 , so making a new commit will advance branch reference b1 to that commit and current b1 commit will become its parent. Let's do that. # Creating a file and making a commit $ echo \"I am a file in b1 branch\" > b1.txt $ git add b1.txt $ git commit -m \"adding b1 file\" [b1 872a38f] adding b1 file 1 file changed, 1 insertion(+) create mode 100644 b1.txt # The new line of history $ git log --oneline --graph * 872a38f (HEAD -> b1) adding b1 file * 7f3b00e (master) adding file 2 * df2fb7a adding file 1 $ Do note that master is still pointing to the old commit it was pointing to. We can now checkout to master branch and make commits there. This will result in another line of history starting from commit 7f3b00e. # checkout to master branch $ git checkout master Switched to branch 'master' # Creating a new commit on master branch $ echo \"new file in master branch\" > master.txt $ git add master.txt $ git commit -m \"adding master.txt file\" [master 60dc441] adding master.txt file 1 file changed, 1 insertion(+) create mode 100644 master.txt # The history line $ git log --oneline --graph * 60dc441 (HEAD -> master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 Notice how branch b1 is not visible here since we are on the master. Let's try to visualize both to get the whole picture: $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Above tree structure should make things clear. Notice a clear branch/fork on commit 7f3b00e. This is how we create branches. Now they both are two separate lines of history on which feature development can be done independently. To reiterate, internally, git is just a tree of commits. Branch names (human readable) are pointers to those commits in the tree. We use various git commands to work with the tree structure and references. Git accordingly modifies contents of our repo. Merges Now say the feature you were working on branch b1 is complete and you need to merge it on master branch, where all the final version of code goes. So first you will checkout to branch master and then you pull the latest code from upstream (eg: GitHub). Then you need to merge your code from b1 into master. There could be two ways this can be done. Here is the current history: $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Option 1: Directly merge the branch. Merging the branch b1 into master will result in a new merge commit. This will merge changes from two different lines of history and create a new commit of the result. $ git merge b1 Merge made by the 'recursive' strategy. b1.txt | 1 + 1 file changed, 1 insertion(+) create mode 100644 b1.txt $ git log --oneline --graph --all * 8fc28f9 (HEAD -> master) Merge branch 'b1' |\\ | * 872a38f (b1) adding b1 file * | 60dc441 adding master.txt file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 You can see a new merge commit created (8fc28f9). You will be prompted for the commit message. If there are a lot of branches in the repo, this result will end-up with a lot of merge commits. Which looks ugly compared to a single line of history of development. So let's look at an alternative approach First let's reset our last merge and go to the previous state. $ git reset --hard 60dc441 HEAD is now at 60dc441 adding master.txt file $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Option 2: Rebase. Now, instead of merging two branches which has a similar base (commit: 7f3b00e), let us rebase branch b1 on to current master. What this means is take branch b1 (from commit 7f3b00e to commit 872a38f) and rebase (put them on top of) master (60dc441). # Switch to b1 $ git checkout b1 Switched to branch 'b1' # Rebase (b1 which is current branch) on master $ git rebase master First, rewinding head to replay your work on top of it... Applying: adding b1 file # The result $ git log --oneline --graph --all * 5372c8f (HEAD -> b1) adding b1 file * 60dc441 (master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 You can see b1 which had 1 commit. That commit's parent was 7f3b00e . But since we rebase it on master ( 60dc441 ). That becomes the parent now. As a side effect, you also see it has become a single line of history. Now if we were to merge b1 into master , it would simply mean change master to point to 5372c8f which is b1 . Let's try it: # checkout to master since we want to merge code into master $ git checkout master Switched to branch 'master' # the current history, where b1 is based on master $ git log --oneline --graph --all * 5372c8f (b1) adding b1 file * 60dc441 (HEAD -> master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 # Performing the merge, notice the \"fast-forward\" message $ git merge b1 Updating 60dc441..5372c8f Fast-forward b1.txt | 1 + 1 file changed, 1 insertion(+) create mode 100644 b1.txt # The Result $ git log --oneline --graph --all * 5372c8f (HEAD -> master, b1) adding b1 file * 60dc441 adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 Now you see both b1 and master are pointing to the same commit. Your code has been merged to the master branch and it can be pushed. Also we have clean line of history! :D","title":"Working With Branches"},{"location":"level101/git/branches/#working-with-branches","text":"Coming back to our local repo which has two commits. So far, what we have is a single line of history. Commits are chained in a single line. But sometimes you may have a need to work on two different features in parallel in the same repo. Now one option here could be making a new folder/repo with the same code and use that for another feature development. But there's a better way. Use branches. Since git follows tree like structure for commits, we can use branches to work on different sets of features. From a commit, two or more branches can be created and branches can also be merged. Using branches, there can exist multiple lines of histories and we can checkout to any of them and work on it. Checking out, as we discussed earlier, would simply mean replacing contents of the directory (repo) with the snapshot at the checked out version. Let's create a branch and see how it looks like: $ git branch b1 $ git log --oneline --graph * 7f3b00e (HEAD -> master, b1) adding file 2 * df2fb7a adding file 1 We create a branch called b1 . Git log tells us that b1 also points to the last commit (7f3b00e) but the HEAD is still pointing to master. If you remember, HEAD points to the commit/reference wherever you are checkout to. So if we checkout to b1 , HEAD should point to that. Let's confirm: $ git checkout b1 Switched to branch 'b1' $ git log --oneline --graph * 7f3b00e (HEAD -> b1, master) adding file 2 * df2fb7a adding file 1 b1 still points to the same commit but HEAD now points to b1 . Since we create a branch at commit 7f3b00e , there will be two lines of histories starting this commit. Depending on which branch you are checked out on, the line of history will progress. At this moment, we are checked out on branch b1 , so making a new commit will advance branch reference b1 to that commit and current b1 commit will become its parent. Let's do that. # Creating a file and making a commit $ echo \"I am a file in b1 branch\" > b1.txt $ git add b1.txt $ git commit -m \"adding b1 file\" [b1 872a38f] adding b1 file 1 file changed, 1 insertion(+) create mode 100644 b1.txt # The new line of history $ git log --oneline --graph * 872a38f (HEAD -> b1) adding b1 file * 7f3b00e (master) adding file 2 * df2fb7a adding file 1 $ Do note that master is still pointing to the old commit it was pointing to. We can now checkout to master branch and make commits there. This will result in another line of history starting from commit 7f3b00e. # checkout to master branch $ git checkout master Switched to branch 'master' # Creating a new commit on master branch $ echo \"new file in master branch\" > master.txt $ git add master.txt $ git commit -m \"adding master.txt file\" [master 60dc441] adding master.txt file 1 file changed, 1 insertion(+) create mode 100644 master.txt # The history line $ git log --oneline --graph * 60dc441 (HEAD -> master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 Notice how branch b1 is not visible here since we are on the master. Let's try to visualize both to get the whole picture: $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Above tree structure should make things clear. Notice a clear branch/fork on commit 7f3b00e. This is how we create branches. Now they both are two separate lines of history on which feature development can be done independently. To reiterate, internally, git is just a tree of commits. Branch names (human readable) are pointers to those commits in the tree. We use various git commands to work with the tree structure and references. Git accordingly modifies contents of our repo.","title":"Working With Branches"},{"location":"level101/git/branches/#merges","text":"Now say the feature you were working on branch b1 is complete and you need to merge it on master branch, where all the final version of code goes. So first you will checkout to branch master and then you pull the latest code from upstream (eg: GitHub). Then you need to merge your code from b1 into master. There could be two ways this can be done. Here is the current history: $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Option 1: Directly merge the branch. Merging the branch b1 into master will result in a new merge commit. This will merge changes from two different lines of history and create a new commit of the result. $ git merge b1 Merge made by the 'recursive' strategy. b1.txt | 1 + 1 file changed, 1 insertion(+) create mode 100644 b1.txt $ git log --oneline --graph --all * 8fc28f9 (HEAD -> master) Merge branch 'b1' |\\ | * 872a38f (b1) adding b1 file * | 60dc441 adding master.txt file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 You can see a new merge commit created (8fc28f9). You will be prompted for the commit message. If there are a lot of branches in the repo, this result will end-up with a lot of merge commits. Which looks ugly compared to a single line of history of development. So let's look at an alternative approach First let's reset our last merge and go to the previous state. $ git reset --hard 60dc441 HEAD is now at 60dc441 adding master.txt file $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Option 2: Rebase. Now, instead of merging two branches which has a similar base (commit: 7f3b00e), let us rebase branch b1 on to current master. What this means is take branch b1 (from commit 7f3b00e to commit 872a38f) and rebase (put them on top of) master (60dc441). # Switch to b1 $ git checkout b1 Switched to branch 'b1' # Rebase (b1 which is current branch) on master $ git rebase master First, rewinding head to replay your work on top of it... Applying: adding b1 file # The result $ git log --oneline --graph --all * 5372c8f (HEAD -> b1) adding b1 file * 60dc441 (master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 You can see b1 which had 1 commit. That commit's parent was 7f3b00e . But since we rebase it on master ( 60dc441 ). That becomes the parent now. As a side effect, you also see it has become a single line of history. Now if we were to merge b1 into master , it would simply mean change master to point to 5372c8f which is b1 . Let's try it: # checkout to master since we want to merge code into master $ git checkout master Switched to branch 'master' # the current history, where b1 is based on master $ git log --oneline --graph --all * 5372c8f (b1) adding b1 file * 60dc441 (HEAD -> master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 # Performing the merge, notice the \"fast-forward\" message $ git merge b1 Updating 60dc441..5372c8f Fast-forward b1.txt | 1 + 1 file changed, 1 insertion(+) create mode 100644 b1.txt # The Result $ git log --oneline --graph --all * 5372c8f (HEAD -> master, b1) adding b1 file * 60dc441 adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 Now you see both b1 and master are pointing to the same commit. Your code has been merged to the master branch and it can be pushed. Also we have clean line of history! :D","title":"Merges"},{"location":"level101/git/conclusion/","text":"What next from here? There are a lot of git commands and features which we have not explored here. But with the base built-up, be sure to explore concepts like Cherrypick Squash Amend Stash Reset","title":"Conclusion"},{"location":"level101/git/conclusion/#what-next-from-here","text":"There are a lot of git commands and features which we have not explored here. But with the base built-up, be sure to explore concepts like Cherrypick Squash Amend Stash Reset","title":"What next from here?"},{"location":"level101/git/git-basics/","text":"Git Prerequisites Have Git installed https://git-scm.com/downloads Have taken any git high level tutorial or following LinkedIn learning courses https://www.linkedin.com/learning/git-essential-training-the-basics/ https://www.linkedin.com/learning/git-branches-merges-and-remotes/ The Official Git Docs What to expect from this course As an engineer in the field of computer science, having knowledge of version control tools becomes almost a requirement. While there are a lot of version control tools that exist today like SVN, Mercurial, etc, Git perhaps is the most used one and this course we will be working with Git. While this course does not start with Git 101 and expects basic knowledge of git as a prerequisite, it will reintroduce the git concepts known by you with details covering what is happening under the hood as you execute various git commands. So that next time you run a git command, you will be able to press enter more confidently! What is not covered under this course Advanced usage and specifics of internal implementation details of Git. Course Contents Git Basics Working with Branches Git with Github Hooks Git Basics Though you might be aware already, let's revisit why we need a version control system. As the project grows and multiple developers start working on it, an efficient method for collaboration is warranted. Git helps the team collaborate easily and also maintains the history of the changes happening with the codebase. Creating a Git Repo Any folder can be converted into a git repository. After executing the following command, we will see a .git folder within the folder, which makes our folder a git repository. All the magic that git does, .git folder is the enabler for the same. # creating an empty folder and changing current dir to it $ cd /tmp $ mkdir school-of-sre $ cd school-of-sre/ # initialize a git repo $ git init Initialized empty Git repository in /private/tmp/school-of-sre/.git/ As the output says, an empty git repo has been initialized in our folder. Let's take a look at what is there. $ ls .git/ HEAD config description hooks info objects refs There are a bunch of folders and files in the .git folder. As I said, all these enables git to do its magic. We will look into some of these folders and files. But for now, what we have is an empty git repository. Tracking a File Now as you might already know, let us create a new file in our repo (we will refer to the folder as repo now.) And see git status $ echo \"I am file 1\" > file1.txt $ git status On branch master No commits yet Untracked files: (use \"git add ...\" to include in what will be committed) file1.txt nothing added to commit but untracked files present (use \"git add\" to track) The current git status says No commits yet and there is one untracked file. Since we just created the file, git is not tracking that file. We explicitly need to ask git to track files and folders. (also checkout gitignore ) And how we do that is via git add command as suggested in the above output. Then we go ahead and create a commit. $ git add file1.txt $ git status On branch master No commits yet Changes to be committed: (use \"git rm --cached ...\" to unstage) new file: file1.txt $ git commit -m \"adding file 1\" [master (root-commit) df2fb7a] adding file 1 1 file changed, 1 insertion(+) create mode 100644 file1.txt Notice how after adding the file, git status says Changes to be committed: . What it means is whatever is listed there, will be included in the next commit. Then we go ahead and create a commit, with an attached messaged via -m . More About a Commit Commit is a snapshot of the repo. Whenever a commit is made, a snapshot of the current state of repo (the folder) is taken and saved. Each commit has a unique ID. ( df2fb7a for the commit we made in the previous step). As we keep adding/changing more and more contents and keep making commits, all those snapshots are stored by git. Again, all this magic happens inside the .git folder. This is where all this snapshot or versions are stored in an efficient manner. Adding More Changes Let us create one more file and commit the change. It would look the same as the previous commit we made. $ echo \"I am file 2\" > file2.txt $ git add file2.txt $ git commit -m \"adding file 2\" [master 7f3b00e] adding file 2 1 file changed, 1 insertion(+) create mode 100644 file2.txt A new commit with ID 7f3b00e has been created. You can issue git status at any time to see the state of the repository. **IMPORTANT: Note that commit IDs are long string (SHA) but we can refer to a commit by its initial few (8 or more) characters too. We will interchangeably using shorter and longer commit IDs.** Now that we have two commits, let's visualize them: $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 git log , as the name suggests, prints the log of all the git commits. Here you see two additional arguments, --oneline prints the shorter version of the log, ie: the commit message only and not the person who made the commit and when. --graph prints it in graph format. Now at this moment the commits might look like just one in each line but all commits are stored as a tree like data structure internally by git. That means there can be two or more children commits of a given commit. And not just a single line of commits. We will look more into this part when we get to the Branches section. For now this is our commit history: df2fb7a ===> 7f3b00e Are commits really linked? As I just said, the two commits we just made are linked via tree like data structure and we saw how they are linked. But let's actually verify it. Everything in git is an object. Newly created files are stored as an object. Changes to file are stored as an objects and even commits are objects. To view contents of an object we can use the following command with the object's ID. We will take a look at the contents of the second commit $ git cat-file -p 7f3b00e tree ebf3af44d253e5328340026e45a9fa9ae3ea1982 parent df2fb7a61f5d40c1191e0fdeb0fc5d6e7969685a author Sanket Patel 1603273316 -0700 committer Sanket Patel 1603273316 -0700 adding file 2 Take a note of parent attribute in the above output. It points to the commit id of the first commit we made. So this proves that they are linked! Additionally you can see the second commit's message in this object. As I said all this magic is enabled by .git folder and the object to which we are looking at also is in that folder. $ ls .git/objects/7f/3b00eaa957815884198e2fdfec29361108d6a9 .git/objects/7f/3b00eaa957815884198e2fdfec29361108d6a9 It is stored in .git/objects/ folder. All the files and changes to them as well are stored in this folder. The Version Control part of Git We already can see two commits (versions) in our git log. One thing a version control tool gives you is ability to browse back and forth in history. For example: some of your users are running an old version of code and they are reporting an issue. In order to debug the issue, you need access to the old code. The one in your current repo is the latest code. In this example, you are working on the second commit (7f3b00e) and someone reported an issue with the code snapshot at commit (df2fb7a). This is how you would get access to the code at any older commit # Current contents, two files present $ ls file1.txt file2.txt # checking out to (an older) commit $ git checkout df2fb7a Note: checking out 'df2fb7a'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by performing another checkout. If you want to create a new branch to retain commits you create, you may do so (now or later) by using -b with the checkout command again. Example: git checkout -b HEAD is now at df2fb7a adding file 1 # checking contents, can verify it has old contents $ ls file1.txt So this is how we would get access to old versions/snapshots. All we need is a reference to that snapshot. Upon executing git checkout ... , what git does for you is use the .git folder, see what was the state of things (files and folders) at that version/reference and replace the contents of current directory with those contents. The then-existing content will no longer be present in the local dir (repo) but we can and will still get access to them because they are tracked via git commit and .git folder has them stored/tracked. Reference I mention in the previous section that we need a reference to the version. By default, git repo is made of tree of commits. And each commit has a unique IDs. But the unique ID is not the only thing we can reference commits via. There are multiple ways to reference commits. For example: HEAD is a reference to current commit. Whatever commit your repo is checked out at, HEAD will point to that. HEAD~1 is reference to previous commit. So while checking out previous version in section above, we could have done git checkout HEAD~1 . Similarly, master is also a reference (to a branch). Since git uses tree like structure to store commits, there of course will be branches. And the default branch is called master . Master (or any branch reference) will point to the latest commit in the branch. Even though we have checked out to the previous commit in out repo, master still points to the latest commit. And we can get back to the latest version by checkout at master reference $ git checkout master Previous HEAD position was df2fb7a adding file 1 Switched to branch 'master' # now we will see latest code, with two files $ ls file1.txt file2.txt Note, instead of master in above command, we could have used commit's ID as well. References and The Magic Let's look at the state of things. Two commits, master and HEAD references are pointing to the latest commit $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 The magic? Let's examine these files: $ cat .git/refs/heads/master 7f3b00eaa957815884198e2fdfec29361108d6a9 Viola! Where master is pointing to is stored in a file. Whenever git needs to know where master reference is pointing to, or if git needs to update where master points, it just needs to update the file above. So when you create a new commit, a new commit is created on top of the current commit and the master file is updated with the new commit's ID. Similary, for HEAD reference: $ cat .git/HEAD ref: refs/heads/master We can see HEAD is pointing to a reference called refs/heads/master . So HEAD will point where ever the master points. Little Adventure We discussed how git will update the files as we execute commands. But let's try to do it ourselves, by hand, and see what happens. $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 Now let's change master to point to the previous/first commit. $ echo df2fb7a61f5d40c1191e0fdeb0fc5d6e7969685a > .git/refs/heads/master $ git log --oneline --graph * df2fb7a (HEAD -> master) adding file 1 # RESETTING TO ORIGINAL $ echo 7f3b00eaa957815884198e2fdfec29361108d6a9 > .git/refs/heads/master $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 We just edited the master reference file and now we can see only the first commit in git log. Undoing the change to the file brings the state back to original. Not so much of magic, is it?","title":"Git Basics"},{"location":"level101/git/git-basics/#git","text":"","title":"Git"},{"location":"level101/git/git-basics/#prerequisites","text":"Have Git installed https://git-scm.com/downloads Have taken any git high level tutorial or following LinkedIn learning courses https://www.linkedin.com/learning/git-essential-training-the-basics/ https://www.linkedin.com/learning/git-branches-merges-and-remotes/ The Official Git Docs","title":"Prerequisites"},{"location":"level101/git/git-basics/#what-to-expect-from-this-course","text":"As an engineer in the field of computer science, having knowledge of version control tools becomes almost a requirement. While there are a lot of version control tools that exist today like SVN, Mercurial, etc, Git perhaps is the most used one and this course we will be working with Git. While this course does not start with Git 101 and expects basic knowledge of git as a prerequisite, it will reintroduce the git concepts known by you with details covering what is happening under the hood as you execute various git commands. So that next time you run a git command, you will be able to press enter more confidently!","title":"What to expect from this course"},{"location":"level101/git/git-basics/#what-is-not-covered-under-this-course","text":"Advanced usage and specifics of internal implementation details of Git.","title":"What is not covered under this course"},{"location":"level101/git/git-basics/#course-contents","text":"Git Basics Working with Branches Git with Github Hooks","title":"Course Contents"},{"location":"level101/git/git-basics/#git-basics","text":"Though you might be aware already, let's revisit why we need a version control system. As the project grows and multiple developers start working on it, an efficient method for collaboration is warranted. Git helps the team collaborate easily and also maintains the history of the changes happening with the codebase.","title":"Git Basics"},{"location":"level101/git/git-basics/#creating-a-git-repo","text":"Any folder can be converted into a git repository. After executing the following command, we will see a .git folder within the folder, which makes our folder a git repository. All the magic that git does, .git folder is the enabler for the same. # creating an empty folder and changing current dir to it $ cd /tmp $ mkdir school-of-sre $ cd school-of-sre/ # initialize a git repo $ git init Initialized empty Git repository in /private/tmp/school-of-sre/.git/ As the output says, an empty git repo has been initialized in our folder. Let's take a look at what is there. $ ls .git/ HEAD config description hooks info objects refs There are a bunch of folders and files in the .git folder. As I said, all these enables git to do its magic. We will look into some of these folders and files. But for now, what we have is an empty git repository.","title":"Creating a Git Repo"},{"location":"level101/git/git-basics/#tracking-a-file","text":"Now as you might already know, let us create a new file in our repo (we will refer to the folder as repo now.) And see git status $ echo \"I am file 1\" > file1.txt $ git status On branch master No commits yet Untracked files: (use \"git add ...\" to include in what will be committed) file1.txt nothing added to commit but untracked files present (use \"git add\" to track) The current git status says No commits yet and there is one untracked file. Since we just created the file, git is not tracking that file. We explicitly need to ask git to track files and folders. (also checkout gitignore ) And how we do that is via git add command as suggested in the above output. Then we go ahead and create a commit. $ git add file1.txt $ git status On branch master No commits yet Changes to be committed: (use \"git rm --cached ...\" to unstage) new file: file1.txt $ git commit -m \"adding file 1\" [master (root-commit) df2fb7a] adding file 1 1 file changed, 1 insertion(+) create mode 100644 file1.txt Notice how after adding the file, git status says Changes to be committed: . What it means is whatever is listed there, will be included in the next commit. Then we go ahead and create a commit, with an attached messaged via -m .","title":"Tracking a File"},{"location":"level101/git/git-basics/#more-about-a-commit","text":"Commit is a snapshot of the repo. Whenever a commit is made, a snapshot of the current state of repo (the folder) is taken and saved. Each commit has a unique ID. ( df2fb7a for the commit we made in the previous step). As we keep adding/changing more and more contents and keep making commits, all those snapshots are stored by git. Again, all this magic happens inside the .git folder. This is where all this snapshot or versions are stored in an efficient manner.","title":"More About a Commit"},{"location":"level101/git/git-basics/#adding-more-changes","text":"Let us create one more file and commit the change. It would look the same as the previous commit we made. $ echo \"I am file 2\" > file2.txt $ git add file2.txt $ git commit -m \"adding file 2\" [master 7f3b00e] adding file 2 1 file changed, 1 insertion(+) create mode 100644 file2.txt A new commit with ID 7f3b00e has been created. You can issue git status at any time to see the state of the repository. **IMPORTANT: Note that commit IDs are long string (SHA) but we can refer to a commit by its initial few (8 or more) characters too. We will interchangeably using shorter and longer commit IDs.** Now that we have two commits, let's visualize them: $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 git log , as the name suggests, prints the log of all the git commits. Here you see two additional arguments, --oneline prints the shorter version of the log, ie: the commit message only and not the person who made the commit and when. --graph prints it in graph format. Now at this moment the commits might look like just one in each line but all commits are stored as a tree like data structure internally by git. That means there can be two or more children commits of a given commit. And not just a single line of commits. We will look more into this part when we get to the Branches section. For now this is our commit history: df2fb7a ===> 7f3b00e","title":"Adding More Changes"},{"location":"level101/git/git-basics/#are-commits-really-linked","text":"As I just said, the two commits we just made are linked via tree like data structure and we saw how they are linked. But let's actually verify it. Everything in git is an object. Newly created files are stored as an object. Changes to file are stored as an objects and even commits are objects. To view contents of an object we can use the following command with the object's ID. We will take a look at the contents of the second commit $ git cat-file -p 7f3b00e tree ebf3af44d253e5328340026e45a9fa9ae3ea1982 parent df2fb7a61f5d40c1191e0fdeb0fc5d6e7969685a author Sanket Patel 1603273316 -0700 committer Sanket Patel 1603273316 -0700 adding file 2 Take a note of parent attribute in the above output. It points to the commit id of the first commit we made. So this proves that they are linked! Additionally you can see the second commit's message in this object. As I said all this magic is enabled by .git folder and the object to which we are looking at also is in that folder. $ ls .git/objects/7f/3b00eaa957815884198e2fdfec29361108d6a9 .git/objects/7f/3b00eaa957815884198e2fdfec29361108d6a9 It is stored in .git/objects/ folder. All the files and changes to them as well are stored in this folder.","title":"Are commits really linked?"},{"location":"level101/git/git-basics/#the-version-control-part-of-git","text":"We already can see two commits (versions) in our git log. One thing a version control tool gives you is ability to browse back and forth in history. For example: some of your users are running an old version of code and they are reporting an issue. In order to debug the issue, you need access to the old code. The one in your current repo is the latest code. In this example, you are working on the second commit (7f3b00e) and someone reported an issue with the code snapshot at commit (df2fb7a). This is how you would get access to the code at any older commit # Current contents, two files present $ ls file1.txt file2.txt # checking out to (an older) commit $ git checkout df2fb7a Note: checking out 'df2fb7a'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by performing another checkout. If you want to create a new branch to retain commits you create, you may do so (now or later) by using -b with the checkout command again. Example: git checkout -b HEAD is now at df2fb7a adding file 1 # checking contents, can verify it has old contents $ ls file1.txt So this is how we would get access to old versions/snapshots. All we need is a reference to that snapshot. Upon executing git checkout ... , what git does for you is use the .git folder, see what was the state of things (files and folders) at that version/reference and replace the contents of current directory with those contents. The then-existing content will no longer be present in the local dir (repo) but we can and will still get access to them because they are tracked via git commit and .git folder has them stored/tracked.","title":"The Version Control part of Git"},{"location":"level101/git/git-basics/#reference","text":"I mention in the previous section that we need a reference to the version. By default, git repo is made of tree of commits. And each commit has a unique IDs. But the unique ID is not the only thing we can reference commits via. There are multiple ways to reference commits. For example: HEAD is a reference to current commit. Whatever commit your repo is checked out at, HEAD will point to that. HEAD~1 is reference to previous commit. So while checking out previous version in section above, we could have done git checkout HEAD~1 . Similarly, master is also a reference (to a branch). Since git uses tree like structure to store commits, there of course will be branches. And the default branch is called master . Master (or any branch reference) will point to the latest commit in the branch. Even though we have checked out to the previous commit in out repo, master still points to the latest commit. And we can get back to the latest version by checkout at master reference $ git checkout master Previous HEAD position was df2fb7a adding file 1 Switched to branch 'master' # now we will see latest code, with two files $ ls file1.txt file2.txt Note, instead of master in above command, we could have used commit's ID as well.","title":"Reference"},{"location":"level101/git/git-basics/#references-and-the-magic","text":"Let's look at the state of things. Two commits, master and HEAD references are pointing to the latest commit $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 The magic? Let's examine these files: $ cat .git/refs/heads/master 7f3b00eaa957815884198e2fdfec29361108d6a9 Viola! Where master is pointing to is stored in a file. Whenever git needs to know where master reference is pointing to, or if git needs to update where master points, it just needs to update the file above. So when you create a new commit, a new commit is created on top of the current commit and the master file is updated with the new commit's ID. Similary, for HEAD reference: $ cat .git/HEAD ref: refs/heads/master We can see HEAD is pointing to a reference called refs/heads/master . So HEAD will point where ever the master points.","title":"References and The Magic"},{"location":"level101/git/git-basics/#little-adventure","text":"We discussed how git will update the files as we execute commands. But let's try to do it ourselves, by hand, and see what happens. $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 Now let's change master to point to the previous/first commit. $ echo df2fb7a61f5d40c1191e0fdeb0fc5d6e7969685a > .git/refs/heads/master $ git log --oneline --graph * df2fb7a (HEAD -> master) adding file 1 # RESETTING TO ORIGINAL $ echo 7f3b00eaa957815884198e2fdfec29361108d6a9 > .git/refs/heads/master $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 We just edited the master reference file and now we can see only the first commit in git log. Undoing the change to the file brings the state back to original. Not so much of magic, is it?","title":"Little Adventure"},{"location":"level101/git/github-hooks/","text":"Git with Github Till now all the operations we did were in our local repo while git also helps us in a collaborative environment. GitHub is one place on the internet where you can centrally host your git repos and collaborate with other developers. Most of the workflow will remain the same as we discussed, with addition of couple of things: Pull: to pull latest changes from github (the central) repo Push: to push your changes to github repo so that it's available to all people GitHub has written nice guides and tutorials about this and you can refer them here: GitHub Hello World Git Handbook Hooks Git has another nice feature called hooks. Hooks are basically scripts which will be called when a certain event happens. Here is where hooks are located: $ ls .git/hooks/ applypatch-msg.sample fsmonitor-watchman.sample pre-applypatch.sample pre-push.sample pre-receive.sample update.sample commit-msg.sample post-update.sample pre-commit.sample pre-rebase.sample prepare-commit-msg.sample Names are self explanatory. These hooks are useful when you want to do certain things when a certain event happens. If you want to run tests before pushing code, you would want to setup pre-push hooks. Let's try to create a pre commit hook. $ echo \"echo this is from pre commit hook\" > .git/hooks/pre-commit $ chmod +x .git/hooks/pre-commit We basically create a file called pre-commit in hooks folder and make it executable. Now if we make a commit, we should see the message getting printed. $ echo \"sample file\" > sample.txt $ git add sample.txt $ git commit -m \"adding sample file\" this is from pre commit hook # <===== THE MESSAGE FROM HOOK EXECUTION [master 9894e05] adding sample file 1 file changed, 1 insertion(+) create mode 100644 sample.txt","title":"Github and Hooks"},{"location":"level101/git/github-hooks/#git-with-github","text":"Till now all the operations we did were in our local repo while git also helps us in a collaborative environment. GitHub is one place on the internet where you can centrally host your git repos and collaborate with other developers. Most of the workflow will remain the same as we discussed, with addition of couple of things: Pull: to pull latest changes from github (the central) repo Push: to push your changes to github repo so that it's available to all people GitHub has written nice guides and tutorials about this and you can refer them here: GitHub Hello World Git Handbook","title":"Git with Github"},{"location":"level101/git/github-hooks/#hooks","text":"Git has another nice feature called hooks. Hooks are basically scripts which will be called when a certain event happens. Here is where hooks are located: $ ls .git/hooks/ applypatch-msg.sample fsmonitor-watchman.sample pre-applypatch.sample pre-push.sample pre-receive.sample update.sample commit-msg.sample post-update.sample pre-commit.sample pre-rebase.sample prepare-commit-msg.sample Names are self explanatory. These hooks are useful when you want to do certain things when a certain event happens. If you want to run tests before pushing code, you would want to setup pre-push hooks. Let's try to create a pre commit hook. $ echo \"echo this is from pre commit hook\" > .git/hooks/pre-commit $ chmod +x .git/hooks/pre-commit We basically create a file called pre-commit in hooks folder and make it executable. Now if we make a commit, we should see the message getting printed. $ echo \"sample file\" > sample.txt $ git add sample.txt $ git commit -m \"adding sample file\" this is from pre commit hook # <===== THE MESSAGE FROM HOOK EXECUTION [master 9894e05] adding sample file 1 file changed, 1 insertion(+) create mode 100644 sample.txt","title":"Hooks"},{"location":"level101/linux_basics/command_line_basics/","text":"Command Line Basics Lab Environment Setup One can use an online bash interpreter to run all the commands that are provided as examples in this course. This will also help you in getting a hands-on experience of various linux commands. REPL is one of the popular online bash interpreters for running linux commands. We will be using it for running all the commands mentioned in this course. What is a Command A command is a program that tells the operating system to perform specific work. Programs are stored as files in linux. Therefore, a command is also a file which is stored somewhere on the disk. Commands may also take additional arguments as input from the user. These arguments are called command line arguments. Knowing how to use the commands is important and there are many ways to get help in Linux, especially for commands. Almost every command will have some form of documentation, most commands will have a command-line argument -h or --help that will display a reasonable amount of documentation. But the most popular documentation system in Linux is called man pages - short for manual pages. Using --help to show the documentation for ls command. File System Organization The linux file system has a hierarchical (or tree-like) structure with its highest level directory called root ( denoted by / ). Directories present inside the root directory stores file related to the system. These directories in turn can either store system files or application files or user related files. bin | The executable program of most commonly used commands reside in bin directory sbin | This directory contains programs used for system administration. home | This directory contains user related files and directories. lib | This directory contains all the library files etc | This directory contains all the system configuration files proc | This directory contains files related to the running processes on the system dev | This directory contains files related to devices on the system mnt | This directory contains files related to mounted devices on the system tmp | This directory is used to store temporary files on the system usr | This directory is used to store application programs on the system Commands for Navigating the File System There are three basic commands which are used frequently to navigate the file system: ls pwd cd We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. pwd (print working directory) At any given moment of time, we will be standing in a certain directory. To get the name of the directory in which we are standing, we can use the pwd command in linux. We will now use the cd command to move to a different directory and then print the working directory. cd (change directory) The cd command can be used to change the working directory. Using the command, you can move from one directory to another. In the below example, we are initially in the root directory. we have then used the cd command to change the directory. ls (list files and directories)** The ls command is used to list the contents of a directory. It will list down all the files and folders present in the given directory. If we just type ls in the shell, it will list all the files and directories present in the current directory. We can also provide the directory name as argument to ls command. It will then list all the files and directories inside the given directory. Commands for Manipulating Files There are five basic commands which are used frequently to manipulate files: touch mkdir cp mv rm We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. touch (create new file) The touch command can be used to create an empty new file. This command is very useful for many other purposes but we will discuss the simplest use case of creating a new file. General syntax of using touch command touch mkdir (create new directories) The mkdir command is used to create directories.You can use ls command to verify that the new directory is created. General syntax of using mkdir command mkdir rm (delete files and directories) The rm command can be used to delete files and directories. It is very important to note that this command permanently deletes the files and directories. It's almost impossible to recover these files and directories once you have executed rm command on them successfully. Do run this command with care. General syntax of using rm command: rm Let's try to understand the rm command with an example. We will try to delete the file and directory we created using touch and mkdir command respectively. cp (copy files and directories) The cp command is used to copy files and directories from one location to another. Do note that the cp command doesn't do any change to the original files or directories. The original files or directories and their copy both co-exist after running cp command successfully. General syntax of using cp command: cp We are currently in the '/home/runner' directory. We will use the mkdir command to create a new directory named \"test_directory\". We will now try to copy the \"_test_runner.py\" file to the directory we created just now. Do note that nothing happened to the original \"_test_runner.py\" file. It's still there in the current directory. A new copy of it got created inside the \"test_directory\". We can also use the cp command to copy the whole directory from one location to another. Let's try to understand this with an example. We again used the mkdir command to create a new directory called \"another_directory\". We then used the cp command along with an additional argument '-r' to copy the \"test_directory\". mv (move files and directories) The mv command can either be used to move files or directories from one location to another or it can be used to rename files or directories. Do note that moving files and copying them are very different. When you move the files or directories, the original copy is lost. General syntax of using mv command: mv In this example, we will use the mv command to move the \"_test_runner.py\" file to \"test_directory\". In this case, this file already exists in \"test_directory\". The mv command will just replace it. Do note that the original file doesn't exist in the current directory after mv command ran successfully. We can also use the mv command to move a directory from one location to another. In this case, we do not need to use the '-r' flag that we did while using the cp command. Do note that the original directory will not exist if we use mv command. One of the important uses of the mv command is to rename files and directories. Let's see how we can use this command for renaming. We have first changed our location to \"test_directory\". We then use the mv command to rename the \"\"_test_runner.py\" file to \"test.py\". Commands for Viewing Files There are five basic commands which are used frequently to view the files: cat head tail more less We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. We will create a new file called \"numbers.txt\" and insert numbers from 1 to 100 in this file. Each number will be in a separate line. Do not worry about the above command now. It's an advanced command which is used to generate numbers. We have then used a redirection operator to push these numbers to the file. We will be discussing I/O redirection in the later sections. cat The most simplest use of cat command is to print the contents of the file on your output screen. This command is very useful and can be used for many other purposes. We will study about other use cases later. You can try to run the above command and you will see numbers being printed from 1 to 100 on your screen. You will need to scroll up to view all the numbers. head The head command displays the first 10 lines of the file by default. We can include additional arguments to display as many lines as we want from the top. In this example, we are only able to see the first 10 lines from the file when we use the head command. By default, head command will only display the first 10 lines. If we want to specify the number of lines we want to see from start, use the '-n' argument to provide the input. tail The tail command displays the last 10 lines of the file by default. We can include additional arguments to display as many lines as we want from the end of the file. By default, the tail command will only display the last 10 lines. If we want to specify the number of lines we want to see from the end, use '-n' argument to provide the input. In this example, we are only able to see the last 5 lines from the file when we use the tail command with explicit -n option. more More command displays the contents of a file or a command output, displaying one screen at a time in case the file is large (Eg: log files). It also allows forward navigation and limited backward navigation in the file. More command displays as much as can fit on the current screen and waits for user input to advance. Forward navigation can be done by pressing Enter, which advances the output by one line and Space, which advances the output by one screen. less Less command is an improved version of more. It displays the contents of a file or a command output, one page at a time. It allows backward navigation as well as forward navigation in the file and also has search options. We can use arrow keys for advancing backward or forward by one line. For moving forward by one page, press Space and for moving backward by one page, press b on your keyboard. You can go to the beginning and the end of a file instantly. Echo Command in Linux The echo command is one of the simplest commands that is used in the shell. This command is equivalent to what we have in other programming languages. The echo command prints the given input string on the screen. Text Processing Commands In the previous section, we learned how to view the content of a file. In many cases, we will be interested in performing the below operations: Print only the lines which contain a particular word(s) Replace a particular word with another word in a file Sort the lines in a particular order There are three basic commands which are used frequently to process texts: grep sed sort We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. We will create a new file called \"numbers.txt\" and insert numbers from 1 to 10 in this file. Each number will be in a separate line. grep The grep command in its simplest form can be used to search particular words in a text file. It will display all the lines in a file that contains a particular input. The word we want to search is provided as an input to the grep command. General syntax of using grep command: grep In this example, we are trying to search for a string \"1\" in this file. The grep command outputs the lines where it found this string. sed The sed command in its simplest form can be used to replace a text in a file. General syntax of using the sed command for replacement: sed 's///' Let's try to replace each occurrence of \"1\" in the file with \"3\" using sed command. The content of the file will not change in the above example. To do so, we have to use an extra argument '-i' so that the changes are reflected back in the file. sort The sort command can be used to sort the input provided to it as an argument. By default, it will sort in increasing order. Let's first see the content of the file before trying to sort it. Now, we will try to sort the file using the sort command. The sort command sorts the content in lexicographical order. The content of the file will not change in the above example. I/O Redirection Each open file gets assigned a file descriptor. A file descriptor is an unique identifier for open files in the system. There are always three default files open, stdin (the keyboard), stdout (the screen), and stderr (error messages output to the screen). These files can be redirected. Everything is a file in linux - https://unix.stackexchange.com/questions/225537/everything-is-a-file Till now, we have displayed all the output on the screen which is the standard output. We can use some special operators to redirect the output of the command to files or even to the input of other commands. I/O redirection is a very powerful feature. In the below example, we have used the '>' operator to redirect the output of ls command to output.txt file. In the below example, we have redirected the output from echo command to a file. We can also redirect the output of a command as an input to another command. This is possible with the help of pipes. In the below example, we have passed the output of cat command as an input to grep command using pipe(|) operator. In the below example, we have passed the output of sort command as an input to uniq command using pipe(|) operator. The uniq command only prints the unique numbers from the input. I/O redirection - https://tldp.org/LDP/abs/html/io-redirection.html","title":"Command Line Basics"},{"location":"level101/linux_basics/command_line_basics/#command-line-basics","text":"","title":"Command Line Basics"},{"location":"level101/linux_basics/command_line_basics/#lab-environment-setup","text":"One can use an online bash interpreter to run all the commands that are provided as examples in this course. This will also help you in getting a hands-on experience of various linux commands. REPL is one of the popular online bash interpreters for running linux commands. We will be using it for running all the commands mentioned in this course.","title":"Lab Environment Setup"},{"location":"level101/linux_basics/command_line_basics/#what-is-a-command","text":"A command is a program that tells the operating system to perform specific work. Programs are stored as files in linux. Therefore, a command is also a file which is stored somewhere on the disk. Commands may also take additional arguments as input from the user. These arguments are called command line arguments. Knowing how to use the commands is important and there are many ways to get help in Linux, especially for commands. Almost every command will have some form of documentation, most commands will have a command-line argument -h or --help that will display a reasonable amount of documentation. But the most popular documentation system in Linux is called man pages - short for manual pages. Using --help to show the documentation for ls command.","title":"What is a Command"},{"location":"level101/linux_basics/command_line_basics/#file-system-organization","text":"The linux file system has a hierarchical (or tree-like) structure with its highest level directory called root ( denoted by / ). Directories present inside the root directory stores file related to the system. These directories in turn can either store system files or application files or user related files. bin | The executable program of most commonly used commands reside in bin directory sbin | This directory contains programs used for system administration. home | This directory contains user related files and directories. lib | This directory contains all the library files etc | This directory contains all the system configuration files proc | This directory contains files related to the running processes on the system dev | This directory contains files related to devices on the system mnt | This directory contains files related to mounted devices on the system tmp | This directory is used to store temporary files on the system usr | This directory is used to store application programs on the system","title":"File System Organization"},{"location":"level101/linux_basics/command_line_basics/#commands-for-navigating-the-file-system","text":"There are three basic commands which are used frequently to navigate the file system: ls pwd cd We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell.","title":"Commands for Navigating the File System"},{"location":"level101/linux_basics/command_line_basics/#pwd-print-working-directory","text":"At any given moment of time, we will be standing in a certain directory. To get the name of the directory in which we are standing, we can use the pwd command in linux. We will now use the cd command to move to a different directory and then print the working directory.","title":"pwd (print working directory)"},{"location":"level101/linux_basics/command_line_basics/#cd-change-directory","text":"The cd command can be used to change the working directory. Using the command, you can move from one directory to another. In the below example, we are initially in the root directory. we have then used the cd command to change the directory.","title":"cd (change directory)"},{"location":"level101/linux_basics/command_line_basics/#ls-list-files-and-directories","text":"The ls command is used to list the contents of a directory. It will list down all the files and folders present in the given directory. If we just type ls in the shell, it will list all the files and directories present in the current directory. We can also provide the directory name as argument to ls command. It will then list all the files and directories inside the given directory.","title":"ls (list files and directories)**"},{"location":"level101/linux_basics/command_line_basics/#commands-for-manipulating-files","text":"There are five basic commands which are used frequently to manipulate files: touch mkdir cp mv rm We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell.","title":"Commands for Manipulating Files"},{"location":"level101/linux_basics/command_line_basics/#touch-create-new-file","text":"The touch command can be used to create an empty new file. This command is very useful for many other purposes but we will discuss the simplest use case of creating a new file. General syntax of using touch command touch ","title":"touch (create new file)"},{"location":"level101/linux_basics/command_line_basics/#mkdir-create-new-directories","text":"The mkdir command is used to create directories.You can use ls command to verify that the new directory is created. General syntax of using mkdir command mkdir ","title":"mkdir (create new directories)"},{"location":"level101/linux_basics/command_line_basics/#rm-delete-files-and-directories","text":"The rm command can be used to delete files and directories. It is very important to note that this command permanently deletes the files and directories. It's almost impossible to recover these files and directories once you have executed rm command on them successfully. Do run this command with care. General syntax of using rm command: rm Let's try to understand the rm command with an example. We will try to delete the file and directory we created using touch and mkdir command respectively.","title":"rm (delete files and directories)"},{"location":"level101/linux_basics/command_line_basics/#cp-copy-files-and-directories","text":"The cp command is used to copy files and directories from one location to another. Do note that the cp command doesn't do any change to the original files or directories. The original files or directories and their copy both co-exist after running cp command successfully. General syntax of using cp command: cp We are currently in the '/home/runner' directory. We will use the mkdir command to create a new directory named \"test_directory\". We will now try to copy the \"_test_runner.py\" file to the directory we created just now. Do note that nothing happened to the original \"_test_runner.py\" file. It's still there in the current directory. A new copy of it got created inside the \"test_directory\". We can also use the cp command to copy the whole directory from one location to another. Let's try to understand this with an example. We again used the mkdir command to create a new directory called \"another_directory\". We then used the cp command along with an additional argument '-r' to copy the \"test_directory\". mv (move files and directories) The mv command can either be used to move files or directories from one location to another or it can be used to rename files or directories. Do note that moving files and copying them are very different. When you move the files or directories, the original copy is lost. General syntax of using mv command: mv In this example, we will use the mv command to move the \"_test_runner.py\" file to \"test_directory\". In this case, this file already exists in \"test_directory\". The mv command will just replace it. Do note that the original file doesn't exist in the current directory after mv command ran successfully. We can also use the mv command to move a directory from one location to another. In this case, we do not need to use the '-r' flag that we did while using the cp command. Do note that the original directory will not exist if we use mv command. One of the important uses of the mv command is to rename files and directories. Let's see how we can use this command for renaming. We have first changed our location to \"test_directory\". We then use the mv command to rename the \"\"_test_runner.py\" file to \"test.py\".","title":"cp (copy files and directories)"},{"location":"level101/linux_basics/command_line_basics/#commands-for-viewing-files","text":"There are five basic commands which are used frequently to view the files: cat head tail more less We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. We will create a new file called \"numbers.txt\" and insert numbers from 1 to 100 in this file. Each number will be in a separate line. Do not worry about the above command now. It's an advanced command which is used to generate numbers. We have then used a redirection operator to push these numbers to the file. We will be discussing I/O redirection in the later sections.","title":"Commands for Viewing Files"},{"location":"level101/linux_basics/command_line_basics/#cat","text":"The most simplest use of cat command is to print the contents of the file on your output screen. This command is very useful and can be used for many other purposes. We will study about other use cases later. You can try to run the above command and you will see numbers being printed from 1 to 100 on your screen. You will need to scroll up to view all the numbers.","title":"cat"},{"location":"level101/linux_basics/command_line_basics/#head","text":"The head command displays the first 10 lines of the file by default. We can include additional arguments to display as many lines as we want from the top. In this example, we are only able to see the first 10 lines from the file when we use the head command. By default, head command will only display the first 10 lines. If we want to specify the number of lines we want to see from start, use the '-n' argument to provide the input.","title":"head"},{"location":"level101/linux_basics/command_line_basics/#tail","text":"The tail command displays the last 10 lines of the file by default. We can include additional arguments to display as many lines as we want from the end of the file. By default, the tail command will only display the last 10 lines. If we want to specify the number of lines we want to see from the end, use '-n' argument to provide the input. In this example, we are only able to see the last 5 lines from the file when we use the tail command with explicit -n option.","title":"tail"},{"location":"level101/linux_basics/command_line_basics/#more","text":"More command displays the contents of a file or a command output, displaying one screen at a time in case the file is large (Eg: log files). It also allows forward navigation and limited backward navigation in the file. More command displays as much as can fit on the current screen and waits for user input to advance. Forward navigation can be done by pressing Enter, which advances the output by one line and Space, which advances the output by one screen.","title":"more"},{"location":"level101/linux_basics/command_line_basics/#less","text":"Less command is an improved version of more. It displays the contents of a file or a command output, one page at a time. It allows backward navigation as well as forward navigation in the file and also has search options. We can use arrow keys for advancing backward or forward by one line. For moving forward by one page, press Space and for moving backward by one page, press b on your keyboard. You can go to the beginning and the end of a file instantly.","title":"less"},{"location":"level101/linux_basics/command_line_basics/#echo-command-in-linux","text":"The echo command is one of the simplest commands that is used in the shell. This command is equivalent to what we have in other programming languages. The echo command prints the given input string on the screen.","title":"Echo Command in Linux"},{"location":"level101/linux_basics/command_line_basics/#text-processing-commands","text":"In the previous section, we learned how to view the content of a file. In many cases, we will be interested in performing the below operations: Print only the lines which contain a particular word(s) Replace a particular word with another word in a file Sort the lines in a particular order There are three basic commands which are used frequently to process texts: grep sed sort We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. We will create a new file called \"numbers.txt\" and insert numbers from 1 to 10 in this file. Each number will be in a separate line.","title":"Text Processing Commands"},{"location":"level101/linux_basics/command_line_basics/#grep","text":"The grep command in its simplest form can be used to search particular words in a text file. It will display all the lines in a file that contains a particular input. The word we want to search is provided as an input to the grep command. General syntax of using grep command: grep In this example, we are trying to search for a string \"1\" in this file. The grep command outputs the lines where it found this string.","title":"grep"},{"location":"level101/linux_basics/command_line_basics/#sed","text":"The sed command in its simplest form can be used to replace a text in a file. General syntax of using the sed command for replacement: sed 's///' Let's try to replace each occurrence of \"1\" in the file with \"3\" using sed command. The content of the file will not change in the above example. To do so, we have to use an extra argument '-i' so that the changes are reflected back in the file.","title":"sed"},{"location":"level101/linux_basics/command_line_basics/#sort","text":"The sort command can be used to sort the input provided to it as an argument. By default, it will sort in increasing order. Let's first see the content of the file before trying to sort it. Now, we will try to sort the file using the sort command. The sort command sorts the content in lexicographical order. The content of the file will not change in the above example.","title":"sort"},{"location":"level101/linux_basics/command_line_basics/#io-redirection","text":"Each open file gets assigned a file descriptor. A file descriptor is an unique identifier for open files in the system. There are always three default files open, stdin (the keyboard), stdout (the screen), and stderr (error messages output to the screen). These files can be redirected. Everything is a file in linux - https://unix.stackexchange.com/questions/225537/everything-is-a-file Till now, we have displayed all the output on the screen which is the standard output. We can use some special operators to redirect the output of the command to files or even to the input of other commands. I/O redirection is a very powerful feature. In the below example, we have used the '>' operator to redirect the output of ls command to output.txt file. In the below example, we have redirected the output from echo command to a file. We can also redirect the output of a command as an input to another command. This is possible with the help of pipes. In the below example, we have passed the output of cat command as an input to grep command using pipe(|) operator. In the below example, we have passed the output of sort command as an input to uniq command using pipe(|) operator. The uniq command only prints the unique numbers from the input. I/O redirection - https://tldp.org/LDP/abs/html/io-redirection.html","title":"I/O Redirection"},{"location":"level101/linux_basics/conclusion/","text":"Conclusion We have covered the basics of Linux operating systems and basic commands used in linux. We have also covered the Linux server administration commands. We hope that this course will make it easier for you to operate on the command line. Applications in SRE Role As a SRE, you will be required to perform some general tasks on these Linux servers. You will also be using the command line when you are troubleshooting issues. Moving from one location to another in the filesystem will require the help of ls , pwd and cd commands. You may need to search some specific information in the log files. grep command would be very useful here. I/O redirection will become handy if you want to store the output in a file or pass it as an input to another command. tail command is very useful to view the latest data in the log file. Different users will have different permissions depending on their roles. We will also not want everyone in the company to access our servers for security reasons. Users permissions can be restricted with chown , chmod and chgrp commands. ssh is one of the most frequently used commands for a SRE. Logging into servers and troubleshooting along with performing basic administration tasks will only be possible if we are able to login into the server. What if we want to run an apache server or nginx on a server? We will first install it using the package manager. Package management commands become important here. Managing services on servers is another critical responsibility of a SRE. Systemd related commands can help in troubleshooting issues. If a service goes down, we can start it using systemctl start command. We can also stop a service in case it is not needed. Monitoring is another core responsibility of a SRE. Memory and CPU are two important system level metrics which should be monitored. Commands like top and free are quite helpful here. If a service is throwing an error, how do we find out the root cause of the error ? We will certainly need to check logs to find out the whole stack trace of the error. The log file will also tell us the number of times the error has occurred along with time when it started. Useful Courses and tutorials Edx basic linux commands course Edx Red Hat Enterprise Linux Course https://linuxcommand.org/lc3_learning_the_shell.php","title":"Conclusion"},{"location":"level101/linux_basics/conclusion/#conclusion","text":"We have covered the basics of Linux operating systems and basic commands used in linux. We have also covered the Linux server administration commands. We hope that this course will make it easier for you to operate on the command line.","title":"Conclusion"},{"location":"level101/linux_basics/conclusion/#applications-in-sre-role","text":"As a SRE, you will be required to perform some general tasks on these Linux servers. You will also be using the command line when you are troubleshooting issues. Moving from one location to another in the filesystem will require the help of ls , pwd and cd commands. You may need to search some specific information in the log files. grep command would be very useful here. I/O redirection will become handy if you want to store the output in a file or pass it as an input to another command. tail command is very useful to view the latest data in the log file. Different users will have different permissions depending on their roles. We will also not want everyone in the company to access our servers for security reasons. Users permissions can be restricted with chown , chmod and chgrp commands. ssh is one of the most frequently used commands for a SRE. Logging into servers and troubleshooting along with performing basic administration tasks will only be possible if we are able to login into the server. What if we want to run an apache server or nginx on a server? We will first install it using the package manager. Package management commands become important here. Managing services on servers is another critical responsibility of a SRE. Systemd related commands can help in troubleshooting issues. If a service goes down, we can start it using systemctl start command. We can also stop a service in case it is not needed. Monitoring is another core responsibility of a SRE. Memory and CPU are two important system level metrics which should be monitored. Commands like top and free are quite helpful here. If a service is throwing an error, how do we find out the root cause of the error ? We will certainly need to check logs to find out the whole stack trace of the error. The log file will also tell us the number of times the error has occurred along with time when it started.","title":"Applications in SRE Role"},{"location":"level101/linux_basics/conclusion/#useful-courses-and-tutorials","text":"Edx basic linux commands course Edx Red Hat Enterprise Linux Course https://linuxcommand.org/lc3_learning_the_shell.php","title":"Useful Courses and tutorials"},{"location":"level101/linux_basics/intro/","text":"Linux Basics Introduction Prerequisites Should be comfortable in using any operating systems like Windows, Linux or Mac Expected to have fundamental knowledge of operating systems What to expect from this course This course is divided into three parts. In the first part, we cover the fundamentals of Linux operating systems. We will talk about Linux architecture, Linux distributions and uses of Linux operating systems. We will also talk about the difference between GUI and CLI. In the second part, we cover some basic commands used in Linux. We will focus on commands used for navigating the file system, viewing and manipulating files, I/O redirection etc. In the third part, we cover Linux system administration. This includes day to day tasks performed by Linux admins, like managing users/groups, managing file permissions, monitoring system performance, log files etc. In the second and third part, we will be taking examples to understand the concepts. What is not covered under this course We are not covering advanced Linux commands and bash scripting in this course. We will also not be covering Linux internals. Course Contents The following topics has been covered in this course: Introduction to Linux What are Linux Operating Systems What are popular Linux distributions Uses of Linux Operating Systems Linux Architecture Graphical user interface (GUI) vs Command line interface (CLI) Command Line Basics Lab Environment Setup What is a Command File System Organization Navigating File System Manipulating Files Viewing Files Echo Command Text Processing Commands I/O Redirection Linux system administration Lab Environment Setup User/Groups management Becoming a Superuser File Permissions SSH Command Package Management Process Management Memory Management Daemons and Systemd Logs Conclusion Applications in SRE Role Useful Courses and tutorials What are Linux operating systems Most of us are familiar with the Windows operating system used in more than 75% of the personal computers. The Windows operating systems are based on Windows NT kernel. A kernel is the most important part of an operating system - it performs important functions like process management, memory management, filesystem management etc. Linux operating systems are based on the Linux kernel. A Linux based operating system will consist of Linux kernel, GUI/CLI, system libraries and system utilities. The Linux kernel was independently developed and released by Linus Torvalds. The Linux kernel is free and open-source - https://github.com/torvalds/linux Linux is a kernel and and not a complete operating system. Linux kernel is combined with GNU system to make a complete operating system. Therefore, linux based operating systems are also called as GNU/Linux systems. GNU is an extensive collection of free softwares like compiler, debugger, C library etc. Linux and the GNU System History of Linux - https://en.wikipedia.org/wiki/History_of_Linux What are popular Linux distributions A Linux distribution(distro) is an operating system based on the Linux kernel and a package management system. A package management system consists of tools that help in installing, upgrading, configuring and removing softwares on the operating system. Software are usually adopted to a distribution and are packaged in a distro specific format. These packages are available through a distro specific repository. Packages are installed and managed in the operating system by a package manager. List of popular Linux distributions: Fedora Ubuntu Debian Centos Red Hat Enterprise Linux Suse Arch Linux Packaging systems Distributions Package manager Debian style (.deb) Debian, Ubuntu APT Red Hat style (.rpm) Fedora, CentOS, Red Hat Enterprise Linux YUM Linux Architecture The Linux kernel is monolithic in nature. System calls are used to interact with the Linux kernel space. Kernel code can only be executed in the kernel mode. Non-kernel code is executed in the user mode. Device drivers are used to communicate with the hardware devices. Uses of Linux Operating Systems Operating system based on Linux kernel are widely used in: Personal computers Servers Mobile phones - Android is based on Linux operating system Embedded devices - watches, televisions, traffic lights etc Satellites Network devices - routers, switches etc. Graphical user interface (GUI) vs Command line interface (CLI) A user interacts with a computer with the help of user interfaces. The user interface can be either GUI or CLI. Graphical user interface allows a user to interact with the computer using graphics such as icons and images. When a user clicks on an icon to open an application on a computer, he or she is actually using the GUI. It's easy to perform tasks using GUI. Command line interface allows a user to interact with the computer using commands. A user types the command in a terminal and the system helps in executing these commands. A new user with experience on GUI may find it difficult to interact with CLI as he/she needs to be aware of the commands to perform a particular operation. Shell vs Terminal Shell is a program that takes commands from the users and gives them to the operating system for processing. Shell is an example of a CLI (command line interface). Bash is one of the most popular shell programs available on Linux servers. Other popular shell programs are zsh, ksh and tcsh. Terminal is a program that opens a window and lets you interact with the shell. Some popular examples of terminals are gnome-terminal, xterm, konsole etc. Linux users do use the terms shell, terminal, prompt, console etc. interchangeably. In simple terms, these all refer to a way of taking commands from the user.","title":"Introduction"},{"location":"level101/linux_basics/intro/#linux-basics","text":"","title":"Linux Basics"},{"location":"level101/linux_basics/intro/#introduction","text":"","title":"Introduction"},{"location":"level101/linux_basics/intro/#prerequisites","text":"Should be comfortable in using any operating systems like Windows, Linux or Mac Expected to have fundamental knowledge of operating systems","title":"Prerequisites"},{"location":"level101/linux_basics/intro/#what-to-expect-from-this-course","text":"This course is divided into three parts. In the first part, we cover the fundamentals of Linux operating systems. We will talk about Linux architecture, Linux distributions and uses of Linux operating systems. We will also talk about the difference between GUI and CLI. In the second part, we cover some basic commands used in Linux. We will focus on commands used for navigating the file system, viewing and manipulating files, I/O redirection etc. In the third part, we cover Linux system administration. This includes day to day tasks performed by Linux admins, like managing users/groups, managing file permissions, monitoring system performance, log files etc. In the second and third part, we will be taking examples to understand the concepts.","title":"What to expect from this course"},{"location":"level101/linux_basics/intro/#what-is-not-covered-under-this-course","text":"We are not covering advanced Linux commands and bash scripting in this course. We will also not be covering Linux internals.","title":"What is not covered under this course"},{"location":"level101/linux_basics/intro/#course-contents","text":"The following topics has been covered in this course: Introduction to Linux What are Linux Operating Systems What are popular Linux distributions Uses of Linux Operating Systems Linux Architecture Graphical user interface (GUI) vs Command line interface (CLI) Command Line Basics Lab Environment Setup What is a Command File System Organization Navigating File System Manipulating Files Viewing Files Echo Command Text Processing Commands I/O Redirection Linux system administration Lab Environment Setup User/Groups management Becoming a Superuser File Permissions SSH Command Package Management Process Management Memory Management Daemons and Systemd Logs Conclusion Applications in SRE Role Useful Courses and tutorials","title":"Course Contents"},{"location":"level101/linux_basics/intro/#what-are-linux-operating-systems","text":"Most of us are familiar with the Windows operating system used in more than 75% of the personal computers. The Windows operating systems are based on Windows NT kernel. A kernel is the most important part of an operating system - it performs important functions like process management, memory management, filesystem management etc. Linux operating systems are based on the Linux kernel. A Linux based operating system will consist of Linux kernel, GUI/CLI, system libraries and system utilities. The Linux kernel was independently developed and released by Linus Torvalds. The Linux kernel is free and open-source - https://github.com/torvalds/linux Linux is a kernel and and not a complete operating system. Linux kernel is combined with GNU system to make a complete operating system. Therefore, linux based operating systems are also called as GNU/Linux systems. GNU is an extensive collection of free softwares like compiler, debugger, C library etc. Linux and the GNU System History of Linux - https://en.wikipedia.org/wiki/History_of_Linux","title":"What are Linux operating systems"},{"location":"level101/linux_basics/intro/#what-are-popular-linux-distributions","text":"A Linux distribution(distro) is an operating system based on the Linux kernel and a package management system. A package management system consists of tools that help in installing, upgrading, configuring and removing softwares on the operating system. Software are usually adopted to a distribution and are packaged in a distro specific format. These packages are available through a distro specific repository. Packages are installed and managed in the operating system by a package manager. List of popular Linux distributions: Fedora Ubuntu Debian Centos Red Hat Enterprise Linux Suse Arch Linux Packaging systems Distributions Package manager Debian style (.deb) Debian, Ubuntu APT Red Hat style (.rpm) Fedora, CentOS, Red Hat Enterprise Linux YUM","title":"What are popular Linux distributions"},{"location":"level101/linux_basics/intro/#linux-architecture","text":"The Linux kernel is monolithic in nature. System calls are used to interact with the Linux kernel space. Kernel code can only be executed in the kernel mode. Non-kernel code is executed in the user mode. Device drivers are used to communicate with the hardware devices.","title":"Linux Architecture"},{"location":"level101/linux_basics/intro/#uses-of-linux-operating-systems","text":"Operating system based on Linux kernel are widely used in: Personal computers Servers Mobile phones - Android is based on Linux operating system Embedded devices - watches, televisions, traffic lights etc Satellites Network devices - routers, switches etc.","title":"Uses of Linux Operating Systems"},{"location":"level101/linux_basics/intro/#graphical-user-interface-gui-vs-command-line-interface-cli","text":"A user interacts with a computer with the help of user interfaces. The user interface can be either GUI or CLI. Graphical user interface allows a user to interact with the computer using graphics such as icons and images. When a user clicks on an icon to open an application on a computer, he or she is actually using the GUI. It's easy to perform tasks using GUI. Command line interface allows a user to interact with the computer using commands. A user types the command in a terminal and the system helps in executing these commands. A new user with experience on GUI may find it difficult to interact with CLI as he/she needs to be aware of the commands to perform a particular operation.","title":"Graphical user interface (GUI) vs Command line interface (CLI)"},{"location":"level101/linux_basics/intro/#shell-vs-terminal","text":"Shell is a program that takes commands from the users and gives them to the operating system for processing. Shell is an example of a CLI (command line interface). Bash is one of the most popular shell programs available on Linux servers. Other popular shell programs are zsh, ksh and tcsh. Terminal is a program that opens a window and lets you interact with the shell. Some popular examples of terminals are gnome-terminal, xterm, konsole etc. Linux users do use the terms shell, terminal, prompt, console etc. interchangeably. In simple terms, these all refer to a way of taking commands from the user.","title":"Shell vs Terminal"},{"location":"level101/linux_basics/linux_server_administration/","text":"Linux Server Administration In this course will try to cover some of the common tasks that a linux server administrator performs. We will first try to understand what a particular command does and then try to understand the commands using examples. Do keep in mind that it's very important to practice the Linux commands on your own. Lab Environment Setup Install docker on your system - https://docs.docker.com/engine/install/ We will be running all the commands on Red Hat Enterprise Linux (RHEL) 8 system. We will run most of the commands used in this module in the above Docker container. Multi-User Operating Systems An operating system is considered as multi-user if it allows multiple people/users to use a computer and not affect each other's files and preferences. Linux based operating systems are multi-user in nature as it allows multiple users to access the system at the same time. A typical computer will only have one keyboard and monitor but multiple users can log in via SSH if the computer is connected to the network. We will cover more about SSH later. As a server administrator, we are mostly concerned with the Linux servers which are physically present at a very large distance from us. We can connect to these servers with the help of remote login methods like SSH. Since Linux supports multiple users, we need to have a method which can protect the users from each other. One user should not be able to access and modify files of other users User/Group Management Users in Linux has an associated user ID called UID attached to them. Users also has a home directory and a login shell associated with them. A group is a collection of one or more users. A group makes it easier to share permissions among a group of users. Each group has a group ID called GID associated with it. id command id command can be used to find the uid and gid associated with an user. It also lists down the groups to which the user belongs to. The uid and gid associated with the root user is 0. A good way to find out the current user in Linux is to use the whoami command. \"root\" user or superuser is the most privileged user with unrestricted access to all the resources on the system. It has UID 0 Important files associated with users/groups /etc/passwd Stores the user name, the uid, the gid, the home directory, the login shell etc /etc/shadow Stores the password associated with the users /etc/group Stores information about different groups on the system If you want to understand each filed discussed in the above outputs, you can go through below links: https://tldp.org/LDP/lame/LAME/linux-admin-made-easy/shadow-file-formats.html https://tldp.org/HOWTO/User-Authentication-HOWTO/x71.html Important commands for managing users Some of the commands which are used frequently to manage users/groups on Linux are following: useradd - Creates a new user passwd - Adds or modifies passwords for a user usermod - Modifies attributes of an user userdel - Deletes an user useradd The useradd command adds a new user in Linux. We will create a new user 'shivam'. We will also verify that the user has been created by tailing the /etc/passwd file. The uid and gid are 1000 for the newly created user. The home directory assigned to the user is /home/shivam and the login shell assigned is /bin/bash. Do note that the user home directory and login shell can be modified later on. If we do not specify any value for attributes like home directory or login shell, default values will be assigned to the user. We can also override these default values when creating a new user. passwd The passwd command is used to create or modify passwords for a user. In the above examples, we have not assigned any password for users 'shivam' or 'amit' while creating them. \"!!\" in an account entry in shadow means the account of an user has been created, but not yet given a password. Let's now try to create a password for user \"shivam\". Do remember the password as we will be later using examples where it will be useful. Also, let's change the password for the root user now. When we switch from a normal user to root user, it will request you for a password. Also, when you login using root user, the password will be asked. usermod The usermod command is used to modify the attributes of an user like the home directory or the shell. Let's try to modify the login shell of user \"amit\" to \"/bin/bash\". In a similar way, you can also modify many other attributes for a user. Try 'usermod -h' for a list of attributes you can modify. userdel The userdel command is used to remove a user on Linux. Once we remove a user, all the information related to that user will be removed. Let's try to delete the user \"amit\". After deleting the user, you will not find the entry for that user in \"/etc/passwd\" or \"/etc/shadow\" file. Important commands for managing groups Commands for managing groups are quite similar to the commands used for managing users. Each command is not explained in detail here as they are quite similar. You can try running these commands on your system. groupadd \\ Creates a new group groupmod \\ Modifies attributes of a group groupdel \\ Deletes a group gpasswd \\ Modifies password for group We will now try to add user \"shivam\" to the group we have created above. Becoming a Superuser Before running the below commands, do make sure that you have set up a password for user \"shivam\" and user \"root\" using the passwd command described in the above section. The su command can be used to switch users in Linux. Let's now try to switch to user \"shivam\". Let's now try to open the \"/etc/shadow\" file. The operating system didn't allow the user \"shivam\" to read the content of the \"/etc/shadow\" file. This is an important file in Linux which stores the passwords of users. This file can only be accessed by root or users who have the superuser privileges. The sudo command allows a user to run commands with the security privileges of the root user. Do remember that the root user has all the privileges on a system. We can also use su command to switch to the root user and open the above file but doing that will require the password of the root user. An alternative way which is preferred on most modern operating systems is to use sudo command for becoming a superuser. Using this way, a user has to enter his/her password and they need to be a part of the sudo group. How to provide superpriveleges to other users ? Let's first switch to the root user using su command. Do note that using the below command will need you to enter the password for the root user. In case, you forgot to set a password for the root user, type \"exit\" and you will be back as the root user. Now, set up a password using the passwd command. The file /etc/sudoers holds the names of users permitted to invoke sudo . In redhat operating systems, this file is not present by default. We will need to install sudo. We will discuss the yum command in detail in later sections. Try to open the \"/etc/sudoers\" file on the system. The file has a lot of information. This file stores the rules that users must follow when running the sudo command. For example, root is allowed to run any commands from anywhere. One easy way of providing root access to users is to add them to a group which has permissions to run all the commands. \"wheel\" is a group in redhat Linux with such privileges. Let's add the user \"shivam\" to this group so that it also has sudo privileges. Let's now switch back to user \"shivam\" and try to access the \"/etc/shadow\" file. We need to use sudo before running the command since it can only be accessed with the sudo privileges. We have already given sudo privileges to user \u201cshivam\u201d by adding him to the group \u201cwheel\u201d. File Permissions On a Linux operating system, each file and directory is assigned access permissions for the owner of the file, the members of a group of related users and everybody else. This is to make sure that one user is not allowed to access the files and resources of another user. To see the permissions of a file, we can use the ls command. Let's look at the permissions of /etc/passwd file. Let's go over some of the important fields in the output that are related to file permissions. Chmod command The chmod command is used to modify files and directories permissions in Linux. The chmod command accepts permissions in as a numerical argument. We can think of permission as a series of bits with 1 representing True or allowed and 0 representing False or not allowed. Permission rwx Binary Decimal Read, write and execute rwx 111 7 Read and write rw- 110 6 Read and execute r-x 101 5 Read only r-- 100 4 Write and execute -wx 011 3 Write only -w- 010 2 Execute only --x 001 1 None --- 000 0 We will now create a new file and check the permission of the file. The group owner doesn't have the permission to write to this file. Let's give the group owner or root the permission to write to it using chmod command. Chmod command can be also used to change the permissions of a directory in the similar way. Chown command The chown command is used to change the owner of files or directories in Linux. Command syntax: chown \\ \\ In case, we do not have sudo privileges, we need to use sudo command . Let's switch to user 'shivam' and try changing the owner. We have also changed the owner of the file to root before running the below command. Chown command can also be used to change the owner of a directory in the similar way. Chgrp command The chgrp command can be used to change the group ownership of files or directories in Linux. The syntax is very similar to that of chown command. Chgrp command can also be used to change the owner of a directory in the similar way. SSH Command The ssh command is used for logging into the remote systems, transfer files between systems and for executing commands on a remote machine. SSH stands for secure shell and is used to provide an encrypted secured connection between two hosts over an insecure network like the internet. Reference: https://www.ssh.com/ssh/command/ We will now discuss passwordless authentication which is secure and most commonly used for ssh authentication. Passwordless Authentication Using SSH Using this method, we can ssh into hosts without entering the password. This method is also useful when we want some scripts to perform ssh-related tasks. Passwordless authentication requires the use of a public and private key pair. As the name implies, the public key can be shared with anyone but the private key should be kept private. Lets not get into the details of how this authentication works. You can read more about it here Steps for setting up a passwordless authentication with a remote host: Generating public-private key pair If we already have a key pair stored in \\~/.ssh directory, we will not need to generate keys again. Install openssh package which contains all the commands related to ssh. Generate a key pair using the ssh-keygen command. One can choose the default values for all prompts. After running the ssh-keygen command successfully, we should see two keys present in the \\~/.ssh directory. Id_rsa is the private key and id_rsa.pub is the public key. Do note that the private key can only be read and modified by you. Transferring the public key to the remote host There are multiple ways to transfer the public key to the remote server. We will look at one of the most common ways of doing it using the ssh-copy-id command. Install the openssh-clients package to use ssh-copy-id command. Use the ssh-copy-id command to copy your public key to the remote host. Now, ssh into the remote host using the password authentication. Our public key should be there in \\~/.ssh/authorized_keys now. \\~/.ssh/authorized_key contains a list of public keys. The users associated with these public keys have the ssh access into the remote host. How to run commands on a remote host ? General syntax: ssh \\@\\ \\ How to transfer files from one host to another host ? General syntax: scp \\ \\ Package Management Package management is the process of installing and managing software on the system. We can install the packages which we require from the Linux package distributor. Different distributors use different packaging systems. Packaging systems Distributions Debian style (.deb) Debian, Ubuntu Red Hat style (.rpm) Fedora, CentOS, Red Hat Enterprise Linux Popular Packaging Systems in Linux Command Description yum install \\ Installs a package on your system yum update \\ Updates a package to it's latest available version yum remove \\ Removes a package from your system yum search \\ Searches for a particular keyword DNF is the successor to YUM which is now used in Fedora for installing and managing packages. DNF may replace YUM in the future on all RPM based Linux distributions. We did find an exact match for the keyword httpd when we searched using yum search command. Let's now install the httpd package. After httpd is installed, we will use the yum remove command to remove httpd package. Process Management In this section, we will study about some useful commands that can be used to monitor the processes on Linux systems. ps (process status) The ps command is used to know the information of a process or list of processes. If you get an error \"ps command not found\" while running ps command, do install procps package. ps without any arguments is not very useful. Let's try to list all the processes on the system by using the below command. Reference: https://unix.stackexchange.com/questions/106847/what-does-aux-mean-in-ps-aux We can use an additional argument with ps command to list the information about the process with a specific process ID. We can use grep in combination with ps command to list only specific processes. top The top command is used to show information about Linux processes running on the system in real time. It also shows a summary of the system information. For each process, top lists down the process ID, owner, priority, state, cpu utilization, memory utilization and much more information. It also lists down the memory utilization and cpu utilization of the system as a whole along with system uptime and cpu load average. Memory Management In this section, we will study about some useful commands that can be used to view information about the system memory. free The free command is used to display the memory usage of the system. The command displays the total free and used space available in the RAM along with space occupied by the caches/buffers. free command by default shows the memory usage in kilobytes. We can use an additional argument to get the data in human-readable format. vmstat The vmstat command can be used to display the memory usage along with additional information about io and cpu usage. Checking Disk Space In this section, we will study about some useful commands that can be used to view disk space on Linux. df (disk free) The df command is used to display the free and available space for each mounted file system. du (disk usage) The du command is used to display disk usage of files and directories on the system. The below command can be used to display the top 5 largest directories in the root directory. Daemons A computer program that runs as a background process is called a daemon. Traditionally, the name of daemon processes ended with d - sshd, httpd etc. We cannot interact with a daemon process as they run in the background. Services and daemons are used interchangeably most of the time. Systemd Systemd is a system and service manager for Linux operating systems. Systemd units are the building blocks of systemd. These units are represented by unit configuration files. The below examples shows the unit configuration files available at /usr/lib/systemd/system which are distributed by installed RPM packages. We are more interested in the configuration file that ends with service as these are service units. Managing System Services Service units end with .service file extension. Systemctl command can be used to start/stop/restart the services managed by systemd. Command Description systemctl start name.service Starts a service systemctl stop name.service Stops a service systemctl restart name.service Restarts a service systemctl status name.service Check the status of a service systemctl reload name.service Reload the configuration of a service Logs In this section, we will talk about some important files and directories which can be very useful for viewing system logs and applications logs in Linux. These logs can be very useful when you are troubleshooting on the system.","title":"Server Administration"},{"location":"level101/linux_basics/linux_server_administration/#linux-server-administration","text":"In this course will try to cover some of the common tasks that a linux server administrator performs. We will first try to understand what a particular command does and then try to understand the commands using examples. Do keep in mind that it's very important to practice the Linux commands on your own.","title":"Linux Server Administration"},{"location":"level101/linux_basics/linux_server_administration/#lab-environment-setup","text":"Install docker on your system - https://docs.docker.com/engine/install/ We will be running all the commands on Red Hat Enterprise Linux (RHEL) 8 system. We will run most of the commands used in this module in the above Docker container.","title":"Lab Environment Setup"},{"location":"level101/linux_basics/linux_server_administration/#multi-user-operating-systems","text":"An operating system is considered as multi-user if it allows multiple people/users to use a computer and not affect each other's files and preferences. Linux based operating systems are multi-user in nature as it allows multiple users to access the system at the same time. A typical computer will only have one keyboard and monitor but multiple users can log in via SSH if the computer is connected to the network. We will cover more about SSH later. As a server administrator, we are mostly concerned with the Linux servers which are physically present at a very large distance from us. We can connect to these servers with the help of remote login methods like SSH. Since Linux supports multiple users, we need to have a method which can protect the users from each other. One user should not be able to access and modify files of other users","title":"Multi-User Operating Systems"},{"location":"level101/linux_basics/linux_server_administration/#usergroup-management","text":"Users in Linux has an associated user ID called UID attached to them. Users also has a home directory and a login shell associated with them. A group is a collection of one or more users. A group makes it easier to share permissions among a group of users. Each group has a group ID called GID associated with it.","title":"User/Group Management"},{"location":"level101/linux_basics/linux_server_administration/#id-command","text":"id command can be used to find the uid and gid associated with an user. It also lists down the groups to which the user belongs to. The uid and gid associated with the root user is 0. A good way to find out the current user in Linux is to use the whoami command. \"root\" user or superuser is the most privileged user with unrestricted access to all the resources on the system. It has UID 0","title":"id command"},{"location":"level101/linux_basics/linux_server_administration/#important-files-associated-with-usersgroups","text":"/etc/passwd Stores the user name, the uid, the gid, the home directory, the login shell etc /etc/shadow Stores the password associated with the users /etc/group Stores information about different groups on the system If you want to understand each filed discussed in the above outputs, you can go through below links: https://tldp.org/LDP/lame/LAME/linux-admin-made-easy/shadow-file-formats.html https://tldp.org/HOWTO/User-Authentication-HOWTO/x71.html","title":"Important files associated with users/groups"},{"location":"level101/linux_basics/linux_server_administration/#important-commands-for-managing-users","text":"Some of the commands which are used frequently to manage users/groups on Linux are following: useradd - Creates a new user passwd - Adds or modifies passwords for a user usermod - Modifies attributes of an user userdel - Deletes an user","title":"Important commands for managing users"},{"location":"level101/linux_basics/linux_server_administration/#useradd","text":"The useradd command adds a new user in Linux. We will create a new user 'shivam'. We will also verify that the user has been created by tailing the /etc/passwd file. The uid and gid are 1000 for the newly created user. The home directory assigned to the user is /home/shivam and the login shell assigned is /bin/bash. Do note that the user home directory and login shell can be modified later on. If we do not specify any value for attributes like home directory or login shell, default values will be assigned to the user. We can also override these default values when creating a new user.","title":"useradd"},{"location":"level101/linux_basics/linux_server_administration/#passwd","text":"The passwd command is used to create or modify passwords for a user. In the above examples, we have not assigned any password for users 'shivam' or 'amit' while creating them. \"!!\" in an account entry in shadow means the account of an user has been created, but not yet given a password. Let's now try to create a password for user \"shivam\". Do remember the password as we will be later using examples where it will be useful. Also, let's change the password for the root user now. When we switch from a normal user to root user, it will request you for a password. Also, when you login using root user, the password will be asked.","title":"passwd"},{"location":"level101/linux_basics/linux_server_administration/#usermod","text":"The usermod command is used to modify the attributes of an user like the home directory or the shell. Let's try to modify the login shell of user \"amit\" to \"/bin/bash\". In a similar way, you can also modify many other attributes for a user. Try 'usermod -h' for a list of attributes you can modify.","title":"usermod"},{"location":"level101/linux_basics/linux_server_administration/#userdel","text":"The userdel command is used to remove a user on Linux. Once we remove a user, all the information related to that user will be removed. Let's try to delete the user \"amit\". After deleting the user, you will not find the entry for that user in \"/etc/passwd\" or \"/etc/shadow\" file.","title":"userdel"},{"location":"level101/linux_basics/linux_server_administration/#important-commands-for-managing-groups","text":"Commands for managing groups are quite similar to the commands used for managing users. Each command is not explained in detail here as they are quite similar. You can try running these commands on your system. groupadd \\ Creates a new group groupmod \\ Modifies attributes of a group groupdel \\ Deletes a group gpasswd \\ Modifies password for group We will now try to add user \"shivam\" to the group we have created above.","title":"Important commands for managing groups"},{"location":"level101/linux_basics/linux_server_administration/#becoming-a-superuser","text":"Before running the below commands, do make sure that you have set up a password for user \"shivam\" and user \"root\" using the passwd command described in the above section. The su command can be used to switch users in Linux. Let's now try to switch to user \"shivam\". Let's now try to open the \"/etc/shadow\" file. The operating system didn't allow the user \"shivam\" to read the content of the \"/etc/shadow\" file. This is an important file in Linux which stores the passwords of users. This file can only be accessed by root or users who have the superuser privileges. The sudo command allows a user to run commands with the security privileges of the root user. Do remember that the root user has all the privileges on a system. We can also use su command to switch to the root user and open the above file but doing that will require the password of the root user. An alternative way which is preferred on most modern operating systems is to use sudo command for becoming a superuser. Using this way, a user has to enter his/her password and they need to be a part of the sudo group. How to provide superpriveleges to other users ? Let's first switch to the root user using su command. Do note that using the below command will need you to enter the password for the root user. In case, you forgot to set a password for the root user, type \"exit\" and you will be back as the root user. Now, set up a password using the passwd command. The file /etc/sudoers holds the names of users permitted to invoke sudo . In redhat operating systems, this file is not present by default. We will need to install sudo. We will discuss the yum command in detail in later sections. Try to open the \"/etc/sudoers\" file on the system. The file has a lot of information. This file stores the rules that users must follow when running the sudo command. For example, root is allowed to run any commands from anywhere. One easy way of providing root access to users is to add them to a group which has permissions to run all the commands. \"wheel\" is a group in redhat Linux with such privileges. Let's add the user \"shivam\" to this group so that it also has sudo privileges. Let's now switch back to user \"shivam\" and try to access the \"/etc/shadow\" file. We need to use sudo before running the command since it can only be accessed with the sudo privileges. We have already given sudo privileges to user \u201cshivam\u201d by adding him to the group \u201cwheel\u201d.","title":"Becoming a Superuser"},{"location":"level101/linux_basics/linux_server_administration/#file-permissions","text":"On a Linux operating system, each file and directory is assigned access permissions for the owner of the file, the members of a group of related users and everybody else. This is to make sure that one user is not allowed to access the files and resources of another user. To see the permissions of a file, we can use the ls command. Let's look at the permissions of /etc/passwd file. Let's go over some of the important fields in the output that are related to file permissions.","title":"File Permissions"},{"location":"level101/linux_basics/linux_server_administration/#chmod-command","text":"The chmod command is used to modify files and directories permissions in Linux. The chmod command accepts permissions in as a numerical argument. We can think of permission as a series of bits with 1 representing True or allowed and 0 representing False or not allowed. Permission rwx Binary Decimal Read, write and execute rwx 111 7 Read and write rw- 110 6 Read and execute r-x 101 5 Read only r-- 100 4 Write and execute -wx 011 3 Write only -w- 010 2 Execute only --x 001 1 None --- 000 0 We will now create a new file and check the permission of the file. The group owner doesn't have the permission to write to this file. Let's give the group owner or root the permission to write to it using chmod command. Chmod command can be also used to change the permissions of a directory in the similar way.","title":"Chmod command"},{"location":"level101/linux_basics/linux_server_administration/#chown-command","text":"The chown command is used to change the owner of files or directories in Linux. Command syntax: chown \\ \\ In case, we do not have sudo privileges, we need to use sudo command . Let's switch to user 'shivam' and try changing the owner. We have also changed the owner of the file to root before running the below command. Chown command can also be used to change the owner of a directory in the similar way.","title":"Chown command"},{"location":"level101/linux_basics/linux_server_administration/#chgrp-command","text":"The chgrp command can be used to change the group ownership of files or directories in Linux. The syntax is very similar to that of chown command. Chgrp command can also be used to change the owner of a directory in the similar way.","title":"Chgrp command"},{"location":"level101/linux_basics/linux_server_administration/#ssh-command","text":"The ssh command is used for logging into the remote systems, transfer files between systems and for executing commands on a remote machine. SSH stands for secure shell and is used to provide an encrypted secured connection between two hosts over an insecure network like the internet. Reference: https://www.ssh.com/ssh/command/ We will now discuss passwordless authentication which is secure and most commonly used for ssh authentication.","title":"SSH Command"},{"location":"level101/linux_basics/linux_server_administration/#passwordless-authentication-using-ssh","text":"Using this method, we can ssh into hosts without entering the password. This method is also useful when we want some scripts to perform ssh-related tasks. Passwordless authentication requires the use of a public and private key pair. As the name implies, the public key can be shared with anyone but the private key should be kept private. Lets not get into the details of how this authentication works. You can read more about it here Steps for setting up a passwordless authentication with a remote host: Generating public-private key pair If we already have a key pair stored in \\~/.ssh directory, we will not need to generate keys again. Install openssh package which contains all the commands related to ssh. Generate a key pair using the ssh-keygen command. One can choose the default values for all prompts. After running the ssh-keygen command successfully, we should see two keys present in the \\~/.ssh directory. Id_rsa is the private key and id_rsa.pub is the public key. Do note that the private key can only be read and modified by you. Transferring the public key to the remote host There are multiple ways to transfer the public key to the remote server. We will look at one of the most common ways of doing it using the ssh-copy-id command. Install the openssh-clients package to use ssh-copy-id command. Use the ssh-copy-id command to copy your public key to the remote host. Now, ssh into the remote host using the password authentication. Our public key should be there in \\~/.ssh/authorized_keys now. \\~/.ssh/authorized_key contains a list of public keys. The users associated with these public keys have the ssh access into the remote host.","title":"Passwordless Authentication Using SSH"},{"location":"level101/linux_basics/linux_server_administration/#how-to-run-commands-on-a-remote-host","text":"General syntax: ssh \\@\\ \\","title":"How to run commands on a remote host ?"},{"location":"level101/linux_basics/linux_server_administration/#how-to-transfer-files-from-one-host-to-another-host","text":"General syntax: scp \\ \\","title":"How to transfer files from one host to another host ?"},{"location":"level101/linux_basics/linux_server_administration/#package-management","text":"Package management is the process of installing and managing software on the system. We can install the packages which we require from the Linux package distributor. Different distributors use different packaging systems. Packaging systems Distributions Debian style (.deb) Debian, Ubuntu Red Hat style (.rpm) Fedora, CentOS, Red Hat Enterprise Linux Popular Packaging Systems in Linux Command Description yum install \\ Installs a package on your system yum update \\ Updates a package to it's latest available version yum remove \\ Removes a package from your system yum search \\ Searches for a particular keyword DNF is the successor to YUM which is now used in Fedora for installing and managing packages. DNF may replace YUM in the future on all RPM based Linux distributions. We did find an exact match for the keyword httpd when we searched using yum search command. Let's now install the httpd package. After httpd is installed, we will use the yum remove command to remove httpd package.","title":"Package Management"},{"location":"level101/linux_basics/linux_server_administration/#process-management","text":"In this section, we will study about some useful commands that can be used to monitor the processes on Linux systems.","title":"Process Management"},{"location":"level101/linux_basics/linux_server_administration/#ps-process-status","text":"The ps command is used to know the information of a process or list of processes. If you get an error \"ps command not found\" while running ps command, do install procps package. ps without any arguments is not very useful. Let's try to list all the processes on the system by using the below command. Reference: https://unix.stackexchange.com/questions/106847/what-does-aux-mean-in-ps-aux We can use an additional argument with ps command to list the information about the process with a specific process ID. We can use grep in combination with ps command to list only specific processes.","title":"ps (process status)"},{"location":"level101/linux_basics/linux_server_administration/#top","text":"The top command is used to show information about Linux processes running on the system in real time. It also shows a summary of the system information. For each process, top lists down the process ID, owner, priority, state, cpu utilization, memory utilization and much more information. It also lists down the memory utilization and cpu utilization of the system as a whole along with system uptime and cpu load average.","title":"top"},{"location":"level101/linux_basics/linux_server_administration/#memory-management","text":"In this section, we will study about some useful commands that can be used to view information about the system memory.","title":"Memory Management"},{"location":"level101/linux_basics/linux_server_administration/#free","text":"The free command is used to display the memory usage of the system. The command displays the total free and used space available in the RAM along with space occupied by the caches/buffers. free command by default shows the memory usage in kilobytes. We can use an additional argument to get the data in human-readable format.","title":"free"},{"location":"level101/linux_basics/linux_server_administration/#vmstat","text":"The vmstat command can be used to display the memory usage along with additional information about io and cpu usage.","title":"vmstat"},{"location":"level101/linux_basics/linux_server_administration/#checking-disk-space","text":"In this section, we will study about some useful commands that can be used to view disk space on Linux.","title":"Checking Disk Space"},{"location":"level101/linux_basics/linux_server_administration/#df-disk-free","text":"The df command is used to display the free and available space for each mounted file system.","title":"df (disk free)"},{"location":"level101/linux_basics/linux_server_administration/#du-disk-usage","text":"The du command is used to display disk usage of files and directories on the system. The below command can be used to display the top 5 largest directories in the root directory.","title":"du (disk usage)"},{"location":"level101/linux_basics/linux_server_administration/#daemons","text":"A computer program that runs as a background process is called a daemon. Traditionally, the name of daemon processes ended with d - sshd, httpd etc. We cannot interact with a daemon process as they run in the background. Services and daemons are used interchangeably most of the time.","title":"Daemons"},{"location":"level101/linux_basics/linux_server_administration/#systemd","text":"Systemd is a system and service manager for Linux operating systems. Systemd units are the building blocks of systemd. These units are represented by unit configuration files. The below examples shows the unit configuration files available at /usr/lib/systemd/system which are distributed by installed RPM packages. We are more interested in the configuration file that ends with service as these are service units.","title":"Systemd"},{"location":"level101/linux_basics/linux_server_administration/#managing-system-services","text":"Service units end with .service file extension. Systemctl command can be used to start/stop/restart the services managed by systemd. Command Description systemctl start name.service Starts a service systemctl stop name.service Stops a service systemctl restart name.service Restarts a service systemctl status name.service Check the status of a service systemctl reload name.service Reload the configuration of a service","title":"Managing System Services"},{"location":"level101/linux_basics/linux_server_administration/#logs","text":"In this section, we will talk about some important files and directories which can be very useful for viewing system logs and applications logs in Linux. These logs can be very useful when you are troubleshooting on the system.","title":"Logs"},{"location":"level101/linux_networking/conclusion/","text":"Conclusion With this we have traversed through the TCP/IP stack completely. We hope there will be a different perspective when one opens any website in the browser post the course. During the course we have also dissected what are common tasks in this pipeline which falls under the ambit of SRE. Post Training Exercises Setup own DNS resolver in the dev environment which acts as an authoritative DNS server for example.com and forwarder for other domains. Update resolv.conf to use the new DNS resolver running in localhost Set up a site dummy.example.com in localhost and run a webserver with a self signed certificate. Update the trusted CAs or pass self signed CA\u2019s public key as a parameter so that curl https://dummy.example.com -v works properly without self signed cert warning Update the routing table to use another host(container/VM) in the same network as a gateway for 8.8.8.8/32 and run ping 8.8.8.8. Do the packet capture on the new gateway to see L3 hop is working as expected(might need to disable icmp_redirect)","title":"Conclusion"},{"location":"level101/linux_networking/conclusion/#conclusion","text":"With this we have traversed through the TCP/IP stack completely. We hope there will be a different perspective when one opens any website in the browser post the course. During the course we have also dissected what are common tasks in this pipeline which falls under the ambit of SRE.","title":"Conclusion"},{"location":"level101/linux_networking/conclusion/#post-training-exercises","text":"Setup own DNS resolver in the dev environment which acts as an authoritative DNS server for example.com and forwarder for other domains. Update resolv.conf to use the new DNS resolver running in localhost Set up a site dummy.example.com in localhost and run a webserver with a self signed certificate. Update the trusted CAs or pass self signed CA\u2019s public key as a parameter so that curl https://dummy.example.com -v works properly without self signed cert warning Update the routing table to use another host(container/VM) in the same network as a gateway for 8.8.8.8/32 and run ping 8.8.8.8. Do the packet capture on the new gateway to see L3 hop is working as expected(might need to disable icmp_redirect)","title":"Post Training Exercises"},{"location":"level101/linux_networking/dns/","text":"DNS Domain Names are the simple human-readable names for websites. The Internet understands only IP addresses, but since memorizing incoherent numbers is not practical, domain names are used instead. These domain names are translated into IP addresses by the DNS infrastructure. When somebody tries to open www.linkedin.com in the browser, the browser tries to convert www.linkedin.com to an IP Address. This process is called DNS resolution. A simple pseudocode depicting this process looks this ip, err = getIPAddress(domainName) if err: print(\u201cunknown Host Exception while trying to resolve:%s\u201d.format(domainName)) Now let\u2019s try to understand what happens inside the getIPAddress function. The browser would have a DNS cache of its own where it checks if there is a mapping for the domainName to an IP Address already available, in which case the browser uses that IP address. If no such mapping exists, the browser calls gethostbyname syscall to ask the operating system to find the IP address for the given domainName def getIPAddress(domainName): resp, fail = lookupCache(domainName) If not fail: return resp else: resp, err = gethostbyname(domainName) if err: return null, err else: return resp Now lets understand what operating system kernel does when the gethostbyname function is called. The Linux operating system looks at the file /etc/nsswitch.conf file which usually has a line hosts: files dns This line means the OS has to look up first in file (/etc/hosts) and then use DNS protocol to do the resolution if there is no match in /etc/hosts. The file /etc/hosts is of format IPAddress FQDN [FQDN].* 127.0.0.1 localhost.localdomain localhost ::1 localhost.localdomain localhost If a match exists for a domain in this file then that IP address is returned by the OS. Lets add a line to this file 127.0.0.1 test.linkedin.com And then do ping test.linkedin.com ping test.linkedin.com -n PING test.linkedin.com (127.0.0.1) 56(84) bytes of data. 64 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.047 ms 64 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.036 ms 64 bytes from 127.0.0.1: icmp_seq=3 ttl=64 time=0.037 ms As mentioned earlier, if no match exists in /etc/hosts, the OS tries to do a DNS resolution using the DNS protocol. The linux system makes a DNS request to the first IP in /etc/resolv.conf. If there is no response, requests are sent to subsequent servers in resolv.conf. These servers in resolv.conf are called DNS resolvers. The DNS resolvers are populated by DHCP or statically configured by an administrator. Dig is a userspace DNS system which creates and sends request to DNS resolvers and prints the response it receives to the console. #run this command in one shell to capture all DNS requests sudo tcpdump -s 0 -A -i any port 53 #make a dig request from another shell dig linkedin.com 13:19:54.432507 IP 172.19.209.122.56497 > 172.23.195.101.53: 527+ [1au] A? linkedin.com. (41) ....E..E....@.n....z...e...5.1.:... .........linkedin.com.......)........ 13:19:54.485131 IP 172.23.195.101.53 > 172.19.209.122.56497: 527 1/0/1 A 108.174.10.10 (57) ....E..U..@.|. ....e...z.5...A...............linkedin.com..............3..l. ..)........ The packet capture shows a request is made to 172.23.195.101:53 (this is the resolver in /etc/resolv.conf) for linkedin.com and a response is received from 172.23.195.101 with the IP address of linkedin.com 108.174.10.10 Now let's try to understand how DNS resolver tries to find the IP address of linkedin.com. DNS resolver first looks at its cache. Since many devices in the network can query for the domain name linkedin.com, the name resolution result may already exist in the cache. If there is a cache miss, it starts the DNS resolution process. The DNS server breaks \u201clinkedin.com\u201d to \u201c.\u201d, \u201ccom.\u201d and \u201clinkedin.com.\u201d and starts DNS resolution from \u201c.\u201d. The \u201c.\u201d is called root domain and those IPs are known to the DNS resolver software. DNS resolver queries the root domain Nameservers to find the right nameservers which could respond regarding details for \"com.\". The address of the authoritative nameserver of \u201ccom.\u201d is returned. Now the DNS resolution service contacts the authoritative nameserver for \u201ccom.\u201d to fetch the authoritative nameserver for \u201clinkedin.com\u201d. Once an authoritative nameserver of \u201clinkedin.com\u201d is known, the resolver contacts Linkedin\u2019s nameserver to provide the IP address of \u201clinkedin.com\u201d. This whole process can be visualized by running dig +trace linkedin.com linkedin.com. 3600 IN A 108.174.10.10 This DNS response has 5 fields where the first field is the request and the last field is the response. The second field is the Time to Live which says how long the DNS response is valid in seconds. In this case this mapping of linkedin.com is valid for 1 hour. This is how the resolvers and application(browser) maintain their cache. Any request for linkedin.com beyond 1 hour will be treated as a cache miss as the mapping has expired its TTL and the whole process has to be redone. The 4th field says the type of DNS response/request. Some of the various DNS query types are A, AAAA, NS, TXT, PTR, MX and CNAME. - A record returns IPV4 address of the domain name - AAAA record returns the IPV6 address of the domain Name - NS record returns the authoritative nameserver for the domain name - CNAME records are aliases to the domain names. Some domains point to other domain names and resolving the latter domain name gives an IP which is used as an IP for the former domain name as well. Example www.linkedin.com\u2019s IP address is the same as 2-01-2c3e-005a.cdx.cedexis.net. - For the brevity we are not discussing other DNS record types, the RFC of each of these records are available here . dig A linkedin.com +short 108.174.10.10 dig AAAA linkedin.com +short 2620:109:c002::6cae:a0a dig NS linkedin.com +short dns3.p09.nsone.net. dns4.p09.nsone.net. dns2.p09.nsone.net. ns4.p43.dynect.net. ns1.p43.dynect.net. ns2.p43.dynect.net. ns3.p43.dynect.net. dns1.p09.nsone.net. dig www.linkedin.com CNAME +short 2-01-2c3e-005a.cdx.cedexis.net. Armed with these fundamentals of DNS lets see usecases where DNS is used by SREs. Applications in SRE role This section covers some of the common solutions SRE can derive from DNS Every company has to have its internal DNS infrastructure for intranet sites and internal services like databases and other internal applications like wiki. So there has to be a DNS infrastructure maintained for those domain names by the infrastructure team. This DNS infrastructure has to be optimized and scaled so that it doesn\u2019t become a single point of failure. Failure of the internal DNS infrastructure can cause API calls of microservices to fail and other cascading effects. DNS can also be used for discovering services. For example the hostname serviceb.internal.example.com could list instances which run service b internally in example.com company. Cloud providers provide options to enable DNS discovery( example ) DNS is used by cloud providers and CDN providers to scale their services. In Azure/AWS, Load Balancers are given a CNAME instead of IPAddress. They update the IPAddress of the Loadbalancers as they scale by changing the IP Address of alias domain names. This is one of the reasons why A records of such alias domains are short lived like 1 minute. DNS can also be used to make clients get IP addresses closer to their location so that their HTTP calls can be responded faster if the company has a presence geographically distributed. SRE also has to understand since there is no verification in DNS infrastructure, these responses can be spoofed. This is safeguarded by other protocols like HTTPS(dealt later). DNSSEC protects from forged or manipulated DNS responses. Stale DNS cache can be a problem. Some apps might still be using expired DNS records for their api calls. This is something SRE has to be wary of when doing maintenance. DNS Loadbalancing and service discovery also has to understand TTL and the servers can be removed from the pool only after waiting till TTL post the changes are made to DNS records. If this is not done, a certain portion of the traffic will fail as the server is removed before the TTL.","title":"DNS"},{"location":"level101/linux_networking/dns/#dns","text":"Domain Names are the simple human-readable names for websites. The Internet understands only IP addresses, but since memorizing incoherent numbers is not practical, domain names are used instead. These domain names are translated into IP addresses by the DNS infrastructure. When somebody tries to open www.linkedin.com in the browser, the browser tries to convert www.linkedin.com to an IP Address. This process is called DNS resolution. A simple pseudocode depicting this process looks this ip, err = getIPAddress(domainName) if err: print(\u201cunknown Host Exception while trying to resolve:%s\u201d.format(domainName)) Now let\u2019s try to understand what happens inside the getIPAddress function. The browser would have a DNS cache of its own where it checks if there is a mapping for the domainName to an IP Address already available, in which case the browser uses that IP address. If no such mapping exists, the browser calls gethostbyname syscall to ask the operating system to find the IP address for the given domainName def getIPAddress(domainName): resp, fail = lookupCache(domainName) If not fail: return resp else: resp, err = gethostbyname(domainName) if err: return null, err else: return resp Now lets understand what operating system kernel does when the gethostbyname function is called. The Linux operating system looks at the file /etc/nsswitch.conf file which usually has a line hosts: files dns This line means the OS has to look up first in file (/etc/hosts) and then use DNS protocol to do the resolution if there is no match in /etc/hosts. The file /etc/hosts is of format IPAddress FQDN [FQDN].* 127.0.0.1 localhost.localdomain localhost ::1 localhost.localdomain localhost If a match exists for a domain in this file then that IP address is returned by the OS. Lets add a line to this file 127.0.0.1 test.linkedin.com And then do ping test.linkedin.com ping test.linkedin.com -n PING test.linkedin.com (127.0.0.1) 56(84) bytes of data. 64 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.047 ms 64 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.036 ms 64 bytes from 127.0.0.1: icmp_seq=3 ttl=64 time=0.037 ms As mentioned earlier, if no match exists in /etc/hosts, the OS tries to do a DNS resolution using the DNS protocol. The linux system makes a DNS request to the first IP in /etc/resolv.conf. If there is no response, requests are sent to subsequent servers in resolv.conf. These servers in resolv.conf are called DNS resolvers. The DNS resolvers are populated by DHCP or statically configured by an administrator. Dig is a userspace DNS system which creates and sends request to DNS resolvers and prints the response it receives to the console. #run this command in one shell to capture all DNS requests sudo tcpdump -s 0 -A -i any port 53 #make a dig request from another shell dig linkedin.com 13:19:54.432507 IP 172.19.209.122.56497 > 172.23.195.101.53: 527+ [1au] A? linkedin.com. (41) ....E..E....@.n....z...e...5.1.:... .........linkedin.com.......)........ 13:19:54.485131 IP 172.23.195.101.53 > 172.19.209.122.56497: 527 1/0/1 A 108.174.10.10 (57) ....E..U..@.|. ....e...z.5...A...............linkedin.com..............3..l. ..)........ The packet capture shows a request is made to 172.23.195.101:53 (this is the resolver in /etc/resolv.conf) for linkedin.com and a response is received from 172.23.195.101 with the IP address of linkedin.com 108.174.10.10 Now let's try to understand how DNS resolver tries to find the IP address of linkedin.com. DNS resolver first looks at its cache. Since many devices in the network can query for the domain name linkedin.com, the name resolution result may already exist in the cache. If there is a cache miss, it starts the DNS resolution process. The DNS server breaks \u201clinkedin.com\u201d to \u201c.\u201d, \u201ccom.\u201d and \u201clinkedin.com.\u201d and starts DNS resolution from \u201c.\u201d. The \u201c.\u201d is called root domain and those IPs are known to the DNS resolver software. DNS resolver queries the root domain Nameservers to find the right nameservers which could respond regarding details for \"com.\". The address of the authoritative nameserver of \u201ccom.\u201d is returned. Now the DNS resolution service contacts the authoritative nameserver for \u201ccom.\u201d to fetch the authoritative nameserver for \u201clinkedin.com\u201d. Once an authoritative nameserver of \u201clinkedin.com\u201d is known, the resolver contacts Linkedin\u2019s nameserver to provide the IP address of \u201clinkedin.com\u201d. This whole process can be visualized by running dig +trace linkedin.com linkedin.com. 3600 IN A 108.174.10.10 This DNS response has 5 fields where the first field is the request and the last field is the response. The second field is the Time to Live which says how long the DNS response is valid in seconds. In this case this mapping of linkedin.com is valid for 1 hour. This is how the resolvers and application(browser) maintain their cache. Any request for linkedin.com beyond 1 hour will be treated as a cache miss as the mapping has expired its TTL and the whole process has to be redone. The 4th field says the type of DNS response/request. Some of the various DNS query types are A, AAAA, NS, TXT, PTR, MX and CNAME. - A record returns IPV4 address of the domain name - AAAA record returns the IPV6 address of the domain Name - NS record returns the authoritative nameserver for the domain name - CNAME records are aliases to the domain names. Some domains point to other domain names and resolving the latter domain name gives an IP which is used as an IP for the former domain name as well. Example www.linkedin.com\u2019s IP address is the same as 2-01-2c3e-005a.cdx.cedexis.net. - For the brevity we are not discussing other DNS record types, the RFC of each of these records are available here . dig A linkedin.com +short 108.174.10.10 dig AAAA linkedin.com +short 2620:109:c002::6cae:a0a dig NS linkedin.com +short dns3.p09.nsone.net. dns4.p09.nsone.net. dns2.p09.nsone.net. ns4.p43.dynect.net. ns1.p43.dynect.net. ns2.p43.dynect.net. ns3.p43.dynect.net. dns1.p09.nsone.net. dig www.linkedin.com CNAME +short 2-01-2c3e-005a.cdx.cedexis.net. Armed with these fundamentals of DNS lets see usecases where DNS is used by SREs.","title":"DNS"},{"location":"level101/linux_networking/dns/#applications-in-sre-role","text":"This section covers some of the common solutions SRE can derive from DNS Every company has to have its internal DNS infrastructure for intranet sites and internal services like databases and other internal applications like wiki. So there has to be a DNS infrastructure maintained for those domain names by the infrastructure team. This DNS infrastructure has to be optimized and scaled so that it doesn\u2019t become a single point of failure. Failure of the internal DNS infrastructure can cause API calls of microservices to fail and other cascading effects. DNS can also be used for discovering services. For example the hostname serviceb.internal.example.com could list instances which run service b internally in example.com company. Cloud providers provide options to enable DNS discovery( example ) DNS is used by cloud providers and CDN providers to scale their services. In Azure/AWS, Load Balancers are given a CNAME instead of IPAddress. They update the IPAddress of the Loadbalancers as they scale by changing the IP Address of alias domain names. This is one of the reasons why A records of such alias domains are short lived like 1 minute. DNS can also be used to make clients get IP addresses closer to their location so that their HTTP calls can be responded faster if the company has a presence geographically distributed. SRE also has to understand since there is no verification in DNS infrastructure, these responses can be spoofed. This is safeguarded by other protocols like HTTPS(dealt later). DNSSEC protects from forged or manipulated DNS responses. Stale DNS cache can be a problem. Some apps might still be using expired DNS records for their api calls. This is something SRE has to be wary of when doing maintenance. DNS Loadbalancing and service discovery also has to understand TTL and the servers can be removed from the pool only after waiting till TTL post the changes are made to DNS records. If this is not done, a certain portion of the traffic will fail as the server is removed before the TTL.","title":"Applications in SRE role"},{"location":"level101/linux_networking/http/","text":"HTTP Till this point we have only got the IP address of linkedin.com. The HTML page of linkedin.com is served by HTTP protocol which the browser renders. Browser sends a HTTP request to the IP of the server determined above. Request has a verb GET, PUT, POST followed by a path and query parameters and lines of key value pair which gives information about the client and capabilities of the client like contents it can accept and a body (usually in POST or PUT) # Eg run the following in your container and have a look at the headers curl linkedin.com -v * Connected to linkedin.com (108.174.10.10) port 80 (#0) > GET / HTTP/1.1 > Host: linkedin.com > User-Agent: curl/7.64.1 > Accept: */* > < HTTP/1.1 301 Moved Permanently < Date: Mon, 09 Nov 2020 10:39:43 GMT < X-Li-Pop: prod-esv5 < X-LI-Proto: http/1.1 < Location: https://www.linkedin.com/ < Content-Length: 0 < * Connection #0 to host linkedin.com left intact * Closing connection 0 Here, in the first line GET is the verb, / is the path and 1.1 is the HTTP protocol version. Then there are key value pairs which give client capabilities and some details to the server. The server responds back with HTTP version, Status Code and Status message . Status codes 2xx means success, 3xx denotes redirection, 4xx denotes client side errors and 5xx server side errors. We will now jump in to see the difference between HTTP/1.0 and HTTP/1.1. #On the terminal type telnet www.linkedin.com 80 #Copy and paste the following with an empty new line at last in the telnet STDIN GET / HTTP/1.1 HOST:linkedin.com USER-AGENT: curl This would get server response and waits for next input as the underlying connection to www.linkedin.com can be reused for further queries. While going through TCP, we can understand the benefits of this. But in HTTP/1.0 this connection will be immediately closed after the response meaning new connection has to be opened for each query. HTTP/1.1 can have only one inflight request in an open connection but connection can be reused for multiple requests one after another. One of the benefits of HTTP/2.0 over HTTP/1.1 is we can have multiple inflight requests on the same connection. We are restricting our scope to generic HTTP and not jumping to the intricacies of each protocol version but they should be straight forward to understand post the course. HTTP is called stateless protocol . This section we will try to understand what stateless means. Say we logged in to linkedin.com, each request to linkedin.com from the client will have no context of the user and it makes no sense to prompt user to login for each page/resource. This problem of HTTP is solved by COOKIE . A user is created a session when a user logs in. This session identifier is sent to the browser via SET-COOKIE header. The browser stores the COOKIE till the expiry set by the server and sends the cookie for each request from hereon for linkedin.com. More details on cookies are available here . Cookies are a critical piece of information like password and since HTTP is a plain text protocol, any man in the middle can capture either password or cookies and can breach the privacy of the user. Similarly as discussed during DNS a spoofed IP of linkedin.com can cause a phishing attack on users where an user can give linkedin\u2019s password to login on the malicious site. To solve both problems HTTPs came in place and HTTPs has to be mandated. HTTPS has to provide server identification and encryption of data between client and server. The server administrator has to generate a private public key pair and certificate request. This certificate request has to be signed by a certificate authority which converts the certificate request to a certificate. The server administrator has to update the certificate and private key to the webserver. The certificate has details about the server (like domain name for which it serves, expiry date), public key of the server. The private key is a secret to the server and losing the private key loses the trust the server provides. When clients connect, the client sends a HELLO. The server sends its certificate to the client. The client checks the validity of the cert by seeing if it is within its expiry time, if it is signed by a trusted authority and the hostname in the cert is the same as the server. This validation makes sure the server is the right server and there is no phishing. Once that is validated, the client negotiates a symmetrical key and cipher with the server by encrypting the negotiation with the public key of the server. Nobody else other than the server who has the private key can understand this data. Once negotiation is complete, that symmetric key and algorithm is used for further encryption which can be decrypted only by client and server from thereon as they only know the symmetric key and algorithm. The switch to symmetric algorithm from asymmetric encryption algorithm is to not strain the resources of client devices as symmetric encryption is generally less resource intensive than asymmetric. #Try the following on your terminal to see the cert details like Subject Name(domain name), Issuer details, Expiry date curl https://www.linkedin.com -v * Connected to www.linkedin.com (13.107.42.14) port 443 (#0) * ALPN, offering h2 * ALPN, offering http/1.1 * successfully set certificate verify locations: * CAfile: /etc/ssl/cert.pem CApath: none * TLSv1.2 (OUT), TLS handshake, Client hello (1): } [230 bytes data] * TLSv1.2 (IN), TLS handshake, Server hello (2): { [90 bytes data] * TLSv1.2 (IN), TLS handshake, Certificate (11): { [3171 bytes data] * TLSv1.2 (IN), TLS handshake, Server key exchange (12): { [365 bytes data] * TLSv1.2 (IN), TLS handshake, Server finished (14): { [4 bytes data] * TLSv1.2 (OUT), TLS handshake, Client key exchange (16): } [102 bytes data] * TLSv1.2 (OUT), TLS change cipher, Change cipher spec (1): } [1 bytes data] * TLSv1.2 (OUT), TLS handshake, Finished (20): } [16 bytes data] * TLSv1.2 (IN), TLS change cipher, Change cipher spec (1): { [1 bytes data] * TLSv1.2 (IN), TLS handshake, Finished (20): { [16 bytes data] * SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384 * ALPN, server accepted to use h2 * Server certificate: * subject: C=US; ST=California; L=Sunnyvale; O=LinkedIn Corporation; CN=www.linkedin.com * start date: Oct 2 00:00:00 2020 GMT * expire date: Apr 2 12:00:00 2021 GMT * subjectAltName: host \"www.linkedin.com\" matched cert's \"www.linkedin.com\" * issuer: C=US; O=DigiCert Inc; CN=DigiCert SHA2 Secure Server CA * SSL certificate verify ok. * Using HTTP2, server supports multi-use * Connection state changed (HTTP/2 confirmed) * Copying HTTP/2 data in stream buffer to connection buffer after upgrade: len=0 * Using Stream ID: 1 (easy handle 0x7fb055808200) * Connection state changed (MAX_CONCURRENT_STREAMS == 100)! 0 82117 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0 * Connection #0 to host www.linkedin.com left intact HTTP/2 200 cache-control: no-cache, no-store pragma: no-cache content-length: 82117 content-type: text/html; charset=utf-8 expires: Thu, 01 Jan 1970 00:00:00 GMT set-cookie: JSESSIONID=ajax:2747059799136291014; SameSite=None; Path=/; Domain=.www.linkedin.com; Secure set-cookie: lang=v=2&lang=en-us; SameSite=None; Path=/; Domain=linkedin.com; Secure set-cookie: bcookie=\"v=2&70bd59e3-5a51-406c-8e0d-dd70befa8890\"; domain=.linkedin.com; Path=/; Secure; Expires=Wed, 09-Nov-2022 22:27:42 GMT; SameSite=None set-cookie: bscookie=\"v=1&202011091050107ae9b7ac-fe97-40fc-830d-d7a9ccf80659AQGib5iXwarbY8CCBP94Q39THkgUlx6J\"; domain=.www.linkedin.com; Path=/; Secure; Expires=Wed, 09-Nov-2022 22:27:42 GMT; HttpOnly; SameSite=None set-cookie: lissc=1; domain=.linkedin.com; Path=/; Secure; Expires=Tue, 09-Nov-2021 10:50:10 GMT; SameSite=None set-cookie: lidc=\"b=VGST04:s=V:r=V:g=2201:u=1:i=1604919010:t=1605005410:v=1:sig=AQHe-KzU8i_5Iy6MwnFEsgRct3c9Lh5R\"; Expires=Tue, 10 Nov 2020 10:50:10 GMT; domain=.linkedin.com; Path=/; SameSite=None; Secure x-fs-txn-id: 2b8d5409ba70 x-fs-uuid: 61bbf94956d14516302567fc882b0000 expect-ct: max-age=86400, report-uri=\"https://www.linkedin.com/platform-telemetry/ct\" x-xss-protection: 1; mode=block content-security-policy-report-only: default-src 'none'; connect-src 'self' www.linkedin.com www.google-analytics.com https://dpm.demdex.net/id lnkd.demdex.net blob: https://linkedin.sc.omtrdc.net/b/ss/ static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; script-src 'sha256-THuVhwbXPeTR0HszASqMOnIyxqEgvGyBwSPBKBF/iMc=' 'sha256-PyCXNcEkzRWqbiNr087fizmiBBrq9O6GGD8eV3P09Ik=' 'sha256-2SQ55Erm3CPCb+k03EpNxU9bdV3XL9TnVTriDs7INZ4=' 'sha256-S/KSPe186K/1B0JEjbIXcCdpB97krdzX05S+dHnQjUs=' platform.linkedin.com platform-akam.linkedin.com platform-ecst.linkedin.com platform-azur.linkedin.com static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; img-src data: blob: *; font-src data: *; style-src 'self' 'unsafe-inline' static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; media-src dms.licdn.com; child-src blob: *; frame-src 'self' lnkd.demdex.net linkedin.cdn.qualaroo.com; manifest-src 'self'; report-uri https://www.linkedin.com/platform-telemetry/csp?f=g content-security-policy: default-src *; connect-src 'self' https://media-src.linkedin.com/media/ www.linkedin.com s.c.lnkd.licdn.com m.c.lnkd.licdn.com s.c.exp1.licdn.com s.c.exp2.licdn.com m.c.exp1.licdn.com m.c.exp2.licdn.com wss://*.linkedin.com dms.licdn.com https://dpm.demdex.net/id lnkd.demdex.net blob: https://accounts.google.com/gsi/status https://linkedin.sc.omtrdc.net/b/ss/ www.google-analytics.com static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com media.licdn.com media-exp1.licdn.com media-exp2.licdn.com media-exp3.licdn.com; img-src data: blob: *; font-src data: *; style-src 'unsafe-inline' 'self' static-src.linkedin.com *.licdn.com; script-src 'report-sample' 'unsafe-inline' 'unsafe-eval' 'self' spdy.linkedin.com static-src.linkedin.com *.ads.linkedin.com *.licdn.com static.chartbeat.com www.google-analytics.com ssl.google-analytics.com bcvipva02.rightnowtech.com www.bizographics.com sjs.bizographics.com js.bizographics.com d.la4-c1-was.salesforceliveagent.com slideshare.www.linkedin.com https://snap.licdn.com/li.lms-analytics/ platform.linkedin.com platform-akam.linkedin.com platform-ecst.linkedin.com platform-azur.linkedin.com; object-src 'none'; media-src blob: *; child-src blob: lnkd-communities: voyager: *; frame-ancestors 'self'; report-uri https://www.linkedin.com/platform-telemetry/csp?f=l x-frame-options: sameorigin x-content-type-options: nosniff strict-transport-security: max-age=2592000 x-li-fabric: prod-lva1 x-li-pop: afd-prod-lva1 x-li-proto: http/2 x-li-uuid: Ybv5SVbRRRYwJWf8iCsAAA== x-msedge-ref: Ref A: CFB9AC1D2B0645DDB161CEE4A4909AEF Ref B: BOM02EDGE0712 Ref C: 2020-11-09T10:50:10Z date: Mon, 09 Nov 2020 10:50:10 GMT * Closing connection 0 Here my system has a list of certificate authorities it trusts in this file /etc/ssl/cert.pem. Curl validates the certificate is for www.linkedin.com by seeing the CN section of the subject part of the certificate. It also makes sure the certificate is not expired by seeing the expire date. It also validates the signature on the certificate by using the public key of issuer Digicert in /etc/ssl/cert.pem. Once this is done, using the public key of www.linkedin.com it negotiates cipher TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 with a symmetric key. Subsequent data transfer including first HTTP request uses the same cipher and symmetric key.","title":"HTTP"},{"location":"level101/linux_networking/http/#http","text":"Till this point we have only got the IP address of linkedin.com. The HTML page of linkedin.com is served by HTTP protocol which the browser renders. Browser sends a HTTP request to the IP of the server determined above. Request has a verb GET, PUT, POST followed by a path and query parameters and lines of key value pair which gives information about the client and capabilities of the client like contents it can accept and a body (usually in POST or PUT) # Eg run the following in your container and have a look at the headers curl linkedin.com -v * Connected to linkedin.com (108.174.10.10) port 80 (#0) > GET / HTTP/1.1 > Host: linkedin.com > User-Agent: curl/7.64.1 > Accept: */* > < HTTP/1.1 301 Moved Permanently < Date: Mon, 09 Nov 2020 10:39:43 GMT < X-Li-Pop: prod-esv5 < X-LI-Proto: http/1.1 < Location: https://www.linkedin.com/ < Content-Length: 0 < * Connection #0 to host linkedin.com left intact * Closing connection 0 Here, in the first line GET is the verb, / is the path and 1.1 is the HTTP protocol version. Then there are key value pairs which give client capabilities and some details to the server. The server responds back with HTTP version, Status Code and Status message . Status codes 2xx means success, 3xx denotes redirection, 4xx denotes client side errors and 5xx server side errors. We will now jump in to see the difference between HTTP/1.0 and HTTP/1.1. #On the terminal type telnet www.linkedin.com 80 #Copy and paste the following with an empty new line at last in the telnet STDIN GET / HTTP/1.1 HOST:linkedin.com USER-AGENT: curl This would get server response and waits for next input as the underlying connection to www.linkedin.com can be reused for further queries. While going through TCP, we can understand the benefits of this. But in HTTP/1.0 this connection will be immediately closed after the response meaning new connection has to be opened for each query. HTTP/1.1 can have only one inflight request in an open connection but connection can be reused for multiple requests one after another. One of the benefits of HTTP/2.0 over HTTP/1.1 is we can have multiple inflight requests on the same connection. We are restricting our scope to generic HTTP and not jumping to the intricacies of each protocol version but they should be straight forward to understand post the course. HTTP is called stateless protocol . This section we will try to understand what stateless means. Say we logged in to linkedin.com, each request to linkedin.com from the client will have no context of the user and it makes no sense to prompt user to login for each page/resource. This problem of HTTP is solved by COOKIE . A user is created a session when a user logs in. This session identifier is sent to the browser via SET-COOKIE header. The browser stores the COOKIE till the expiry set by the server and sends the cookie for each request from hereon for linkedin.com. More details on cookies are available here . Cookies are a critical piece of information like password and since HTTP is a plain text protocol, any man in the middle can capture either password or cookies and can breach the privacy of the user. Similarly as discussed during DNS a spoofed IP of linkedin.com can cause a phishing attack on users where an user can give linkedin\u2019s password to login on the malicious site. To solve both problems HTTPs came in place and HTTPs has to be mandated. HTTPS has to provide server identification and encryption of data between client and server. The server administrator has to generate a private public key pair and certificate request. This certificate request has to be signed by a certificate authority which converts the certificate request to a certificate. The server administrator has to update the certificate and private key to the webserver. The certificate has details about the server (like domain name for which it serves, expiry date), public key of the server. The private key is a secret to the server and losing the private key loses the trust the server provides. When clients connect, the client sends a HELLO. The server sends its certificate to the client. The client checks the validity of the cert by seeing if it is within its expiry time, if it is signed by a trusted authority and the hostname in the cert is the same as the server. This validation makes sure the server is the right server and there is no phishing. Once that is validated, the client negotiates a symmetrical key and cipher with the server by encrypting the negotiation with the public key of the server. Nobody else other than the server who has the private key can understand this data. Once negotiation is complete, that symmetric key and algorithm is used for further encryption which can be decrypted only by client and server from thereon as they only know the symmetric key and algorithm. The switch to symmetric algorithm from asymmetric encryption algorithm is to not strain the resources of client devices as symmetric encryption is generally less resource intensive than asymmetric. #Try the following on your terminal to see the cert details like Subject Name(domain name), Issuer details, Expiry date curl https://www.linkedin.com -v * Connected to www.linkedin.com (13.107.42.14) port 443 (#0) * ALPN, offering h2 * ALPN, offering http/1.1 * successfully set certificate verify locations: * CAfile: /etc/ssl/cert.pem CApath: none * TLSv1.2 (OUT), TLS handshake, Client hello (1): } [230 bytes data] * TLSv1.2 (IN), TLS handshake, Server hello (2): { [90 bytes data] * TLSv1.2 (IN), TLS handshake, Certificate (11): { [3171 bytes data] * TLSv1.2 (IN), TLS handshake, Server key exchange (12): { [365 bytes data] * TLSv1.2 (IN), TLS handshake, Server finished (14): { [4 bytes data] * TLSv1.2 (OUT), TLS handshake, Client key exchange (16): } [102 bytes data] * TLSv1.2 (OUT), TLS change cipher, Change cipher spec (1): } [1 bytes data] * TLSv1.2 (OUT), TLS handshake, Finished (20): } [16 bytes data] * TLSv1.2 (IN), TLS change cipher, Change cipher spec (1): { [1 bytes data] * TLSv1.2 (IN), TLS handshake, Finished (20): { [16 bytes data] * SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384 * ALPN, server accepted to use h2 * Server certificate: * subject: C=US; ST=California; L=Sunnyvale; O=LinkedIn Corporation; CN=www.linkedin.com * start date: Oct 2 00:00:00 2020 GMT * expire date: Apr 2 12:00:00 2021 GMT * subjectAltName: host \"www.linkedin.com\" matched cert's \"www.linkedin.com\" * issuer: C=US; O=DigiCert Inc; CN=DigiCert SHA2 Secure Server CA * SSL certificate verify ok. * Using HTTP2, server supports multi-use * Connection state changed (HTTP/2 confirmed) * Copying HTTP/2 data in stream buffer to connection buffer after upgrade: len=0 * Using Stream ID: 1 (easy handle 0x7fb055808200) * Connection state changed (MAX_CONCURRENT_STREAMS == 100)! 0 82117 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0 * Connection #0 to host www.linkedin.com left intact HTTP/2 200 cache-control: no-cache, no-store pragma: no-cache content-length: 82117 content-type: text/html; charset=utf-8 expires: Thu, 01 Jan 1970 00:00:00 GMT set-cookie: JSESSIONID=ajax:2747059799136291014; SameSite=None; Path=/; Domain=.www.linkedin.com; Secure set-cookie: lang=v=2&lang=en-us; SameSite=None; Path=/; Domain=linkedin.com; Secure set-cookie: bcookie=\"v=2&70bd59e3-5a51-406c-8e0d-dd70befa8890\"; domain=.linkedin.com; Path=/; Secure; Expires=Wed, 09-Nov-2022 22:27:42 GMT; SameSite=None set-cookie: bscookie=\"v=1&202011091050107ae9b7ac-fe97-40fc-830d-d7a9ccf80659AQGib5iXwarbY8CCBP94Q39THkgUlx6J\"; domain=.www.linkedin.com; Path=/; Secure; Expires=Wed, 09-Nov-2022 22:27:42 GMT; HttpOnly; SameSite=None set-cookie: lissc=1; domain=.linkedin.com; Path=/; Secure; Expires=Tue, 09-Nov-2021 10:50:10 GMT; SameSite=None set-cookie: lidc=\"b=VGST04:s=V:r=V:g=2201:u=1:i=1604919010:t=1605005410:v=1:sig=AQHe-KzU8i_5Iy6MwnFEsgRct3c9Lh5R\"; Expires=Tue, 10 Nov 2020 10:50:10 GMT; domain=.linkedin.com; Path=/; SameSite=None; Secure x-fs-txn-id: 2b8d5409ba70 x-fs-uuid: 61bbf94956d14516302567fc882b0000 expect-ct: max-age=86400, report-uri=\"https://www.linkedin.com/platform-telemetry/ct\" x-xss-protection: 1; mode=block content-security-policy-report-only: default-src 'none'; connect-src 'self' www.linkedin.com www.google-analytics.com https://dpm.demdex.net/id lnkd.demdex.net blob: https://linkedin.sc.omtrdc.net/b/ss/ static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; script-src 'sha256-THuVhwbXPeTR0HszASqMOnIyxqEgvGyBwSPBKBF/iMc=' 'sha256-PyCXNcEkzRWqbiNr087fizmiBBrq9O6GGD8eV3P09Ik=' 'sha256-2SQ55Erm3CPCb+k03EpNxU9bdV3XL9TnVTriDs7INZ4=' 'sha256-S/KSPe186K/1B0JEjbIXcCdpB97krdzX05S+dHnQjUs=' platform.linkedin.com platform-akam.linkedin.com platform-ecst.linkedin.com platform-azur.linkedin.com static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; img-src data: blob: *; font-src data: *; style-src 'self' 'unsafe-inline' static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; media-src dms.licdn.com; child-src blob: *; frame-src 'self' lnkd.demdex.net linkedin.cdn.qualaroo.com; manifest-src 'self'; report-uri https://www.linkedin.com/platform-telemetry/csp?f=g content-security-policy: default-src *; connect-src 'self' https://media-src.linkedin.com/media/ www.linkedin.com s.c.lnkd.licdn.com m.c.lnkd.licdn.com s.c.exp1.licdn.com s.c.exp2.licdn.com m.c.exp1.licdn.com m.c.exp2.licdn.com wss://*.linkedin.com dms.licdn.com https://dpm.demdex.net/id lnkd.demdex.net blob: https://accounts.google.com/gsi/status https://linkedin.sc.omtrdc.net/b/ss/ www.google-analytics.com static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com media.licdn.com media-exp1.licdn.com media-exp2.licdn.com media-exp3.licdn.com; img-src data: blob: *; font-src data: *; style-src 'unsafe-inline' 'self' static-src.linkedin.com *.licdn.com; script-src 'report-sample' 'unsafe-inline' 'unsafe-eval' 'self' spdy.linkedin.com static-src.linkedin.com *.ads.linkedin.com *.licdn.com static.chartbeat.com www.google-analytics.com ssl.google-analytics.com bcvipva02.rightnowtech.com www.bizographics.com sjs.bizographics.com js.bizographics.com d.la4-c1-was.salesforceliveagent.com slideshare.www.linkedin.com https://snap.licdn.com/li.lms-analytics/ platform.linkedin.com platform-akam.linkedin.com platform-ecst.linkedin.com platform-azur.linkedin.com; object-src 'none'; media-src blob: *; child-src blob: lnkd-communities: voyager: *; frame-ancestors 'self'; report-uri https://www.linkedin.com/platform-telemetry/csp?f=l x-frame-options: sameorigin x-content-type-options: nosniff strict-transport-security: max-age=2592000 x-li-fabric: prod-lva1 x-li-pop: afd-prod-lva1 x-li-proto: http/2 x-li-uuid: Ybv5SVbRRRYwJWf8iCsAAA== x-msedge-ref: Ref A: CFB9AC1D2B0645DDB161CEE4A4909AEF Ref B: BOM02EDGE0712 Ref C: 2020-11-09T10:50:10Z date: Mon, 09 Nov 2020 10:50:10 GMT * Closing connection 0 Here my system has a list of certificate authorities it trusts in this file /etc/ssl/cert.pem. Curl validates the certificate is for www.linkedin.com by seeing the CN section of the subject part of the certificate. It also makes sure the certificate is not expired by seeing the expire date. It also validates the signature on the certificate by using the public key of issuer Digicert in /etc/ssl/cert.pem. Once this is done, using the public key of www.linkedin.com it negotiates cipher TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 with a symmetric key. Subsequent data transfer including first HTTP request uses the same cipher and symmetric key.","title":"HTTP"},{"location":"level101/linux_networking/intro/","text":"Linux Networking Fundamentals Prerequisites High-level knowledge of commonly used jargon in TCP/IP stack like DNS, TCP, UDP and HTTP Linux Commandline Basics What to expect from this course Throughout the course, we cover how an SRE can optimize the system to improve their web stack performance and troubleshoot if there is an issue in any of the layers of the networking stack. This course tries to dig through each layer of traditional TCP/IP stack and expects an SRE to have a picture beyond the bird\u2019s eye view of the functioning of the Internet. What is not covered under this course This course spends time on the fundamentals. We are not covering concepts like HTTP/2.0 , QUIC , TCP congestion control protocols , Anycast , BGP , CDN , Tunnels and Multicast . We expect that this course will provide the relevant basics to understand such concepts Birds eye view of the course The course covers the question \u201cWhat happens when you open linkedin.com in your browser?\u201d The course follows the flow of TCP/IP stack.More specifically, the course covers topics of Application layer protocols DNS and HTTP, transport layer protocols UDP and TCP, networking layer protocol IP and Data Link Layer protocol Course Contents DNS UDP HTTP TCP IP Routing","title":"Introduction"},{"location":"level101/linux_networking/intro/#linux-networking-fundamentals","text":"","title":"Linux Networking Fundamentals"},{"location":"level101/linux_networking/intro/#prerequisites","text":"High-level knowledge of commonly used jargon in TCP/IP stack like DNS, TCP, UDP and HTTP Linux Commandline Basics","title":"Prerequisites"},{"location":"level101/linux_networking/intro/#what-to-expect-from-this-course","text":"Throughout the course, we cover how an SRE can optimize the system to improve their web stack performance and troubleshoot if there is an issue in any of the layers of the networking stack. This course tries to dig through each layer of traditional TCP/IP stack and expects an SRE to have a picture beyond the bird\u2019s eye view of the functioning of the Internet.","title":"What to expect from this course"},{"location":"level101/linux_networking/intro/#what-is-not-covered-under-this-course","text":"This course spends time on the fundamentals. We are not covering concepts like HTTP/2.0 , QUIC , TCP congestion control protocols , Anycast , BGP , CDN , Tunnels and Multicast . We expect that this course will provide the relevant basics to understand such concepts","title":"What is not covered under this course"},{"location":"level101/linux_networking/intro/#birds-eye-view-of-the-course","text":"The course covers the question \u201cWhat happens when you open linkedin.com in your browser?\u201d The course follows the flow of TCP/IP stack.More specifically, the course covers topics of Application layer protocols DNS and HTTP, transport layer protocols UDP and TCP, networking layer protocol IP and Data Link Layer protocol","title":"Birds eye view of the course"},{"location":"level101/linux_networking/intro/#course-contents","text":"DNS UDP HTTP TCP IP Routing","title":"Course Contents"},{"location":"level101/linux_networking/ipr/","text":"IP Routing and Data Link Layer We will dig how packets that leave the client reach the server and vice versa. When the packet reaches the IP layer, the transport layer populates source port, destination port. IP/Network layer populates destination IP(discovered from DNS) and then looks up the route to the destination IP on the routing table. #Linux route -n command gives the default routing table route -n Kernel IP routing table Destination Gateway Genmask Flags Metric Ref Use Iface 0.0.0.0 172.17.0.1 0.0.0.0 UG 0 0 0 eth0 172.17.0.0 0.0.0.0 255.255.0.0 U 0 0 0 eth0 Here the destination IP is bitwise AND\u2019d with the Genmask and if the answer is the destination part of the table then that gateway and interface is picked for routing. Here linkedin.com\u2019s IP 108.174.10.10 is AND\u2019d with 255.255.255.0 and the answer we get is 108.174.10.0 which doesn\u2019t match with any destination in the routing table. Then Linux does an AND of destination IP with 0.0.0.0 and we get 0.0.0.0. This answer matches the default row Routing table is processed in the order of more octets of 1 set in genmask and genmask 0.0.0.0 is the default route if nothing matches. At the end of this operation Linux figured out that the packet has to be sent to next hop 172.17.0.1 via eth0. The source IP of the packet will be set as the IP of interface eth0. Now to send the packet to 172.17.0.1 linux has to figure out the MAC address of 172.17.0.1. MAC address is figured by looking at the internal arp cache which stores translation between IP address and MAC address. If there is a cache miss, Linux broadcasts ARP request within the internal network asking who has 172.17.0.1. The owner of the IP sends an ARP response which is cached by the kernel and the kernel sends the packet to the gateway by setting Source mac address as mac address of eth0 and destination mac address of 172.17.0.1 which we got just now. Similar routing lookup process is followed in each hop till the packet reaches the actual server. Transport layer and layers above it come to play only at end servers. During intermediate hops only till the IP/Network layer is involved. One weird gateway we saw in the routing table is 0.0.0.0. This gateway means no Layer3(Network layer) hop is needed to send the packet. Both source and destination are in the same network. Kernel has to figure out the mac of the destination and populate source and destination mac appropriately and send the packet out so that it reaches the destination without any Layer3 hop in the middle As we followed in other modules, lets complete this session with SRE usecases Applications in SRE role Generally the routing table is populated by DHCP and playing around is not a good practice. There can be reasons where one has to play around the routing table but take that path only when it's absolutely necessary Understanding error messages better like, \u201cNo route to host\u201d error can mean mac address of the destination host is not found and it can mean the destination host is down On rare cases looking at the ARP table can help us understand if there is a IP conflict where same IP is assigned to two hosts by mistake and this is causing unexpected behavior","title":"Routing"},{"location":"level101/linux_networking/ipr/#ip-routing-and-data-link-layer","text":"We will dig how packets that leave the client reach the server and vice versa. When the packet reaches the IP layer, the transport layer populates source port, destination port. IP/Network layer populates destination IP(discovered from DNS) and then looks up the route to the destination IP on the routing table. #Linux route -n command gives the default routing table route -n Kernel IP routing table Destination Gateway Genmask Flags Metric Ref Use Iface 0.0.0.0 172.17.0.1 0.0.0.0 UG 0 0 0 eth0 172.17.0.0 0.0.0.0 255.255.0.0 U 0 0 0 eth0 Here the destination IP is bitwise AND\u2019d with the Genmask and if the answer is the destination part of the table then that gateway and interface is picked for routing. Here linkedin.com\u2019s IP 108.174.10.10 is AND\u2019d with 255.255.255.0 and the answer we get is 108.174.10.0 which doesn\u2019t match with any destination in the routing table. Then Linux does an AND of destination IP with 0.0.0.0 and we get 0.0.0.0. This answer matches the default row Routing table is processed in the order of more octets of 1 set in genmask and genmask 0.0.0.0 is the default route if nothing matches. At the end of this operation Linux figured out that the packet has to be sent to next hop 172.17.0.1 via eth0. The source IP of the packet will be set as the IP of interface eth0. Now to send the packet to 172.17.0.1 linux has to figure out the MAC address of 172.17.0.1. MAC address is figured by looking at the internal arp cache which stores translation between IP address and MAC address. If there is a cache miss, Linux broadcasts ARP request within the internal network asking who has 172.17.0.1. The owner of the IP sends an ARP response which is cached by the kernel and the kernel sends the packet to the gateway by setting Source mac address as mac address of eth0 and destination mac address of 172.17.0.1 which we got just now. Similar routing lookup process is followed in each hop till the packet reaches the actual server. Transport layer and layers above it come to play only at end servers. During intermediate hops only till the IP/Network layer is involved. One weird gateway we saw in the routing table is 0.0.0.0. This gateway means no Layer3(Network layer) hop is needed to send the packet. Both source and destination are in the same network. Kernel has to figure out the mac of the destination and populate source and destination mac appropriately and send the packet out so that it reaches the destination without any Layer3 hop in the middle As we followed in other modules, lets complete this session with SRE usecases","title":"IP Routing and Data Link Layer"},{"location":"level101/linux_networking/ipr/#applications-in-sre-role","text":"Generally the routing table is populated by DHCP and playing around is not a good practice. There can be reasons where one has to play around the routing table but take that path only when it's absolutely necessary Understanding error messages better like, \u201cNo route to host\u201d error can mean mac address of the destination host is not found and it can mean the destination host is down On rare cases looking at the ARP table can help us understand if there is a IP conflict where same IP is assigned to two hosts by mistake and this is causing unexpected behavior","title":"Applications in SRE role"},{"location":"level101/linux_networking/tcp/","text":"TCP TCP is a transport layer protocol like UDP but it guarantees reliability, flow control and congestion control. TCP guarantees reliable delivery by using sequence numbers. A TCP connection is established by a three way handshake. In our case, the client sends a SYN packet along with the starting sequence number it plans to use, the server acknowledges the SYN packet and sends a SYN with its sequence number. Once the client acknowledges the syn packet, the connection is established. Each data transferred from here on is considered delivered reliably once acknowledgement for that sequence is received by the concerned party #To understand handshake run packet capture on one bash session tcpdump -S -i any port 80 #Run curl on one bash session curl www.linkedin.com Here client sends a syn flag shown by [S] flag with a sequence number 1522264672. The server acknowledges receipt of SYN with an ack [.] flag and a Syn flag for its sequence number[S]. The server uses the sequence number 1063230400 and acknowledges the client it\u2019s expecting sequence number 1522264673 (client sequence+1). Client sends a zero length acknowledgement packet to the server(server sequence+1) and connection stands established. This is called three way handshake. The client sends a 76 bytes length packet after this and increments its sequence number by 76. Server sends a 170 byte response and closes the connection. This was the difference we were talking about between HTTP/1.1 and HTTP/1.0. In HTTP/1.1 this same connection can be reused which reduces overhead of 3 way handshake for each HTTP request. If a packet is missed between client and server, server won\u2019t send an ack to the client and client would retry sending the packet till the ACK is received. This guarantees reliability. The flow control is established by the win size field in each segment. The win size says available TCP buffer length in the kernel which can be used to buffer received segments. A size 0 means the receiver has a lot of lag to catch from its socket buffer and the sender has to pause sending packets so that receiver can cope up. This flow control protects from slow receiver and fast sender problem TCP also does congestion control which determines how many segments can be in transit without an ack. Linux provides us the ability to configure algorithms for congestion control which we are not covering here. While closing a connection, client/server calls a close syscall. Let's assume client do that. Client\u2019s kernel will send a FIN packet to the server. Server\u2019s kernel can\u2019t close the connection till the close syscall is called by the server application. Once server app calls close, server also sends a FIN packet and client enters into time wait state for 2*MSS(120s) so that this socket can\u2019t be reused for that time period to prevent any TCP state corruptions due to stray stale packets. Armed with our TCP and HTTP knowledge lets see how this is used by SREs in their role Applications in SRE role Scaling HTTP performance using load balancers need consistent knowledge about both TCP and HTTP. There are different kinds of load balancing like L4, L7 load balancing, Direct Server Return etc. HTTPs offloading can be done on Load balancer or directly on servers based on the performance and compliance needs. Tweaking sysctl variables for rmem and wmem like we did for UDP can improve throughput of sender and receiver. Sysctl variable tcp_max_syn_backlog and socket variable somax_conn determines how many connections for which the kernel can complete 3 way handshake before app calling accept syscall. This is much useful in single threaded applications. Once the backlog is full, new connections stay in SYN_RCVD state (when you run netstat) till the application calls accept syscall Apps can run out of file descriptors if there are too many short lived connections. Digging through tcp_reuse and tcp_recycle can help reduce time spent in the time wait state(it has its own risk). Making apps reuse a pool of connections instead of creating ad hoc connection can also help Understanding performance bottlenecks by seeing metrics and classifying whether its a problem in App or network side. Example too many sockets in Close_wait state is a problem on application whereas retransmissions can be a problem more on network or on OS stack than the application itself. Understanding the fundamentals can help us narrow down where the bottleneck is","title":"TCP"},{"location":"level101/linux_networking/tcp/#tcp","text":"TCP is a transport layer protocol like UDP but it guarantees reliability, flow control and congestion control. TCP guarantees reliable delivery by using sequence numbers. A TCP connection is established by a three way handshake. In our case, the client sends a SYN packet along with the starting sequence number it plans to use, the server acknowledges the SYN packet and sends a SYN with its sequence number. Once the client acknowledges the syn packet, the connection is established. Each data transferred from here on is considered delivered reliably once acknowledgement for that sequence is received by the concerned party #To understand handshake run packet capture on one bash session tcpdump -S -i any port 80 #Run curl on one bash session curl www.linkedin.com Here client sends a syn flag shown by [S] flag with a sequence number 1522264672. The server acknowledges receipt of SYN with an ack [.] flag and a Syn flag for its sequence number[S]. The server uses the sequence number 1063230400 and acknowledges the client it\u2019s expecting sequence number 1522264673 (client sequence+1). Client sends a zero length acknowledgement packet to the server(server sequence+1) and connection stands established. This is called three way handshake. The client sends a 76 bytes length packet after this and increments its sequence number by 76. Server sends a 170 byte response and closes the connection. This was the difference we were talking about between HTTP/1.1 and HTTP/1.0. In HTTP/1.1 this same connection can be reused which reduces overhead of 3 way handshake for each HTTP request. If a packet is missed between client and server, server won\u2019t send an ack to the client and client would retry sending the packet till the ACK is received. This guarantees reliability. The flow control is established by the win size field in each segment. The win size says available TCP buffer length in the kernel which can be used to buffer received segments. A size 0 means the receiver has a lot of lag to catch from its socket buffer and the sender has to pause sending packets so that receiver can cope up. This flow control protects from slow receiver and fast sender problem TCP also does congestion control which determines how many segments can be in transit without an ack. Linux provides us the ability to configure algorithms for congestion control which we are not covering here. While closing a connection, client/server calls a close syscall. Let's assume client do that. Client\u2019s kernel will send a FIN packet to the server. Server\u2019s kernel can\u2019t close the connection till the close syscall is called by the server application. Once server app calls close, server also sends a FIN packet and client enters into time wait state for 2*MSS(120s) so that this socket can\u2019t be reused for that time period to prevent any TCP state corruptions due to stray stale packets. Armed with our TCP and HTTP knowledge lets see how this is used by SREs in their role","title":"TCP"},{"location":"level101/linux_networking/tcp/#applications-in-sre-role","text":"Scaling HTTP performance using load balancers need consistent knowledge about both TCP and HTTP. There are different kinds of load balancing like L4, L7 load balancing, Direct Server Return etc. HTTPs offloading can be done on Load balancer or directly on servers based on the performance and compliance needs. Tweaking sysctl variables for rmem and wmem like we did for UDP can improve throughput of sender and receiver. Sysctl variable tcp_max_syn_backlog and socket variable somax_conn determines how many connections for which the kernel can complete 3 way handshake before app calling accept syscall. This is much useful in single threaded applications. Once the backlog is full, new connections stay in SYN_RCVD state (when you run netstat) till the application calls accept syscall Apps can run out of file descriptors if there are too many short lived connections. Digging through tcp_reuse and tcp_recycle can help reduce time spent in the time wait state(it has its own risk). Making apps reuse a pool of connections instead of creating ad hoc connection can also help Understanding performance bottlenecks by seeing metrics and classifying whether its a problem in App or network side. Example too many sockets in Close_wait state is a problem on application whereas retransmissions can be a problem more on network or on OS stack than the application itself. Understanding the fundamentals can help us narrow down where the bottleneck is","title":"Applications in SRE role"},{"location":"level101/linux_networking/udp/","text":"UDP UDP is a transport layer protocol. DNS is an application layer protocol that runs on top of UDP(most of the times). Before jumping into UDP, let's try to understand what an application and transport layer is. DNS protocol is used by a DNS client(eg dig) and DNS server(eg named). The transport layer makes sure the DNS request reaches the DNS server process and similarly the response reaches the DNS client process. Multiple processes can run on a system and they can listen on any ports . DNS servers usually listen on port number 53. When a client makes a DNS request, after filling the necessary application payload, it passes the payload to the kernel via sendto system call. The kernel picks a random port number( >1024 ) as source port number and puts 53 as destination port number and sends the packet to lower layers. When the kernel on server side receives the packet, it checks the port number and queues the packet to the application buffer of the DNS server process which makes a recvfrom system call and reads the packet. This process by the kernel is called multiplexing(combining packets from multiple applications to same lower layers) and demultiplexing(segregating packets from single lower layer to multiple applications). Multiplexing and Demultiplexing is done by the Transport layer. UDP is one of the simplest transport layer protocol and it does only multiplexing and demultiplexing. Another common transport layer protocol TCP does a bunch of other things like reliable communication, flow control and congestion control. UDP is designed to be lightweight and handle communications with little overhead. So it doesn\u2019t do anything beyond multiplexing and demultiplexing. If applications running on top of UDP need any of the features of TCP, they have to implement that in their application This example from python wiki covers a sample UDP client and server where \u201cHello World\u201d is an application payload sent to server listening on port number 5005. The server receives the packet and prints the \u201cHello World\u201d string from the client Applications in SRE role If the underlying network is slow and the UDP layer is unable to queue packets down to the networking layer, sendto syscall from the application will hang till the kernel finds some of its buffer is freed. This can affect the throughput of the system. Increasing write memory buffer values using sysctl variables net.core.wmem_max and net.core.wmem_default provides some cushion to the application from the slow network Similarly if the receiver process is slow in consuming from its buffer, the kernel has to drop packets which it can\u2019t queue due to the buffer being full. Since UDP doesn\u2019t guarantee reliability these dropped packets can cause data loss unless tracked by the application layer. Increasing sysctl variables rmem_default and rmem_max can provide some cushion to slow applications from fast senders.","title":"UDP"},{"location":"level101/linux_networking/udp/#udp","text":"UDP is a transport layer protocol. DNS is an application layer protocol that runs on top of UDP(most of the times). Before jumping into UDP, let's try to understand what an application and transport layer is. DNS protocol is used by a DNS client(eg dig) and DNS server(eg named). The transport layer makes sure the DNS request reaches the DNS server process and similarly the response reaches the DNS client process. Multiple processes can run on a system and they can listen on any ports . DNS servers usually listen on port number 53. When a client makes a DNS request, after filling the necessary application payload, it passes the payload to the kernel via sendto system call. The kernel picks a random port number( >1024 ) as source port number and puts 53 as destination port number and sends the packet to lower layers. When the kernel on server side receives the packet, it checks the port number and queues the packet to the application buffer of the DNS server process which makes a recvfrom system call and reads the packet. This process by the kernel is called multiplexing(combining packets from multiple applications to same lower layers) and demultiplexing(segregating packets from single lower layer to multiple applications). Multiplexing and Demultiplexing is done by the Transport layer. UDP is one of the simplest transport layer protocol and it does only multiplexing and demultiplexing. Another common transport layer protocol TCP does a bunch of other things like reliable communication, flow control and congestion control. UDP is designed to be lightweight and handle communications with little overhead. So it doesn\u2019t do anything beyond multiplexing and demultiplexing. If applications running on top of UDP need any of the features of TCP, they have to implement that in their application This example from python wiki covers a sample UDP client and server where \u201cHello World\u201d is an application payload sent to server listening on port number 5005. The server receives the packet and prints the \u201cHello World\u201d string from the client","title":"UDP"},{"location":"level101/linux_networking/udp/#applications-in-sre-role","text":"If the underlying network is slow and the UDP layer is unable to queue packets down to the networking layer, sendto syscall from the application will hang till the kernel finds some of its buffer is freed. This can affect the throughput of the system. Increasing write memory buffer values using sysctl variables net.core.wmem_max and net.core.wmem_default provides some cushion to the application from the slow network Similarly if the receiver process is slow in consuming from its buffer, the kernel has to drop packets which it can\u2019t queue due to the buffer being full. Since UDP doesn\u2019t guarantee reliability these dropped packets can cause data loss unless tracked by the application layer. Increasing sysctl variables rmem_default and rmem_max can provide some cushion to slow applications from fast senders.","title":"Applications in SRE role"},{"location":"level101/metrics_and_monitoring/alerts/","text":"Proactive monitoring using alerts Earlier we discussed different ways to collect key metric data points from a service and its underlying infrastructure. This data gives us a better understanding of how the service is performing. One of the main objectives of monitoring is to detect any service degradations early (reduce Mean Time To Detect) and notify stakeholders so that the issues are either avoided or can be fixed early, thus reducing Mean Time To Recover (MTTR). For example, if you are notified when resource usage by a service exceeds 90 percent, you can take preventive measures to avoid any service breakdown due to a shortage of resources. On the other hand, when a service goes down due to an issue, early detection and notification of such incidents can help you quickly fix the issue. Figure 8: An alert notification received on Slack Today most of the monitoring services available provide a mechanism to set up alerts on one or a combination of metrics to actively monitor the service health. These alerts have a set of defined rules or conditions, and when the rule is broken, you are notified. These rules can be as simple as notifying when the metric value exceeds n to as complex as a week over week (WoW) comparison of standard deviation over a period of time. Monitoring tools notify you about an active alert, and most of these tools support instant messaging (IM) platforms, SMS, email, or phone calls. Figure 8 shows a sample alert notification received on Slack for memory usage exceeding 90 percent of total RAM space on the host.","title":"Proactive Monitoring with Alerts"},{"location":"level101/metrics_and_monitoring/alerts/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/alerts/#proactive-monitoring-using-alerts","text":"Earlier we discussed different ways to collect key metric data points from a service and its underlying infrastructure. This data gives us a better understanding of how the service is performing. One of the main objectives of monitoring is to detect any service degradations early (reduce Mean Time To Detect) and notify stakeholders so that the issues are either avoided or can be fixed early, thus reducing Mean Time To Recover (MTTR). For example, if you are notified when resource usage by a service exceeds 90 percent, you can take preventive measures to avoid any service breakdown due to a shortage of resources. On the other hand, when a service goes down due to an issue, early detection and notification of such incidents can help you quickly fix the issue. Figure 8: An alert notification received on Slack Today most of the monitoring services available provide a mechanism to set up alerts on one or a combination of metrics to actively monitor the service health. These alerts have a set of defined rules or conditions, and when the rule is broken, you are notified. These rules can be as simple as notifying when the metric value exceeds n to as complex as a week over week (WoW) comparison of standard deviation over a period of time. Monitoring tools notify you about an active alert, and most of these tools support instant messaging (IM) platforms, SMS, email, or phone calls. Figure 8 shows a sample alert notification received on Slack for memory usage exceeding 90 percent of total RAM space on the host.","title":"Proactive monitoring using alerts"},{"location":"level101/metrics_and_monitoring/best_practices/","text":"Best practices for monitoring When setting up monitoring for a service, keep the following best practices in mind. Use the right metric type -- Most of the libraries available today offer various metric types. Choose the appropriate metric type for monitoring your system. Following are the types of metrics and their purposes. Gauge -- Gauge is a constant type of metric. After the metric is initialized, the metric value does not change unless you intentionally update it. Timer -- Timer measures the time taken to complete a task. Counter -- Counter counts the number of occurrences of a particular event. For more information about these metric types, see Data Types . Avoid over-monitoring -- Monitoring can be a significant engineering endeavor . Therefore, be sure not to spend too much time and resources on monitoring services, yet make sure all important metrics are captured. Prevent alert fatigue -- Set alerts for metrics that are important and actionable. If you receive too many non-critical alerts, you might start ignoring alert notifications over time. As a result, critical alerts might get overlooked. Have a runbook for alerts -- For every alert, make sure you have a document explaining what actions and checks need to be performed when the alert fires. This enables any engineer on the team to handle the alert and take necessary actions, without any help from others.","title":"Best Practices for Monitoring"},{"location":"level101/metrics_and_monitoring/best_practices/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/best_practices/#best-practices-for-monitoring","text":"When setting up monitoring for a service, keep the following best practices in mind. Use the right metric type -- Most of the libraries available today offer various metric types. Choose the appropriate metric type for monitoring your system. Following are the types of metrics and their purposes. Gauge -- Gauge is a constant type of metric. After the metric is initialized, the metric value does not change unless you intentionally update it. Timer -- Timer measures the time taken to complete a task. Counter -- Counter counts the number of occurrences of a particular event. For more information about these metric types, see Data Types . Avoid over-monitoring -- Monitoring can be a significant engineering endeavor . Therefore, be sure not to spend too much time and resources on monitoring services, yet make sure all important metrics are captured. Prevent alert fatigue -- Set alerts for metrics that are important and actionable. If you receive too many non-critical alerts, you might start ignoring alert notifications over time. As a result, critical alerts might get overlooked. Have a runbook for alerts -- For every alert, make sure you have a document explaining what actions and checks need to be performed when the alert fires. This enables any engineer on the team to handle the alert and take necessary actions, without any help from others.","title":"Best practices for monitoring"},{"location":"level101/metrics_and_monitoring/command-line_tools/","text":"Command-line tools Most of the Linux distributions today come with a set of tools that monitor the system's performance. These tools help you measure and understand various subsystem statistics (CPU, memory, network, and so on). Let's look at some of the tools that are predominantly used. ps/top -- The process status command (ps) displays information about all the currently running processes in a Linux system. The top command is similar to the ps command, but it periodically updates the information displayed until the program is terminated. An advanced version of top, called htop, has a more user-friendly interface and some additional features. These command-line utilities come with options to modify the operation and output of the command. Following are some important options supported by the ps command. -p -- Displays information about processes that match the specified process IDs. Similarly, you can use -u and -g to display information about processes belonging to a specific user or group. -a -- Displays information about other users' processes, as well as one's own. -x -- When displaying processes matched by other options, includes processes that do not have a controlling terminal. Figure 2: Results of top command ss -- The socket statistics command (ss) displays information about network sockets on the system. This tool is the successor of netstat , which is deprecated. Following are some command-line options supported by the ss command: -t -- Displays the TCP socket. Similarly, -u displays UDP sockets, -x is for UNIX domain sockets, and so on. -l -- Displays only listening sockets. -n -- Instructs the command to not resolve service names. Instead displays the port numbers. Figure 3: List of listening sockets on a system free -- The free command displays memory usage statistics on the host like available memory, used memory, and free memory. Most often, this command is used with the -h command-line option, which displays the statistics in a human-readable format. Figure 4: Memory statistics on a host in human-readable form df -- The df command displays disk space usage statistics. The -i command-line option is also often used to display inode usage statistics. The -h command-line option is used for displaying statistics in a human-readable format. Figure 5: Disk usage statistics on a system in human-readable form sar -- The sar utility monitors various subsystems, such as CPU and memory, in real time. This data can be stored in a file specified with the -o option. This tool helps to identify anomalies. iftop -- The interface top command ( iftop ) displays bandwidth utilization by a host on an interface. This command is often used to identify bandwidth usage by active connections. The -i option specifies which network interface to watch. Figure 6: Network bandwidth usage by active connection on the host tcpdump -- The tcpdump command is a network monitoring tool that captures network packets flowing over the network and displays a description of the captured packets. The following options are available: -i -- Interface to listen on host -- Filters traffic going to or from the specified host src/dst -- Displays one-way traffic from the source (src) or to the destination (dst) port -- Filters traffic to or from a particular port Figure 7: *tcpdump* of packets on *docker0* interface on a host","title":"Command-line Tools"},{"location":"level101/metrics_and_monitoring/command-line_tools/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/command-line_tools/#command-line-tools","text":"Most of the Linux distributions today come with a set of tools that monitor the system's performance. These tools help you measure and understand various subsystem statistics (CPU, memory, network, and so on). Let's look at some of the tools that are predominantly used. ps/top -- The process status command (ps) displays information about all the currently running processes in a Linux system. The top command is similar to the ps command, but it periodically updates the information displayed until the program is terminated. An advanced version of top, called htop, has a more user-friendly interface and some additional features. These command-line utilities come with options to modify the operation and output of the command. Following are some important options supported by the ps command. -p -- Displays information about processes that match the specified process IDs. Similarly, you can use -u and -g to display information about processes belonging to a specific user or group. -a -- Displays information about other users' processes, as well as one's own. -x -- When displaying processes matched by other options, includes processes that do not have a controlling terminal. Figure 2: Results of top command ss -- The socket statistics command (ss) displays information about network sockets on the system. This tool is the successor of netstat , which is deprecated. Following are some command-line options supported by the ss command: -t -- Displays the TCP socket. Similarly, -u displays UDP sockets, -x is for UNIX domain sockets, and so on. -l -- Displays only listening sockets. -n -- Instructs the command to not resolve service names. Instead displays the port numbers. Figure 3: List of listening sockets on a system free -- The free command displays memory usage statistics on the host like available memory, used memory, and free memory. Most often, this command is used with the -h command-line option, which displays the statistics in a human-readable format. Figure 4: Memory statistics on a host in human-readable form df -- The df command displays disk space usage statistics. The -i command-line option is also often used to display inode usage statistics. The -h command-line option is used for displaying statistics in a human-readable format. Figure 5: Disk usage statistics on a system in human-readable form sar -- The sar utility monitors various subsystems, such as CPU and memory, in real time. This data can be stored in a file specified with the -o option. This tool helps to identify anomalies. iftop -- The interface top command ( iftop ) displays bandwidth utilization by a host on an interface. This command is often used to identify bandwidth usage by active connections. The -i option specifies which network interface to watch. Figure 6: Network bandwidth usage by active connection on the host tcpdump -- The tcpdump command is a network monitoring tool that captures network packets flowing over the network and displays a description of the captured packets. The following options are available: -i -- Interface to listen on host -- Filters traffic going to or from the specified host src/dst -- Displays one-way traffic from the source (src) or to the destination (dst) port -- Filters traffic to or from a particular port Figure 7: *tcpdump* of packets on *docker0* interface on a host","title":"Command-line tools"},{"location":"level101/metrics_and_monitoring/conclusion/","text":"Conclusion A robust monitoring and alerting system is necessary for maintaining and troubleshooting a system. A dashboard with key metrics can give you an overview of service performance, all in one place. Well-defined alerts (with realistic thresholds and notifications) further enable you to quickly identify any anomalies in the service infrastructure and in resource saturation. By taking necessary actions, you can avoid any service degradations and decrease MTTD for service breakdowns. In addition to in-house monitoring, monitoring real user experience can help you to understand service performance as perceived by the users. Many modules are involved in serving the user, and most of them are out of your control. Therefore, you need to have real-user monitoring in place. Metrics give very abstract details on service performance. To get a better understanding of the system and for faster recovery during incidents, you might want to implement the other two pillars of observability: logs and tracing. Logs and trace data can help you understand what led to service failure or degradation. Following are some resources to learn more about monitoring and observability: Google SRE book: Monitoring Distributed Systems Mastering Distributed Tracing by Yuri Shkuro References Google SRE book: Monitoring Distributed Systems Mastering Distributed Tracing, by Yuri Shkuro Monitoring and Observability Three PIllars with Zero Answers Engineering blogs on LinkedIn , Grafana , Elastic.co , OpenTelemetry","title":"Conclusion"},{"location":"level101/metrics_and_monitoring/conclusion/#conclusion","text":"A robust monitoring and alerting system is necessary for maintaining and troubleshooting a system. A dashboard with key metrics can give you an overview of service performance, all in one place. Well-defined alerts (with realistic thresholds and notifications) further enable you to quickly identify any anomalies in the service infrastructure and in resource saturation. By taking necessary actions, you can avoid any service degradations and decrease MTTD for service breakdowns. In addition to in-house monitoring, monitoring real user experience can help you to understand service performance as perceived by the users. Many modules are involved in serving the user, and most of them are out of your control. Therefore, you need to have real-user monitoring in place. Metrics give very abstract details on service performance. To get a better understanding of the system and for faster recovery during incidents, you might want to implement the other two pillars of observability: logs and tracing. Logs and trace data can help you understand what led to service failure or degradation. Following are some resources to learn more about monitoring and observability: Google SRE book: Monitoring Distributed Systems Mastering Distributed Tracing by Yuri Shkuro","title":"Conclusion"},{"location":"level101/metrics_and_monitoring/conclusion/#references","text":"Google SRE book: Monitoring Distributed Systems Mastering Distributed Tracing, by Yuri Shkuro Monitoring and Observability Three PIllars with Zero Answers Engineering blogs on LinkedIn , Grafana , Elastic.co , OpenTelemetry","title":"References"},{"location":"level101/metrics_and_monitoring/introduction/","text":"Prerequisites Linux Basics Python and the Web Systems Design Linux Networking Fundamentals What to expect from this course Monitoring is an integral part of any system. As an SRE, you need to have a basic understanding of monitoring a service infrastructure. By the end of this course, you will gain a better understanding of the following topics: What is monitoring? What needs to be measured How the metrics gathered can be used to improve business decisions and overall reliability Proactive monitoring with alerts Log processing and its importance What is observability? Distributed tracing Logs Metrics What is not covered in this course Guide to setting up a monitoring infrastructure Deep dive into different monitoring technologies and benchmarking or comparison of any tools Course content Introduction Four golden signals of monitoring Why is monitoring important? Command-line tools Third-party monitoring Proactive monitoring using alerts Best practices for monitoring Observability Logs Tracing Conclusion Introduction Monitoring is a process of collecting real-time performance metrics from a system, analyzing the data to derive meaningful information, and displaying the data to the users. In simple terms, you measure various metrics regularly to understand the state of the system, including but not limited to, user requests, latency, and error rate. What gets measured, gets fixed ---if you can measure something, you can reason about it, understand it, discuss it, and act upon it with confidence. Four golden signals of monitoring When setting up monitoring for a system, you need to decide what to measure. The four golden signals of monitoring provide a good understanding of service performance and lay a foundation for monitoring a system. These four golden signals are Traffic Latency Error Saturation These metrics help you to understand the system performance and bottlenecks, and to create a better end-user experience. As discussed in the Google SRE book , if you can measure only four metrics of your service, focus on these four. Let's look at each of the four golden signals. Traffic -- Traffic gives a better understanding of the service demand. Often referred to as service QPS (queries per second), traffic is a measure of requests served by the service. This signal helps you to decide when a service needs to be scaled up to handle increasing customer demand and scaled down to be cost-effective. Latency -- Latency is the measure of time taken by the service to process the incoming request and send the response. Measuring service latency helps in the early detection of slow degradation of the service. Distinguishing between the latency of successful requests and the latency of failed requests is important. For example, an HTTP 5XX error triggered due to loss of connection to a database or other critical backend might be served very quickly. However, because an HTTP 500 error indicates a failed request, factoring 500s into overall latency might result in misleading calculations. Error (rate) -- Error is the measure of failed client requests. These failures can be easily identified based on the response codes ( HTTP 5XX error ). There might be cases where the response is considered erroneous due to wrong result data or due to policy violations. For example, you might get an HTTP 200 response, but the body has incomplete data, or response time is breaching the agreed-upon SLA s. Therefore, you need to have other mechanisms (code logic or instrumentation ) in place to capture errors in addition to the response codes. Saturation -- Saturation is a measure of the resource utilization by a service. This signal tells you the state of service resources and how full they are. These resources include memory, compute, network I/O, and so on. Service performance slowly degrades even before resource utilization is at 100 percent. Therefore, having a utilization target is important. An increase in latency is a good indicator of saturation; measuring the 99th percentile of latency can help in the early detection of saturation. Depending on the type of service, you can measure these signals in different ways. For example, you might measure queries per second served for a web server. In contrast, for a database server, transactions performed and database sessions created give you an idea about the traffic handled by the database server. With the help of additional code logic (monitoring libraries and instrumentation), you can measure these signals periodically and store them for future analysis. Although these metrics give you an idea about the performance at the service end, you need to also ensure that the same user experience is delivered at the client end. Therefore, you might need to monitor the service from outside the service infrastructure, which is discussed under third-party monitoring. Why is monitoring important? Monitoring plays a key role in the success of a service. As discussed earlier, monitoring provides performance insights for understanding service health. With access to historical data collected over time, you can build intelligent applications to address specific needs. Some of the key use cases follow: Reduction in time to resolve issues -- With a good monitoring infrastructure in place, you can identify issues quickly and resolve them, which reduces the impact caused by the issues. Business decisions -- Data collected over a period of time can help you make business decisions such as determining the product release cycle, which features to invest in, and geographical areas to focus on. Decisions based on long-term data can improve the overall product experience. Resource planning -- By analyzing historical data, you can forecast service compute-resource demands, and you can properly allocate resources. This allows financially effective decisions, with no compromise in end-user experience. Before we dive deeper into monitoring, let's understand some basic terminologies. Metric -- A metric is a quantitative measure of a particular system attribute---for example, memory or CPU Node or host -- A physical server, virtual machine, or container where an application is running QPS -- Queries Per Second , a measure of traffic served by the service per second Latency -- The time interval between user action and the response from the server---for example, time spent after sending a query to a database before the first response bit is received Error rate -- Number of errors observed over a particular time period (usually a second) Graph -- In monitoring, a graph is a representation of one or more values of metrics collected over time Dashboard -- A dashboard is a collection of graphs that provide an overview of system health Incident -- An incident is an event that disrupts the normal operations of a system MTTD -- Mean Time To Detect is the time interval between the beginning of a service failure and the detection of such failure MTTR -- Mean Time To Resolve is the time spent to fix a service failure and bring the service back to its normal state Before we discuss monitoring an application, let us look at the monitoring infrastructure. Following is an illustration of a basic monitoring system. Figure 1: Illustration of a monitoring infrastructure Figure 1 shows a monitoring infrastructure mechanism for aggregating metrics on the system, and collecting and storing the data for display. In addition, a monitoring infrastructure includes alert subsystems for notifying concerned parties during any abnormal behavior. Let's look at each of these infrastructure components: Host metrics agent -- A host metrics agent is a process running on the host that collects performance statistics for host subsystems such as memory, CPU, and network. These metrics are regularly relayed to a metrics collector for storage and visualization. Some examples are collectd , telegraf , and metricbeat . Metric aggregator -- A metric aggregator is a process running on the host. Applications running on the host collect service metrics using instrumentation . Collected metrics are sent either to the aggregator process or directly to the metrics collector over API, if available. Received metrics are aggregated periodically and relayed to the metrics collector in batches. An example is StatsD . Metrics collector -- A metrics collector process collects all the metrics from the metric aggregators running on multiple hosts. The collector takes care of decoding and stores this data on the database. Metric collection and storage might be taken care of by one single service such as InfluxDB , which we discuss next. An example is carbon daemons . Storage -- A time-series database stores all of these metrics. Examples are OpenTSDB , Whisper , and InfluxDB . Metrics server -- A metrics server can be as basic as a web server that graphically renders metric data. In addition, the metrics server provides aggregation functionalities and APIs for fetching metric data programmatically. Some examples are Grafana and Graphite-Web . Alert manager -- The alert manager regularly polls metric data available and, if there are any anomalies detected, notifies you. Each alert has a set of rules for identifying such anomalies. Today many metrics servers such as Grafana support alert management. We discuss alerting in detail later . Examples are Grafana and Icinga .","title":"Introduction"},{"location":"level101/metrics_and_monitoring/introduction/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/introduction/#prerequisites","text":"Linux Basics Python and the Web Systems Design Linux Networking Fundamentals","title":"Prerequisites"},{"location":"level101/metrics_and_monitoring/introduction/#what-to-expect-from-this-course","text":"Monitoring is an integral part of any system. As an SRE, you need to have a basic understanding of monitoring a service infrastructure. By the end of this course, you will gain a better understanding of the following topics: What is monitoring? What needs to be measured How the metrics gathered can be used to improve business decisions and overall reliability Proactive monitoring with alerts Log processing and its importance What is observability? Distributed tracing Logs Metrics","title":"What to expect from this course"},{"location":"level101/metrics_and_monitoring/introduction/#what-is-not-covered-in-this-course","text":"Guide to setting up a monitoring infrastructure Deep dive into different monitoring technologies and benchmarking or comparison of any tools","title":"What is not covered in this course"},{"location":"level101/metrics_and_monitoring/introduction/#course-content","text":"Introduction Four golden signals of monitoring Why is monitoring important? Command-line tools Third-party monitoring Proactive monitoring using alerts Best practices for monitoring Observability Logs Tracing Conclusion","title":"Course content"},{"location":"level101/metrics_and_monitoring/introduction/#_2","text":"","title":""},{"location":"level101/metrics_and_monitoring/introduction/#introduction","text":"Monitoring is a process of collecting real-time performance metrics from a system, analyzing the data to derive meaningful information, and displaying the data to the users. In simple terms, you measure various metrics regularly to understand the state of the system, including but not limited to, user requests, latency, and error rate. What gets measured, gets fixed ---if you can measure something, you can reason about it, understand it, discuss it, and act upon it with confidence.","title":"Introduction"},{"location":"level101/metrics_and_monitoring/introduction/#four-golden-signals-of-monitoring","text":"When setting up monitoring for a system, you need to decide what to measure. The four golden signals of monitoring provide a good understanding of service performance and lay a foundation for monitoring a system. These four golden signals are Traffic Latency Error Saturation These metrics help you to understand the system performance and bottlenecks, and to create a better end-user experience. As discussed in the Google SRE book , if you can measure only four metrics of your service, focus on these four. Let's look at each of the four golden signals. Traffic -- Traffic gives a better understanding of the service demand. Often referred to as service QPS (queries per second), traffic is a measure of requests served by the service. This signal helps you to decide when a service needs to be scaled up to handle increasing customer demand and scaled down to be cost-effective. Latency -- Latency is the measure of time taken by the service to process the incoming request and send the response. Measuring service latency helps in the early detection of slow degradation of the service. Distinguishing between the latency of successful requests and the latency of failed requests is important. For example, an HTTP 5XX error triggered due to loss of connection to a database or other critical backend might be served very quickly. However, because an HTTP 500 error indicates a failed request, factoring 500s into overall latency might result in misleading calculations. Error (rate) -- Error is the measure of failed client requests. These failures can be easily identified based on the response codes ( HTTP 5XX error ). There might be cases where the response is considered erroneous due to wrong result data or due to policy violations. For example, you might get an HTTP 200 response, but the body has incomplete data, or response time is breaching the agreed-upon SLA s. Therefore, you need to have other mechanisms (code logic or instrumentation ) in place to capture errors in addition to the response codes. Saturation -- Saturation is a measure of the resource utilization by a service. This signal tells you the state of service resources and how full they are. These resources include memory, compute, network I/O, and so on. Service performance slowly degrades even before resource utilization is at 100 percent. Therefore, having a utilization target is important. An increase in latency is a good indicator of saturation; measuring the 99th percentile of latency can help in the early detection of saturation. Depending on the type of service, you can measure these signals in different ways. For example, you might measure queries per second served for a web server. In contrast, for a database server, transactions performed and database sessions created give you an idea about the traffic handled by the database server. With the help of additional code logic (monitoring libraries and instrumentation), you can measure these signals periodically and store them for future analysis. Although these metrics give you an idea about the performance at the service end, you need to also ensure that the same user experience is delivered at the client end. Therefore, you might need to monitor the service from outside the service infrastructure, which is discussed under third-party monitoring.","title":"Four golden signals of monitoring"},{"location":"level101/metrics_and_monitoring/introduction/#why-is-monitoring-important","text":"Monitoring plays a key role in the success of a service. As discussed earlier, monitoring provides performance insights for understanding service health. With access to historical data collected over time, you can build intelligent applications to address specific needs. Some of the key use cases follow: Reduction in time to resolve issues -- With a good monitoring infrastructure in place, you can identify issues quickly and resolve them, which reduces the impact caused by the issues. Business decisions -- Data collected over a period of time can help you make business decisions such as determining the product release cycle, which features to invest in, and geographical areas to focus on. Decisions based on long-term data can improve the overall product experience. Resource planning -- By analyzing historical data, you can forecast service compute-resource demands, and you can properly allocate resources. This allows financially effective decisions, with no compromise in end-user experience. Before we dive deeper into monitoring, let's understand some basic terminologies. Metric -- A metric is a quantitative measure of a particular system attribute---for example, memory or CPU Node or host -- A physical server, virtual machine, or container where an application is running QPS -- Queries Per Second , a measure of traffic served by the service per second Latency -- The time interval between user action and the response from the server---for example, time spent after sending a query to a database before the first response bit is received Error rate -- Number of errors observed over a particular time period (usually a second) Graph -- In monitoring, a graph is a representation of one or more values of metrics collected over time Dashboard -- A dashboard is a collection of graphs that provide an overview of system health Incident -- An incident is an event that disrupts the normal operations of a system MTTD -- Mean Time To Detect is the time interval between the beginning of a service failure and the detection of such failure MTTR -- Mean Time To Resolve is the time spent to fix a service failure and bring the service back to its normal state Before we discuss monitoring an application, let us look at the monitoring infrastructure. Following is an illustration of a basic monitoring system. Figure 1: Illustration of a monitoring infrastructure Figure 1 shows a monitoring infrastructure mechanism for aggregating metrics on the system, and collecting and storing the data for display. In addition, a monitoring infrastructure includes alert subsystems for notifying concerned parties during any abnormal behavior. Let's look at each of these infrastructure components: Host metrics agent -- A host metrics agent is a process running on the host that collects performance statistics for host subsystems such as memory, CPU, and network. These metrics are regularly relayed to a metrics collector for storage and visualization. Some examples are collectd , telegraf , and metricbeat . Metric aggregator -- A metric aggregator is a process running on the host. Applications running on the host collect service metrics using instrumentation . Collected metrics are sent either to the aggregator process or directly to the metrics collector over API, if available. Received metrics are aggregated periodically and relayed to the metrics collector in batches. An example is StatsD . Metrics collector -- A metrics collector process collects all the metrics from the metric aggregators running on multiple hosts. The collector takes care of decoding and stores this data on the database. Metric collection and storage might be taken care of by one single service such as InfluxDB , which we discuss next. An example is carbon daemons . Storage -- A time-series database stores all of these metrics. Examples are OpenTSDB , Whisper , and InfluxDB . Metrics server -- A metrics server can be as basic as a web server that graphically renders metric data. In addition, the metrics server provides aggregation functionalities and APIs for fetching metric data programmatically. Some examples are Grafana and Graphite-Web . Alert manager -- The alert manager regularly polls metric data available and, if there are any anomalies detected, notifies you. Each alert has a set of rules for identifying such anomalies. Today many metrics servers such as Grafana support alert management. We discuss alerting in detail later . Examples are Grafana and Icinga .","title":"Why is monitoring important?"},{"location":"level101/metrics_and_monitoring/observability/","text":"Observability Engineers often use observability when referring to building reliable systems. Observability is a term derived from control theory, It is a measure of how well internal states of a system can be inferred from knowledge of its external outputs. Service infrastructures used on a daily basis are becoming more and more complex; proactive monitoring alone is not sufficient to quickly resolve issues causing application failures. With monitoring, you can keep known past failures from recurring, but with a complex service architecture, many unknown factors can cause potential problems. To address such cases, you can make the service observable. An observable system provides highly granular insights into the implicit failure modes. In addition, an observable system furnishes ample context about its inner workings, which unlocks the ability to uncover deeper systemic issues. Monitoring enables failure detection; observability helps in gaining a better understanding of the system. Among engineers, there is a common misconception that monitoring and observability are two different things. Actually, observability is the superset to monitoring; that is, monitoring improves service observability. The goal of observability is not only to detect problems, but also to understand where the issue is and what is causing it. In addition to metrics, observability has two more pillars: logs and traces, as shown in Figure 9. Although these three components do not make a system 100 percent observable, these are the most important and powerful components that give a better understanding of the system. Each of these pillars has its flaws, which are described in Three Pillars with Zero Answers . Figure 9: Three pillars of observability Because we have covered metrics already, let's look at the other two pillars (logs and traces). Logs Logs (often referred to as events ) are a record of activities performed by a service during its run time, with a corresponding timestamp. Metrics give abstract information about degradations in a system, and logs give a detailed view of what is causing these degradations. Logs created by the applications and infrastructure components help in effectively understanding the behavior of the system by providing details on application errors, exceptions, and event timelines. Logs help you to go back in time to understand the events that led to a failure. Therefore, examining logs is essential to troubleshooting system failures. Log processing involves the aggregation of different logs from individual applications and their subsequent shipment to central storage. Moving logs to central storage helps to preserve the logs, in case the application instances are inaccessible, or the application crashes due to a failure. After the logs are available in a central place, you can analyze the logs to derive sensible information from them. For audit and compliance purposes, you archive these logs on the central storage for a certain period of time. Log analyzers fetch useful information from log lines, such as request user information, request URL (feature), and response headers (such as content length) and response time. This information is grouped based on these attributes and made available to you through a visualization tool for quick understanding. You might be wondering how this log information helps. This information gives a holistic view of activities performed on all the involved entities. For example, let's say someone is performing a DoS (denial of service) attack on a web application. With the help of log processing, you can quickly look at top client IPs derived from access logs and identify where the attack is coming from. Similarly, if a feature in an application is causing a high error rate when accessed with a particular request parameter value, the results of log analysis can help you to quickly identify the misbehaving parameter value and take further action. Figure 10: Log processing and analysis using ELK stack Figure 10 shows a log processing platform using ELK (Elasticsearch, Logstash, Kibana), which provides centralized log processing. Beats is a collection of lightweight data shippers that can ship logs, audit data, network data, and so on over the network. In this use case specifically, we are using filebeat as a log shipper. Filebeat watches service log files and ships the log data to Logstash. Logstash parses these logs and transforms the data, preparing it to store on Elasticsearch. Transformed log data is stored on Elasticsearch and indexed for fast retrieval. Kibana searches and displays log data stored on Elasticsearch. Kibana also provides a set of visualizations for graphically displaying summaries derived from log data. Storing logs is expensive. And extensive logging of every event on the server is costly and takes up more storage space. With an increasing number of services, this cost can increase proportionally to the number of services. Tracing So far, we covered the importance of metrics and logging. Metrics give an abstract overview of the system, and logging gives a record of events that occurred. Imagine a complex distributed system with multiple microservices, where a user request is processed by multiple microservices in the system. Metrics and logging give you some information about how these requests are being handled by the system, but they fail to provide detailed information across all the microservices and how they affect a particular client request. If a slow downstream microservice is leading to increased response times, you need to have detailed visibility across all involved microservices to identify such microservice. The answer to this need is a request tracing mechanism. A trace is a series of spans, where each span is a record of events performed by different microservices to serve the client's request. In simple terms, a trace is a log of client-request serving derived from various microservices across different physical machines. Each span includes span metadata such as trace ID and span ID, and context, which includes information about transactions performed. Figure 11: Trace and spans for a URL shortener request Figure 11 is a graphical representation of a trace captured on the URL shortener example we covered earlier while learning Python. Similar to monitoring, the tracing infrastructure comprises a few modules for collecting traces, storing them, and accessing them. Each microservice runs a tracing library that collects traces in the background, creates in-memory batches, and submits the tracing backend. The tracing backend normalizes received trace data and stores it on persistent storage. Tracing data comes from multiple different microservices; therefore, trace storage is often organized to store data incrementally and is indexed by trace identifier. This organization helps in the reconstruction of trace data and in visualization. Figure 12 illustrates the anatomy of the distributed system. Figure 12: Anatomy of distributed tracing Today a set of tools and frameworks are available for building distributed tracing solutions. Following are some of the popular tools: OpenTelemetry : Observability framework for cloud-native software Jaeger : Open-source distributed tracing solution Zipkin : Open-source distributed tracing solution","title":"Observability"},{"location":"level101/metrics_and_monitoring/observability/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/observability/#observability","text":"Engineers often use observability when referring to building reliable systems. Observability is a term derived from control theory, It is a measure of how well internal states of a system can be inferred from knowledge of its external outputs. Service infrastructures used on a daily basis are becoming more and more complex; proactive monitoring alone is not sufficient to quickly resolve issues causing application failures. With monitoring, you can keep known past failures from recurring, but with a complex service architecture, many unknown factors can cause potential problems. To address such cases, you can make the service observable. An observable system provides highly granular insights into the implicit failure modes. In addition, an observable system furnishes ample context about its inner workings, which unlocks the ability to uncover deeper systemic issues. Monitoring enables failure detection; observability helps in gaining a better understanding of the system. Among engineers, there is a common misconception that monitoring and observability are two different things. Actually, observability is the superset to monitoring; that is, monitoring improves service observability. The goal of observability is not only to detect problems, but also to understand where the issue is and what is causing it. In addition to metrics, observability has two more pillars: logs and traces, as shown in Figure 9. Although these three components do not make a system 100 percent observable, these are the most important and powerful components that give a better understanding of the system. Each of these pillars has its flaws, which are described in Three Pillars with Zero Answers . Figure 9: Three pillars of observability Because we have covered metrics already, let's look at the other two pillars (logs and traces).","title":"Observability"},{"location":"level101/metrics_and_monitoring/observability/#logs","text":"Logs (often referred to as events ) are a record of activities performed by a service during its run time, with a corresponding timestamp. Metrics give abstract information about degradations in a system, and logs give a detailed view of what is causing these degradations. Logs created by the applications and infrastructure components help in effectively understanding the behavior of the system by providing details on application errors, exceptions, and event timelines. Logs help you to go back in time to understand the events that led to a failure. Therefore, examining logs is essential to troubleshooting system failures. Log processing involves the aggregation of different logs from individual applications and their subsequent shipment to central storage. Moving logs to central storage helps to preserve the logs, in case the application instances are inaccessible, or the application crashes due to a failure. After the logs are available in a central place, you can analyze the logs to derive sensible information from them. For audit and compliance purposes, you archive these logs on the central storage for a certain period of time. Log analyzers fetch useful information from log lines, such as request user information, request URL (feature), and response headers (such as content length) and response time. This information is grouped based on these attributes and made available to you through a visualization tool for quick understanding. You might be wondering how this log information helps. This information gives a holistic view of activities performed on all the involved entities. For example, let's say someone is performing a DoS (denial of service) attack on a web application. With the help of log processing, you can quickly look at top client IPs derived from access logs and identify where the attack is coming from. Similarly, if a feature in an application is causing a high error rate when accessed with a particular request parameter value, the results of log analysis can help you to quickly identify the misbehaving parameter value and take further action. Figure 10: Log processing and analysis using ELK stack Figure 10 shows a log processing platform using ELK (Elasticsearch, Logstash, Kibana), which provides centralized log processing. Beats is a collection of lightweight data shippers that can ship logs, audit data, network data, and so on over the network. In this use case specifically, we are using filebeat as a log shipper. Filebeat watches service log files and ships the log data to Logstash. Logstash parses these logs and transforms the data, preparing it to store on Elasticsearch. Transformed log data is stored on Elasticsearch and indexed for fast retrieval. Kibana searches and displays log data stored on Elasticsearch. Kibana also provides a set of visualizations for graphically displaying summaries derived from log data. Storing logs is expensive. And extensive logging of every event on the server is costly and takes up more storage space. With an increasing number of services, this cost can increase proportionally to the number of services.","title":"Logs"},{"location":"level101/metrics_and_monitoring/observability/#tracing","text":"So far, we covered the importance of metrics and logging. Metrics give an abstract overview of the system, and logging gives a record of events that occurred. Imagine a complex distributed system with multiple microservices, where a user request is processed by multiple microservices in the system. Metrics and logging give you some information about how these requests are being handled by the system, but they fail to provide detailed information across all the microservices and how they affect a particular client request. If a slow downstream microservice is leading to increased response times, you need to have detailed visibility across all involved microservices to identify such microservice. The answer to this need is a request tracing mechanism. A trace is a series of spans, where each span is a record of events performed by different microservices to serve the client's request. In simple terms, a trace is a log of client-request serving derived from various microservices across different physical machines. Each span includes span metadata such as trace ID and span ID, and context, which includes information about transactions performed. Figure 11: Trace and spans for a URL shortener request Figure 11 is a graphical representation of a trace captured on the URL shortener example we covered earlier while learning Python. Similar to monitoring, the tracing infrastructure comprises a few modules for collecting traces, storing them, and accessing them. Each microservice runs a tracing library that collects traces in the background, creates in-memory batches, and submits the tracing backend. The tracing backend normalizes received trace data and stores it on persistent storage. Tracing data comes from multiple different microservices; therefore, trace storage is often organized to store data incrementally and is indexed by trace identifier. This organization helps in the reconstruction of trace data and in visualization. Figure 12 illustrates the anatomy of the distributed system. Figure 12: Anatomy of distributed tracing Today a set of tools and frameworks are available for building distributed tracing solutions. Following are some of the popular tools: OpenTelemetry : Observability framework for cloud-native software Jaeger : Open-source distributed tracing solution Zipkin : Open-source distributed tracing solution","title":"Tracing"},{"location":"level101/metrics_and_monitoring/third-party_monitoring/","text":"Third-party monitoring Today most cloud providers offer a variety of monitoring solutions. In addition, a number of companies such as Datadog offer monitoring-as-a-service. In this section, we are not covering monitoring-as-a-service in depth. In recent years, more and more people have access to the internet. Many services are offered online to cater to the increasing user base. As a result, web pages are becoming larger, with increased client-side scripts. Users want these services to be fast and error-free. From the service point of view, when the response body is composed, an HTTP 200 OK response is sent, and everything looks okay. But there might be errors during transmission or on the client side. As previously mentioned, monitoring services from within the service infrastructure give good visibility into service health, but this is not enough. You need to monitor user experience, specifically the availability of services for clients. A number of third-party services such asf Catchpoint , Pingdom , and so on are available for achieving this goal. Third-party monitoring services can generate synthetic traffic simulating user requests from various parts of the world, to ensure the service is globally accessible. Other third-party monitoring solutions for real user monitoring (RUM) provide performance statistics such as service uptime and response time, from different geographical locations. This allows you to monitor the user experience from these locations, which might have different internet backbones, different operating systems, and different browsers and browser versions. Catchpoint Global Monitoring Network is a comprehensive 3-minute video that explains the importance of monitoring the client experience.","title":"Third-party Monitoring"},{"location":"level101/metrics_and_monitoring/third-party_monitoring/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/third-party_monitoring/#third-party-monitoring","text":"Today most cloud providers offer a variety of monitoring solutions. In addition, a number of companies such as Datadog offer monitoring-as-a-service. In this section, we are not covering monitoring-as-a-service in depth. In recent years, more and more people have access to the internet. Many services are offered online to cater to the increasing user base. As a result, web pages are becoming larger, with increased client-side scripts. Users want these services to be fast and error-free. From the service point of view, when the response body is composed, an HTTP 200 OK response is sent, and everything looks okay. But there might be errors during transmission or on the client side. As previously mentioned, monitoring services from within the service infrastructure give good visibility into service health, but this is not enough. You need to monitor user experience, specifically the availability of services for clients. A number of third-party services such asf Catchpoint , Pingdom , and so on are available for achieving this goal. Third-party monitoring services can generate synthetic traffic simulating user requests from various parts of the world, to ensure the service is globally accessible. Other third-party monitoring solutions for real user monitoring (RUM) provide performance statistics such as service uptime and response time, from different geographical locations. This allows you to monitor the user experience from these locations, which might have different internet backbones, different operating systems, and different browsers and browser versions. Catchpoint Global Monitoring Network is a comprehensive 3-minute video that explains the importance of monitoring the client experience.","title":"Third-party monitoring"},{"location":"level101/python_web/intro/","text":"Python and The Web Prerequisites Basic understanding of python language. Basic familiarity with flask framework. What to expect from this course This course is divided into two high level parts. In the first part, assuming familiarity with python language\u2019s basic operations and syntax usage, we will dive a little deeper into understanding python as a language. We will compare python with other programming languages that you might already know like Java and C. We will also explore concepts of Python objects and with help of that, explore python features like decorators. In the second part which will revolve around the web, and also assume familiarity with the Flask framework, we will start from the socket module and work with HTTP requests. This will demystify how frameworks like flask work internally. And to introduce SRE flavour to the course, we will design, develop and deploy (in theory) a URL shortening application. We will emphasize parts of the whole process that are more important as an SRE of the said app/service. What is not covered under this course Extensive knowledge of python internals and advanced python. Lab Environment Setup Have latest version of python installed Course Contents The Python Language Some Python Concepts Python Gotchas Python and Web Sockets Flask The URL Shortening App Design Scaling The App Monitoring The App The Python Language Assuming you know a little bit of C/C++ and Java, let's try to discuss the following questions in context of those two languages and python. You might have heard that C/C++ is a compiled language while python is an interpreted language. Generally, with compiled language we first compile the program and then run the executable while in case of python we run the source code directly like python hello_world.py . While Java, being an interpreted language, still has a separate compilation step and then its run. So what's really the difference? Compiled vs. Interpreted This might sound a little weird to you: python, in a way is a compiled language! Python has a compiler built-in! It is obvious in the case of java since we compile it using a separate command ie: javac helloWorld.java and it will produce a .class file which we know as a bytecode . Well, python is very similar to that. One difference here is that there is no separate compile command/binary needed to run a python program. What is the difference then, between java and python? Well, Java's compiler is more strict and sophisticated. As you might know Java is a statically typed language. So the compiler is written in a way that it can verify types related errors during compile time. While python being a dynamic language, types are not known until a program is run. So in a way, python compiler is dumb (or, less strict). But there indeed is a compile step involved when a python program is run. You might have seen python bytecode files with .pyc extension. Here is how you can see bytecode for a given python program. # Create a Hello World $ echo \"print('hello world')\" > hello_world.py # Making sure it runs $ python3 hello_world.py hello world # The bytecode of the given program $ python -m dis hello_world.py 1 0 LOAD_NAME 0 (print) 2 LOAD_CONST 0 ('hello world') 4 CALL_FUNCTION 1 6 POP_TOP 8 LOAD_CONST 1 (None) 10 RETURN_VALUE Read more about dis module here Now coming to C/C++, there of course is a compiler. But the output is different than what java/python compiler would produce. Compiling a C program would produce what we also know as machine code . As opposed to bytecode. Running The Programs We know compilation is involved in all 3 languages we are discussing. Just that the compilers are different in nature and they output different types of content. In case of C/C++, the output is machine code which can be directly read by your operating system. When you execute that program, your OS will know how exactly to run it. But this is not the case with bytecode. Those bytecodes are language specific. Python has its own set of bytecode defined (more in dis module) and so does java. So naturally, your operating system will not know how to run it. To run this bytecode, we have something called Virtual Machines. Ie: The JVM or the Python VM (CPython, Jython). These so called Virtual Machines are the programs which can read the bytecode and run it on a given operating system. Python has multiple VMs available. Cpython is a python VM implemented in C language, similarly Jython is a Java implementation of python VM. At the end of the day, what they should be capable of is to understand python language syntax, be able to compile it to bytecode and be able to run that bytecode. You can implement a python VM in any language! (And people do so, just because it can be done) The Operating System +------------------------------------+ | | | | | | hello_world.py Python bytecode | Python VM Process | | | +----------------+ +----------------+ | +----------------+ | |print(... | COMPILE |LOAD_CONST... | | |Reads bytecode | | | +--------------->+ +------------------->+line by line | | | | | | | |and executes. | | | | | | | | | | +----------------+ +----------------+ | +----------------+ | | | | | | | hello_world.c OS Specific machinecode | A New Process | | | +----------------+ +----------------+ | +----------------+ | |void main() { | COMPILE | binary contents| | | binary contents| | | +--------------->+ +------------------->+ | | | | | | | | | | | | | | | | | | +----------------+ +----------------+ | +----------------+ | | (binary contents | | runs as is) | | | | | +------------------------------------+ Two things to note for above diagram: Generally, when we run a python program, a python VM process is started which reads the python source code, compiles it to byte code and run it in a single step. Compiling is not a separate step. Shown only for illustration purpose. Binaries generated for C like languages are not exactly run as is. Since there are multiple types of binaries (eg: ELF), there are more complicated steps involved in order to run a binary but we will not go into that since all that is done at OS level.","title":"Introduction"},{"location":"level101/python_web/intro/#python-and-the-web","text":"","title":"Python and The Web"},{"location":"level101/python_web/intro/#prerequisites","text":"Basic understanding of python language. Basic familiarity with flask framework.","title":"Prerequisites"},{"location":"level101/python_web/intro/#what-to-expect-from-this-course","text":"This course is divided into two high level parts. In the first part, assuming familiarity with python language\u2019s basic operations and syntax usage, we will dive a little deeper into understanding python as a language. We will compare python with other programming languages that you might already know like Java and C. We will also explore concepts of Python objects and with help of that, explore python features like decorators. In the second part which will revolve around the web, and also assume familiarity with the Flask framework, we will start from the socket module and work with HTTP requests. This will demystify how frameworks like flask work internally. And to introduce SRE flavour to the course, we will design, develop and deploy (in theory) a URL shortening application. We will emphasize parts of the whole process that are more important as an SRE of the said app/service.","title":"What to expect from this course"},{"location":"level101/python_web/intro/#what-is-not-covered-under-this-course","text":"Extensive knowledge of python internals and advanced python.","title":"What is not covered under this course"},{"location":"level101/python_web/intro/#lab-environment-setup","text":"Have latest version of python installed","title":"Lab Environment Setup"},{"location":"level101/python_web/intro/#course-contents","text":"The Python Language Some Python Concepts Python Gotchas Python and Web Sockets Flask The URL Shortening App Design Scaling The App Monitoring The App","title":"Course Contents"},{"location":"level101/python_web/intro/#the-python-language","text":"Assuming you know a little bit of C/C++ and Java, let's try to discuss the following questions in context of those two languages and python. You might have heard that C/C++ is a compiled language while python is an interpreted language. Generally, with compiled language we first compile the program and then run the executable while in case of python we run the source code directly like python hello_world.py . While Java, being an interpreted language, still has a separate compilation step and then its run. So what's really the difference?","title":"The Python Language"},{"location":"level101/python_web/intro/#compiled-vs-interpreted","text":"This might sound a little weird to you: python, in a way is a compiled language! Python has a compiler built-in! It is obvious in the case of java since we compile it using a separate command ie: javac helloWorld.java and it will produce a .class file which we know as a bytecode . Well, python is very similar to that. One difference here is that there is no separate compile command/binary needed to run a python program. What is the difference then, between java and python? Well, Java's compiler is more strict and sophisticated. As you might know Java is a statically typed language. So the compiler is written in a way that it can verify types related errors during compile time. While python being a dynamic language, types are not known until a program is run. So in a way, python compiler is dumb (or, less strict). But there indeed is a compile step involved when a python program is run. You might have seen python bytecode files with .pyc extension. Here is how you can see bytecode for a given python program. # Create a Hello World $ echo \"print('hello world')\" > hello_world.py # Making sure it runs $ python3 hello_world.py hello world # The bytecode of the given program $ python -m dis hello_world.py 1 0 LOAD_NAME 0 (print) 2 LOAD_CONST 0 ('hello world') 4 CALL_FUNCTION 1 6 POP_TOP 8 LOAD_CONST 1 (None) 10 RETURN_VALUE Read more about dis module here Now coming to C/C++, there of course is a compiler. But the output is different than what java/python compiler would produce. Compiling a C program would produce what we also know as machine code . As opposed to bytecode.","title":"Compiled vs. Interpreted"},{"location":"level101/python_web/intro/#running-the-programs","text":"We know compilation is involved in all 3 languages we are discussing. Just that the compilers are different in nature and they output different types of content. In case of C/C++, the output is machine code which can be directly read by your operating system. When you execute that program, your OS will know how exactly to run it. But this is not the case with bytecode. Those bytecodes are language specific. Python has its own set of bytecode defined (more in dis module) and so does java. So naturally, your operating system will not know how to run it. To run this bytecode, we have something called Virtual Machines. Ie: The JVM or the Python VM (CPython, Jython). These so called Virtual Machines are the programs which can read the bytecode and run it on a given operating system. Python has multiple VMs available. Cpython is a python VM implemented in C language, similarly Jython is a Java implementation of python VM. At the end of the day, what they should be capable of is to understand python language syntax, be able to compile it to bytecode and be able to run that bytecode. You can implement a python VM in any language! (And people do so, just because it can be done) The Operating System +------------------------------------+ | | | | | | hello_world.py Python bytecode | Python VM Process | | | +----------------+ +----------------+ | +----------------+ | |print(... | COMPILE |LOAD_CONST... | | |Reads bytecode | | | +--------------->+ +------------------->+line by line | | | | | | | |and executes. | | | | | | | | | | +----------------+ +----------------+ | +----------------+ | | | | | | | hello_world.c OS Specific machinecode | A New Process | | | +----------------+ +----------------+ | +----------------+ | |void main() { | COMPILE | binary contents| | | binary contents| | | +--------------->+ +------------------->+ | | | | | | | | | | | | | | | | | | +----------------+ +----------------+ | +----------------+ | | (binary contents | | runs as is) | | | | | +------------------------------------+ Two things to note for above diagram: Generally, when we run a python program, a python VM process is started which reads the python source code, compiles it to byte code and run it in a single step. Compiling is not a separate step. Shown only for illustration purpose. Binaries generated for C like languages are not exactly run as is. Since there are multiple types of binaries (eg: ELF), there are more complicated steps involved in order to run a binary but we will not go into that since all that is done at OS level.","title":"Running The Programs"},{"location":"level101/python_web/python-concepts/","text":"Some Python Concepts Though you are expected to know python and its syntax at basic level, let us discuss some fundamental concepts that will help you understand the python language better. Everything in Python is an object. That includes the functions, lists, dicts, classes, modules, a running function (instance of function definition), everything. In the CPython, it would mean there is an underlying struct variable for each object. In python's current execution context, all the variables are stored in a dict. It'd be a string to object mapping. If you have a function and a float variable defined in the current context, here is how it is handled internally. >>> float_number=42.0 >>> def foo_func(): ... pass ... # NOTICE HOW VARIABLE NAMES ARE STRINGS, stored in a dict >>> locals() {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'float_number': 42.0, 'foo_func': } Python Functions Since functions too are objects, we can see what all attributes a function contains as following >>> def hello(name): ... print(f\"Hello, {name}!\") ... >>> dir(hello) ['__annotations__', '__call__', '__class__', '__closure__', '__code__', '__defaults__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__get__', '__getattribute__', '__globals__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__kwdefaults__', '__le__', '__lt__', '__module__', '__name__', '__ne__', '__new__', '__qualname__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__'] While there are a lot of them, let's look at some interesting ones globals This attribute, as the name suggests, has references of global variables. If you ever need to know what all global variables are in the scope of this function, this will tell you. See how the function start seeing the new variable in globals >>> hello.__globals__ {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'hello': } # adding new global variable >>> GLOBAL=\"g_val\" >>> hello.__globals__ {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'hello': , 'GLOBAL': 'g_val'} code This is an interesting one! As everything in python is an object, this includes the bytecode too. The compiled python bytecode is a python code object. Which is accessible via __code__ attribute here. A function has an associated code object which carries some interesting information. # the file in which function is defined # stdin here since this is run in an interpreter >>> hello.__code__.co_filename '' # number of arguments the function takes >>> hello.__code__.co_argcount 1 # local variable names >>> hello.__code__.co_varnames ('name',) # the function code's compiled bytecode >>> hello.__code__.co_code b't\\x00d\\x01|\\x00\\x9b\\x00d\\x02\\x9d\\x03\\x83\\x01\\x01\\x00d\\x00S\\x00' There are more code attributes which you can enlist by >>> dir(hello.__code__) Decorators Related to functions, python has another feature called decorators. Let's see how that works, keeping everything is an object in mind. Here is a sample decorator: >>> def deco(func): ... def inner(): ... print(\"before\") ... func() ... print(\"after\") ... return inner ... >>> @deco ... def hello_world(): ... print(\"hello world\") ... >>> >>> hello_world() before hello world after Here @deco syntax is used to decorate the hello_world function. It is essentially same as doing >>> def hello_world(): ... print(\"hello world\") ... >>> hello_world = deco(hello_world) What goes inside the deco function might seem complex. Let's try to uncover it. Function hello_world is created It is passed to deco function deco create a new function This new function is calls hello_world function And does a couple other things deco returns the newly created function hello_world is replaced with above function Let's visualize it for better understanding BEFORE function_object (ID: 100) \"hello_world\" +--------------------+ + |print(\"hello_world\")| | | | +--------------> | | | | +--------------------+ WHAT DECORATOR DOES creates a new function (ID: 101) +---------------------------------+ |input arg: function with id: 100 | | | |print(\"before\") | |call function object with id 100 | |print(\"after\") | | | +---------------------------------+ ^ | AFTER | | | \"hello_world\" +-------------+ Note how the hello_world name points to a new function object but that new function object knows the reference (ID) of the original function. Some Gotchas While it is very quick to build prototypes in python and there are tons of libraries available, as the codebase complexity increases, type errors become more common and will get hard to deal with. (There are solutions to that problem like type annotations in python. Checkout mypy .) Because python is dynamically typed language, that means all types are determined at runtime. And that makes python run very slow compared to other statically typed languages. Python has something called GIL (global interpreter lock) which is a limiting factor for utilizing multiple CPU cores for parallel computation. Some weird things that python does: https://github.com/satwikkansal/wtfpython","title":"Some Python Concepts"},{"location":"level101/python_web/python-concepts/#some-python-concepts","text":"Though you are expected to know python and its syntax at basic level, let us discuss some fundamental concepts that will help you understand the python language better. Everything in Python is an object. That includes the functions, lists, dicts, classes, modules, a running function (instance of function definition), everything. In the CPython, it would mean there is an underlying struct variable for each object. In python's current execution context, all the variables are stored in a dict. It'd be a string to object mapping. If you have a function and a float variable defined in the current context, here is how it is handled internally. >>> float_number=42.0 >>> def foo_func(): ... pass ... # NOTICE HOW VARIABLE NAMES ARE STRINGS, stored in a dict >>> locals() {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'float_number': 42.0, 'foo_func': }","title":"Some Python Concepts"},{"location":"level101/python_web/python-concepts/#python-functions","text":"Since functions too are objects, we can see what all attributes a function contains as following >>> def hello(name): ... print(f\"Hello, {name}!\") ... >>> dir(hello) ['__annotations__', '__call__', '__class__', '__closure__', '__code__', '__defaults__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__get__', '__getattribute__', '__globals__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__kwdefaults__', '__le__', '__lt__', '__module__', '__name__', '__ne__', '__new__', '__qualname__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__'] While there are a lot of them, let's look at some interesting ones","title":"Python Functions"},{"location":"level101/python_web/python-concepts/#globals","text":"This attribute, as the name suggests, has references of global variables. If you ever need to know what all global variables are in the scope of this function, this will tell you. See how the function start seeing the new variable in globals >>> hello.__globals__ {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'hello': } # adding new global variable >>> GLOBAL=\"g_val\" >>> hello.__globals__ {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'hello': , 'GLOBAL': 'g_val'}","title":"globals"},{"location":"level101/python_web/python-concepts/#code","text":"This is an interesting one! As everything in python is an object, this includes the bytecode too. The compiled python bytecode is a python code object. Which is accessible via __code__ attribute here. A function has an associated code object which carries some interesting information. # the file in which function is defined # stdin here since this is run in an interpreter >>> hello.__code__.co_filename '' # number of arguments the function takes >>> hello.__code__.co_argcount 1 # local variable names >>> hello.__code__.co_varnames ('name',) # the function code's compiled bytecode >>> hello.__code__.co_code b't\\x00d\\x01|\\x00\\x9b\\x00d\\x02\\x9d\\x03\\x83\\x01\\x01\\x00d\\x00S\\x00' There are more code attributes which you can enlist by >>> dir(hello.__code__)","title":"code"},{"location":"level101/python_web/python-concepts/#decorators","text":"Related to functions, python has another feature called decorators. Let's see how that works, keeping everything is an object in mind. Here is a sample decorator: >>> def deco(func): ... def inner(): ... print(\"before\") ... func() ... print(\"after\") ... return inner ... >>> @deco ... def hello_world(): ... print(\"hello world\") ... >>> >>> hello_world() before hello world after Here @deco syntax is used to decorate the hello_world function. It is essentially same as doing >>> def hello_world(): ... print(\"hello world\") ... >>> hello_world = deco(hello_world) What goes inside the deco function might seem complex. Let's try to uncover it. Function hello_world is created It is passed to deco function deco create a new function This new function is calls hello_world function And does a couple other things deco returns the newly created function hello_world is replaced with above function Let's visualize it for better understanding BEFORE function_object (ID: 100) \"hello_world\" +--------------------+ + |print(\"hello_world\")| | | | +--------------> | | | | +--------------------+ WHAT DECORATOR DOES creates a new function (ID: 101) +---------------------------------+ |input arg: function with id: 100 | | | |print(\"before\") | |call function object with id 100 | |print(\"after\") | | | +---------------------------------+ ^ | AFTER | | | \"hello_world\" +-------------+ Note how the hello_world name points to a new function object but that new function object knows the reference (ID) of the original function.","title":"Decorators"},{"location":"level101/python_web/python-concepts/#some-gotchas","text":"While it is very quick to build prototypes in python and there are tons of libraries available, as the codebase complexity increases, type errors become more common and will get hard to deal with. (There are solutions to that problem like type annotations in python. Checkout mypy .) Because python is dynamically typed language, that means all types are determined at runtime. And that makes python run very slow compared to other statically typed languages. Python has something called GIL (global interpreter lock) which is a limiting factor for utilizing multiple CPU cores for parallel computation. Some weird things that python does: https://github.com/satwikkansal/wtfpython","title":"Some Gotchas"},{"location":"level101/python_web/python-web-flask/","text":"Python, Web and Flask Back in the old days, websites were simple. They were simple static html contents. A webserver would be listening on a defined port and according to the HTTP request received, it would read files from disk and return them in response. But since then, complexity has evolved and websites are now dynamic. Depending on the request, multiple operations need to be performed like reading from database or calling other API and finally returning some response (HTML data, JSON content etc.) Since serving web requests is no longer a simple task like reading files from disk and return contents, we need to process each http request, perform some operations programmatically and construct a response. Sockets Though we have frameworks like flask, HTTP is still a protocol that works over TCP protocol. So let us setup a TCP server and send an HTTP request and inspect the request's payload. Note that this is not a tutorial on socket programming but what we are doing here is inspecting HTTP protocol at its ground level and look at what its contents look like. (Ref: Socket Programming in Python (Guide) on RealPython ) import socket HOST = '127.0.0.1' # Standard loopback interface address (localhost) PORT = 65432 # Port to listen on (non-privileged ports are > 1023) with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s: s.bind((HOST, PORT)) s.listen() conn, addr = s.accept() with conn: print('Connected by', addr) while True: data = conn.recv(1024) if not data: break print(data) Then we open localhost:65432 in our web browser and following would be the output: Connected by ('127.0.0.1', 54719) b'GET / HTTP/1.1\\r\\nHost: localhost:65432\\r\\nConnection: keep-alive\\r\\nDNT: 1\\r\\nUpgrade-Insecure-Requests: 1\\r\\nUser-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36 Edg/85.0.564.44\\r\\nAccept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9\\r\\nSec-Fetch-Site: none\\r\\nSec-Fetch-Mode: navigate\\r\\nSec-Fetch-User: ?1\\r\\nSec-Fetch-Dest: document\\r\\nAccept-Encoding: gzip, deflate, br\\r\\nAccept-Language: en-US,en;q=0.9\\r\\n\\r\\n' Examine closely and the content will look like the HTTP protocol's format. ie: HTTP_METHOD URI_PATH HTTP_VERSION HEADERS_SEPARATED_BY_SEPARATOR So though it's a blob of bytes, knowing http protocol specification , you can parse that string (ie: split by \\r\\n ) and get meaningful information out of it. Flask Flask, and other such frameworks does pretty much what we just discussed in the last section (with added more sophistication). They listen on a port on a TCP socket, receive an HTTP request, parse the data according to protocol format and make it available to you in a convenient manner. ie: you can access headers in flask by request.headers which is made available to you by splitting above payload by /r/n , as defined in http protocol. Another example: we register routes in flask by @app.route(\"/hello\") . What flask will do is maintain a registry internally which will map /hello with the function you decorated with. Now whenever a request comes with the /hello route (second component in the first line, split by space), flask calls the registered function and returns whatever the function returned. Same with all other web frameworks in other languages too. They all work on similar principles. What they basically do is understand the HTTP protocol, parses the HTTP request data and gives us programmers a nice interface to work with HTTP requests. Not so much of magic, innit?","title":"Python, Web and Flask"},{"location":"level101/python_web/python-web-flask/#python-web-and-flask","text":"Back in the old days, websites were simple. They were simple static html contents. A webserver would be listening on a defined port and according to the HTTP request received, it would read files from disk and return them in response. But since then, complexity has evolved and websites are now dynamic. Depending on the request, multiple operations need to be performed like reading from database or calling other API and finally returning some response (HTML data, JSON content etc.) Since serving web requests is no longer a simple task like reading files from disk and return contents, we need to process each http request, perform some operations programmatically and construct a response.","title":"Python, Web and Flask"},{"location":"level101/python_web/python-web-flask/#sockets","text":"Though we have frameworks like flask, HTTP is still a protocol that works over TCP protocol. So let us setup a TCP server and send an HTTP request and inspect the request's payload. Note that this is not a tutorial on socket programming but what we are doing here is inspecting HTTP protocol at its ground level and look at what its contents look like. (Ref: Socket Programming in Python (Guide) on RealPython ) import socket HOST = '127.0.0.1' # Standard loopback interface address (localhost) PORT = 65432 # Port to listen on (non-privileged ports are > 1023) with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s: s.bind((HOST, PORT)) s.listen() conn, addr = s.accept() with conn: print('Connected by', addr) while True: data = conn.recv(1024) if not data: break print(data) Then we open localhost:65432 in our web browser and following would be the output: Connected by ('127.0.0.1', 54719) b'GET / HTTP/1.1\\r\\nHost: localhost:65432\\r\\nConnection: keep-alive\\r\\nDNT: 1\\r\\nUpgrade-Insecure-Requests: 1\\r\\nUser-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36 Edg/85.0.564.44\\r\\nAccept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9\\r\\nSec-Fetch-Site: none\\r\\nSec-Fetch-Mode: navigate\\r\\nSec-Fetch-User: ?1\\r\\nSec-Fetch-Dest: document\\r\\nAccept-Encoding: gzip, deflate, br\\r\\nAccept-Language: en-US,en;q=0.9\\r\\n\\r\\n' Examine closely and the content will look like the HTTP protocol's format. ie: HTTP_METHOD URI_PATH HTTP_VERSION HEADERS_SEPARATED_BY_SEPARATOR So though it's a blob of bytes, knowing http protocol specification , you can parse that string (ie: split by \\r\\n ) and get meaningful information out of it.","title":"Sockets"},{"location":"level101/python_web/python-web-flask/#flask","text":"Flask, and other such frameworks does pretty much what we just discussed in the last section (with added more sophistication). They listen on a port on a TCP socket, receive an HTTP request, parse the data according to protocol format and make it available to you in a convenient manner. ie: you can access headers in flask by request.headers which is made available to you by splitting above payload by /r/n , as defined in http protocol. Another example: we register routes in flask by @app.route(\"/hello\") . What flask will do is maintain a registry internally which will map /hello with the function you decorated with. Now whenever a request comes with the /hello route (second component in the first line, split by space), flask calls the registered function and returns whatever the function returned. Same with all other web frameworks in other languages too. They all work on similar principles. What they basically do is understand the HTTP protocol, parses the HTTP request data and gives us programmers a nice interface to work with HTTP requests. Not so much of magic, innit?","title":"Flask"},{"location":"level101/python_web/sre-conclusion/","text":"Conclusion Scaling The App The design and development is just a part of the journey. We will need to setup continuous integration and continuous delivery pipelines sooner or later. And we have to deploy this app somewhere. Initially we can start with deploying this app on one virtual machine on any cloud provider. But this is a Single point of failure which is something we never allow as an SRE (or even as an engineer). So an improvement here can be having multiple instances of applications deployed behind a load balancer. This certainly prevents problems of one machine going down. Scaling here would mean adding more instances behind the load balancer. But this is scalable upto only a certain point. After that, other bottlenecks in the system will start appearing. ie: DB will become the bottleneck, or perhaps the load balancer itself. How do you know what is the bottleneck? You need to have observability into each aspects of the application architecture. Only after you have metrics, you will be able to know what is going wrong where. What gets measured, gets fixed! Get deeper insights into scaling from School Of SRE's Scalability module and post going through it, apply your learnings and takeaways to this app. Think how will we make this app geographically distributed and highly available and scalable. Monitoring Strategy Once we have our application deployed. It will be working ok. But not forever. Reliability is in the title of our job and we make systems reliable by making the design in a certain way. But things still will go down. Machines will fail. Disks will behave weirdly. Buggy code will get pushed to production. And all these possible scenarios will make the system less reliable. So what do we do? We monitor! We keep an eye on the system's health and if anything is not going as expected, we want ourselves to get alerted. Now let's think in terms of the given url shortening app. We need to monitor it. And we would want to get notified in case something goes wrong. But we first need to decide what is that something that we want to keep an eye on. Since it's a web app serving HTTP requests, we want to keep an eye on HTTP Status codes and latencies Request volume again is a good candidate, if the app is receiving an unusual amount of traffic, something might be off. We also want to keep an eye on the database so depending on the database solution chosen. Query times, volumes, disk usage etc. Finally, there also needs to be some external monitoring which runs periodic tests from devices outside of your data centers. This emulates customers and ensures that from customer point of view, the system is working as expected. Applications in SRE role In the world of SRE, python is a widely used language. For small scripts and tooling developed for various purposes. Since tooling developed by SRE works with critical pieces of infrastructure and has great power (to bring things down), it is important to know what you are doing while using a programming language and its features. Also it is equally important to know the language and its characteristics while debugging the issues. As an SRE having a deeper understanding of python language, it has helped me a lot to debug very sneaky bugs and be generally more aware and informed while making certain design decisions. While developing tools may or may not be part of SRE job, supporting tools or services is more likely to be a daily duty. Building an application or tool is just a small part of productionization. While there is certainly that goes in the design of the application itself to make it more robust, as an SRE you are responsible for its reliability and stability once it is deployed and running. And to ensure that, you\u2019d need to understand the application first and then come up with a strategy to monitor it properly and be prepared for various failure scenarios. Optional Exercises Make a decorator that will cache function return values depending on input parameters. Host the URL shortening app on any cloud provider. Setup monitoring using many of the tools available like catchpoint, datadog etc. Create a minimal flask-like framework on top of TCP sockets. Conclusion This module, in the first part, aims to make you more aware of the things that will happen when you choose python as your programming language and what happens when you run a python program. With the knowledge of how python handles things internally as objects, lot of seemingly magic things in python will start to make more sense. The second part will first explain how a framework like flask works using the existing knowledge of protocols like TCP and HTTP. It then touches the whole lifecycle of an application development lifecycle including the SRE parts of it. While the design and areas in architecture considered will not be exhaustive, it will give a good overview of things that are also important being an SRE and why they are important.","title":"Conclusion"},{"location":"level101/python_web/sre-conclusion/#conclusion","text":"","title":"Conclusion"},{"location":"level101/python_web/sre-conclusion/#scaling-the-app","text":"The design and development is just a part of the journey. We will need to setup continuous integration and continuous delivery pipelines sooner or later. And we have to deploy this app somewhere. Initially we can start with deploying this app on one virtual machine on any cloud provider. But this is a Single point of failure which is something we never allow as an SRE (or even as an engineer). So an improvement here can be having multiple instances of applications deployed behind a load balancer. This certainly prevents problems of one machine going down. Scaling here would mean adding more instances behind the load balancer. But this is scalable upto only a certain point. After that, other bottlenecks in the system will start appearing. ie: DB will become the bottleneck, or perhaps the load balancer itself. How do you know what is the bottleneck? You need to have observability into each aspects of the application architecture. Only after you have metrics, you will be able to know what is going wrong where. What gets measured, gets fixed! Get deeper insights into scaling from School Of SRE's Scalability module and post going through it, apply your learnings and takeaways to this app. Think how will we make this app geographically distributed and highly available and scalable.","title":"Scaling The App"},{"location":"level101/python_web/sre-conclusion/#monitoring-strategy","text":"Once we have our application deployed. It will be working ok. But not forever. Reliability is in the title of our job and we make systems reliable by making the design in a certain way. But things still will go down. Machines will fail. Disks will behave weirdly. Buggy code will get pushed to production. And all these possible scenarios will make the system less reliable. So what do we do? We monitor! We keep an eye on the system's health and if anything is not going as expected, we want ourselves to get alerted. Now let's think in terms of the given url shortening app. We need to monitor it. And we would want to get notified in case something goes wrong. But we first need to decide what is that something that we want to keep an eye on. Since it's a web app serving HTTP requests, we want to keep an eye on HTTP Status codes and latencies Request volume again is a good candidate, if the app is receiving an unusual amount of traffic, something might be off. We also want to keep an eye on the database so depending on the database solution chosen. Query times, volumes, disk usage etc. Finally, there also needs to be some external monitoring which runs periodic tests from devices outside of your data centers. This emulates customers and ensures that from customer point of view, the system is working as expected.","title":"Monitoring Strategy"},{"location":"level101/python_web/sre-conclusion/#applications-in-sre-role","text":"In the world of SRE, python is a widely used language. For small scripts and tooling developed for various purposes. Since tooling developed by SRE works with critical pieces of infrastructure and has great power (to bring things down), it is important to know what you are doing while using a programming language and its features. Also it is equally important to know the language and its characteristics while debugging the issues. As an SRE having a deeper understanding of python language, it has helped me a lot to debug very sneaky bugs and be generally more aware and informed while making certain design decisions. While developing tools may or may not be part of SRE job, supporting tools or services is more likely to be a daily duty. Building an application or tool is just a small part of productionization. While there is certainly that goes in the design of the application itself to make it more robust, as an SRE you are responsible for its reliability and stability once it is deployed and running. And to ensure that, you\u2019d need to understand the application first and then come up with a strategy to monitor it properly and be prepared for various failure scenarios.","title":"Applications in SRE role"},{"location":"level101/python_web/sre-conclusion/#optional-exercises","text":"Make a decorator that will cache function return values depending on input parameters. Host the URL shortening app on any cloud provider. Setup monitoring using many of the tools available like catchpoint, datadog etc. Create a minimal flask-like framework on top of TCP sockets.","title":"Optional Exercises"},{"location":"level101/python_web/sre-conclusion/#conclusion_1","text":"This module, in the first part, aims to make you more aware of the things that will happen when you choose python as your programming language and what happens when you run a python program. With the knowledge of how python handles things internally as objects, lot of seemingly magic things in python will start to make more sense. The second part will first explain how a framework like flask works using the existing knowledge of protocols like TCP and HTTP. It then touches the whole lifecycle of an application development lifecycle including the SRE parts of it. While the design and areas in architecture considered will not be exhaustive, it will give a good overview of things that are also important being an SRE and why they are important.","title":"Conclusion"},{"location":"level101/python_web/url-shorten-app/","text":"The URL Shortening App Let's build a very simple URL shortening app using flask and try to incorporate all aspects of the development process including the reliability aspects. We will not be building the UI and we will come up with a minimal set of API that will be enough for the app to function well. Design We don't jump directly to coding. First thing we do is gather requirements. Come up with an approach. Have the approach/design reviewed by peers. Evolve, iterate, document the decisions and tradeoffs. And then finally implement. While we will not do the full blown design document here, we will raise certain questions here that are important to the design. 1. High Level Operations and API Endpoints Since it's a URL shortening app, we will need an API for generating the shorten link given an original link. And an API/Endpoint which will accept the shorten link and redirect to original URL. We are not including the user aspect of the app to keep things minimal. These two API should make app functional and usable by anyone. 2. How to shorten? Given a url, we will need to generate a shortened version of it. One approach could be using random characters for each link. Another thing that can be done is to use some sort of hashing algorithm. The benefit here is we will reuse the same hash for the same link. ie: if lot of people are shortening https://www.linkedin.com they all will have the same value, compared to multiple entries in DB if chosen random characters. What about hash collisions? Even in random characters approach, though there is a less probability, hash collisions can happen. And we need to be mindful of them. In that case we might want to prepend/append the string with some random value to avoid conflict. Also, choice of hash algorithm matters. We will need to analyze algorithms. Their CPU requirements and their characteristics. Choose one that suits the most. 3. Is URL Valid? Given a URL to shorten, how do we verify if the URL is valid? Do we even verify or validate? One basic check that can be done is see if the URL matches a regex of a URL. To go even further we can try opening/visiting the URL. But there are certain gotchas here. We need to define success criteria. ie: HTTP 200 means it is valid. What is the URL is in private network? What if URL is temporarily down? 4. Storage Finally, storage. Where will we store the data that we will generate over time? There are multiple database solutions available and we will need to choose the one that suits this app the most. Relational database like MySQL would be a fair choice but be sure to checkout School of SRE's SQL database section and NoSQL databases section for deeper insights into making a more informed decision. 5. Other We are not accounting for users into our app and other possible features like rate limiting, customized links etc but it will eventually come up with time. Depending on the requirements, they too might need to get incorporated. The minimal working code is given below for reference but I'd encourage you to come up with your own. from flask import Flask, redirect, request from hashlib import md5 app = Flask(\"url_shortener\") mapping = {} @app.route(\"/shorten\", methods=[\"POST\"]) def shorten(): global mapping payload = request.json if \"url\" not in payload: return \"Missing URL Parameter\", 400 # TODO: check if URL is valid hash_ = md5() hash_.update(payload[\"url\"].encode()) digest = hash_.hexdigest()[:5] # limiting to 5 chars. Less the limit more the chances of collission if digest not in mapping: mapping[digest] = payload[\"url\"] return f\"Shortened: r/{digest}\\n\" else: # TODO: check for hash collission return f\"Already exists: r/{digest}\\n\" @app.route(\"/r/\") def redirect_(hash_): if hash_ not in mapping: return \"URL Not Found\", 404 return redirect(mapping[hash_]) if __name__ == \"__main__\": app.run(debug=True) \"\"\" OUTPUT: ===> SHORTENING $ curl localhost:5000/shorten -H \"content-type: application/json\" --data '{\"url\":\"https://linkedin.com\"}' Shortened: r/a62a4 ===> REDIRECTING, notice the response code 302 and the location header $ curl localhost:5000/r/a62a4 -v * Uses proxy env variable NO_PROXY == '127.0.0.1' * Trying ::1... * TCP_NODELAY set * Connection failed * connect to ::1 port 5000 failed: Connection refused * Trying 127.0.0.1... * TCP_NODELAY set * Connected to localhost (127.0.0.1) port 5000 (#0) > GET /r/a62a4 HTTP/1.1 > Host: localhost:5000 > User-Agent: curl/7.64.1 > Accept: */* > * HTTP 1.0, assume close after body < HTTP/1.0 302 FOUND < Content-Type: text/html; charset=utf-8 < Content-Length: 247 < Location: https://linkedin.com < Server: Werkzeug/0.15.4 Python/3.7.7 < Date: Tue, 27 Oct 2020 09:37:12 GMT < Redirecting...

    Redirecting...

    * Closing connection 0

    You should be redirected automatically to target URL: https://linkedin.com. If not click the link. \"\"\"","title":"The URL Shortening App"},{"location":"level101/python_web/url-shorten-app/#the-url-shortening-app","text":"Let's build a very simple URL shortening app using flask and try to incorporate all aspects of the development process including the reliability aspects. We will not be building the UI and we will come up with a minimal set of API that will be enough for the app to function well.","title":"The URL Shortening App"},{"location":"level101/python_web/url-shorten-app/#design","text":"We don't jump directly to coding. First thing we do is gather requirements. Come up with an approach. Have the approach/design reviewed by peers. Evolve, iterate, document the decisions and tradeoffs. And then finally implement. While we will not do the full blown design document here, we will raise certain questions here that are important to the design.","title":"Design"},{"location":"level101/python_web/url-shorten-app/#1-high-level-operations-and-api-endpoints","text":"Since it's a URL shortening app, we will need an API for generating the shorten link given an original link. And an API/Endpoint which will accept the shorten link and redirect to original URL. We are not including the user aspect of the app to keep things minimal. These two API should make app functional and usable by anyone.","title":"1. High Level Operations and API Endpoints"},{"location":"level101/python_web/url-shorten-app/#2-how-to-shorten","text":"Given a url, we will need to generate a shortened version of it. One approach could be using random characters for each link. Another thing that can be done is to use some sort of hashing algorithm. The benefit here is we will reuse the same hash for the same link. ie: if lot of people are shortening https://www.linkedin.com they all will have the same value, compared to multiple entries in DB if chosen random characters. What about hash collisions? Even in random characters approach, though there is a less probability, hash collisions can happen. And we need to be mindful of them. In that case we might want to prepend/append the string with some random value to avoid conflict. Also, choice of hash algorithm matters. We will need to analyze algorithms. Their CPU requirements and their characteristics. Choose one that suits the most.","title":"2. How to shorten?"},{"location":"level101/python_web/url-shorten-app/#3-is-url-valid","text":"Given a URL to shorten, how do we verify if the URL is valid? Do we even verify or validate? One basic check that can be done is see if the URL matches a regex of a URL. To go even further we can try opening/visiting the URL. But there are certain gotchas here. We need to define success criteria. ie: HTTP 200 means it is valid. What is the URL is in private network? What if URL is temporarily down?","title":"3. Is URL Valid?"},{"location":"level101/python_web/url-shorten-app/#4-storage","text":"Finally, storage. Where will we store the data that we will generate over time? There are multiple database solutions available and we will need to choose the one that suits this app the most. Relational database like MySQL would be a fair choice but be sure to checkout School of SRE's SQL database section and NoSQL databases section for deeper insights into making a more informed decision.","title":"4. Storage"},{"location":"level101/python_web/url-shorten-app/#5-other","text":"We are not accounting for users into our app and other possible features like rate limiting, customized links etc but it will eventually come up with time. Depending on the requirements, they too might need to get incorporated. The minimal working code is given below for reference but I'd encourage you to come up with your own. from flask import Flask, redirect, request from hashlib import md5 app = Flask(\"url_shortener\") mapping = {} @app.route(\"/shorten\", methods=[\"POST\"]) def shorten(): global mapping payload = request.json if \"url\" not in payload: return \"Missing URL Parameter\", 400 # TODO: check if URL is valid hash_ = md5() hash_.update(payload[\"url\"].encode()) digest = hash_.hexdigest()[:5] # limiting to 5 chars. Less the limit more the chances of collission if digest not in mapping: mapping[digest] = payload[\"url\"] return f\"Shortened: r/{digest}\\n\" else: # TODO: check for hash collission return f\"Already exists: r/{digest}\\n\" @app.route(\"/r/\") def redirect_(hash_): if hash_ not in mapping: return \"URL Not Found\", 404 return redirect(mapping[hash_]) if __name__ == \"__main__\": app.run(debug=True) \"\"\" OUTPUT: ===> SHORTENING $ curl localhost:5000/shorten -H \"content-type: application/json\" --data '{\"url\":\"https://linkedin.com\"}' Shortened: r/a62a4 ===> REDIRECTING, notice the response code 302 and the location header $ curl localhost:5000/r/a62a4 -v * Uses proxy env variable NO_PROXY == '127.0.0.1' * Trying ::1... * TCP_NODELAY set * Connection failed * connect to ::1 port 5000 failed: Connection refused * Trying 127.0.0.1... * TCP_NODELAY set * Connected to localhost (127.0.0.1) port 5000 (#0) > GET /r/a62a4 HTTP/1.1 > Host: localhost:5000 > User-Agent: curl/7.64.1 > Accept: */* > * HTTP 1.0, assume close after body < HTTP/1.0 302 FOUND < Content-Type: text/html; charset=utf-8 < Content-Length: 247 < Location: https://linkedin.com < Server: Werkzeug/0.15.4 Python/3.7.7 < Date: Tue, 27 Oct 2020 09:37:12 GMT < Redirecting...

    Redirecting...

    * Closing connection 0

    You should be redirected automatically to target URL: https://linkedin.com. If not click the link. \"\"\"","title":"5. Other"},{"location":"level101/security/conclusion/","text":"Conclusion Now that you have completed this course on Security you are now aware of the possible security threats to computer systems & networks. Not only that, but you are now better able to protect your systems as well as recommend security measures to others. This course provides fundamental everyday knowledge on security domain which will also help you keep security at the top of your priority. Other Resources Some books that would be a great resource Holistic Info-Sec for Web Developers https://holisticinfosecforwebdevelopers.com/ - Free and downloadable book series with very broad and deep coverage of what Web Developers and DevOps Engineers need to know in order to create robust, reliable, maintainable and secure software, networks and other, that are delivered continuously, on time, with no nasty surprises Docker Security - Quick Reference: For DevOps Engineers https://leanpub.com/dockersecurity-quickreference - A book on understanding the Docker security defaults, how to improve them (theory and practical), along with many tools and techniques. How to Hack Like a Legend https://amzn.to/2uWh1Up - A hacker\u2019s tale breaking into a secretive offshore company, Sparc Flow, 2018 How to Investigate Like a Rockstar https://books2read.com/u/4jDWoZ - Live a real crisis to master the secrets of forensic analysis, Sparc Flow, 2017 Real World Cryptography https://www.manning.com/books/real-world-cryptography - This early-access book teaches you applied cryptographic techniques to understand and apply security at every level of your systems and applications. AWS Security https://www.manning.com/books/aws-security?utm_source=github&utm_medium=organic&utm_campaign=book_shields_aws_1_31_20 - This early-access book covers commong AWS security issues and best practices for access policies, data protection, auditing, continuous monitoring, and incident response. Post Training asks/ Further Reading CTF Events like : https://github.com/apsdehal/awesome-ctf Penetration Testing : https://github.com/enaqx/awesome-pentest Threat Intelligence : https://github.com/hslatman/awesome-threat-intelligence Threat Detection & Hunting : https://github.com/0x4D31/awesome-threat-detection Web Security: https://github.com/qazbnm456/awesome-web-security Building Secure and Reliable Systems : https://landing.google.com/sre/resources/foundationsandprinciples/srs-book/","title":"Conclusion"},{"location":"level101/security/conclusion/#conclusion","text":"Now that you have completed this course on Security you are now aware of the possible security threats to computer systems & networks. Not only that, but you are now better able to protect your systems as well as recommend security measures to others. This course provides fundamental everyday knowledge on security domain which will also help you keep security at the top of your priority.","title":"Conclusion"},{"location":"level101/security/conclusion/#other-resources","text":"Some books that would be a great resource Holistic Info-Sec for Web Developers https://holisticinfosecforwebdevelopers.com/ - Free and downloadable book series with very broad and deep coverage of what Web Developers and DevOps Engineers need to know in order to create robust, reliable, maintainable and secure software, networks and other, that are delivered continuously, on time, with no nasty surprises Docker Security - Quick Reference: For DevOps Engineers https://leanpub.com/dockersecurity-quickreference - A book on understanding the Docker security defaults, how to improve them (theory and practical), along with many tools and techniques. How to Hack Like a Legend https://amzn.to/2uWh1Up - A hacker\u2019s tale breaking into a secretive offshore company, Sparc Flow, 2018 How to Investigate Like a Rockstar https://books2read.com/u/4jDWoZ - Live a real crisis to master the secrets of forensic analysis, Sparc Flow, 2017 Real World Cryptography https://www.manning.com/books/real-world-cryptography - This early-access book teaches you applied cryptographic techniques to understand and apply security at every level of your systems and applications. AWS Security https://www.manning.com/books/aws-security?utm_source=github&utm_medium=organic&utm_campaign=book_shields_aws_1_31_20 - This early-access book covers commong AWS security issues and best practices for access policies, data protection, auditing, continuous monitoring, and incident response.","title":"Other Resources"},{"location":"level101/security/conclusion/#post-training-asks-further-reading","text":"CTF Events like : https://github.com/apsdehal/awesome-ctf Penetration Testing : https://github.com/enaqx/awesome-pentest Threat Intelligence : https://github.com/hslatman/awesome-threat-intelligence Threat Detection & Hunting : https://github.com/0x4D31/awesome-threat-detection Web Security: https://github.com/qazbnm456/awesome-web-security Building Secure and Reliable Systems : https://landing.google.com/sre/resources/foundationsandprinciples/srs-book/","title":"Post Training asks/ Further Reading"},{"location":"level101/security/fundamentals/","text":"Part I: Fundamentals Introduction to Security Overview for SRE If you look closely, both Site Reliability Engineering and Security Engineering are concerned with keeping a system usable. Issues like broken releases, capacity shortages, and misconfigurations can make a system unusable (at least temporarily). Security or privacy incidents that break the trust of users also undermine the usefulness of a system. Consequently, system security should be top of mind for SREs. SREs should be involved in both significant design discussions and actual system changes. They have quite a big role in System design & hence are quite sometimes the first line of defence. SRE\u2019s help in preventing bad design & implementations which can affect the overall security of the infrastructure. Successfully designing, implementing, and maintaining systems requires a commitment to the full system lifecycle . This commitment is possible only when security and reliability are central elements in the architecture of systems. Core Pillars of Information Security : Confidentiality \u2013 only allow access to data for which the user is permitted Integrity \u2013 ensure data is not tampered or altered by unauthorized users Availability \u2013 ensure systems and data are available to authorized users when they need it Thinking like a Security Engineer When starting a new application or re-factoring an existing application, you should consider each functional feature, and consider: Is the process surrounding this feature as safe as possible? In other words, is this a flawed process? If I were evil, how would I abuse this feature? Or more specifically failing to address how a feature can be abused can cause design flaws. Is the feature required to be on by default? If so, are there limits or options that could help reduce the risk from this feature? Security Principles By OWASP (Open Web Application Security Project) Minimize attack surface area : Every feature that is added to an application adds a certain amount of risk to the overall application. The aim of secure development is to reduce the overall risk by reducing the attack surface area. For example, a web application implements online help with a search function. The search function may be vulnerable to SQL injection attacks. If the help feature was limited to authorized users, the attack likelihood is reduced. If the help feature\u2019s search function was gated through centralized data validation routines, the ability to perform SQL injection is dramatically reduced. However, if the help feature was re-written to eliminate the search function (through a better user interface, for example), this almost eliminates the attack surface area, even if the help feature was available to the Internet at large. Establish secure defaults: There are many ways to deliver an \u201cout of the box\u201d experience for users. However, by default, the experience should be secure, and it should be up to the user to reduce their security \u2013 if they are allowed. For example, by default, password ageing and complexity should be enabled. Users might be allowed to turn these two features off to simplify their use of the application and increase their risk. Default Passwords of routers, IoT devices should be changed Principle of Least privilege The principle of least privilege recommends that accounts have the least amount of privilege required to perform their business processes. This encompasses user rights, resource permissions such as CPU limits, memory, network, and file system permissions. For example, if a middleware server only requires access to the network, read access to a database table, and the ability to write to a log, this describes all the permissions that should be granted. Under no circumstances should the middleware be granted administrative privileges. Principle of Defense in depth The principle of defence in depth suggests that where one control would be reasonable, more controls that approach risks in different fashions are better. Controls, when used in depth, can make severe vulnerabilities extraordinarily difficult to exploit and thus unlikely to occur. With secure coding, this may take the form of tier-based validation, centralized auditing controls, and requiring users to be logged on all pages. For example, a flawed administrative interface is unlikely to be vulnerable to an anonymous attack if it correctly gates access to production management networks, checks for administrative user authorization, and logs all access. Fail securely Applications regularly fail to process transactions for many reasons. How they fail can determine if an application is secure or not. ``` is_admin = true; try { code_which_may_faile(); is_admin = is_user_assigned_role(\"Adminstrator\"); } catch (Exception err) { log.error(err.toString()); } ``` - If either codeWhichMayFail() or isUserInRole fails or throws an exception, the user is an admin by default. This is obviously a security risk. Don\u2019t trust services Many organizations utilize the processing capabilities of third-party partners, who more than likely have different security policies and posture than you. It is unlikely that you can influence or control any external third party, whether they are home users or major suppliers or partners. Therefore, the implicit trust of externally run systems is not warranted. All external systems should be treated similarly. For example, a loyalty program provider provides data that is used by Internet Banking, providing the number of reward points and a small list of potential redemption items. However, the data should be checked to ensure that it is safe to display to end-users and that the reward points are a positive number, and not improbably large. Separation of duties The key to fraud control is the separation of duties. For example, someone who requests a computer cannot also sign for it, nor should they directly receive the computer. This prevents the user from requesting many computers and claiming they never arrived. Certain roles have different levels of trust than normal users. In particular, administrators are different from normal users. In general, administrators should not be users of the application. For example, an administrator should be able to turn the system on or off, set password policy but shouldn\u2019t be able to log on to the storefront as a super privileged user, such as being able to \u201cbuy\u201d goods on behalf of other users. Avoid security by obscurity Security through obscurity is a weak security control, and nearly always fails when it is the only control. This is not to say that keeping secrets is a bad idea, it simply means that the security of systems should not be reliant upon keeping details hidden. For example, the security of an application should not rely upon knowledge of the source code being kept secret. The security should rely upon many other factors, including reasonable password policies, defence in depth, business transaction limits, solid network architecture, and fraud, and audit controls. A practical example is Linux. Linux\u2019s source code is widely available, and yet when properly secured, Linux is a secure and robust operating system. Keep security simple Attack surface area and simplicity go hand in hand. Certain software engineering practices prefer overly complex approaches to what would otherwise be a relatively straightforward and simple design. Developers should avoid the use of double negatives and complex architectures when a simpler approach would be faster and simpler. For example, although it might be fashionable to have a slew of singleton entity beans running on a separate middleware server, it is more secure and faster to simply use global variables with an appropriate mutex mechanism to protect against race conditions. Fix security issues correctly Once a security issue has been identified, it is important to develop a test for it and to understand the root cause of the issue. When design patterns are used, the security issue is likely widespread amongst all codebases, so developing the right fix without introducing regressions is essential. For example, a user has found that they can see another user\u2019s balance by adjusting their cookie. The fix seems to be relatively straightforward, but as the cookie handling code is shared among all applications, a change to just one application will trickle through to all other applications. The fix must, therefore, be tested on all affected applications. Reliability & Security Reliability and security are both crucial components of a truly trustworthy system, but building systems that are both reliable and secure is difficult. While the requirements for reliability and security share many common properties, they also require different design considerations. It is easy to miss the subtle interplay between reliability and security that can cause unexpected outcomes Ex: A password management application failure was triggered by a reliability problem i.e poor load-balancing and load-shedding strategies and its recovery were later complicated by multiple measures (HSM mechanism which needs to be plugged into server racks, which works as an authentication & the HSM token supposedly locked inside a case.. & the problem can be further elongated ) designed to increase the security of the system. Authentication vs Authorization Authentication is the act of validating that users are who they claim to be. Passwords are the most common authentication factor\u2014if a user enters the correct password, the system assumes the identity is valid and grants access. Other technologies such as One-Time Pins, authentication apps, and even biometrics can also be used to authenticate identity. In some instances, systems require the successful verification of more than one factor before granting access. This multi-factor authentication (MFA) requirement is often deployed to increase security beyond what passwords alone can provide. Authorization in system security is the process of giving the user permission to access a specific resource or function. This term is often used interchangeably with access control or client privilege. Giving someone permission to download a particular file on a server or providing individual users with administrative access to an application are good examples. In secure environments, authorization must always follow authentication, users should first prove that their identities are genuine before an organization\u2019s administrators grant them access to the requested resources. Common authentication flow (local authentication) The user registers using an identifier like username/email/mobile The application stores user credentials in the database The application sends a verification email/message to validate the registration Post successful registration, the user enters credentials for logging in On successful authentication, the user is allowed access to specific resources OpenID/OAuth OpenID is an authentication protocol that allows us to authenticate users without using a local auth system. In such a scenario, a user has to be registered with an OpenID Provider and the same provider should be integrated with the authentication flow of your application. To verify the details, we have to forward the authentication requests to the provider. On successful authentication, we receive a success message and/or profile details with which we can execute the necessary flow. OAuth is an authorization mechanism that allows your application user access to a provider(Gmail/Facebook/Instagram/etc). On successful response, we (your application) receive a token with which the application can access certain APIs on behalf of a user. OAuth is convenient in case your business use case requires some certain user-facing APIs like access to Google Drive or sending tweets on your behalf. Most OAuth 2.0 providers can be used for pseudo authentication. Having said that, it can get pretty complicated if you are using multiple OAuth providers to authenticate users on top of the local authentication system. Cryptography It is the science and study of hiding any text in such a way that only the intended recipients or authorized persons can read it and that any text can even use things such as invisible ink or the mechanical cryptography machines of the past. Cryptography is necessary for securing critical or proprietary information and is used to encode private data messages by converting some plain text into ciphertext. At its core, there are two ways of doing this, more advanced methods are all built upon. Ciphers Ciphers are the cornerstone of cryptography. A cipher is a set of algorithms that performs encryption or decryption on a message. An encryption algorithm (E) takes a secret key (k) and a message (m) and produces a ciphertext (c). Similarly, a Decryption algorithm (D) takes a secret key (K) and the previous resulting Ciphertext (C). They are represented as follows: E(k,m) = c D(k,c) = m This also means that for it to be a cipher, it must satisfy the consistency equation as follows, making it possible to decrypt. D(k,E(k,m)) = m Stream Ciphers: The message is broken into characters or bits and enciphered with a key or keystream(should be random and generated independently of the message stream) that is as long as the plaintext bitstream. If the keystream is random, this scheme would be unbreakable unless the keystream was acquired, making it unconditionally secure. The keystream must be provided to both parties in a secure way to prevent its release. Block Ciphers: Block ciphers \u2014 process messages in blocks, each of which is then encrypted or decrypted. A block cipher is a symmetric cipher in which blocks of plaintext are treated as a whole and used to produce ciphertext blocks. The block cipher takes blocks that are b bits long and encrypts them to blocks that are also b bits long. Block sizes are typically 64 or 128 bits long. Encryption Secret Key (Symmetric Key) : the same key is used for encryption and decryption Public Key (Asymmetric Key) in an asymmetric, the encryption and decryption keys are different but related. The encryption key is known as the public key and the decryption key is known as the private key. The public and private keys are known as a key pair. Symmetric Key Encryption DES The Data Encryption Standard (DES) has been the worldwide encryption standard for a long time. IBM developed DES in 1975, and it has held up remarkably well against years of cryptanalysis. DES is a symmetric encryption algorithm with a fixed key length of 56 bits. The algorithm is still good, but because of the short key length, it is susceptible to brute-force attacks that have sufficient resources. DES usually operates in block mode, whereby it encrypts data in 64-bit blocks. The same algorithm and key are used for both encryption and decryption. Because DES is based on simple mathematical functions, it can be easily implemented and accelerated in hardware. Triple DES With advances in computer processing power, the original 56-bit DES key became too short to withstand an attacker with even a limited budget. One way of increasing the effective key length of DES without changing the well-analyzed algorithm itself is to use the same algorithm with different keys several times in a row. The technique of applying DES three times in a row to a plain text block is called Triple DES (3DES). The 3DES technique is shown in Figure. Brute-force attacks on 3DES are considered unfeasible today. Because the basic algorithm has been tested in the field for more than 25 years, it is considered to be more trustworthy than its predecessor. AES On October 2, 2000, The U.S. National Institute of Standards and Technology (NIST) announced the selection of the Rijndael cipher as the AES algorithm. This cipher, developed by Joan Daemen and Vincent Rijmen, has a variable block length and key length. The algorithm currently specifies how to use keys with a length of 128, 192, or 256 bits to encrypt blocks with a length of 128, 192, or 256 bits (all nine combinations of key length and block length are possible). Both block and key lengths can be extended easily to multiples of 32 bits. AES was chosen to replace DES and 3DES because they are either too weak (DES, in terms of key length) or too slow (3DES) to run on modern, efficient hardware. AES is more efficient and much faster, usually by a factor of 5 compared to DES on the same hardware. AES is also more suitable for high throughput, especially if pure software encryption is used. However, AES is a relatively young algorithm, and as the golden rule of cryptography states, \u201cA more mature algorithm is always more trusted.\u201d Asymmetric Key Algorithm In a symmetric key system, Alice first puts the secret message in a box and then padlocks the box using a lock to which she has a key. She then sends the box to Bob through regular mail. When Bob receives the box, he uses an identical copy of Alice's key (which he has obtained previously) to open the box and read the message. In an asymmetric key system, instead of opening the box when he receives it, Bob simply adds his own personal lock to the box and returns the box through public mail to Alice. Alice uses her key to remove her lock and returns the box to Bob, with Bob's lock still in place. Finally, Bob uses his key to remove his lock and reads the message from Alice. The critical advantage in an asymmetric system is that Alice never needs to send a copy of her key to Bob. This reduces the possibility that a third party (for example, an unscrupulous postmaster) can copy the key while it is in transit to Bob, allowing that third party to spy on all future messages sent by Alice. In addition, if Bob is careless and allows someone else to copy his key, Alice's messages to Bob are compromised, but Alice's messages to other people remain secret NOTE : In terms of TLS key exchange, this is the common approach. Diffie-Hellman The protocol has two system parameters, p and g. They are both public and may be used by everybody. Parameter p is a prime number, and parameter g (usually called a generator) is an integer that is smaller than p, but with the following property: For every number n between 1 and p \u2013 1 inclusive, there is a power k of g such that n = gk mod p. Diffie Hellman algorithm is an asymmetric algorithm used to establish a shared secret for a symmetric key algorithm. Nowadays most of the people use hybrid cryptosystem i.e, a combination of symmetric and asymmetric encryption. Asymmetric Encryption is used as a technique in key exchange mechanism to share a secret key and after the key is shared between sender and receiver, the communication will take place using symmetric encryption. The shared secret key will be used to encrypt the communication. Refer: https://medium.com/@akhigbemmanuel/what-is-the-diffie-hellman-key-exchange-algorithm-84d60025a30d RSA The RSA algorithm is very flexible and has a variable key length where, if necessary, speed can be traded for the level of security of the algorithm. The RSA keys are usually 512 to 2048 bits long. RSA has withstood years of extensive cryptanalysis. Although those years neither proved nor disproved RSA's security, they attest to a confidence level in the algorithm. RSA security is based on the difficulty of factoring very large numbers. If an easy method of factoring these large numbers were discovered, the effectiveness of RSA would be destroyed. Refer: https://medium.com/curiositypapers/a-complete-explanation-of-rsa-asymmetric-encryption-742c5971e0f NOTE : RSA Keys can be used for key exchange just like Diffie Hellman Hashing Algorithms Hashing is one of the mechanisms used for data integrity assurance. Hashing is based on a one-way mathematical function, which is relatively easy to compute but significantly harder to reverse. A hash function, which is a one-way function to input data to produce a fixed-length digest (fingerprint) of output data. The digest is cryptographically strong; that is, it is impossible to recover input data from its digest. If the input data changes just a little, the digest (fingerprint) changes substantially in what is called an avalanche effect. More: https://medium.com/@rauljordan/the-state-of-hashing-algorithms-the-why-the-how-and-the-future-b21d5c0440de https://medium.com/@StevieCEllis/the-beautiful-hash-algorithm-f18d9d2b84fb MD5 MD5 is a one-way function with which it is easy to compute the hash from the given input data, but it is unfeasible to compute input data given only a hash. SHA-1 MD5 is considered less secure than SHA-1 because MD5 has some weaknesses. HA-1 also uses a stronger, 160-bit digest, which makes MD5 the second choice as hash methods are concerned. The algorithm takes a message of less than 264 bits in length and produces a 160-bit message digest. This algorithm is slightly slower than MD5. NOTE : SHA-1 is also recently demonstrated to be broken, Minimum current recommendation is SHA-256 Digital Certificates Digital signatures, provide a means to digitally authenticate devices and individual users. In public-key cryptography, such as the RSA encryption system, each user has a key-pair containing both a public key and a private key. The keys act as complements, and anything encrypted with one of the keys can be decrypted with the other. In simple terms, a signature is formed when data is encrypted with a user's private key. The receiver verifies the signature by decrypting the message with the sender's public key. Key management is often considered the most difficult task in designing and implementing cryptographic systems. Businesses can simplify some of the deployment and management issues that are encountered with secured data communications by employing a Public Key Infrastructure (PKI). Because corporations often move security-sensitive communications across the Internet, an effective mechanism must be implemented to protect sensitive information from the threats presented on the Internet. PKI provides a hierarchical framework for managing digital security attributes. Each PKI participant holds a digital certificate that has been issued by a CA (either public or private). The certificate contains several attributes that are used when parties negotiate a secure connection. These attributes must include the certificate validity period, end-host identity information, encryption keys that will be used for secure communications, and the signature of the issuing CA. Optional attributes may be included, depending on the requirements and capability of the PKI. A CA can be a trusted third party, such as VeriSign or Entrust, or a private (in-house) CA that you establish within your organization. The fact that the message could be decrypted using the sender's public key means that the holder of the private key created the message. This process relies on the receiver having a copy of the sender's public key and knowing with a high degree of certainty that it really does belong to the sender and not to someone pretending to be the sender. To validate the CA's signature, the receiver must know the CA's public key. Normally, this is handled out-of-band or through an operation performed during the installation of the certificate. For instance, most web browsers are configured with the root certificates of several CAs by default. CA Enrollment process The end host generates a private-public key pair. The end host generates a certificate request, which it forwards to the CA. Manual human intervention is required to approve the enrollment request, which is received by the CA. After the CA operator approves the request, the CA signs the certificate request with its private key and returns the completed certificate to the end host. The end host writes the certificate into a nonvolatile storage area (PC hard disk or NVRAM on Cisco routers). Refer : https://www.ssh.com/manuals/server-zos-product/55/ch06s03s01.html Login Security SSH SSH, the Secure Shell, is a popular, powerful, software-based approach to network security. Whenever data is sent by a computer to the network, SSH automatically encrypts (scrambles) it. Then, when the data reaches its intended recipient, SSH automatically decrypts (unscrambles) it. The result is transparent encryption: users can work normally, unaware that their communications are safely encrypted on the network. In addition, SSH can use modern, secure encryption algorithms based on how it's being configured and is effective enough to be found within mission-critical applications at major corporations. SSH has a client/server architecture An SSH server program, typically installed and run by a system administrator, accepts or rejects incoming connections to its host computer. Users then run SSH client programs, typically on other computers, to make requests of the SSH server, such as \u201cPlease log me in,\u201d \u201cPlease send me a file,\u201d or \u201cPlease execute this command.\u201d All communications between clients and servers are securely encrypted and protected from modification. What SSH is not: Although SSH stands for Secure Shell, it is not a true shell in the sense of the Unix Bourne shell and C shell. It is not a command interpreter, nor does it provide wildcard expansion, command history, and so forth. Rather, SSH creates a channel for running a shell on a remote computer, with end-to-end encryption between the two systems. The major features and guarantees of the SSH protocol are: Privacy of your data, via strong encryption Integrity of communications, guaranteeing they haven\u2019t been altered Authentication, i.e., proof of identity of senders and receivers Authorization, i.e., access control to accounts Forwarding or tunnelling to encrypt other TCP/IP-based sessions Kerberos According to Greek mythology Kerberos (Cerberus) was the gigantic, three-headed dog that guards the gates of the underworld to prevent the dead from leaving. So when it comes to Computer Science, Kerberos is a network authentication protocol and is currently the default authentication technology used by Microsoft Active Directory to authenticate users to services within a local area network. Kerberos uses symmetric-key cryptography and requires a trusted third-party authentication service to verify user identities. So they used the name of Kerberos for their computer network authentication protocol as the three heads of the Kerberos represent: a client: A user/ a service a server: Kerberos protected hosts reside - a Key Distribution Center (KDC), which acts as the trusted third-party authentication service. The KDC includes the following two servers: Authentication Server (AS) that performs the initial authentication and issues ticket-granting tickets (TGT) for users. Ticket-Granting Server (TGS) that issues service tickets that are based on the initial ticket-granting tickets (TGT). Certificate Chain The first part of the output of the OpenSSL command shows three certificates numbered 0, 1, and 2(not 2 anymore). Each certificate has a subject, s, and an issuer, i. The first certificate, number 0, is called the end-entity certificate. The subject line tells us it\u2019s valid for any subdomain of google.com because its subject is set to *.google.com. $ openssl s_client -connect www.google.com:443 -CApath /etc/ssl/certs CONNECTED(00000005) depth=2 OU = GlobalSign Root CA - R2, O = GlobalSign, CN = GlobalSign verify return:1 depth=1 C = US, O = Google Trust Services, CN = GTS CA 1O1 verify return:1 depth=0 C = US, ST = California, L = Mountain View, O = Google LLC, CN = www.google.com verify return:1 --- Certificate chain 0 s:/C=US/ST=California/L=Mountain View/O=Google LLC/CN=www.google.com i:/C=US/O=Google Trust Services/CN=GTS CA 1O1 1 s:/C=US/O=Google Trust Services/CN=GTS CA 1O1 i:/OU=GlobalSign Root CA - R2/O=GlobalSign/CN=GlobalSign --- Server certificate The issuer line indicates it\u2019s issued by Google Internet Authority G2, which also happens to be the subject of the second certificate, number 1 What the OpenSSL command line doesn\u2019t show here is the trust store that contains the list of CA certificates trusted by the system OpenSSL runs on. The public certificate of GlobalSign Authority must be present in the system\u2019s trust store to close the verification chain. This is called a chain of trust, and the figure below summarizes its behaviour at a high level. High-level view of the concept of chain of trust applied to verifying the authenticity of a website. The Root CA in the Firefox trust store provides the initial trust to verify the entire chain and trust the end-entity certificate. TLS Handshake The client sends a HELLO message to the server with a list of protocols and algorithms it supports. The server says HELLO back and sends its chain of certificates. Based on the capabilities of the client, the server picks a cipher suite. If the cipher suite supports ephemeral key exchange, like ECDHE does(ECDHE is an algorithm known as the Elliptic Curve Diffie-Hellman Exchange), the server and the client negotiate a pre-master key with the Diffie-Hellman algorithm. The pre-master key is never sent over the wire. The client and server create a session key that will be used to encrypt the data transiting through the connection. At the end of the handshake, both parties possess a secret session key used to encrypt data for the rest of the connection. This is what OpenSSL refers to as Master-Key NOTE There are 3 versions of TLS , TLS 1.0, 1.1 & 1.2 TLS 1.0 was released in 1999, making it a nearly two-decade-old protocol. It has been known to be vulnerable to attacks\u2014such as BEAST and POODLE\u2014for years, in addition to supporting weak cryptography, which doesn\u2019t keep modern-day connections sufficiently secure. TLS 1.1 is the forgotten \u201cmiddle child.\u201d It also has bad cryptography like its younger sibling. In most software, it was leapfrogged by TLS 1.2 and it\u2019s rare to see TLS 1.1 used. \u201cPerfect\u201d Forward Secrecy The term \u201cephemeral\u201d in the key exchange provides an important security feature mis-named perfect forward secrecy (PFS) or just \u201cForward Secrecy\u201d. In a non-ephemeral key exchange, the client sends the pre-master key to the server by encrypting it with the server\u2019s public key. The server then decrypts the pre-master key with its private key. If at a later point in time, the private key of the server is compromised, an attacker can go back to this handshake, decrypt the pre-master key, obtain the session key, and decrypt the entire traffic. Non-ephemeral key exchanges are vulnerable to attacks that may happen in the future on recorded traffic. And because people seldom change their password, decrypting data from the past may still be valuable for an attacker. An ephemeral key exchange like DHE, or its variant on elliptic curve, ECDHE, solves this problem by not transmitting the pre-master key over the wire. Instead, the pre-master key is computed by both the client and the server in isolation, using nonsensitive information exchanged publicly. Because the pre-master key can\u2019t be decrypted later by an attacker, the session key is safe from future attacks: hence, the term perfect forward secrecy. Keys are changed every X blocks along the stream. That prevents an attacker from simply sniffing the stream and applying brute force to crack the whole thing. \"Forward secrecy\" means that just because I can decrypt block M, does not mean that I can decrypt block Q Downside: The downside to PFS is that all those extra computational steps induce latency on the handshake and slow the user down. To avoid repeating this expensive work at every connection, both sides cache the session key for future use via a technique called session resumption. This is what the session-ID and TLS ticket are for: they allow a client and server that share a session ID to skip over the negotiation of a session key, because they already agreed on one previously, and go directly to exchanging data securely.","title":"Fundamentals of Security"},{"location":"level101/security/fundamentals/#part-i-fundamentals","text":"","title":"Part I: Fundamentals"},{"location":"level101/security/fundamentals/#introduction-to-security-overview-for-sre","text":"If you look closely, both Site Reliability Engineering and Security Engineering are concerned with keeping a system usable. Issues like broken releases, capacity shortages, and misconfigurations can make a system unusable (at least temporarily). Security or privacy incidents that break the trust of users also undermine the usefulness of a system. Consequently, system security should be top of mind for SREs. SREs should be involved in both significant design discussions and actual system changes. They have quite a big role in System design & hence are quite sometimes the first line of defence. SRE\u2019s help in preventing bad design & implementations which can affect the overall security of the infrastructure. Successfully designing, implementing, and maintaining systems requires a commitment to the full system lifecycle . This commitment is possible only when security and reliability are central elements in the architecture of systems. Core Pillars of Information Security : Confidentiality \u2013 only allow access to data for which the user is permitted Integrity \u2013 ensure data is not tampered or altered by unauthorized users Availability \u2013 ensure systems and data are available to authorized users when they need it Thinking like a Security Engineer When starting a new application or re-factoring an existing application, you should consider each functional feature, and consider: Is the process surrounding this feature as safe as possible? In other words, is this a flawed process? If I were evil, how would I abuse this feature? Or more specifically failing to address how a feature can be abused can cause design flaws. Is the feature required to be on by default? If so, are there limits or options that could help reduce the risk from this feature? Security Principles By OWASP (Open Web Application Security Project) Minimize attack surface area : Every feature that is added to an application adds a certain amount of risk to the overall application. The aim of secure development is to reduce the overall risk by reducing the attack surface area. For example, a web application implements online help with a search function. The search function may be vulnerable to SQL injection attacks. If the help feature was limited to authorized users, the attack likelihood is reduced. If the help feature\u2019s search function was gated through centralized data validation routines, the ability to perform SQL injection is dramatically reduced. However, if the help feature was re-written to eliminate the search function (through a better user interface, for example), this almost eliminates the attack surface area, even if the help feature was available to the Internet at large. Establish secure defaults: There are many ways to deliver an \u201cout of the box\u201d experience for users. However, by default, the experience should be secure, and it should be up to the user to reduce their security \u2013 if they are allowed. For example, by default, password ageing and complexity should be enabled. Users might be allowed to turn these two features off to simplify their use of the application and increase their risk. Default Passwords of routers, IoT devices should be changed Principle of Least privilege The principle of least privilege recommends that accounts have the least amount of privilege required to perform their business processes. This encompasses user rights, resource permissions such as CPU limits, memory, network, and file system permissions. For example, if a middleware server only requires access to the network, read access to a database table, and the ability to write to a log, this describes all the permissions that should be granted. Under no circumstances should the middleware be granted administrative privileges. Principle of Defense in depth The principle of defence in depth suggests that where one control would be reasonable, more controls that approach risks in different fashions are better. Controls, when used in depth, can make severe vulnerabilities extraordinarily difficult to exploit and thus unlikely to occur. With secure coding, this may take the form of tier-based validation, centralized auditing controls, and requiring users to be logged on all pages. For example, a flawed administrative interface is unlikely to be vulnerable to an anonymous attack if it correctly gates access to production management networks, checks for administrative user authorization, and logs all access. Fail securely Applications regularly fail to process transactions for many reasons. How they fail can determine if an application is secure or not. ``` is_admin = true; try { code_which_may_faile(); is_admin = is_user_assigned_role(\"Adminstrator\"); } catch (Exception err) { log.error(err.toString()); } ``` - If either codeWhichMayFail() or isUserInRole fails or throws an exception, the user is an admin by default. This is obviously a security risk. Don\u2019t trust services Many organizations utilize the processing capabilities of third-party partners, who more than likely have different security policies and posture than you. It is unlikely that you can influence or control any external third party, whether they are home users or major suppliers or partners. Therefore, the implicit trust of externally run systems is not warranted. All external systems should be treated similarly. For example, a loyalty program provider provides data that is used by Internet Banking, providing the number of reward points and a small list of potential redemption items. However, the data should be checked to ensure that it is safe to display to end-users and that the reward points are a positive number, and not improbably large. Separation of duties The key to fraud control is the separation of duties. For example, someone who requests a computer cannot also sign for it, nor should they directly receive the computer. This prevents the user from requesting many computers and claiming they never arrived. Certain roles have different levels of trust than normal users. In particular, administrators are different from normal users. In general, administrators should not be users of the application. For example, an administrator should be able to turn the system on or off, set password policy but shouldn\u2019t be able to log on to the storefront as a super privileged user, such as being able to \u201cbuy\u201d goods on behalf of other users. Avoid security by obscurity Security through obscurity is a weak security control, and nearly always fails when it is the only control. This is not to say that keeping secrets is a bad idea, it simply means that the security of systems should not be reliant upon keeping details hidden. For example, the security of an application should not rely upon knowledge of the source code being kept secret. The security should rely upon many other factors, including reasonable password policies, defence in depth, business transaction limits, solid network architecture, and fraud, and audit controls. A practical example is Linux. Linux\u2019s source code is widely available, and yet when properly secured, Linux is a secure and robust operating system. Keep security simple Attack surface area and simplicity go hand in hand. Certain software engineering practices prefer overly complex approaches to what would otherwise be a relatively straightforward and simple design. Developers should avoid the use of double negatives and complex architectures when a simpler approach would be faster and simpler. For example, although it might be fashionable to have a slew of singleton entity beans running on a separate middleware server, it is more secure and faster to simply use global variables with an appropriate mutex mechanism to protect against race conditions. Fix security issues correctly Once a security issue has been identified, it is important to develop a test for it and to understand the root cause of the issue. When design patterns are used, the security issue is likely widespread amongst all codebases, so developing the right fix without introducing regressions is essential. For example, a user has found that they can see another user\u2019s balance by adjusting their cookie. The fix seems to be relatively straightforward, but as the cookie handling code is shared among all applications, a change to just one application will trickle through to all other applications. The fix must, therefore, be tested on all affected applications. Reliability & Security Reliability and security are both crucial components of a truly trustworthy system, but building systems that are both reliable and secure is difficult. While the requirements for reliability and security share many common properties, they also require different design considerations. It is easy to miss the subtle interplay between reliability and security that can cause unexpected outcomes Ex: A password management application failure was triggered by a reliability problem i.e poor load-balancing and load-shedding strategies and its recovery were later complicated by multiple measures (HSM mechanism which needs to be plugged into server racks, which works as an authentication & the HSM token supposedly locked inside a case.. & the problem can be further elongated ) designed to increase the security of the system.","title":"Introduction to Security Overview for SRE"},{"location":"level101/security/fundamentals/#authentication-vs-authorization","text":"Authentication is the act of validating that users are who they claim to be. Passwords are the most common authentication factor\u2014if a user enters the correct password, the system assumes the identity is valid and grants access. Other technologies such as One-Time Pins, authentication apps, and even biometrics can also be used to authenticate identity. In some instances, systems require the successful verification of more than one factor before granting access. This multi-factor authentication (MFA) requirement is often deployed to increase security beyond what passwords alone can provide. Authorization in system security is the process of giving the user permission to access a specific resource or function. This term is often used interchangeably with access control or client privilege. Giving someone permission to download a particular file on a server or providing individual users with administrative access to an application are good examples. In secure environments, authorization must always follow authentication, users should first prove that their identities are genuine before an organization\u2019s administrators grant them access to the requested resources.","title":"Authentication vs Authorization"},{"location":"level101/security/fundamentals/#common-authentication-flow-local-authentication","text":"The user registers using an identifier like username/email/mobile The application stores user credentials in the database The application sends a verification email/message to validate the registration Post successful registration, the user enters credentials for logging in On successful authentication, the user is allowed access to specific resources","title":"Common authentication flow (local authentication)"},{"location":"level101/security/fundamentals/#openidoauth","text":"OpenID is an authentication protocol that allows us to authenticate users without using a local auth system. In such a scenario, a user has to be registered with an OpenID Provider and the same provider should be integrated with the authentication flow of your application. To verify the details, we have to forward the authentication requests to the provider. On successful authentication, we receive a success message and/or profile details with which we can execute the necessary flow. OAuth is an authorization mechanism that allows your application user access to a provider(Gmail/Facebook/Instagram/etc). On successful response, we (your application) receive a token with which the application can access certain APIs on behalf of a user. OAuth is convenient in case your business use case requires some certain user-facing APIs like access to Google Drive or sending tweets on your behalf. Most OAuth 2.0 providers can be used for pseudo authentication. Having said that, it can get pretty complicated if you are using multiple OAuth providers to authenticate users on top of the local authentication system.","title":"OpenID/OAuth"},{"location":"level101/security/fundamentals/#cryptography","text":"It is the science and study of hiding any text in such a way that only the intended recipients or authorized persons can read it and that any text can even use things such as invisible ink or the mechanical cryptography machines of the past. Cryptography is necessary for securing critical or proprietary information and is used to encode private data messages by converting some plain text into ciphertext. At its core, there are two ways of doing this, more advanced methods are all built upon.","title":"Cryptography"},{"location":"level101/security/fundamentals/#ciphers","text":"Ciphers are the cornerstone of cryptography. A cipher is a set of algorithms that performs encryption or decryption on a message. An encryption algorithm (E) takes a secret key (k) and a message (m) and produces a ciphertext (c). Similarly, a Decryption algorithm (D) takes a secret key (K) and the previous resulting Ciphertext (C). They are represented as follows: E(k,m) = c D(k,c) = m This also means that for it to be a cipher, it must satisfy the consistency equation as follows, making it possible to decrypt. D(k,E(k,m)) = m Stream Ciphers: The message is broken into characters or bits and enciphered with a key or keystream(should be random and generated independently of the message stream) that is as long as the plaintext bitstream. If the keystream is random, this scheme would be unbreakable unless the keystream was acquired, making it unconditionally secure. The keystream must be provided to both parties in a secure way to prevent its release. Block Ciphers: Block ciphers \u2014 process messages in blocks, each of which is then encrypted or decrypted. A block cipher is a symmetric cipher in which blocks of plaintext are treated as a whole and used to produce ciphertext blocks. The block cipher takes blocks that are b bits long and encrypts them to blocks that are also b bits long. Block sizes are typically 64 or 128 bits long. Encryption Secret Key (Symmetric Key) : the same key is used for encryption and decryption Public Key (Asymmetric Key) in an asymmetric, the encryption and decryption keys are different but related. The encryption key is known as the public key and the decryption key is known as the private key. The public and private keys are known as a key pair. Symmetric Key Encryption DES The Data Encryption Standard (DES) has been the worldwide encryption standard for a long time. IBM developed DES in 1975, and it has held up remarkably well against years of cryptanalysis. DES is a symmetric encryption algorithm with a fixed key length of 56 bits. The algorithm is still good, but because of the short key length, it is susceptible to brute-force attacks that have sufficient resources. DES usually operates in block mode, whereby it encrypts data in 64-bit blocks. The same algorithm and key are used for both encryption and decryption. Because DES is based on simple mathematical functions, it can be easily implemented and accelerated in hardware. Triple DES With advances in computer processing power, the original 56-bit DES key became too short to withstand an attacker with even a limited budget. One way of increasing the effective key length of DES without changing the well-analyzed algorithm itself is to use the same algorithm with different keys several times in a row. The technique of applying DES three times in a row to a plain text block is called Triple DES (3DES). The 3DES technique is shown in Figure. Brute-force attacks on 3DES are considered unfeasible today. Because the basic algorithm has been tested in the field for more than 25 years, it is considered to be more trustworthy than its predecessor. AES On October 2, 2000, The U.S. National Institute of Standards and Technology (NIST) announced the selection of the Rijndael cipher as the AES algorithm. This cipher, developed by Joan Daemen and Vincent Rijmen, has a variable block length and key length. The algorithm currently specifies how to use keys with a length of 128, 192, or 256 bits to encrypt blocks with a length of 128, 192, or 256 bits (all nine combinations of key length and block length are possible). Both block and key lengths can be extended easily to multiples of 32 bits. AES was chosen to replace DES and 3DES because they are either too weak (DES, in terms of key length) or too slow (3DES) to run on modern, efficient hardware. AES is more efficient and much faster, usually by a factor of 5 compared to DES on the same hardware. AES is also more suitable for high throughput, especially if pure software encryption is used. However, AES is a relatively young algorithm, and as the golden rule of cryptography states, \u201cA more mature algorithm is always more trusted.\u201d Asymmetric Key Algorithm In a symmetric key system, Alice first puts the secret message in a box and then padlocks the box using a lock to which she has a key. She then sends the box to Bob through regular mail. When Bob receives the box, he uses an identical copy of Alice's key (which he has obtained previously) to open the box and read the message. In an asymmetric key system, instead of opening the box when he receives it, Bob simply adds his own personal lock to the box and returns the box through public mail to Alice. Alice uses her key to remove her lock and returns the box to Bob, with Bob's lock still in place. Finally, Bob uses his key to remove his lock and reads the message from Alice. The critical advantage in an asymmetric system is that Alice never needs to send a copy of her key to Bob. This reduces the possibility that a third party (for example, an unscrupulous postmaster) can copy the key while it is in transit to Bob, allowing that third party to spy on all future messages sent by Alice. In addition, if Bob is careless and allows someone else to copy his key, Alice's messages to Bob are compromised, but Alice's messages to other people remain secret NOTE : In terms of TLS key exchange, this is the common approach. Diffie-Hellman The protocol has two system parameters, p and g. They are both public and may be used by everybody. Parameter p is a prime number, and parameter g (usually called a generator) is an integer that is smaller than p, but with the following property: For every number n between 1 and p \u2013 1 inclusive, there is a power k of g such that n = gk mod p. Diffie Hellman algorithm is an asymmetric algorithm used to establish a shared secret for a symmetric key algorithm. Nowadays most of the people use hybrid cryptosystem i.e, a combination of symmetric and asymmetric encryption. Asymmetric Encryption is used as a technique in key exchange mechanism to share a secret key and after the key is shared between sender and receiver, the communication will take place using symmetric encryption. The shared secret key will be used to encrypt the communication. Refer: https://medium.com/@akhigbemmanuel/what-is-the-diffie-hellman-key-exchange-algorithm-84d60025a30d RSA The RSA algorithm is very flexible and has a variable key length where, if necessary, speed can be traded for the level of security of the algorithm. The RSA keys are usually 512 to 2048 bits long. RSA has withstood years of extensive cryptanalysis. Although those years neither proved nor disproved RSA's security, they attest to a confidence level in the algorithm. RSA security is based on the difficulty of factoring very large numbers. If an easy method of factoring these large numbers were discovered, the effectiveness of RSA would be destroyed. Refer: https://medium.com/curiositypapers/a-complete-explanation-of-rsa-asymmetric-encryption-742c5971e0f NOTE : RSA Keys can be used for key exchange just like Diffie Hellman Hashing Algorithms Hashing is one of the mechanisms used for data integrity assurance. Hashing is based on a one-way mathematical function, which is relatively easy to compute but significantly harder to reverse. A hash function, which is a one-way function to input data to produce a fixed-length digest (fingerprint) of output data. The digest is cryptographically strong; that is, it is impossible to recover input data from its digest. If the input data changes just a little, the digest (fingerprint) changes substantially in what is called an avalanche effect. More: https://medium.com/@rauljordan/the-state-of-hashing-algorithms-the-why-the-how-and-the-future-b21d5c0440de https://medium.com/@StevieCEllis/the-beautiful-hash-algorithm-f18d9d2b84fb MD5 MD5 is a one-way function with which it is easy to compute the hash from the given input data, but it is unfeasible to compute input data given only a hash. SHA-1 MD5 is considered less secure than SHA-1 because MD5 has some weaknesses. HA-1 also uses a stronger, 160-bit digest, which makes MD5 the second choice as hash methods are concerned. The algorithm takes a message of less than 264 bits in length and produces a 160-bit message digest. This algorithm is slightly slower than MD5. NOTE : SHA-1 is also recently demonstrated to be broken, Minimum current recommendation is SHA-256 Digital Certificates Digital signatures, provide a means to digitally authenticate devices and individual users. In public-key cryptography, such as the RSA encryption system, each user has a key-pair containing both a public key and a private key. The keys act as complements, and anything encrypted with one of the keys can be decrypted with the other. In simple terms, a signature is formed when data is encrypted with a user's private key. The receiver verifies the signature by decrypting the message with the sender's public key. Key management is often considered the most difficult task in designing and implementing cryptographic systems. Businesses can simplify some of the deployment and management issues that are encountered with secured data communications by employing a Public Key Infrastructure (PKI). Because corporations often move security-sensitive communications across the Internet, an effective mechanism must be implemented to protect sensitive information from the threats presented on the Internet. PKI provides a hierarchical framework for managing digital security attributes. Each PKI participant holds a digital certificate that has been issued by a CA (either public or private). The certificate contains several attributes that are used when parties negotiate a secure connection. These attributes must include the certificate validity period, end-host identity information, encryption keys that will be used for secure communications, and the signature of the issuing CA. Optional attributes may be included, depending on the requirements and capability of the PKI. A CA can be a trusted third party, such as VeriSign or Entrust, or a private (in-house) CA that you establish within your organization. The fact that the message could be decrypted using the sender's public key means that the holder of the private key created the message. This process relies on the receiver having a copy of the sender's public key and knowing with a high degree of certainty that it really does belong to the sender and not to someone pretending to be the sender. To validate the CA's signature, the receiver must know the CA's public key. Normally, this is handled out-of-band or through an operation performed during the installation of the certificate. For instance, most web browsers are configured with the root certificates of several CAs by default. CA Enrollment process The end host generates a private-public key pair. The end host generates a certificate request, which it forwards to the CA. Manual human intervention is required to approve the enrollment request, which is received by the CA. After the CA operator approves the request, the CA signs the certificate request with its private key and returns the completed certificate to the end host. The end host writes the certificate into a nonvolatile storage area (PC hard disk or NVRAM on Cisco routers). Refer : https://www.ssh.com/manuals/server-zos-product/55/ch06s03s01.html","title":"Ciphers"},{"location":"level101/security/fundamentals/#login-security","text":"","title":"Login Security"},{"location":"level101/security/fundamentals/#ssh","text":"SSH, the Secure Shell, is a popular, powerful, software-based approach to network security. Whenever data is sent by a computer to the network, SSH automatically encrypts (scrambles) it. Then, when the data reaches its intended recipient, SSH automatically decrypts (unscrambles) it. The result is transparent encryption: users can work normally, unaware that their communications are safely encrypted on the network. In addition, SSH can use modern, secure encryption algorithms based on how it's being configured and is effective enough to be found within mission-critical applications at major corporations. SSH has a client/server architecture An SSH server program, typically installed and run by a system administrator, accepts or rejects incoming connections to its host computer. Users then run SSH client programs, typically on other computers, to make requests of the SSH server, such as \u201cPlease log me in,\u201d \u201cPlease send me a file,\u201d or \u201cPlease execute this command.\u201d All communications between clients and servers are securely encrypted and protected from modification. What SSH is not: Although SSH stands for Secure Shell, it is not a true shell in the sense of the Unix Bourne shell and C shell. It is not a command interpreter, nor does it provide wildcard expansion, command history, and so forth. Rather, SSH creates a channel for running a shell on a remote computer, with end-to-end encryption between the two systems. The major features and guarantees of the SSH protocol are: Privacy of your data, via strong encryption Integrity of communications, guaranteeing they haven\u2019t been altered Authentication, i.e., proof of identity of senders and receivers Authorization, i.e., access control to accounts Forwarding or tunnelling to encrypt other TCP/IP-based sessions","title":"SSH"},{"location":"level101/security/fundamentals/#kerberos","text":"According to Greek mythology Kerberos (Cerberus) was the gigantic, three-headed dog that guards the gates of the underworld to prevent the dead from leaving. So when it comes to Computer Science, Kerberos is a network authentication protocol and is currently the default authentication technology used by Microsoft Active Directory to authenticate users to services within a local area network. Kerberos uses symmetric-key cryptography and requires a trusted third-party authentication service to verify user identities. So they used the name of Kerberos for their computer network authentication protocol as the three heads of the Kerberos represent: a client: A user/ a service a server: Kerberos protected hosts reside - a Key Distribution Center (KDC), which acts as the trusted third-party authentication service. The KDC includes the following two servers: Authentication Server (AS) that performs the initial authentication and issues ticket-granting tickets (TGT) for users. Ticket-Granting Server (TGS) that issues service tickets that are based on the initial ticket-granting tickets (TGT).","title":"Kerberos"},{"location":"level101/security/fundamentals/#certificate-chain","text":"The first part of the output of the OpenSSL command shows three certificates numbered 0, 1, and 2(not 2 anymore). Each certificate has a subject, s, and an issuer, i. The first certificate, number 0, is called the end-entity certificate. The subject line tells us it\u2019s valid for any subdomain of google.com because its subject is set to *.google.com. $ openssl s_client -connect www.google.com:443 -CApath /etc/ssl/certs CONNECTED(00000005) depth=2 OU = GlobalSign Root CA - R2, O = GlobalSign, CN = GlobalSign verify return:1 depth=1 C = US, O = Google Trust Services, CN = GTS CA 1O1 verify return:1 depth=0 C = US, ST = California, L = Mountain View, O = Google LLC, CN = www.google.com verify return:1 --- Certificate chain 0 s:/C=US/ST=California/L=Mountain View/O=Google LLC/CN=www.google.com i:/C=US/O=Google Trust Services/CN=GTS CA 1O1 1 s:/C=US/O=Google Trust Services/CN=GTS CA 1O1 i:/OU=GlobalSign Root CA - R2/O=GlobalSign/CN=GlobalSign --- Server certificate The issuer line indicates it\u2019s issued by Google Internet Authority G2, which also happens to be the subject of the second certificate, number 1 What the OpenSSL command line doesn\u2019t show here is the trust store that contains the list of CA certificates trusted by the system OpenSSL runs on. The public certificate of GlobalSign Authority must be present in the system\u2019s trust store to close the verification chain. This is called a chain of trust, and the figure below summarizes its behaviour at a high level. High-level view of the concept of chain of trust applied to verifying the authenticity of a website. The Root CA in the Firefox trust store provides the initial trust to verify the entire chain and trust the end-entity certificate.","title":"Certificate Chain"},{"location":"level101/security/fundamentals/#tls-handshake","text":"The client sends a HELLO message to the server with a list of protocols and algorithms it supports. The server says HELLO back and sends its chain of certificates. Based on the capabilities of the client, the server picks a cipher suite. If the cipher suite supports ephemeral key exchange, like ECDHE does(ECDHE is an algorithm known as the Elliptic Curve Diffie-Hellman Exchange), the server and the client negotiate a pre-master key with the Diffie-Hellman algorithm. The pre-master key is never sent over the wire. The client and server create a session key that will be used to encrypt the data transiting through the connection. At the end of the handshake, both parties possess a secret session key used to encrypt data for the rest of the connection. This is what OpenSSL refers to as Master-Key NOTE There are 3 versions of TLS , TLS 1.0, 1.1 & 1.2 TLS 1.0 was released in 1999, making it a nearly two-decade-old protocol. It has been known to be vulnerable to attacks\u2014such as BEAST and POODLE\u2014for years, in addition to supporting weak cryptography, which doesn\u2019t keep modern-day connections sufficiently secure. TLS 1.1 is the forgotten \u201cmiddle child.\u201d It also has bad cryptography like its younger sibling. In most software, it was leapfrogged by TLS 1.2 and it\u2019s rare to see TLS 1.1 used.","title":"TLS Handshake"},{"location":"level101/security/fundamentals/#perfect-forward-secrecy","text":"The term \u201cephemeral\u201d in the key exchange provides an important security feature mis-named perfect forward secrecy (PFS) or just \u201cForward Secrecy\u201d. In a non-ephemeral key exchange, the client sends the pre-master key to the server by encrypting it with the server\u2019s public key. The server then decrypts the pre-master key with its private key. If at a later point in time, the private key of the server is compromised, an attacker can go back to this handshake, decrypt the pre-master key, obtain the session key, and decrypt the entire traffic. Non-ephemeral key exchanges are vulnerable to attacks that may happen in the future on recorded traffic. And because people seldom change their password, decrypting data from the past may still be valuable for an attacker. An ephemeral key exchange like DHE, or its variant on elliptic curve, ECDHE, solves this problem by not transmitting the pre-master key over the wire. Instead, the pre-master key is computed by both the client and the server in isolation, using nonsensitive information exchanged publicly. Because the pre-master key can\u2019t be decrypted later by an attacker, the session key is safe from future attacks: hence, the term perfect forward secrecy. Keys are changed every X blocks along the stream. That prevents an attacker from simply sniffing the stream and applying brute force to crack the whole thing. \"Forward secrecy\" means that just because I can decrypt block M, does not mean that I can decrypt block Q Downside: The downside to PFS is that all those extra computational steps induce latency on the handshake and slow the user down. To avoid repeating this expensive work at every connection, both sides cache the session key for future use via a technique called session resumption. This is what the session-ID and TLS ticket are for: they allow a client and server that share a session ID to skip over the negotiation of a session key, because they already agreed on one previously, and go directly to exchanging data securely.","title":"\u201cPerfect\u201d Forward Secrecy"},{"location":"level101/security/intro/","text":"Security Prerequisites Linux Basics Linux Networking What to expect from this course The course covers fundamentals of information security along with touching on subjects of system security, network & web security. This course aims to get you familiar with the basics of information security in day to day operations & then as an SRE develop the mindset of ensuring that security takes a front-seat while developing solutions. The course also serves as an introduction to common risks and best practices along with practical ways to find out vulnerable systems and loopholes which might become compromised if not secured. What is not covered under this course The courseware is not an ethical hacking workshop or a very deep dive into the fundamentals of the problems. The course does not deal with hacking or breaking into systems but rather an approach on how to ensure you don\u2019t get into those situations and also to make you aware of different ways a system can be compromised. Course Contents Fundamentals Network Security Threats, Attacks & Defence Writing Secure Code & More Conclusion","title":"Introduction"},{"location":"level101/security/intro/#security","text":"","title":"Security"},{"location":"level101/security/intro/#prerequisites","text":"Linux Basics Linux Networking","title":"Prerequisites"},{"location":"level101/security/intro/#what-to-expect-from-this-course","text":"The course covers fundamentals of information security along with touching on subjects of system security, network & web security. This course aims to get you familiar with the basics of information security in day to day operations & then as an SRE develop the mindset of ensuring that security takes a front-seat while developing solutions. The course also serves as an introduction to common risks and best practices along with practical ways to find out vulnerable systems and loopholes which might become compromised if not secured.","title":"What to expect from this course"},{"location":"level101/security/intro/#what-is-not-covered-under-this-course","text":"The courseware is not an ethical hacking workshop or a very deep dive into the fundamentals of the problems. The course does not deal with hacking or breaking into systems but rather an approach on how to ensure you don\u2019t get into those situations and also to make you aware of different ways a system can be compromised.","title":"What is not covered under this course"},{"location":"level101/security/intro/#course-contents","text":"Fundamentals Network Security Threats, Attacks & Defence Writing Secure Code & More Conclusion","title":"Course Contents"},{"location":"level101/security/network_security/","text":"Part II: Network Security Introduction TCP/IP is the dominant networking technology today. It is a five-layer architecture. These layers are, from top to bottom, the application layer, the transport layer (TCP), the network layer (IP), the data-link layer, and the physical layer. In addition to TCP/IP, there also are other networking technologies. For convenience, we use the OSI network model to represent non-TCP/IP network technologies. Different networks are interconnected using gateways. A gateway can be placed at any layer. The OSI model is a seven-layer architecture. The OSI architecture is similar to the TCP/IP architecture, except that the OSI model specifies two additional layers between the application layer and the transport layer in the TCP/IP architecture. These two layers are the presentation layer and the session layer. Figure 5.1 shows the relationship between the TCP/IP layers and the OSI layers. The application layer in TCP/IP corresponds to the application layer and the presentation layer in OSI. The transport layer in TCP/IP corresponds to the session layer and the transport layer in OSI. The remaining three layers in the TCP/IP architecture are one-to-one correspondent to the remaining three layers in the OSI model. Correspondence between layers of the TCP/IP architecture and the OSI model. Also shown are placements of cryptographic algorithms in network layers, where the dotted arrows indicate actual communications of cryptographic algorithms The functionalities of OSI layers are briefly described as follows: The application layer serves as an interface between applications and network programs. It supports application programs and end-user processing. Common application-layer programs include remote logins, file transfer, email, and Web browsing. The presentation layer is responsible for dealing with data that is formed differently. This protocol layer allows application-layer programs residing on different sides of a communication channel with different platforms to understand each other's data formats regardless of how they are presented. The session layer is responsible for creating, managing, and closing a communication connection. The transport layer is responsible for providing reliable connections, such as packet sequencing, traffic control, and congestion control. The network layer is responsible for routing device-independent data packets from the current hop to the next hop. The data-link layer is responsible for encapsulating device-independent data packets into device-dependent data frames. It has two sublayers: logical link control and media access control. The physical layer is responsible for transmitting device-dependent frames through some physical media. Starting from the application layer, data generated from an application program is passed down layer-by-layer to the physical layer. Data from the previous layer is enclosed in a new envelope at the current layer, where the data from the previous layer is also just an envelope containing the data from the layer before it. This is similar to enclosing a smaller envelope in a larger one. The envelope added at each layer contains sufficient information for handling the packet. Application-layer data are divided into blocks small enough to be encapsulated in an envelope at the next layer. Application data blocks are \u201cdressed up\u201d in the TCP/IP architecture according to the following basic steps. At the sending side, an application data block is encapsulated in a TCP packet when it is passed down to the TCP layer. In other words, a TCP packet consists of a header and a payload, where the header corresponds to the TCP envelope and the payload is the application data block. Likewise, the TCP packet will be encapsulated in an IP packet when it is passed down to the IP layer. An IP packet consists of a header and a payload, which is the TCP packet passed down from the TCP layer. The IP packet will be encapsulated in a device-dependent frame (e.g., an Ethernet frame) when it is passed down to the data-link layer. A frame has a header, and it may also have a trailer. For example, in addition to having a header, an Ethernet frame also has a 32-bit cyclic redundancy check (CRC) trailer. When it is passed down to the physical layer, a frame will be transformed into a sequence of media signals for transmission Flow Diagram of a Packet Generation At the destination side, the medium signals are converted by the physical layer into a frame, which is passed up to the data-link layer. The data-link layer passes the frame payload (i.e., the IP packet encapsulated in the frame) up to the IP layer. The IP layer passes the IP payload, namely, the TCP packet encapsulated in the IP packet, up to the TCP layer. The TCP layer passes the TCP payload, namely, the application data block, up to the application layer. When a packet arrives at a router, it only goes up to the IP layer, where certain fields in the IP header are modified (e.g., the value of TTL is decreased by 1). This modified packet is then passed back down layer-by-layer to the physical layer for further transmission. Public Key Infrastructure To deploy cryptographic algorithms in network applications, we need a way to distribute secret keys using open networks. Public-key cryptography is the best way to distribute these secret keys. To use public-key cryptography, we need to build a public-key infrastructure (PKI) to support and manage public-key certificates and certificate authority (CA) networks. In particular, PKIs are set up to perform the following functions: Determine the legitimacy of users before issuing public-key certificates to them. Issue public-key certificates upon user requests. Extend public-key certificates valid time upon user requests. Revoke public-key certificates upon users' requests or when the corresponding private keys are compromised. Store and manage public-key certificates. Prevent digital signature signers from denying their signatures. Support CA networks to allow different CAs to authenticate public-key certificates issued by other CAs. X.509: https://certificatedecoder.dev/?gclid=EAIaIQobChMI0M731O6G6gIVVSQrCh04bQaAEAAYASAAEgKRkPD_BwE IPsec: A Security Protocol at the Network Layer IPsec is a major security protocol at the network layer IPsec provides a potent platform for constructing virtual private networks (VPN). VPNs are private networks overlayed on public networks. The purpose of deploying cryptographic algorithms at the network layer is to encrypt or authenticate IP packets (either just the payloads or the whole packets). IPsec also specifies how to exchange keys. Thus, IPsec consists of authentication protocols, encryption protocols, and key exchange protocols. They are referred to, respectively, as authentication header (AH), encapsulating security payload (ESP), and Internet key exchange (IKE). PGP & S/MIME : Email Security There are several security protocols at the application layer. The most used of these protocols are email security protocols namely PGP and S/MIME. SMTP (\u201cSimple Mail Transfer Protocol\u201d) is used for sending and delivering from a client to a server via port 25: it\u2019s the outgoing server. On the contrary, POP (\u201cPost Office Protocol\u201d) allows the users to pick up the message and download it into their inbox: it\u2019s the incoming server. The latest version of the Post Office Protocol is named POP3, and it\u2019s been used since 1996; it uses port 110 PGP PGP implements all major cryptographic algorithms, the ZIP compression algorithm, and the Base64 encoding algorithm. It can be used to authenticate a message, encrypt a message, or both. PGP follows the following general process: authentication, ZIP compression, encryption, and Base64 encoding. The Base64 encoding procedure makes the message ready for SMTP transmission GPG (GnuPG) GnuPG is another free encryption standard that companies may use that is based on OpenPGP. GnuPG serves as a replacement for Symantec\u2019s PGP. The main difference is the supported algorithms. However, GnuPG plays nice with PGP by design. Because GnuPG is open, some businesses would prefer the technical support and the user interface that comes with Symantec\u2019s PGP. It is important to note that there are some nuances between the compatibility of GnuPG and PGP, such as the compatibility between certain algorithms, but in most applications such as email, there are workarounds. One such algorithm is the IDEA Module which isn\u2019t included in GnuPG out of the box due to patent issues. S/MIME SMTP can only handle 7-bit ASCII text (You can use UTF-8 extensions to alleviate these limitations, ) messages. While POP can handle other content types besides 7-bit ASCII, POP may, under a common default setting, download all the messages stored in the mail server to the user's local computer. After that, if POP removes these messages from the mail server. This makes it difficult for the users to read their messages from multiple computers. The Multipurpose Internet Mail Extension protocol (MIME) was designed to support sending and receiving email messages in various formats, including nontext files generated by word processors, graphics files, sound files, and video clips. Moreover, MIME allows a single message to include mixed types of data in any combination of these formats. The Internet Mail Access Protocol (IMAP), operated on TCP port 143(only for non-encrypted), stores (Configurable on both server & client just like PoP) incoming email messages in the mail server until the user deletes them deliberately. This allows the users to access their mailbox from multiple machines and download messages to a local machine without deleting it from the mailbox in the mail server. SSL/TLS SSL uses a PKI to decide if a server\u2019s public key is trustworthy by requiring servers to use a security certificate signed by a trusted CA. When Netscape Navigator 1.0 was released, it trusted a single CA operated by the RSA Data Security corporation. The server\u2019s public RSA keys were used to be stored in the security certificate, which can then be used by the browser to establish a secure communication channel. The security certificates we use today still rely on the same standard (named X.509) that Netscape Navigator 1.0 used back then. Netscape intended to train users(though this didn\u2019t work out later) to differentiate secure communications from insecure ones, so they put a lock icon next to the address bar. When the lock is open, the communication is insecure. A closed lock means communication has been secured with SSL, which required the server to provide a signed certificate. You\u2019re obviously familiar with this icon as it\u2019s been in every browser ever since. The engineers at Netscape truly created a standard for secure internet communications. A year after releasing SSL 2.0, Netscape fixed several security issues and released SSL 3.0, a protocol that, albeit being officially deprecated since June 2015, remains in use in certain parts of the world more than 20 years after its introduction. To standardize SSL, the Internet Engineering Task Force (IETF) created a slightly modified SSL 3.0 and, in 1999, unveiled it as Transport Layer Security (TLS) 1.0. The name change between SSL and TLS continues to confuse people today. Officially, TLS is the new SSL, but in practice, people use SSL and TLS interchangeably to talk about any version of the protocol. Must See: https://tls.ulfheim.net/ https://davidwong.fr/tls13/ Network Perimeter Security Let us see how we keep a check on the perimeter i.e the edges, the first layer of protection General Firewall Framework Firewalls are needed because encryption algorithms cannot effectively stop malicious packets from getting into an edge network. This is because IP packets, regardless of whether they are encrypted, can always be forwarded into an edge network. Firewalls that were developed in the 1990s are important instruments to help restrict network access. A firewall may be a hardware device, a software package, or a combination of both. Packets flowing into the internal network from the outside should be evaluated before they are allowed to enter. One of the critical elements of a firewall is its ability to examine packets without imposing a negative impact on communication speed while providing security protections for the internal network. The packet inspection that is carried out by firewalls can be done using several different methods. Based on the particular method used by the firewall, it can be characterized as either a packet filter, circuit gateway, application gateway, or dynamic packet filter. Packet Filters It inspects ingress packets coming to an internal network from outside and inspects egress packets going outside from an internal network Packing filtering only inspects IP headers and TCP headers, not the payloads generated at the application layer A packet-filtering firewall uses a set of rules to determine whether a packet should be allowed or denied to pass through. 2 types: Stateless It treats each packet as an independent object, and it does not keep track of any previously processed packets. In other words, stateless filtering inspects a packet when it arrives and makes a decision without leaving any record of the packet being inspected. Stateful Stateful filtering, also referred to as connection-state filtering, keeps track of connections between an internal host and an external host. A connection state (or state, for short) indicates whether it is a TCP connection or a UDP connection and whether the connection is established. Circuit Gateways Circuit gateways, also referred to as circuit-level gateways, are typically operated at the transportation layer They evaluate the information of the IP addresses and the port numbers contained in TCP (or UDP) headers and use it to determine whether to allow or to disallow an internal host and an external host to establish a connection. It is common practice to combine packet filters and circuit gateways to form a dynamic packet filter (DPF). Application Gateways(ALG) Aka PROXY Servers An Application Level Gateway (ALG) acts as a proxy for internal hosts, processing service requests from external clients. An ALG performs deep inspections on each IP packet (ingress or egress). In particular, an ALG inspects application program formats contained in the packet (e.g., MIME format or SQL format) and examines whether its payload is permitted. Thus, an ALG may be able to detect a computer virus contained in the payload. Because an ALG inspects packet payloads, it may be able to detect malicious code and quarantine suspicious packets, in addition to blocking packets with suspicious IP addresses and TCP ports. On the other hand, an ALG also incurs substantial computation and space overheads. Trusted Systems & Bastion Hosts A Trusted Operating System (TOS) is an operating system that meets a particular set of security requirements. Whether an operating system can be trusted or not depends on several elements. For example, for an operating system on a particular computer to be certified trusted, one needs to validate that, among other things, the following four requirements are satisfied: Its system design contains no defects; Its system software contains no loopholes; Its system is configured properly; and Its system management is appropriate. Bastion Hosts Bastion hosts are computers with strong defence mechanisms. They often serve as host computers for implementing application gateways, circuit gateways, and other types of firewalls. A bastion host is operated on a trusted operating system that must not contain unnecessary functionalities or programs. This measure helps to reduce error probabilities and makes it easier to conduct security checks. Only those network application programs that are necessary, for example, SSH, DNS, SMTP, and authentication programs, are installed on a bastion host. Bastion hosts are also primarily used as controlled ingress points so that the security monitoring can focus more narrowly on actions happening at a single point closely. Common Techniques & Scannings, Packet Capturing Scanning Ports with Nmap Nmap (\"Network Mapper\") is a free and open-source (license) utility for network discovery and security auditing. Many systems and network administrators also find it useful for tasks such as network inventory, managing service upgrade schedules, and monitoring host or service uptime. The best thing about Nmap is it\u2019s free and open-source and is very flexible and versatile Nmap is often used to determine alive hosts in a network, open ports on those hosts, services running on those open ports, and version identification of that service on that port. More at http://scanme.nmap.org/ nmap [scan type] [options] [target specification] Nmap uses 6 different port states: Open \u2014 An open port is one that is actively accepting TCP, UDP or SCTP connections. Open ports are what interests us the most because they are the ones that are vulnerable to attacks. Open ports also show the available services on a network. Closed \u2014 A port that receives and responds to Nmap probe packets but there is no application listening on that port. Useful for identifying that the host exists and for OS detection. Filtered \u2014 Nmap can\u2019t determine whether the port is open because packet filtering prevents its probes from reaching the port. Filtering could come from firewalls or router rules. Often little information is given from filtered ports during scans as the filters can drop the probes without responding or respond with useless error messages e.g. destination unreachable. Unfiltered \u2014 Port is accessible but Nmap doesn\u2019t know if it is open or closed. Only used in ACK scan which is used to map firewall rulesets. Other scan types can be used to identify whether the port is open. Open/filtered \u2014 Nmap is unable to determine between open and filtered. This happens when an open port gives no response. No response could mean that the probe was dropped by a packet filter or any response is blocked. Closed/filtered \u2014 Nmap is unable to determine whether a port is closed or filtered. Only used in the IP ID idle scan. Types of Nmap Scan: TCP Connect TCP Connect scan completes the 3-way handshake. If a port is open, the operating system completes the TCP three-way handshake and the port scanner immediately closes the connection to avoid DOS. This is \u201cnoisy\u201d because the services can log the sender IP address and might trigger Intrusion Detection Systems. UDP Scan This scan checks to see if any UDP ports are listening. Since UDP does not respond with a positive acknowledgement like TCP and only responds to an incoming UDP packet when the port is closed, SYN Scan SYN scan is another form of TCP scanning. This scan type is also known as \u201chalf-open scanning\u201d because it never actually opens a full TCP connection. The port scanner generates a SYN packet. If the target port is open, it will respond with an SYN-ACK packet. The scanner host responds with an RST packet, closing the connection before the handshake is completed. If the port is closed but unfiltered, the target will instantly respond with an RST packet. SYN scan has the advantage that the individual services never actually receive a connection. FIN Scan This is a stealthy scan, like the SYN scan, but sends a TCP FIN packet instead. ACK Scan Ack scanning determines whether the port is filtered or not. Null Scan Another very stealthy scan that sets all the TCP header flags to off or null. This is not normally a valid packet and some hosts will not know what to do with this. XMAS Scan Similar to the NULL scan except for all the flags in the TCP header is set to on RPC Scan This special type of scan looks for machine answering to RPC (Remote Procedure Call) services IDLE Scan It is a super stealthy method whereby the scan packets are bounced off an external host. You don\u2019t need to have control over the other host but it does have to set up and meet certain requirements. You must input the IP address of our \u201czombie\u201d host and what port number to use. It is one of the more controversial options in Nmap since it only has a use for malicious attacks. Scan Techniques A couple of scan techniques which can be used to gain more information about a system and its ports. You can read more at https://medium.com/infosec-adventures/nmap-cheatsheet-a423fcdda0ca OpenVAS OpenVAS is a full-featured vulnerability scanner. OpenVAS is a framework of services and tools that provides a comprehensive and powerful vulnerability scanning and management package OpenVAS, which is an open-source program, began as a fork of the once-more-popular scanning program, Nessus. OpenVAS is made up of three main parts. These are: a regularly updated feed of Network Vulnerability Tests (NVTs); a scanner, which runs the NVTs; and an SQLite 3 database for storing both your test configurations and the NVTs\u2019 results and configurations. https://www.greenbone.net/en/install_use_gce/ WireShark Wireshark is a protocol analyzer. This means Wireshark is designed to decode not only packet bits and bytes but also the relations between packets and protocols. Wireshark understands protocol sequences. A simple demo of Wireshark Capture only udp packets: Capture filter = \u201cudp\u201d Capture only tcp packets Capture filter = \u201ctcp\u201d TCP/IP 3 way Handshake Filter by IP address: displays all traffic from IP, be it source or destination ip.addr == 192.168.1.1 Filter by source address: display traffic only from IP source ip.src == 192.168.0.1 Filter by destination: display traffic only form IP destination ip.dst == 192.168.0.1 Filter by IP subnet: display traffic from subnet, be it source or destination ip.addr = 192.168.0.1/24 Filter by protocol: filter traffic by protocol name dns http ftp arp ssh telnet icmp Exclude IP address: remove traffic from and to IP address !ip.addr ==192.168.0.1 Display traffic between two specific subnet ip.addr == 192.168.0.1/24 and ip.addr == 192.168.1.1/24 Display traffic between two specific workstations ip.addr == 192.168.0.1 and ip.addr == 192.168.0.2 Filter by MAC eth.addr = 00:50:7f:c5:b6:78 Filter TCP port tcp.port == 80 Filter TCP port source tcp.srcport == 80 Filter TCP port destination tcp.dstport == 80 Find user agents http.user_agent contains Firefox !http.user_agent contains || !http.user_agent contains Chrome Filter broadcast traffic !(arp or icmp or dns) Filter IP address and port tcp.port == 80 && ip.addr == 192.168.0.1 Filter all http get requests http.request Filter all http get requests and responses http.request or http.response Filter three way handshake tcp.flags.syn==1 or (tcp.seq==1 and tcp.ack==1 and tcp.len==0 and tcp.analysis.initial_rtt) Find files by type frame contains \u201c(attachment|tar|exe|zip|pdf)\u201d Find traffic based on keyword tcp contains facebook frame contains facebook Detecting SYN Floods tcp.flags.syn == 1 and tcp.flags.ack == 0 Wireshark Promiscuous Mode - By default, Wireshark only captures packets going to and from the computer where it runs. By checking the box to run Wireshark in Promiscuous Mode in the Capture Settings, you can capture most of the traffic on the LAN. DumpCap Dumpcap is a network traffic dump tool. It captures packet data from a live network and writes the packets to a file. Dumpcap\u2019s native capture file format is pcapng, which is also the format used by Wireshark. By default, Dumpcap uses the pcap library to capture traffic from the first available network interface and writes the received raw packet data, along with the packets\u2019 time stamps into a pcapng file. The capture filter syntax follows the rules of the pcap library. The Wireshark command-line utility called 'dumpcap.exe' can be used to capture LAN traffic over an extended period of time. Wireshark itself can also be used, but dumpcap does not significantly utilize the computer's memory while capturing for long periods. DaemonLogger Daemonlogger is a packet logging application designed specifically for use in Network and Systems Management (NSM) environments. The biggest benefit Daemonlogger provides is that, like Dumpcap, it is simple to use for capturing packets. In order to begin capturing, you need only to invoke the command and specify an interface. daemonlogger \u2013i eth1 This option, by default, will begin capturing packets and logging them to the current working directory. Packets will be collected until the capture file size reaches 2 GB, and then a new file will be created. This will continue indefinitely until the process is halted. NetSniff-NG Netsniff-NG is a high-performance packet capture utility While the utilities we\u2019ve discussed to this point rely on Libpcap for capture, Netsniff-NG utilizes zero-copy mechanisms to capture packets. This is done with the intent to support full packet capture over high throughput links. To begin capturing packets with Netsniff-NG, we have to specify an input and output. In most cases, the input will be a network interface, and the output will be a file or folder on disk. netsniff-ng \u2013i eth1 \u2013o data.pcap Netflow NetFlow is a feature that was introduced on Cisco routers around 1996 that provides the ability to collect IP network traffic as it enters or exits an interface. By analyzing the data provided by NetFlow, a network administrator can determine things such as the source and destination of traffic, class of service, and the causes of congestion. A typical flow monitoring setup (using NetFlow) consists of three main components:[1] Flow exporter: aggregates packets into flows and exports flow records towards one or more flow collectors. Flow collector: responsible for reception, storage and pre-processing of flow data received from a flow exporter. Analysis application: analyzes received flow data in the context of intrusion detection or traffic profiling, for example. Routers and switches that support NetFlow can collect IP traffic statistics on all interfaces where NetFlow is enabled, and later export those statistics as NetFlow records toward at least one NetFlow collector\u2014typically a server that does the actual traffic analysis. IDS A security solution that detects security-related events in your environment but does not block them. IDS sensors can be software and hardware-based used to collect and analyze the network traffic. These sensors are available in two varieties, network IDS and host IDS. A host IDS is a server-specific agent running on a server with a minimum of overhead to monitor the operating system. A network IDS can be embedded in a networking device, a standalone appliance, or a module monitoring the network traffic. Signature Based IDS The signature-based IDS monitors the network traffic or observes the system and sends an alarm if a known malicious event is happening. It does so by comparing the data flow against a database of known attack patterns These signatures explicitly define what traffic or activity should be considered as malicious. Signature-based detection has been the bread and butter of network-based defensive security for over a decade, partially because it is very similar to how malicious activity is detected at the host level with antivirus utilities The formula is fairly simple: an analyst observes a malicious activity, derives indicators from the activity and develops them into signatures, and then those signatures will alert whenever the activity occurs again. ex: SNORT & SURICATA Policy-Based IDS The policy-based IDSs (mainly host IDSs) trigger an alarm whenever a violation occurs against the configured policy. This configured policy is or should be a representation of the security policies. This type of IDS is flexible and can be customized to a company's network requirements because it knows exactly what is permitted and what is not. On the other hand, the signature-based systems rely on vendor specifics and default settings. Anomaly Based IDS The anomaly-based IDS looks for traffic that deviates from the normal, but the definition of what is a normal network traffic pattern is the tricky part Two types of anomaly-based IDS exist: statistical and nonstatistical anomaly detection Statistical anomaly detection learns the traffic patterns interactively over a period of time. In the nonstatistical approach, the IDS has a predefined configuration of the supposedly acceptable and valid traffic patterns. Host-Based IDS & Network-Based IDS A host IDS can be described as a distributed agent residing on each server of the network that needs protection. These distributed agents are tied very closely to the underlying operating system. Network IDSs, on the other hand, can be described as intelligent sniffing devices. Data (raw packets) is captured from the network by a network IDS, whereas host IDSs capture the data from the host on which they are installed. Honeypots The use of decoy machines to direct intruders' attention away from the machines under protection is a major technique to preclude intrusion attacks. Any device, system, directory, or file used as a decoy to lure attackers away from important assets and to collect intrusion or abusive behaviours is referred to as a honeypot. A honeypot may be implemented as a physical device or as an emulation system. The idea is to set up decoy machines in a LAN, or decoy directories/files in a file system and make them appear important, but with several exploitable loopholes, to lure attackers to attack these machines or directories/files, so that other machines, directories, and files can evade intruders' attentions. A decoy machine may be a host computer or a server computer. Likewise, we may also set up decoy routers or even decoy LANs. Chinks In The Armour (TCP/IP Security Issues) IP Spoofing In this type of attack, the attacker replaces the IP address of the sender, or in some rare cases the destination, with a different address. IP spoofing is normally used to exploit a target host. In other cases, it is used to start a denial-of-service (DoS) attack. In a DoS attack, an attacker modifies the IP packet to mislead the target host into accepting the original packet as a packet sourced at a trusted host. The attacker must know the IP address of the trusted host to modify the packet headers (source IP address) so that it appears that the packets are coming from that host. IP Spoofing Detection Techniques Direct TTL Probes In this technique we send a packet to a host of suspect spoofed IP that triggers reply and compares TTL with suspect packet; if the TTL in the reply is not the same as the packet being checked; it is a spoofed packet. This Technique is successful when the attacker is in a different subnet from the victim. IP Identification Number. Send a probe to the host of suspect spoofed traffic that triggers a reply and compares IP ID with suspect traffic. If IP IDs are not in the near value of packet being checked, suspect traffic is spoofed TCP Flow Control Method Attackers sending spoofed TCP packets will not receive the target\u2019s SYN-ACK packets. Attackers cannot, therefore, be responsive to change in the congestion window size When the receiver still receives traffic even after a windows size is exhausted, most probably the packets are spoofed. Covert Channel A covert or clandestine channel can be best described as a pipe or communication channel between two entities that can be exploited by a process or application transferring information in a manner that violates the system's security specifications. More specifically for TCP/IP, in some instances, covert channels are established, and data can be secretly passed between two end systems. Ex: ICMP resides at the Internet layer of the TCP/IP protocol suite and is implemented in all TCP/IP hosts. Based on the specifications of the ICMP Protocol, an ICMP Echo Request message should have an 8-byte header and a 56-byte payload. The ICMP Echo Request packet should not carry any data in the payload. However, these packets are often used to carry secret information. The ICMP packets are altered slightly to carry secret data in the payload. This makes the size of the packet larger, but no control exists in the protocol stack to defeat this behaviour. The alteration of ICMP packets allows intruders to program specialized client-server pairs. These small pieces of code export confidential information without alerting the network administrator. ICMP can be leveraged for more than data exfiltration. For eg. some C&C tools such as Loki used ICMP channel to establish encrypted interactive session back in 1996. Deep packet inspection has since come a long way. A lot of IDS/IPS detect ICMP tunnelling. Check for echo responses that do not contain the same payload as request Check for the volume of ICMP traffic especially for volumes beyond an acceptable threshold IP Fragmentation Attack The TCP/IP protocol suite, or more specifically IP, allows the fragmentation of packets.(this is a feature & not a bug) IP fragmentation offset is used to keep track of the different parts of a datagram. The information or content in this field is used at the destination to reassemble the datagrams All such fragments have the same Identification field value, and the fragmentation offset indicates the position of the current fragment in the context of the original packet. Many access routers and firewalls do not perform packet reassembly. In normal operation, IP fragments do not overlap, but attackers can create artificially fragmented packets to mislead the routers or firewalls. Usually, these packets are small and almost impractical for end systems because of data and computational overhead. A good example of an IP fragmentation attack is the Ping of Death attack. The Ping of Death attack sends fragments that, when reassembled at the end station, create a larger packet than the maximum permissible length. TCP Flags Data exchange using TCP does not happen until a three-way handshake has been completed. This handshake uses different flags to influence the way TCP segments are processed. There are 6 bits in the TCP header that are often called flags. Namely: 6 different flags are part of the TCP header: Urgent pointer field (URG), Acknowledgment field (ACK), Push function (PSH), Reset the connection (RST), Synchronize sequence numbers (SYN), and the sender is finished with this connection (FIN). Abuse of the normal operation or settings of these flags can be used by attackers to launch DoS attacks. This causes network servers or web servers to crash or hang. | SYN | FIN | PSH | RST | Validity| |------|------|-------|------|---------| | 1 |1 |0 |0 |Illegal Combination | 1 |1 |1 |0 |Illegal Combination | 1 |1 |0 |1 |Illegal Combination | 1 |1 |1 |1 |Illegal Combination The attacker's ultimate goal is to write special programs or pieces of code that can construct these illegal combinations resulting in an efficient DoS attack. SYN FLOOD The timers (or lack of certain timers) in 3 way handshake are often used and exploited by attackers to disable services or even to enter systems. After step 2 of the three-way handshake, no limit is set on the time to wait after receiving a SYN. The attacker initiates many connection requests to the webserver of Company XYZ (almost certainly with a spoofed IP address). The SYN+ACK packets (Step 2) sent by the web server back to the originating source IP address are not replied to. This leaves a TCP session half-open on the webserver. Multiple packets cause multiple TCP sessions to stay open. Based on the hardware limitations of the server, a limited number of TCP sessions can stay open, and as a result, the webserver refuses further connection establishments attempts from any host as soon as a certain limit is reached. These half-open connections need to be completed or timed out before new connections can be established. FIN Attack In normal operation, the sender sets the TCP FIN flag indicating that no more data will be transmitted and the connection can be closed down. This is a four-way handshake mechanism, with both sender and receiver expected to send an acknowledgement on a received FIN packet. During an attack that is trying to kill connections, a spoofed FIN packet is constructed. This packet also has the correct sequence number, so the packets are seen as valid by the targeted host. These sequence numbers are easy to predict. This process is referred to as TCP sequence number prediction, whereby the attacker either sniffs the current Sequence and Acknowledgment (SEQ/ACK) numbers of the connection or can algorithmically predict these numbers. Connection Hijacking An authorized user (Employee X) sends HTTP requests over a TCP session with the webserver. The web server accepts the packets from Employee X only when the packet has the correct SEQ/ACK numbers. As seen previously, these numbers are important for the webserver to distinguish between different sessions and to make sure it is still talking to Employee X. Imagine that the cracker starts sending packets to the web server spoofing the IP address of Employee X, using the correct SEQ/ACK combination. The web server accepts the packet and increments the ACK number. In the meantime, Employee X continues to send packets but with incorrect SEQ/ACK numbers. As a result of sending unsynchronized packets, all data from Employee X is discarded when received by the webserver. The attacker pretends to be Employee X using the correct numbers. This finally results in the cracker hijacking the connection, whereby Employee X is completely confused and the webserver replies assuming the cracker is sending correct synchronized data. STEPS: The attacker examines the traffic flows with a network monitor and notices traffic from Employee X to a web server. The web server returns or echoes data back to the origination station (Employee X). Employee X acknowledges the packet. The cracker launches a spoofed packet to the server. The web server responds to the cracker. The cracker starts verifying SEQ/ACK numbers to double-check success. At this time, the cracker takes over the session from Employee X, which results in a session hanging for Employee X. The cracker can start sending traffic to the webserver. The web server returns the requested data to confirm delivery with the correct ACK number. The cracker can continue to send data (keeping track of the correct SEQ/ACK numbers) until eventually setting the FIN flag to terminate the session. Buffer Overflow A buffer is a temporary data storage area used to store program code and data. When a program or process tries to store more data in a buffer than it was originally anticipated to hold, a buffer overflow occurs. Buffers are temporary storage locations in memory (memory or buffer sizes are often measured in bytes) that can store a fixed amount of data in bytes. When more data is retrieved than can be stored in a buffer location, the additional information must go into an adjacent buffer, resulting in overwriting the valid data held in them. Mechanism: Buffer overflow vulnerabilities exist in different types. But the overall goal for all buffer overflow attacks is to take over the control of a privileged program and, if possible, the host. The attacker has two tasks to achieve this goal. First, the dirty code needs to be available in the program's code address space. Second, the privileged program should jump to that particular part of the code, which ensures that the proper parameters are loaded into memory. The first task can be achieved in two ways: by injecting the code in the right address space or by using the existing code and modifying certain parameters slightly. The second task is a little more complex because the program's control flow needs to be modified to make the program jump to the dirty code. CounterMeasure: The most important approach is to have a concerted focus on writing correct code. A second method is to make the data buffers (memory locations) address space of the program code non-executable. This type of address space makes it impossible to execute code, which might be infiltrated in the program's buffers during an attack. More Spoofing Address Resolution Protocol Spoofing The Address Resolution Protocol (ARP) provides a mechanism to resolve, or map, a known IP address to a MAC sublayer address. Using ARP spoofing, the cracker can exploit this hardware address authentication mechanism by spoofing the hardware address of Host B. Basically, the attacker can convince any host or network device on the local network that the cracker's workstation is the host to be trusted. This is a common method used in a switched environment. ARP spoofing can be prevented with the implementation of static ARP tables in all the hosts and routers of your network. Alternatively, you can implement an ARP server that responds to ARP requests on behalf of the target host. DNS Spoofing DNS spoofing is the method whereby the hacker convinces the target machine that the system it wants to connect to is the machine of the cracker. The cracker modifies some records so that name entries of hosts correspond to the attacker's IP address. There have been instances in which the complete DNS server was compromised by an attack. To counter DNS spoofing, the reverse lookup detects these attacks. The reverse lookup is a mechanism to verify the IP address against a name. The IP address and name files are usually kept on different servers to make compromise much more difficult","title":"Network Security"},{"location":"level101/security/network_security/#part-ii-network-security","text":"","title":"Part II: Network Security"},{"location":"level101/security/network_security/#introduction","text":"TCP/IP is the dominant networking technology today. It is a five-layer architecture. These layers are, from top to bottom, the application layer, the transport layer (TCP), the network layer (IP), the data-link layer, and the physical layer. In addition to TCP/IP, there also are other networking technologies. For convenience, we use the OSI network model to represent non-TCP/IP network technologies. Different networks are interconnected using gateways. A gateway can be placed at any layer. The OSI model is a seven-layer architecture. The OSI architecture is similar to the TCP/IP architecture, except that the OSI model specifies two additional layers between the application layer and the transport layer in the TCP/IP architecture. These two layers are the presentation layer and the session layer. Figure 5.1 shows the relationship between the TCP/IP layers and the OSI layers. The application layer in TCP/IP corresponds to the application layer and the presentation layer in OSI. The transport layer in TCP/IP corresponds to the session layer and the transport layer in OSI. The remaining three layers in the TCP/IP architecture are one-to-one correspondent to the remaining three layers in the OSI model. Correspondence between layers of the TCP/IP architecture and the OSI model. Also shown are placements of cryptographic algorithms in network layers, where the dotted arrows indicate actual communications of cryptographic algorithms The functionalities of OSI layers are briefly described as follows: The application layer serves as an interface between applications and network programs. It supports application programs and end-user processing. Common application-layer programs include remote logins, file transfer, email, and Web browsing. The presentation layer is responsible for dealing with data that is formed differently. This protocol layer allows application-layer programs residing on different sides of a communication channel with different platforms to understand each other's data formats regardless of how they are presented. The session layer is responsible for creating, managing, and closing a communication connection. The transport layer is responsible for providing reliable connections, such as packet sequencing, traffic control, and congestion control. The network layer is responsible for routing device-independent data packets from the current hop to the next hop. The data-link layer is responsible for encapsulating device-independent data packets into device-dependent data frames. It has two sublayers: logical link control and media access control. The physical layer is responsible for transmitting device-dependent frames through some physical media. Starting from the application layer, data generated from an application program is passed down layer-by-layer to the physical layer. Data from the previous layer is enclosed in a new envelope at the current layer, where the data from the previous layer is also just an envelope containing the data from the layer before it. This is similar to enclosing a smaller envelope in a larger one. The envelope added at each layer contains sufficient information for handling the packet. Application-layer data are divided into blocks small enough to be encapsulated in an envelope at the next layer. Application data blocks are \u201cdressed up\u201d in the TCP/IP architecture according to the following basic steps. At the sending side, an application data block is encapsulated in a TCP packet when it is passed down to the TCP layer. In other words, a TCP packet consists of a header and a payload, where the header corresponds to the TCP envelope and the payload is the application data block. Likewise, the TCP packet will be encapsulated in an IP packet when it is passed down to the IP layer. An IP packet consists of a header and a payload, which is the TCP packet passed down from the TCP layer. The IP packet will be encapsulated in a device-dependent frame (e.g., an Ethernet frame) when it is passed down to the data-link layer. A frame has a header, and it may also have a trailer. For example, in addition to having a header, an Ethernet frame also has a 32-bit cyclic redundancy check (CRC) trailer. When it is passed down to the physical layer, a frame will be transformed into a sequence of media signals for transmission Flow Diagram of a Packet Generation At the destination side, the medium signals are converted by the physical layer into a frame, which is passed up to the data-link layer. The data-link layer passes the frame payload (i.e., the IP packet encapsulated in the frame) up to the IP layer. The IP layer passes the IP payload, namely, the TCP packet encapsulated in the IP packet, up to the TCP layer. The TCP layer passes the TCP payload, namely, the application data block, up to the application layer. When a packet arrives at a router, it only goes up to the IP layer, where certain fields in the IP header are modified (e.g., the value of TTL is decreased by 1). This modified packet is then passed back down layer-by-layer to the physical layer for further transmission.","title":"Introduction"},{"location":"level101/security/network_security/#public-key-infrastructure","text":"To deploy cryptographic algorithms in network applications, we need a way to distribute secret keys using open networks. Public-key cryptography is the best way to distribute these secret keys. To use public-key cryptography, we need to build a public-key infrastructure (PKI) to support and manage public-key certificates and certificate authority (CA) networks. In particular, PKIs are set up to perform the following functions: Determine the legitimacy of users before issuing public-key certificates to them. Issue public-key certificates upon user requests. Extend public-key certificates valid time upon user requests. Revoke public-key certificates upon users' requests or when the corresponding private keys are compromised. Store and manage public-key certificates. Prevent digital signature signers from denying their signatures. Support CA networks to allow different CAs to authenticate public-key certificates issued by other CAs. X.509: https://certificatedecoder.dev/?gclid=EAIaIQobChMI0M731O6G6gIVVSQrCh04bQaAEAAYASAAEgKRkPD_BwE","title":"Public Key Infrastructure"},{"location":"level101/security/network_security/#ipsec-a-security-protocol-at-the-network-layer","text":"IPsec is a major security protocol at the network layer IPsec provides a potent platform for constructing virtual private networks (VPN). VPNs are private networks overlayed on public networks. The purpose of deploying cryptographic algorithms at the network layer is to encrypt or authenticate IP packets (either just the payloads or the whole packets). IPsec also specifies how to exchange keys. Thus, IPsec consists of authentication protocols, encryption protocols, and key exchange protocols. They are referred to, respectively, as authentication header (AH), encapsulating security payload (ESP), and Internet key exchange (IKE).","title":"IPsec: A Security Protocol at the Network Layer"},{"location":"level101/security/network_security/#pgp-smime-email-security","text":"There are several security protocols at the application layer. The most used of these protocols are email security protocols namely PGP and S/MIME. SMTP (\u201cSimple Mail Transfer Protocol\u201d) is used for sending and delivering from a client to a server via port 25: it\u2019s the outgoing server. On the contrary, POP (\u201cPost Office Protocol\u201d) allows the users to pick up the message and download it into their inbox: it\u2019s the incoming server. The latest version of the Post Office Protocol is named POP3, and it\u2019s been used since 1996; it uses port 110 PGP PGP implements all major cryptographic algorithms, the ZIP compression algorithm, and the Base64 encoding algorithm. It can be used to authenticate a message, encrypt a message, or both. PGP follows the following general process: authentication, ZIP compression, encryption, and Base64 encoding. The Base64 encoding procedure makes the message ready for SMTP transmission GPG (GnuPG) GnuPG is another free encryption standard that companies may use that is based on OpenPGP. GnuPG serves as a replacement for Symantec\u2019s PGP. The main difference is the supported algorithms. However, GnuPG plays nice with PGP by design. Because GnuPG is open, some businesses would prefer the technical support and the user interface that comes with Symantec\u2019s PGP. It is important to note that there are some nuances between the compatibility of GnuPG and PGP, such as the compatibility between certain algorithms, but in most applications such as email, there are workarounds. One such algorithm is the IDEA Module which isn\u2019t included in GnuPG out of the box due to patent issues. S/MIME SMTP can only handle 7-bit ASCII text (You can use UTF-8 extensions to alleviate these limitations, ) messages. While POP can handle other content types besides 7-bit ASCII, POP may, under a common default setting, download all the messages stored in the mail server to the user's local computer. After that, if POP removes these messages from the mail server. This makes it difficult for the users to read their messages from multiple computers. The Multipurpose Internet Mail Extension protocol (MIME) was designed to support sending and receiving email messages in various formats, including nontext files generated by word processors, graphics files, sound files, and video clips. Moreover, MIME allows a single message to include mixed types of data in any combination of these formats. The Internet Mail Access Protocol (IMAP), operated on TCP port 143(only for non-encrypted), stores (Configurable on both server & client just like PoP) incoming email messages in the mail server until the user deletes them deliberately. This allows the users to access their mailbox from multiple machines and download messages to a local machine without deleting it from the mailbox in the mail server. SSL/TLS SSL uses a PKI to decide if a server\u2019s public key is trustworthy by requiring servers to use a security certificate signed by a trusted CA. When Netscape Navigator 1.0 was released, it trusted a single CA operated by the RSA Data Security corporation. The server\u2019s public RSA keys were used to be stored in the security certificate, which can then be used by the browser to establish a secure communication channel. The security certificates we use today still rely on the same standard (named X.509) that Netscape Navigator 1.0 used back then. Netscape intended to train users(though this didn\u2019t work out later) to differentiate secure communications from insecure ones, so they put a lock icon next to the address bar. When the lock is open, the communication is insecure. A closed lock means communication has been secured with SSL, which required the server to provide a signed certificate. You\u2019re obviously familiar with this icon as it\u2019s been in every browser ever since. The engineers at Netscape truly created a standard for secure internet communications. A year after releasing SSL 2.0, Netscape fixed several security issues and released SSL 3.0, a protocol that, albeit being officially deprecated since June 2015, remains in use in certain parts of the world more than 20 years after its introduction. To standardize SSL, the Internet Engineering Task Force (IETF) created a slightly modified SSL 3.0 and, in 1999, unveiled it as Transport Layer Security (TLS) 1.0. The name change between SSL and TLS continues to confuse people today. Officially, TLS is the new SSL, but in practice, people use SSL and TLS interchangeably to talk about any version of the protocol. Must See: https://tls.ulfheim.net/ https://davidwong.fr/tls13/","title":"PGP & S/MIME : Email Security"},{"location":"level101/security/network_security/#network-perimeter-security","text":"Let us see how we keep a check on the perimeter i.e the edges, the first layer of protection","title":"Network Perimeter Security"},{"location":"level101/security/network_security/#general-firewall-framework","text":"Firewalls are needed because encryption algorithms cannot effectively stop malicious packets from getting into an edge network. This is because IP packets, regardless of whether they are encrypted, can always be forwarded into an edge network. Firewalls that were developed in the 1990s are important instruments to help restrict network access. A firewall may be a hardware device, a software package, or a combination of both. Packets flowing into the internal network from the outside should be evaluated before they are allowed to enter. One of the critical elements of a firewall is its ability to examine packets without imposing a negative impact on communication speed while providing security protections for the internal network. The packet inspection that is carried out by firewalls can be done using several different methods. Based on the particular method used by the firewall, it can be characterized as either a packet filter, circuit gateway, application gateway, or dynamic packet filter.","title":"General Firewall Framework"},{"location":"level101/security/network_security/#packet-filters","text":"It inspects ingress packets coming to an internal network from outside and inspects egress packets going outside from an internal network Packing filtering only inspects IP headers and TCP headers, not the payloads generated at the application layer A packet-filtering firewall uses a set of rules to determine whether a packet should be allowed or denied to pass through. 2 types: Stateless It treats each packet as an independent object, and it does not keep track of any previously processed packets. In other words, stateless filtering inspects a packet when it arrives and makes a decision without leaving any record of the packet being inspected. Stateful Stateful filtering, also referred to as connection-state filtering, keeps track of connections between an internal host and an external host. A connection state (or state, for short) indicates whether it is a TCP connection or a UDP connection and whether the connection is established.","title":"Packet Filters"},{"location":"level101/security/network_security/#circuit-gateways","text":"Circuit gateways, also referred to as circuit-level gateways, are typically operated at the transportation layer They evaluate the information of the IP addresses and the port numbers contained in TCP (or UDP) headers and use it to determine whether to allow or to disallow an internal host and an external host to establish a connection. It is common practice to combine packet filters and circuit gateways to form a dynamic packet filter (DPF).","title":"Circuit Gateways"},{"location":"level101/security/network_security/#application-gatewaysalg","text":"Aka PROXY Servers An Application Level Gateway (ALG) acts as a proxy for internal hosts, processing service requests from external clients. An ALG performs deep inspections on each IP packet (ingress or egress). In particular, an ALG inspects application program formats contained in the packet (e.g., MIME format or SQL format) and examines whether its payload is permitted. Thus, an ALG may be able to detect a computer virus contained in the payload. Because an ALG inspects packet payloads, it may be able to detect malicious code and quarantine suspicious packets, in addition to blocking packets with suspicious IP addresses and TCP ports. On the other hand, an ALG also incurs substantial computation and space overheads.","title":"Application Gateways(ALG)"},{"location":"level101/security/network_security/#trusted-systems-bastion-hosts","text":"A Trusted Operating System (TOS) is an operating system that meets a particular set of security requirements. Whether an operating system can be trusted or not depends on several elements. For example, for an operating system on a particular computer to be certified trusted, one needs to validate that, among other things, the following four requirements are satisfied: Its system design contains no defects; Its system software contains no loopholes; Its system is configured properly; and Its system management is appropriate. Bastion Hosts Bastion hosts are computers with strong defence mechanisms. They often serve as host computers for implementing application gateways, circuit gateways, and other types of firewalls. A bastion host is operated on a trusted operating system that must not contain unnecessary functionalities or programs. This measure helps to reduce error probabilities and makes it easier to conduct security checks. Only those network application programs that are necessary, for example, SSH, DNS, SMTP, and authentication programs, are installed on a bastion host. Bastion hosts are also primarily used as controlled ingress points so that the security monitoring can focus more narrowly on actions happening at a single point closely.","title":"Trusted Systems & Bastion Hosts"},{"location":"level101/security/network_security/#common-techniques-scannings-packet-capturing","text":"","title":"Common Techniques & Scannings, Packet Capturing"},{"location":"level101/security/network_security/#scanning-ports-with-nmap","text":"Nmap (\"Network Mapper\") is a free and open-source (license) utility for network discovery and security auditing. Many systems and network administrators also find it useful for tasks such as network inventory, managing service upgrade schedules, and monitoring host or service uptime. The best thing about Nmap is it\u2019s free and open-source and is very flexible and versatile Nmap is often used to determine alive hosts in a network, open ports on those hosts, services running on those open ports, and version identification of that service on that port. More at http://scanme.nmap.org/ nmap [scan type] [options] [target specification] Nmap uses 6 different port states: Open \u2014 An open port is one that is actively accepting TCP, UDP or SCTP connections. Open ports are what interests us the most because they are the ones that are vulnerable to attacks. Open ports also show the available services on a network. Closed \u2014 A port that receives and responds to Nmap probe packets but there is no application listening on that port. Useful for identifying that the host exists and for OS detection. Filtered \u2014 Nmap can\u2019t determine whether the port is open because packet filtering prevents its probes from reaching the port. Filtering could come from firewalls or router rules. Often little information is given from filtered ports during scans as the filters can drop the probes without responding or respond with useless error messages e.g. destination unreachable. Unfiltered \u2014 Port is accessible but Nmap doesn\u2019t know if it is open or closed. Only used in ACK scan which is used to map firewall rulesets. Other scan types can be used to identify whether the port is open. Open/filtered \u2014 Nmap is unable to determine between open and filtered. This happens when an open port gives no response. No response could mean that the probe was dropped by a packet filter or any response is blocked. Closed/filtered \u2014 Nmap is unable to determine whether a port is closed or filtered. Only used in the IP ID idle scan.","title":"Scanning Ports with Nmap"},{"location":"level101/security/network_security/#types-of-nmap-scan","text":"TCP Connect TCP Connect scan completes the 3-way handshake. If a port is open, the operating system completes the TCP three-way handshake and the port scanner immediately closes the connection to avoid DOS. This is \u201cnoisy\u201d because the services can log the sender IP address and might trigger Intrusion Detection Systems. UDP Scan This scan checks to see if any UDP ports are listening. Since UDP does not respond with a positive acknowledgement like TCP and only responds to an incoming UDP packet when the port is closed, SYN Scan SYN scan is another form of TCP scanning. This scan type is also known as \u201chalf-open scanning\u201d because it never actually opens a full TCP connection. The port scanner generates a SYN packet. If the target port is open, it will respond with an SYN-ACK packet. The scanner host responds with an RST packet, closing the connection before the handshake is completed. If the port is closed but unfiltered, the target will instantly respond with an RST packet. SYN scan has the advantage that the individual services never actually receive a connection. FIN Scan This is a stealthy scan, like the SYN scan, but sends a TCP FIN packet instead. ACK Scan Ack scanning determines whether the port is filtered or not. Null Scan Another very stealthy scan that sets all the TCP header flags to off or null. This is not normally a valid packet and some hosts will not know what to do with this. XMAS Scan Similar to the NULL scan except for all the flags in the TCP header is set to on RPC Scan This special type of scan looks for machine answering to RPC (Remote Procedure Call) services IDLE Scan It is a super stealthy method whereby the scan packets are bounced off an external host. You don\u2019t need to have control over the other host but it does have to set up and meet certain requirements. You must input the IP address of our \u201czombie\u201d host and what port number to use. It is one of the more controversial options in Nmap since it only has a use for malicious attacks. Scan Techniques A couple of scan techniques which can be used to gain more information about a system and its ports. You can read more at https://medium.com/infosec-adventures/nmap-cheatsheet-a423fcdda0ca","title":"Types of Nmap Scan:"},{"location":"level101/security/network_security/#openvas","text":"OpenVAS is a full-featured vulnerability scanner. OpenVAS is a framework of services and tools that provides a comprehensive and powerful vulnerability scanning and management package OpenVAS, which is an open-source program, began as a fork of the once-more-popular scanning program, Nessus. OpenVAS is made up of three main parts. These are: a regularly updated feed of Network Vulnerability Tests (NVTs); a scanner, which runs the NVTs; and an SQLite 3 database for storing both your test configurations and the NVTs\u2019 results and configurations. https://www.greenbone.net/en/install_use_gce/","title":"OpenVAS"},{"location":"level101/security/network_security/#wireshark","text":"Wireshark is a protocol analyzer. This means Wireshark is designed to decode not only packet bits and bytes but also the relations between packets and protocols. Wireshark understands protocol sequences. A simple demo of Wireshark Capture only udp packets: Capture filter = \u201cudp\u201d Capture only tcp packets Capture filter = \u201ctcp\u201d TCP/IP 3 way Handshake Filter by IP address: displays all traffic from IP, be it source or destination ip.addr == 192.168.1.1 Filter by source address: display traffic only from IP source ip.src == 192.168.0.1 Filter by destination: display traffic only form IP destination ip.dst == 192.168.0.1 Filter by IP subnet: display traffic from subnet, be it source or destination ip.addr = 192.168.0.1/24 Filter by protocol: filter traffic by protocol name dns http ftp arp ssh telnet icmp Exclude IP address: remove traffic from and to IP address !ip.addr ==192.168.0.1 Display traffic between two specific subnet ip.addr == 192.168.0.1/24 and ip.addr == 192.168.1.1/24 Display traffic between two specific workstations ip.addr == 192.168.0.1 and ip.addr == 192.168.0.2 Filter by MAC eth.addr = 00:50:7f:c5:b6:78 Filter TCP port tcp.port == 80 Filter TCP port source tcp.srcport == 80 Filter TCP port destination tcp.dstport == 80 Find user agents http.user_agent contains Firefox !http.user_agent contains || !http.user_agent contains Chrome Filter broadcast traffic !(arp or icmp or dns) Filter IP address and port tcp.port == 80 && ip.addr == 192.168.0.1 Filter all http get requests http.request Filter all http get requests and responses http.request or http.response Filter three way handshake tcp.flags.syn==1 or (tcp.seq==1 and tcp.ack==1 and tcp.len==0 and tcp.analysis.initial_rtt) Find files by type frame contains \u201c(attachment|tar|exe|zip|pdf)\u201d Find traffic based on keyword tcp contains facebook frame contains facebook Detecting SYN Floods tcp.flags.syn == 1 and tcp.flags.ack == 0 Wireshark Promiscuous Mode - By default, Wireshark only captures packets going to and from the computer where it runs. By checking the box to run Wireshark in Promiscuous Mode in the Capture Settings, you can capture most of the traffic on the LAN.","title":"WireShark"},{"location":"level101/security/network_security/#dumpcap","text":"Dumpcap is a network traffic dump tool. It captures packet data from a live network and writes the packets to a file. Dumpcap\u2019s native capture file format is pcapng, which is also the format used by Wireshark. By default, Dumpcap uses the pcap library to capture traffic from the first available network interface and writes the received raw packet data, along with the packets\u2019 time stamps into a pcapng file. The capture filter syntax follows the rules of the pcap library. The Wireshark command-line utility called 'dumpcap.exe' can be used to capture LAN traffic over an extended period of time. Wireshark itself can also be used, but dumpcap does not significantly utilize the computer's memory while capturing for long periods.","title":"DumpCap"},{"location":"level101/security/network_security/#daemonlogger","text":"Daemonlogger is a packet logging application designed specifically for use in Network and Systems Management (NSM) environments. The biggest benefit Daemonlogger provides is that, like Dumpcap, it is simple to use for capturing packets. In order to begin capturing, you need only to invoke the command and specify an interface. daemonlogger \u2013i eth1 This option, by default, will begin capturing packets and logging them to the current working directory. Packets will be collected until the capture file size reaches 2 GB, and then a new file will be created. This will continue indefinitely until the process is halted.","title":"DaemonLogger"},{"location":"level101/security/network_security/#netsniff-ng","text":"Netsniff-NG is a high-performance packet capture utility While the utilities we\u2019ve discussed to this point rely on Libpcap for capture, Netsniff-NG utilizes zero-copy mechanisms to capture packets. This is done with the intent to support full packet capture over high throughput links. To begin capturing packets with Netsniff-NG, we have to specify an input and output. In most cases, the input will be a network interface, and the output will be a file or folder on disk. netsniff-ng \u2013i eth1 \u2013o data.pcap","title":"NetSniff-NG"},{"location":"level101/security/network_security/#netflow","text":"NetFlow is a feature that was introduced on Cisco routers around 1996 that provides the ability to collect IP network traffic as it enters or exits an interface. By analyzing the data provided by NetFlow, a network administrator can determine things such as the source and destination of traffic, class of service, and the causes of congestion. A typical flow monitoring setup (using NetFlow) consists of three main components:[1] Flow exporter: aggregates packets into flows and exports flow records towards one or more flow collectors. Flow collector: responsible for reception, storage and pre-processing of flow data received from a flow exporter. Analysis application: analyzes received flow data in the context of intrusion detection or traffic profiling, for example. Routers and switches that support NetFlow can collect IP traffic statistics on all interfaces where NetFlow is enabled, and later export those statistics as NetFlow records toward at least one NetFlow collector\u2014typically a server that does the actual traffic analysis.","title":"Netflow"},{"location":"level101/security/network_security/#ids","text":"A security solution that detects security-related events in your environment but does not block them. IDS sensors can be software and hardware-based used to collect and analyze the network traffic. These sensors are available in two varieties, network IDS and host IDS. A host IDS is a server-specific agent running on a server with a minimum of overhead to monitor the operating system. A network IDS can be embedded in a networking device, a standalone appliance, or a module monitoring the network traffic. Signature Based IDS The signature-based IDS monitors the network traffic or observes the system and sends an alarm if a known malicious event is happening. It does so by comparing the data flow against a database of known attack patterns These signatures explicitly define what traffic or activity should be considered as malicious. Signature-based detection has been the bread and butter of network-based defensive security for over a decade, partially because it is very similar to how malicious activity is detected at the host level with antivirus utilities The formula is fairly simple: an analyst observes a malicious activity, derives indicators from the activity and develops them into signatures, and then those signatures will alert whenever the activity occurs again. ex: SNORT & SURICATA Policy-Based IDS The policy-based IDSs (mainly host IDSs) trigger an alarm whenever a violation occurs against the configured policy. This configured policy is or should be a representation of the security policies. This type of IDS is flexible and can be customized to a company's network requirements because it knows exactly what is permitted and what is not. On the other hand, the signature-based systems rely on vendor specifics and default settings. Anomaly Based IDS The anomaly-based IDS looks for traffic that deviates from the normal, but the definition of what is a normal network traffic pattern is the tricky part Two types of anomaly-based IDS exist: statistical and nonstatistical anomaly detection Statistical anomaly detection learns the traffic patterns interactively over a period of time. In the nonstatistical approach, the IDS has a predefined configuration of the supposedly acceptable and valid traffic patterns. Host-Based IDS & Network-Based IDS A host IDS can be described as a distributed agent residing on each server of the network that needs protection. These distributed agents are tied very closely to the underlying operating system. Network IDSs, on the other hand, can be described as intelligent sniffing devices. Data (raw packets) is captured from the network by a network IDS, whereas host IDSs capture the data from the host on which they are installed. Honeypots The use of decoy machines to direct intruders' attention away from the machines under protection is a major technique to preclude intrusion attacks. Any device, system, directory, or file used as a decoy to lure attackers away from important assets and to collect intrusion or abusive behaviours is referred to as a honeypot. A honeypot may be implemented as a physical device or as an emulation system. The idea is to set up decoy machines in a LAN, or decoy directories/files in a file system and make them appear important, but with several exploitable loopholes, to lure attackers to attack these machines or directories/files, so that other machines, directories, and files can evade intruders' attentions. A decoy machine may be a host computer or a server computer. Likewise, we may also set up decoy routers or even decoy LANs.","title":"IDS"},{"location":"level101/security/network_security/#chinks-in-the-armour-tcpip-security-issues","text":"","title":"Chinks In The Armour (TCP/IP Security Issues)"},{"location":"level101/security/network_security/#ip-spoofing","text":"In this type of attack, the attacker replaces the IP address of the sender, or in some rare cases the destination, with a different address. IP spoofing is normally used to exploit a target host. In other cases, it is used to start a denial-of-service (DoS) attack. In a DoS attack, an attacker modifies the IP packet to mislead the target host into accepting the original packet as a packet sourced at a trusted host. The attacker must know the IP address of the trusted host to modify the packet headers (source IP address) so that it appears that the packets are coming from that host. IP Spoofing Detection Techniques Direct TTL Probes In this technique we send a packet to a host of suspect spoofed IP that triggers reply and compares TTL with suspect packet; if the TTL in the reply is not the same as the packet being checked; it is a spoofed packet. This Technique is successful when the attacker is in a different subnet from the victim. IP Identification Number. Send a probe to the host of suspect spoofed traffic that triggers a reply and compares IP ID with suspect traffic. If IP IDs are not in the near value of packet being checked, suspect traffic is spoofed TCP Flow Control Method Attackers sending spoofed TCP packets will not receive the target\u2019s SYN-ACK packets. Attackers cannot, therefore, be responsive to change in the congestion window size When the receiver still receives traffic even after a windows size is exhausted, most probably the packets are spoofed.","title":"IP Spoofing"},{"location":"level101/security/network_security/#covert-channel","text":"A covert or clandestine channel can be best described as a pipe or communication channel between two entities that can be exploited by a process or application transferring information in a manner that violates the system's security specifications. More specifically for TCP/IP, in some instances, covert channels are established, and data can be secretly passed between two end systems. Ex: ICMP resides at the Internet layer of the TCP/IP protocol suite and is implemented in all TCP/IP hosts. Based on the specifications of the ICMP Protocol, an ICMP Echo Request message should have an 8-byte header and a 56-byte payload. The ICMP Echo Request packet should not carry any data in the payload. However, these packets are often used to carry secret information. The ICMP packets are altered slightly to carry secret data in the payload. This makes the size of the packet larger, but no control exists in the protocol stack to defeat this behaviour. The alteration of ICMP packets allows intruders to program specialized client-server pairs. These small pieces of code export confidential information without alerting the network administrator. ICMP can be leveraged for more than data exfiltration. For eg. some C&C tools such as Loki used ICMP channel to establish encrypted interactive session back in 1996. Deep packet inspection has since come a long way. A lot of IDS/IPS detect ICMP tunnelling. Check for echo responses that do not contain the same payload as request Check for the volume of ICMP traffic especially for volumes beyond an acceptable threshold","title":"Covert Channel"},{"location":"level101/security/network_security/#ip-fragmentation-attack","text":"The TCP/IP protocol suite, or more specifically IP, allows the fragmentation of packets.(this is a feature & not a bug) IP fragmentation offset is used to keep track of the different parts of a datagram. The information or content in this field is used at the destination to reassemble the datagrams All such fragments have the same Identification field value, and the fragmentation offset indicates the position of the current fragment in the context of the original packet. Many access routers and firewalls do not perform packet reassembly. In normal operation, IP fragments do not overlap, but attackers can create artificially fragmented packets to mislead the routers or firewalls. Usually, these packets are small and almost impractical for end systems because of data and computational overhead. A good example of an IP fragmentation attack is the Ping of Death attack. The Ping of Death attack sends fragments that, when reassembled at the end station, create a larger packet than the maximum permissible length. TCP Flags Data exchange using TCP does not happen until a three-way handshake has been completed. This handshake uses different flags to influence the way TCP segments are processed. There are 6 bits in the TCP header that are often called flags. Namely: 6 different flags are part of the TCP header: Urgent pointer field (URG), Acknowledgment field (ACK), Push function (PSH), Reset the connection (RST), Synchronize sequence numbers (SYN), and the sender is finished with this connection (FIN). Abuse of the normal operation or settings of these flags can be used by attackers to launch DoS attacks. This causes network servers or web servers to crash or hang. | SYN | FIN | PSH | RST | Validity| |------|------|-------|------|---------| | 1 |1 |0 |0 |Illegal Combination | 1 |1 |1 |0 |Illegal Combination | 1 |1 |0 |1 |Illegal Combination | 1 |1 |1 |1 |Illegal Combination The attacker's ultimate goal is to write special programs or pieces of code that can construct these illegal combinations resulting in an efficient DoS attack. SYN FLOOD The timers (or lack of certain timers) in 3 way handshake are often used and exploited by attackers to disable services or even to enter systems. After step 2 of the three-way handshake, no limit is set on the time to wait after receiving a SYN. The attacker initiates many connection requests to the webserver of Company XYZ (almost certainly with a spoofed IP address). The SYN+ACK packets (Step 2) sent by the web server back to the originating source IP address are not replied to. This leaves a TCP session half-open on the webserver. Multiple packets cause multiple TCP sessions to stay open. Based on the hardware limitations of the server, a limited number of TCP sessions can stay open, and as a result, the webserver refuses further connection establishments attempts from any host as soon as a certain limit is reached. These half-open connections need to be completed or timed out before new connections can be established. FIN Attack In normal operation, the sender sets the TCP FIN flag indicating that no more data will be transmitted and the connection can be closed down. This is a four-way handshake mechanism, with both sender and receiver expected to send an acknowledgement on a received FIN packet. During an attack that is trying to kill connections, a spoofed FIN packet is constructed. This packet also has the correct sequence number, so the packets are seen as valid by the targeted host. These sequence numbers are easy to predict. This process is referred to as TCP sequence number prediction, whereby the attacker either sniffs the current Sequence and Acknowledgment (SEQ/ACK) numbers of the connection or can algorithmically predict these numbers.","title":"IP Fragmentation Attack"},{"location":"level101/security/network_security/#connection-hijacking","text":"An authorized user (Employee X) sends HTTP requests over a TCP session with the webserver. The web server accepts the packets from Employee X only when the packet has the correct SEQ/ACK numbers. As seen previously, these numbers are important for the webserver to distinguish between different sessions and to make sure it is still talking to Employee X. Imagine that the cracker starts sending packets to the web server spoofing the IP address of Employee X, using the correct SEQ/ACK combination. The web server accepts the packet and increments the ACK number. In the meantime, Employee X continues to send packets but with incorrect SEQ/ACK numbers. As a result of sending unsynchronized packets, all data from Employee X is discarded when received by the webserver. The attacker pretends to be Employee X using the correct numbers. This finally results in the cracker hijacking the connection, whereby Employee X is completely confused and the webserver replies assuming the cracker is sending correct synchronized data. STEPS: The attacker examines the traffic flows with a network monitor and notices traffic from Employee X to a web server. The web server returns or echoes data back to the origination station (Employee X). Employee X acknowledges the packet. The cracker launches a spoofed packet to the server. The web server responds to the cracker. The cracker starts verifying SEQ/ACK numbers to double-check success. At this time, the cracker takes over the session from Employee X, which results in a session hanging for Employee X. The cracker can start sending traffic to the webserver. The web server returns the requested data to confirm delivery with the correct ACK number. The cracker can continue to send data (keeping track of the correct SEQ/ACK numbers) until eventually setting the FIN flag to terminate the session.","title":"Connection Hijacking"},{"location":"level101/security/network_security/#buffer-overflow","text":"A buffer is a temporary data storage area used to store program code and data. When a program or process tries to store more data in a buffer than it was originally anticipated to hold, a buffer overflow occurs. Buffers are temporary storage locations in memory (memory or buffer sizes are often measured in bytes) that can store a fixed amount of data in bytes. When more data is retrieved than can be stored in a buffer location, the additional information must go into an adjacent buffer, resulting in overwriting the valid data held in them. Mechanism: Buffer overflow vulnerabilities exist in different types. But the overall goal for all buffer overflow attacks is to take over the control of a privileged program and, if possible, the host. The attacker has two tasks to achieve this goal. First, the dirty code needs to be available in the program's code address space. Second, the privileged program should jump to that particular part of the code, which ensures that the proper parameters are loaded into memory. The first task can be achieved in two ways: by injecting the code in the right address space or by using the existing code and modifying certain parameters slightly. The second task is a little more complex because the program's control flow needs to be modified to make the program jump to the dirty code. CounterMeasure: The most important approach is to have a concerted focus on writing correct code. A second method is to make the data buffers (memory locations) address space of the program code non-executable. This type of address space makes it impossible to execute code, which might be infiltrated in the program's buffers during an attack.","title":"Buffer Overflow"},{"location":"level101/security/network_security/#more-spoofing","text":"Address Resolution Protocol Spoofing The Address Resolution Protocol (ARP) provides a mechanism to resolve, or map, a known IP address to a MAC sublayer address. Using ARP spoofing, the cracker can exploit this hardware address authentication mechanism by spoofing the hardware address of Host B. Basically, the attacker can convince any host or network device on the local network that the cracker's workstation is the host to be trusted. This is a common method used in a switched environment. ARP spoofing can be prevented with the implementation of static ARP tables in all the hosts and routers of your network. Alternatively, you can implement an ARP server that responds to ARP requests on behalf of the target host. DNS Spoofing DNS spoofing is the method whereby the hacker convinces the target machine that the system it wants to connect to is the machine of the cracker. The cracker modifies some records so that name entries of hosts correspond to the attacker's IP address. There have been instances in which the complete DNS server was compromised by an attack. To counter DNS spoofing, the reverse lookup detects these attacks. The reverse lookup is a mechanism to verify the IP address against a name. The IP address and name files are usually kept on different servers to make compromise much more difficult","title":"More Spoofing"},{"location":"level101/security/threats_attacks_defences/","text":"Part III: Threats, Attacks & Defense DNS Protection Cache Poisoning Attack Since DNS responses are cached, a quick response can be provided for repeated translations. DNS negative queries are also cached, e.g., misspelt words, and all cached data periodically times out. Cache poisoning is an issue in what is known as pharming. This term is used to describe a hacker\u2019s attack in which a website\u2019s traffic is redirected to a bogus website by forging the DNS mapping. In this case, an attacker attempts to insert a fake address record for an Internet domain into the DNS. If the server accepts the fake record, the cache is poisoned and subsequent requests for the address of the domain are answered with the address of a server controlled by the attacker. As long as the fake entry is cached by the server, browsers or e-mail servers will automatically go to the address provided by the compromised DNS server. the typical time to live (TTL) for cached entries is a couple of hours, thereby permitting ample time for numerous users to be affected by the attack. DNSSEC (Security Extension) The long-term solution to these DNS problems is authentication. If a resolver cannot distinguish between valid and invalid data in a response, then add source authentication to verify that the data received in response is equal to the data entered by the zone administrator DNS Security Extensions (DNSSEC) protects against data spoofing and corruption and provides mechanisms to authenticate servers and requests, as well as mechanisms to establish authenticity and integrity. When authenticating DNS responses, each DNS zone signs its data using a private key. It is recommended that this signing be done offline and in advance. The query for a particular record returns the requested resource record set (RRset) and signature (RRSIG) of the requested resource record set. The resolver then authenticates the response using a public key, which is pre-configured or learned via a sequence of key records in the DNS hierarchy. The goals of DNSSEC are to provide authentication and integrity for DNS responses without confidentiality or DDoS protection. BGP BGP stands for border gateway protocol. It is a routing protocol that exchanges routing information among multiple Autonomous Systems (AS) An Autonomous System is a collection of routers or networks with the same network policy usually under single administrative control. BGP tells routers which hop to use in order to reach the destination network. BGP is used for both communicating information among routers in an AS (interior) and between multiple ASes (exterior). How BGP Works BGP is responsible for finding a path to a destination router & the path it chooses should be the shortest and most reliable one. This decision is done through a protocol known as Link state. With the link-state protocol, each router broadcasts to all other routers in the network the state of its links and IP subnets. Each router then receives information from the other routers and constructs a complete topology view of the entire network. The next-hop routing table is based on this topology view. The link-state protocol uses a famous algorithm in the field of computer science, Dijkstra\u2019s shortest path algorithm: We start from our router considering the path cost to all our direct neighbours. The shortest path is then taken We then re-look at all our neighbours that we can reach and update our link state table with the cost information. We then continue taking the shortest path until every router has been visited. BGP Vulnerabilities By corrupting the BGP routing table we are able to influence the direction traffic flows on the internet! This action is known as BGP hijacking. Injecting bogus route advertising information into the BGP-distributed routing database by malicious sources, accidentally or routers can disrupt Internet backbone operations. Blackholing traffic: Blackhole route is a network route, i.e., routing table entry, that goes nowhere and packets matching the route prefix are dropped or ignored. Blackhole routes can only be detected by monitoring the lost traffic. Blackhole routes are the best defence against many common viral attacks where the traffic is dropped from infected machines to/from command & control hosts. Infamous BGP Injection attack on Youtube Ex: In 2008, Pakistan decided to block YouTube by creating a BGP route that led into a black hole. Instead, this routing information got transmitted to a hong kong ISP and from there accidentally got propagated to the rest of the world meaning millions were routed through to this black hole and therefore unable to access YouTube. Potentially, the greatest risk to BGP occurs in a denial of service attack in which a router is flooded with more packets than it can handle. Network overload and router resource exhaustion happen when the network begins carrying an excessive number of BGP messages, overloading the router control processors, memory, routing table and reducing the bandwidth available for data traffic. Refer: https://medium.com/bugbountywriteup/bgp-the-weak-link-in-the-internet-what-is-bgp-and-how-do-hackers-exploit-it-d899a68ba5bb Router flapping is another type of attack. Route flapping refers to repetitive changes to the BGP routing table, often several times a minute. Withdrawing and re-advertising at a high-rate can cause a serious problem for routers since they propagate the announcements of routes. If these route flaps happen fast enough, e.g., 30 to 50 times per second, the router becomes overloaded, which eventually prevents convergence on valid routes. The potential impact for Internet users is a slowdown in message delivery, and in some cases, packets may not be delivered at all. BGP Security Border Gateway Protocol Security recommends the use of BGP peer authentication since it is one of the strongest mechanisms for preventing malicious activity. The authentication mechanisms are Internet Protocol Security (IPsec) or BGP MD5. Another method, known as prefix limits, can be used to avoid filling router tables. In this approach, routers should be configured to disable or terminate a BGP peering session, and issue warning messages to administrators when a neighbour sends in excess of a preset number of prefixes. IETF is currently working on improving this space Web-Based Attacks HTTP Response Splitting Attacks HTTP response splitting attack may happen where the server script embeds user data in HTTP response headers without appropriate sanitation. This typically happens when the script embeds user data in the redirection URL of a redirection response (HTTP status code 3xx), or when the script embeds user data in a cookie value or name when the response sets a cookie. HTTP response splitting attacks can be used to perform web cache poisoning and cross-site scripting attacks. HTTP response splitting is the attacker\u2019s ability to send a single HTTP request that forces the webserver to form an output stream, which is then interpreted by the target as two HTTP responses instead of one response. Cross-Site Request Forgery (CSRF or XSRF) A Cross-Site Request Forgery attack tricks the victim\u2019s browser into issuing a command to a vulnerable web application. Vulnerability is caused by browsers automatically including user authentication data, session ID, IP address, Windows domain credentials, etc. with each request. Attackers typically use CSRF to initiate transactions such as transfer funds, login/logout user, close account, access sensitive data, and change account details. The vulnerability is caused by web browsers that automatically include credentials with each request, even for requests caused by a form, script, or image on another site. CSRF can also be dynamically constructed as part of a payload for a cross-site scripting attack All sites relying on automatic credentials are vulnerable. Popular browsers cannot prevent cross-site request forgery. Logging out of high-value sites as soon as possible can mitigate CSRF risk. It is recommended that a high-value website must require a client to manually provide authentication data in the same HTTP request used to perform any operation with security implications. Limiting the lifetime of session cookies can also reduce the chance of being used by other malicious sites. OWASP recommends website developers include a required security token in HTTP requests associated with sensitive business functions in order to mitigate CSRF attacks Cross-Site Scripting (XSS) Attacks Cross-Site Scripting occurs when dynamically generated web pages display user input, such as login information, that is not properly validated, allowing an attacker to embed malicious scripts into the generated page and then execute the script on the machine of any user that views the site. If successful, Cross-Site Scripting vulnerabilities can be exploited to manipulate or steal cookies, create requests that can be mistaken for those of a valid user, compromise confidential information, or execute malicious code on end-user systems. Cross-Site Scripting (XSS or CSS) attacks involve the execution of malicious scripts on the victim\u2019s browser. The victim is simply a user\u2019s host and not the server. XSS results from a failure to validate user input by a web-based application. Document Object Model (DOM) XSS Attacks The Document Object Model (DOM) based XSS does not require the webserver to receive the XSS payload for a successful attack. The attacker abuses the runtime by embedding their data on the client-side. An attacker can force the client (browser) to render the page with parts of the DOM controlled by the attacker. When the page is rendered and the data is processed by the page, typically by a client-side HTML-embedded script such as JavaScript, the page\u2019s code may insecurely embed the data in the page itself, thus delivering the cross-site scripting payload. There are several DOM objects which can serve as an attack vehicle for delivering malicious script to victims browser. Clickjacking The technique works by hiding malicious link/scripts under the cover of the content of a legitimate site. Buttons on a website actually contain invisible links, placed there by the attacker. So, an individual who clicks on an object they can visually see is actually being duped into visiting a malicious page or executing a malicious script. When mouseover is used together with clickjacking, the outcome is devastating. Facebook users have been hit by a clickjacking attack, which tricks people into \u201cliking\u201d a particular Facebook page, thus enabling the attack to spread since Memorial Day 2010. There is not yet effective defence against clickjacking, and disabling JavaScript is the only viable method DataBase Attacks & Defenses SQL injection Attacks It exploits improper input validation in database queries. A successful exploit will allow attackers to access, modify, or delete information in the database. It permits attackers to steal sensitive information stored within the backend databases of affected websites, which may include such things as user credentials, email addresses, personal information, and credit card numbers SELECT USERNAME,PASSWORD from USERS where USERNAME='' AND PASSWORD=''; Here the username & password is the input provided by the user. Suppose an attacker gives the input as \" OR '1'='1'\" in both fields. Therefore the SQL query will look like: SELECT USERNAME,PASSWORD from USERS where USERNAME='' OR '1'='1' AND PASSOWRD='' OR '1'='1'; This query results in a true statement & the user gets logged in. This example depicts the bost basic type of SQL injection SQL Injection Attack Defenses SQL injection can be protected by filtering the query to eliminate malicious syntax, which involves the employment of some tools in order to (a) scan the source code. In addition, the input fields should be restricted to the absolute minimum, typically anywhere from 7-12 characters, and validate any data, e.g., if a user inputs an age make sure the input is an integer with a maximum of 3 digits. VPN A virtual private network (VPN) is a service that offers a secure, reliable connection over a shared public infrastructure such as the Internet. Cisco defines a VPN as an encrypted connection between private networks over a public network. To date, there are three types of VPNs: Remote access Site-to-site Firewall-based Security Breach In spite of the most aggressive steps to protect computers from attacks, attackers sometimes get through. Any event that results in a violation of any of the confidentiality, integrity, or availability (CIA) security tenets is a security breach. Denial of Service Attacks Denial of service (DoS) attacks result in downtime or inability of a user to access a system. DoS attacks impact the availability of tenet of information systems security. A DoS attack is a coordinated attempt to deny service by occupying a computer to perform large amounts of unnecessary tasks. This excessive activity makes the system unavailable to perform legitimate operations Two common types of DoS attacks are as follows: Logic attacks\u2014Logic attacks use software flaws to crash or seriously hinder the performance of remote servers. You can prevent many of these attacks by installing the latest patches to keep your software up to date. Flooding attacks\u2014Flooding attacks overwhelm the victim computer\u2019s CPU, memory, or network resources by sending large numbers of useless requests to the machine. Most DoS attacks target weaknesses in the overall system architecture rather than a software bug or security flaw One popular technique for launching a packet flood is a SYN flood. One of the best defences against DoS attacks is to use intrusion prevention system (IPS) software or devices to detect and stop the attack. Distributed Denial of Service Attacks DDoS attacks differ from regular DoS attacks in their scope. In a DDoS attack, attackers hijack hundreds or even thousands of Internet computers, planting automated attack agents on those systems. The attacker then instructs the agents to bombard the target site with forged messages. This overloads the site and blocks legitimate traffic. The key here is strength in numbers. The attacker does more damage by distributing the attack across multiple computers. Wiretapping Although the term wiretapping is generally associated with voice telephone communications, attackers can also use wiretapping to intercept data communications. Attackers can tap telephone lines and data communication lines. Wiretapping can be active, where the attacker makes modifications to the line. It can also be passive, where an unauthorized user simply listens to the transmission without changing the contents. Passive intrusion can include the copying of data for a subsequent active attack. Two methods of active wiretapping are as follows: Between-the-lines wiretapping\u2014This type of wiretapping does not alter the messages sent by the legitimate user but inserts additional messages into the communication line when the legitimate user pauses. Piggyback-entry wiretapping\u2014This type of wiretapping intercepts and modifies the original message by breaking the communications line and routing the message to another computer that acts as a host. Backdoors Software developers sometimes include hidden access methods, called backdoors, in their programs. Backdoors give developers or support personnel easy access to a system without having to struggle with security controls. The problem is that backdoors don\u2019t always stay hidden. When an attacker discovers a backdoor, he or she can use it to bypass existing security controls such as passwords, encryption, and so on. Where legitimate users log on through front doors using a user ID and password, attackers use backdoors to bypass these normal access controls. Malicious Attacks Birthday Attack Once an attacker compromises a hashed password file, a birthday attack is performed. A birthday attack is a type of cryptographic attack that is used to make a brute-force attack of one-way hashes easier. It is a mathematical exploit that is based on the birthday problem in probability theory. Further Reading: https://www.sciencedirect.com/topics/computer-science/birthday-attack https://www.internetsecurity.tips/birthday-attack/ Brute-Force Password Attacks In a brute-force password attack, the attacker tries different passwords on a system until one of them is successful. Usually, the attacker employs a software program to try all possible combinations of a likely password, user ID, or security code until it locates a match. This occurs rapidly and in sequence. This type of attack is called a brute-force password attack because the attacker simply hammers away at the code. There is no skill or stealth involved\u2014just brute force that eventually breaks the code. Further Reading: https://owasp.org/www-community/attacks/Brute_force_attack https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks Dictionary Password Attacks A dictionary password attack is a simple attack that relies on users making poor password choices. In a dictionary password attack, a simple password-cracker program takes all the words from a dictionary file and attempts to log on by entering each dictionary entry as a password. Further Reading: https://capec.mitre.org/data/definitions/16.html Replay Attacks Replay attacks involve capturing data packets from a network and retransmitting them to produce an unauthorized effect. The receipt of duplicate, authenticated IP packets may disrupt service or have some other undesired consequence. Systems can be broken through replay attacks when attackers reuse old messages or parts of old messages to deceive system users. This helps intruders to gain information that allows unauthorized access into a system. Further reading: https://study.com/academy/lesson/replay-attack-definition-examples-prevention.html Man-in-the-Middle Attacks A man-in-the-middle attack takes advantage of the multihop process used by many types of networks. In this type of attack, an attacker intercepts messages between two parties before transferring them on to their intended destination. Web spoofing is a type of man-in-the-middle attack in which the user believes a secure session exists with a particular web server. In reality, the secure connection exists only with the attacker, not the webserver. The attacker then establishes a secure connection with the webserver, acting as an invisible go-between. The attacker passes traffic between the user and the webserver. In this way, the attacker can trick the user into supplying passwords, credit card information, and other private data. Further Reading: https://owasp.org/www-community/attacks/Man-in-the-middle_attack Masquerading In a masquerade attack, one user or computer pretends to be another user or computer. Masquerade attacks usually include one of the other forms of active attacks, such as IP address spoofing or replaying. Attackers can capture authentication sequences and then replay them later to log on again to an application or operating system. For example, an attacker might monitor usernames and passwords sent to a weak web application. The attacker could then use the intercepted credentials to log on to the web application and impersonate the user. Further Reading: https://dl.acm.org/doi/book/10.5555/2521792 https://ieeexplore.ieee.org/document/1653228 Eavesdropping Eavesdropping, or sniffing, occurs when a host sets its network interface on promiscuous mode and copies packets that pass by for later analysis. Promiscuous mode enables a network device to intercept and read each network packet(of course given some conditions) given sec, even if the packet\u2019s address doesn\u2019t match the network device. It is possible to attach hardware and software to monitor and analyze all packets on that segment of the transmission media without alerting any other users. Candidates for eavesdropping include satellite, wireless, mobile, and other transmission methods. Social Engineering Attackers often use a deception technique called social engineering to gain access to resources in an IT infrastructure. In nearly all cases, social engineering involves tricking authorized users into carrying out actions for unauthorized users. The success of social engineering attacks depends on the basic tendency of people to want to be helpful. Phreaking Phone phreaking, or simply phreaking, is a slang term that describes the activity of a subculture of people who study, experiment with, or explore telephone systems, telephone company equipment, and systems connected to public telephone networks. Phreaking is the art of exploiting bugs and glitches that exist in the telephone system. Phishing Phishing is a type of fraud in which an attacker attempts to trick the victim into providing private information such as credit card numbers, passwords, dates of birth, bank account numbers, automated teller machine (ATM) PINs, and Social Security numbers. Pharming Pharming is another type of attack that seeks to obtain personal or private financial information through domain spoofing. A pharming attack doesn\u2019t use messages to trick victims into visiting spoofed websites that appear legitimate, however. Instead, pharming \u201cpoisons\u201d a domain name on the domain name server (DNS), a process known as DNS poisoning. The result is that when a user enters the poisoned server\u2019s web address into his or her address bar, that user navigates to the attacker\u2019s site. The user\u2019s browser still shows the correct website, which makes pharming difficult to detect\u2014and therefore more serious. Where phishing attempts to scam people one at a time with an email or instant message, pharming enables scammers to target large groups of people at one time through domain spoofing.","title":"Threat, Attacks & Defences"},{"location":"level101/security/threats_attacks_defences/#part-iii-threats-attacks-defense","text":"","title":"Part III: Threats, Attacks & Defense"},{"location":"level101/security/threats_attacks_defences/#dns-protection","text":"","title":"DNS Protection"},{"location":"level101/security/threats_attacks_defences/#cache-poisoning-attack","text":"Since DNS responses are cached, a quick response can be provided for repeated translations. DNS negative queries are also cached, e.g., misspelt words, and all cached data periodically times out. Cache poisoning is an issue in what is known as pharming. This term is used to describe a hacker\u2019s attack in which a website\u2019s traffic is redirected to a bogus website by forging the DNS mapping. In this case, an attacker attempts to insert a fake address record for an Internet domain into the DNS. If the server accepts the fake record, the cache is poisoned and subsequent requests for the address of the domain are answered with the address of a server controlled by the attacker. As long as the fake entry is cached by the server, browsers or e-mail servers will automatically go to the address provided by the compromised DNS server. the typical time to live (TTL) for cached entries is a couple of hours, thereby permitting ample time for numerous users to be affected by the attack.","title":"Cache Poisoning Attack"},{"location":"level101/security/threats_attacks_defences/#dnssec-security-extension","text":"The long-term solution to these DNS problems is authentication. If a resolver cannot distinguish between valid and invalid data in a response, then add source authentication to verify that the data received in response is equal to the data entered by the zone administrator DNS Security Extensions (DNSSEC) protects against data spoofing and corruption and provides mechanisms to authenticate servers and requests, as well as mechanisms to establish authenticity and integrity. When authenticating DNS responses, each DNS zone signs its data using a private key. It is recommended that this signing be done offline and in advance. The query for a particular record returns the requested resource record set (RRset) and signature (RRSIG) of the requested resource record set. The resolver then authenticates the response using a public key, which is pre-configured or learned via a sequence of key records in the DNS hierarchy. The goals of DNSSEC are to provide authentication and integrity for DNS responses without confidentiality or DDoS protection.","title":"DNSSEC (Security Extension)"},{"location":"level101/security/threats_attacks_defences/#bgp","text":"BGP stands for border gateway protocol. It is a routing protocol that exchanges routing information among multiple Autonomous Systems (AS) An Autonomous System is a collection of routers or networks with the same network policy usually under single administrative control. BGP tells routers which hop to use in order to reach the destination network. BGP is used for both communicating information among routers in an AS (interior) and between multiple ASes (exterior).","title":"BGP"},{"location":"level101/security/threats_attacks_defences/#how-bgp-works","text":"BGP is responsible for finding a path to a destination router & the path it chooses should be the shortest and most reliable one. This decision is done through a protocol known as Link state. With the link-state protocol, each router broadcasts to all other routers in the network the state of its links and IP subnets. Each router then receives information from the other routers and constructs a complete topology view of the entire network. The next-hop routing table is based on this topology view. The link-state protocol uses a famous algorithm in the field of computer science, Dijkstra\u2019s shortest path algorithm: We start from our router considering the path cost to all our direct neighbours. The shortest path is then taken We then re-look at all our neighbours that we can reach and update our link state table with the cost information. We then continue taking the shortest path until every router has been visited.","title":"How BGP Works"},{"location":"level101/security/threats_attacks_defences/#bgp-vulnerabilities","text":"By corrupting the BGP routing table we are able to influence the direction traffic flows on the internet! This action is known as BGP hijacking. Injecting bogus route advertising information into the BGP-distributed routing database by malicious sources, accidentally or routers can disrupt Internet backbone operations. Blackholing traffic: Blackhole route is a network route, i.e., routing table entry, that goes nowhere and packets matching the route prefix are dropped or ignored. Blackhole routes can only be detected by monitoring the lost traffic. Blackhole routes are the best defence against many common viral attacks where the traffic is dropped from infected machines to/from command & control hosts. Infamous BGP Injection attack on Youtube Ex: In 2008, Pakistan decided to block YouTube by creating a BGP route that led into a black hole. Instead, this routing information got transmitted to a hong kong ISP and from there accidentally got propagated to the rest of the world meaning millions were routed through to this black hole and therefore unable to access YouTube. Potentially, the greatest risk to BGP occurs in a denial of service attack in which a router is flooded with more packets than it can handle. Network overload and router resource exhaustion happen when the network begins carrying an excessive number of BGP messages, overloading the router control processors, memory, routing table and reducing the bandwidth available for data traffic. Refer: https://medium.com/bugbountywriteup/bgp-the-weak-link-in-the-internet-what-is-bgp-and-how-do-hackers-exploit-it-d899a68ba5bb Router flapping is another type of attack. Route flapping refers to repetitive changes to the BGP routing table, often several times a minute. Withdrawing and re-advertising at a high-rate can cause a serious problem for routers since they propagate the announcements of routes. If these route flaps happen fast enough, e.g., 30 to 50 times per second, the router becomes overloaded, which eventually prevents convergence on valid routes. The potential impact for Internet users is a slowdown in message delivery, and in some cases, packets may not be delivered at all. BGP Security Border Gateway Protocol Security recommends the use of BGP peer authentication since it is one of the strongest mechanisms for preventing malicious activity. The authentication mechanisms are Internet Protocol Security (IPsec) or BGP MD5. Another method, known as prefix limits, can be used to avoid filling router tables. In this approach, routers should be configured to disable or terminate a BGP peering session, and issue warning messages to administrators when a neighbour sends in excess of a preset number of prefixes. IETF is currently working on improving this space","title":"BGP Vulnerabilities"},{"location":"level101/security/threats_attacks_defences/#web-based-attacks","text":"","title":"Web-Based Attacks"},{"location":"level101/security/threats_attacks_defences/#http-response-splitting-attacks","text":"HTTP response splitting attack may happen where the server script embeds user data in HTTP response headers without appropriate sanitation. This typically happens when the script embeds user data in the redirection URL of a redirection response (HTTP status code 3xx), or when the script embeds user data in a cookie value or name when the response sets a cookie. HTTP response splitting attacks can be used to perform web cache poisoning and cross-site scripting attacks. HTTP response splitting is the attacker\u2019s ability to send a single HTTP request that forces the webserver to form an output stream, which is then interpreted by the target as two HTTP responses instead of one response.","title":"HTTP Response Splitting Attacks"},{"location":"level101/security/threats_attacks_defences/#cross-site-request-forgery-csrf-or-xsrf","text":"A Cross-Site Request Forgery attack tricks the victim\u2019s browser into issuing a command to a vulnerable web application. Vulnerability is caused by browsers automatically including user authentication data, session ID, IP address, Windows domain credentials, etc. with each request. Attackers typically use CSRF to initiate transactions such as transfer funds, login/logout user, close account, access sensitive data, and change account details. The vulnerability is caused by web browsers that automatically include credentials with each request, even for requests caused by a form, script, or image on another site. CSRF can also be dynamically constructed as part of a payload for a cross-site scripting attack All sites relying on automatic credentials are vulnerable. Popular browsers cannot prevent cross-site request forgery. Logging out of high-value sites as soon as possible can mitigate CSRF risk. It is recommended that a high-value website must require a client to manually provide authentication data in the same HTTP request used to perform any operation with security implications. Limiting the lifetime of session cookies can also reduce the chance of being used by other malicious sites. OWASP recommends website developers include a required security token in HTTP requests associated with sensitive business functions in order to mitigate CSRF attacks","title":"Cross-Site Request Forgery (CSRF or XSRF)"},{"location":"level101/security/threats_attacks_defences/#cross-site-scripting-xss-attacks","text":"Cross-Site Scripting occurs when dynamically generated web pages display user input, such as login information, that is not properly validated, allowing an attacker to embed malicious scripts into the generated page and then execute the script on the machine of any user that views the site. If successful, Cross-Site Scripting vulnerabilities can be exploited to manipulate or steal cookies, create requests that can be mistaken for those of a valid user, compromise confidential information, or execute malicious code on end-user systems. Cross-Site Scripting (XSS or CSS) attacks involve the execution of malicious scripts on the victim\u2019s browser. The victim is simply a user\u2019s host and not the server. XSS results from a failure to validate user input by a web-based application.","title":"Cross-Site Scripting (XSS) Attacks"},{"location":"level101/security/threats_attacks_defences/#document-object-model-dom-xss-attacks","text":"The Document Object Model (DOM) based XSS does not require the webserver to receive the XSS payload for a successful attack. The attacker abuses the runtime by embedding their data on the client-side. An attacker can force the client (browser) to render the page with parts of the DOM controlled by the attacker. When the page is rendered and the data is processed by the page, typically by a client-side HTML-embedded script such as JavaScript, the page\u2019s code may insecurely embed the data in the page itself, thus delivering the cross-site scripting payload. There are several DOM objects which can serve as an attack vehicle for delivering malicious script to victims browser.","title":"Document Object Model (DOM) XSS Attacks"},{"location":"level101/security/threats_attacks_defences/#clickjacking","text":"The technique works by hiding malicious link/scripts under the cover of the content of a legitimate site. Buttons on a website actually contain invisible links, placed there by the attacker. So, an individual who clicks on an object they can visually see is actually being duped into visiting a malicious page or executing a malicious script. When mouseover is used together with clickjacking, the outcome is devastating. Facebook users have been hit by a clickjacking attack, which tricks people into \u201cliking\u201d a particular Facebook page, thus enabling the attack to spread since Memorial Day 2010. There is not yet effective defence against clickjacking, and disabling JavaScript is the only viable method","title":"Clickjacking"},{"location":"level101/security/threats_attacks_defences/#database-attacks-defenses","text":"","title":"DataBase Attacks & Defenses"},{"location":"level101/security/threats_attacks_defences/#sql-injection-attacks","text":"It exploits improper input validation in database queries. A successful exploit will allow attackers to access, modify, or delete information in the database. It permits attackers to steal sensitive information stored within the backend databases of affected websites, which may include such things as user credentials, email addresses, personal information, and credit card numbers SELECT USERNAME,PASSWORD from USERS where USERNAME='' AND PASSWORD=''; Here the username & password is the input provided by the user. Suppose an attacker gives the input as \" OR '1'='1'\" in both fields. Therefore the SQL query will look like: SELECT USERNAME,PASSWORD from USERS where USERNAME='' OR '1'='1' AND PASSOWRD='' OR '1'='1'; This query results in a true statement & the user gets logged in. This example depicts the bost basic type of SQL injection","title":"SQL injection Attacks"},{"location":"level101/security/threats_attacks_defences/#sql-injection-attack-defenses","text":"SQL injection can be protected by filtering the query to eliminate malicious syntax, which involves the employment of some tools in order to (a) scan the source code. In addition, the input fields should be restricted to the absolute minimum, typically anywhere from 7-12 characters, and validate any data, e.g., if a user inputs an age make sure the input is an integer with a maximum of 3 digits.","title":"SQL Injection Attack Defenses"},{"location":"level101/security/threats_attacks_defences/#vpn","text":"A virtual private network (VPN) is a service that offers a secure, reliable connection over a shared public infrastructure such as the Internet. Cisco defines a VPN as an encrypted connection between private networks over a public network. To date, there are three types of VPNs: Remote access Site-to-site Firewall-based","title":"VPN"},{"location":"level101/security/threats_attacks_defences/#security-breach","text":"In spite of the most aggressive steps to protect computers from attacks, attackers sometimes get through. Any event that results in a violation of any of the confidentiality, integrity, or availability (CIA) security tenets is a security breach.","title":"Security Breach"},{"location":"level101/security/threats_attacks_defences/#denial-of-service-attacks","text":"Denial of service (DoS) attacks result in downtime or inability of a user to access a system. DoS attacks impact the availability of tenet of information systems security. A DoS attack is a coordinated attempt to deny service by occupying a computer to perform large amounts of unnecessary tasks. This excessive activity makes the system unavailable to perform legitimate operations Two common types of DoS attacks are as follows: Logic attacks\u2014Logic attacks use software flaws to crash or seriously hinder the performance of remote servers. You can prevent many of these attacks by installing the latest patches to keep your software up to date. Flooding attacks\u2014Flooding attacks overwhelm the victim computer\u2019s CPU, memory, or network resources by sending large numbers of useless requests to the machine. Most DoS attacks target weaknesses in the overall system architecture rather than a software bug or security flaw One popular technique for launching a packet flood is a SYN flood. One of the best defences against DoS attacks is to use intrusion prevention system (IPS) software or devices to detect and stop the attack.","title":"Denial of Service Attacks"},{"location":"level101/security/threats_attacks_defences/#distributed-denial-of-service-attacks","text":"DDoS attacks differ from regular DoS attacks in their scope. In a DDoS attack, attackers hijack hundreds or even thousands of Internet computers, planting automated attack agents on those systems. The attacker then instructs the agents to bombard the target site with forged messages. This overloads the site and blocks legitimate traffic. The key here is strength in numbers. The attacker does more damage by distributing the attack across multiple computers.","title":"Distributed Denial of Service Attacks"},{"location":"level101/security/threats_attacks_defences/#wiretapping","text":"Although the term wiretapping is generally associated with voice telephone communications, attackers can also use wiretapping to intercept data communications. Attackers can tap telephone lines and data communication lines. Wiretapping can be active, where the attacker makes modifications to the line. It can also be passive, where an unauthorized user simply listens to the transmission without changing the contents. Passive intrusion can include the copying of data for a subsequent active attack. Two methods of active wiretapping are as follows: Between-the-lines wiretapping\u2014This type of wiretapping does not alter the messages sent by the legitimate user but inserts additional messages into the communication line when the legitimate user pauses. Piggyback-entry wiretapping\u2014This type of wiretapping intercepts and modifies the original message by breaking the communications line and routing the message to another computer that acts as a host.","title":"Wiretapping"},{"location":"level101/security/threats_attacks_defences/#backdoors","text":"Software developers sometimes include hidden access methods, called backdoors, in their programs. Backdoors give developers or support personnel easy access to a system without having to struggle with security controls. The problem is that backdoors don\u2019t always stay hidden. When an attacker discovers a backdoor, he or she can use it to bypass existing security controls such as passwords, encryption, and so on. Where legitimate users log on through front doors using a user ID and password, attackers use backdoors to bypass these normal access controls.","title":"Backdoors"},{"location":"level101/security/threats_attacks_defences/#malicious-attacks","text":"","title":"Malicious Attacks"},{"location":"level101/security/threats_attacks_defences/#birthday-attack","text":"Once an attacker compromises a hashed password file, a birthday attack is performed. A birthday attack is a type of cryptographic attack that is used to make a brute-force attack of one-way hashes easier. It is a mathematical exploit that is based on the birthday problem in probability theory. Further Reading: https://www.sciencedirect.com/topics/computer-science/birthday-attack https://www.internetsecurity.tips/birthday-attack/","title":"Birthday Attack"},{"location":"level101/security/threats_attacks_defences/#brute-force-password-attacks","text":"In a brute-force password attack, the attacker tries different passwords on a system until one of them is successful. Usually, the attacker employs a software program to try all possible combinations of a likely password, user ID, or security code until it locates a match. This occurs rapidly and in sequence. This type of attack is called a brute-force password attack because the attacker simply hammers away at the code. There is no skill or stealth involved\u2014just brute force that eventually breaks the code. Further Reading: https://owasp.org/www-community/attacks/Brute_force_attack https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks","title":"Brute-Force Password Attacks"},{"location":"level101/security/threats_attacks_defences/#dictionary-password-attacks","text":"A dictionary password attack is a simple attack that relies on users making poor password choices. In a dictionary password attack, a simple password-cracker program takes all the words from a dictionary file and attempts to log on by entering each dictionary entry as a password. Further Reading: https://capec.mitre.org/data/definitions/16.html","title":"Dictionary Password Attacks"},{"location":"level101/security/threats_attacks_defences/#replay-attacks","text":"Replay attacks involve capturing data packets from a network and retransmitting them to produce an unauthorized effect. The receipt of duplicate, authenticated IP packets may disrupt service or have some other undesired consequence. Systems can be broken through replay attacks when attackers reuse old messages or parts of old messages to deceive system users. This helps intruders to gain information that allows unauthorized access into a system. Further reading: https://study.com/academy/lesson/replay-attack-definition-examples-prevention.html","title":"Replay Attacks"},{"location":"level101/security/threats_attacks_defences/#man-in-the-middle-attacks","text":"A man-in-the-middle attack takes advantage of the multihop process used by many types of networks. In this type of attack, an attacker intercepts messages between two parties before transferring them on to their intended destination. Web spoofing is a type of man-in-the-middle attack in which the user believes a secure session exists with a particular web server. In reality, the secure connection exists only with the attacker, not the webserver. The attacker then establishes a secure connection with the webserver, acting as an invisible go-between. The attacker passes traffic between the user and the webserver. In this way, the attacker can trick the user into supplying passwords, credit card information, and other private data. Further Reading: https://owasp.org/www-community/attacks/Man-in-the-middle_attack","title":"Man-in-the-Middle Attacks"},{"location":"level101/security/threats_attacks_defences/#masquerading","text":"In a masquerade attack, one user or computer pretends to be another user or computer. Masquerade attacks usually include one of the other forms of active attacks, such as IP address spoofing or replaying. Attackers can capture authentication sequences and then replay them later to log on again to an application or operating system. For example, an attacker might monitor usernames and passwords sent to a weak web application. The attacker could then use the intercepted credentials to log on to the web application and impersonate the user. Further Reading: https://dl.acm.org/doi/book/10.5555/2521792 https://ieeexplore.ieee.org/document/1653228","title":"Masquerading"},{"location":"level101/security/threats_attacks_defences/#eavesdropping","text":"Eavesdropping, or sniffing, occurs when a host sets its network interface on promiscuous mode and copies packets that pass by for later analysis. Promiscuous mode enables a network device to intercept and read each network packet(of course given some conditions) given sec, even if the packet\u2019s address doesn\u2019t match the network device. It is possible to attach hardware and software to monitor and analyze all packets on that segment of the transmission media without alerting any other users. Candidates for eavesdropping include satellite, wireless, mobile, and other transmission methods.","title":"Eavesdropping"},{"location":"level101/security/threats_attacks_defences/#social-engineering","text":"Attackers often use a deception technique called social engineering to gain access to resources in an IT infrastructure. In nearly all cases, social engineering involves tricking authorized users into carrying out actions for unauthorized users. The success of social engineering attacks depends on the basic tendency of people to want to be helpful.","title":"Social Engineering"},{"location":"level101/security/threats_attacks_defences/#phreaking","text":"Phone phreaking, or simply phreaking, is a slang term that describes the activity of a subculture of people who study, experiment with, or explore telephone systems, telephone company equipment, and systems connected to public telephone networks. Phreaking is the art of exploiting bugs and glitches that exist in the telephone system.","title":"Phreaking"},{"location":"level101/security/threats_attacks_defences/#phishing","text":"Phishing is a type of fraud in which an attacker attempts to trick the victim into providing private information such as credit card numbers, passwords, dates of birth, bank account numbers, automated teller machine (ATM) PINs, and Social Security numbers.","title":"Phishing"},{"location":"level101/security/threats_attacks_defences/#pharming","text":"Pharming is another type of attack that seeks to obtain personal or private financial information through domain spoofing. A pharming attack doesn\u2019t use messages to trick victims into visiting spoofed websites that appear legitimate, however. Instead, pharming \u201cpoisons\u201d a domain name on the domain name server (DNS), a process known as DNS poisoning. The result is that when a user enters the poisoned server\u2019s web address into his or her address bar, that user navigates to the attacker\u2019s site. The user\u2019s browser still shows the correct website, which makes pharming difficult to detect\u2014and therefore more serious. Where phishing attempts to scam people one at a time with an email or instant message, pharming enables scammers to target large groups of people at one time through domain spoofing.","title":"Pharming"},{"location":"level101/security/writing_secure_code/","text":"PART IV: Writing Secure Code & More The first and most important step in reducing security and reliability issues is to educate developers. However, even the best-trained engineers make mistakes, security experts can write insecure code and SREs can miss reliability issues. It\u2019s difficult to keep the many considerations and tradeoffs involved in building secure and reliable systems in mind simultaneously, especially if you\u2019re also responsible for producing software. Use frameworks to enforce security and reliability while writing code A better approach is to handle security and reliability in common frameworks, languages, and libraries. Ideally, libraries only expose an interface that makes writing code with common classes of security vulnerabilities impossible. Multiple applications can use each library or framework. When domain experts fix an issue, they remove it from all the applications the framework supports, allowing this engineering approach to scale better. Common Security Vulnerabilities In large codebases, a handful of classes account for the majority of security vulnerabilities, despite ongoing efforts to educate developers and introduce code review. OWASP and SANS publish lists of common vulnerability classes Write Simple Code Try to keep your code clean and simple. Avoid Multi-Level Nesting Multilevel nesting is a common anti-pattern that can lead to simple mistakes. If the error is in the most common code path, it will likely be captured by the unit tests. However, unit tests don\u2019t always check error handling paths in multilevel nested code. The error might result in decreased reliability (for example, if the service crashes when it mishandles an error) or a security vulnerability (like a mishandled authorization check error). Eliminate YAGNI Smells Sometimes developers overengineer solutions by adding functionality that may be useful in the future, \u201cjust in case.\u201d This goes against the YAGNI (You Aren\u2019t Gonna Need It) principle, which recommends implementing only the code that you need. YAGNI code adds unnecessary complexity because it needs to be documented, tested, and maintained. To summarize, avoiding YAGNI code leads to improved reliability, and simpler code leads to fewer security bugs, fewer opportunities to make mistakes, and less developer time spent maintaining unused code. Repay Technical Debt It is a common practice for developers to mark places that require further attention with TODO or FIXME annotations. In the short term, this habit can accelerate the delivery velocity for the most critical functionality, and allow a team to meet early deadlines\u2014but it also incurs technical debt. Still, it\u2019s not necessarily a bad practice, as long as you have a clear process (and allocate time) for repaying such debt. Refactoring Refactoring is the most effective way to keep a codebase clean and simple. Even a healthy codebase occasionally needs to be Regardless of the reasons behind refactoring, you should always follow one golden rule: never mix refactoring and functional changes in a single commit to the code repository. Refactoring changes are typically significant and can be difficult to understand. If a commit also includes functional changes, there\u2019s a higher risk that an author or reviewer might overlook bugs. Unit Testing Unit testing can increase system security and reliability by pinpointing a wide range of bugs in individual software components before a release. This technique involves breaking software components into smaller, self-contained \u201cunits\u201d that have no external dependencies, and then testing each unit. Fuzz Testing Fuzz testing is a technique that complements the previously mentioned testing techniques. Fuzzing involves using a fuzzing engine to generate a large number of candidate inputs that are then passed through a fuzz driver to the fuzz target. The fuzzer then analyzes how the system handles the input. Complex inputs handled by all kinds of software are popular targets for fuzzing - for example, file parsers, compression algorithms, network protocol implementation and audio codec. Integration Testing Integration testing moves beyond individual units and abstractions, replacing fake or stubbed-out implementations of abstractions like databases or network services with real implementations. As a result, integration tests exercise more complete code paths. Because you must initialize and configure these other dependencies, integration testing may be slower and flakier than unit testing\u2014to execute the test, this approach incorporates real-world variables like network latency as services communicate end-to-end. As you move from testing individual low-level units of code to testing how they interact when composed together, the net result is a higher degree of confidence that the system is behaving as expected. Last But not the least Code Reviews Rely on Automation Don\u2019t check in Secrets Verifiable Builds","title":"Writing Secure code"},{"location":"level101/security/writing_secure_code/#part-iv-writing-secure-code-more","text":"The first and most important step in reducing security and reliability issues is to educate developers. However, even the best-trained engineers make mistakes, security experts can write insecure code and SREs can miss reliability issues. It\u2019s difficult to keep the many considerations and tradeoffs involved in building secure and reliable systems in mind simultaneously, especially if you\u2019re also responsible for producing software.","title":"PART IV: Writing Secure Code & More"},{"location":"level101/security/writing_secure_code/#use-frameworks-to-enforce-security-and-reliability-while-writing-code","text":"A better approach is to handle security and reliability in common frameworks, languages, and libraries. Ideally, libraries only expose an interface that makes writing code with common classes of security vulnerabilities impossible. Multiple applications can use each library or framework. When domain experts fix an issue, they remove it from all the applications the framework supports, allowing this engineering approach to scale better.","title":"Use frameworks to enforce security and reliability while writing code"},{"location":"level101/security/writing_secure_code/#common-security-vulnerabilities","text":"In large codebases, a handful of classes account for the majority of security vulnerabilities, despite ongoing efforts to educate developers and introduce code review. OWASP and SANS publish lists of common vulnerability classes","title":"Common Security Vulnerabilities"},{"location":"level101/security/writing_secure_code/#write-simple-code","text":"Try to keep your code clean and simple.","title":"Write Simple Code"},{"location":"level101/security/writing_secure_code/#avoid-multi-level-nesting","text":"Multilevel nesting is a common anti-pattern that can lead to simple mistakes. If the error is in the most common code path, it will likely be captured by the unit tests. However, unit tests don\u2019t always check error handling paths in multilevel nested code. The error might result in decreased reliability (for example, if the service crashes when it mishandles an error) or a security vulnerability (like a mishandled authorization check error).","title":"Avoid Multi-Level Nesting"},{"location":"level101/security/writing_secure_code/#eliminate-yagni-smells","text":"Sometimes developers overengineer solutions by adding functionality that may be useful in the future, \u201cjust in case.\u201d This goes against the YAGNI (You Aren\u2019t Gonna Need It) principle, which recommends implementing only the code that you need. YAGNI code adds unnecessary complexity because it needs to be documented, tested, and maintained. To summarize, avoiding YAGNI code leads to improved reliability, and simpler code leads to fewer security bugs, fewer opportunities to make mistakes, and less developer time spent maintaining unused code.","title":"Eliminate YAGNI Smells"},{"location":"level101/security/writing_secure_code/#repay-technical-debt","text":"It is a common practice for developers to mark places that require further attention with TODO or FIXME annotations. In the short term, this habit can accelerate the delivery velocity for the most critical functionality, and allow a team to meet early deadlines\u2014but it also incurs technical debt. Still, it\u2019s not necessarily a bad practice, as long as you have a clear process (and allocate time) for repaying such debt.","title":"Repay Technical Debt"},{"location":"level101/security/writing_secure_code/#refactoring","text":"Refactoring is the most effective way to keep a codebase clean and simple. Even a healthy codebase occasionally needs to be Regardless of the reasons behind refactoring, you should always follow one golden rule: never mix refactoring and functional changes in a single commit to the code repository. Refactoring changes are typically significant and can be difficult to understand. If a commit also includes functional changes, there\u2019s a higher risk that an author or reviewer might overlook bugs.","title":"Refactoring"},{"location":"level101/security/writing_secure_code/#unit-testing","text":"Unit testing can increase system security and reliability by pinpointing a wide range of bugs in individual software components before a release. This technique involves breaking software components into smaller, self-contained \u201cunits\u201d that have no external dependencies, and then testing each unit.","title":"Unit Testing"},{"location":"level101/security/writing_secure_code/#fuzz-testing","text":"Fuzz testing is a technique that complements the previously mentioned testing techniques. Fuzzing involves using a fuzzing engine to generate a large number of candidate inputs that are then passed through a fuzz driver to the fuzz target. The fuzzer then analyzes how the system handles the input. Complex inputs handled by all kinds of software are popular targets for fuzzing - for example, file parsers, compression algorithms, network protocol implementation and audio codec.","title":"Fuzz Testing"},{"location":"level101/security/writing_secure_code/#integration-testing","text":"Integration testing moves beyond individual units and abstractions, replacing fake or stubbed-out implementations of abstractions like databases or network services with real implementations. As a result, integration tests exercise more complete code paths. Because you must initialize and configure these other dependencies, integration testing may be slower and flakier than unit testing\u2014to execute the test, this approach incorporates real-world variables like network latency as services communicate end-to-end. As you move from testing individual low-level units of code to testing how they interact when composed together, the net result is a higher degree of confidence that the system is behaving as expected.","title":"Integration Testing"},{"location":"level101/security/writing_secure_code/#last-but-not-the-least","text":"Code Reviews Rely on Automation Don\u2019t check in Secrets Verifiable Builds","title":"Last But not the least"},{"location":"level101/systems_design/availability/","text":"HA - Availability - Common \u201cNines\u201d Availability is generally expressed as \u201cNines\u201d, common \u2018Nines\u2019 are listed below. Availability % Downtime per year Downtime per month Downtime per week Downtime per day 99%(Two Nines) 3.65 days 7.31 hours 1.68 hours 14.40 minutes 99.5%(Two and a half Nines) 1.83 days 3.65 hours 50.40 minutes 7.20 minutes 99.9%(Three Nines) 8.77 hours 43.83 minutes 10.08 minutes 1.44 minutes 99.95%(Three and a half Nines) 4.38 hours 21.92 minutes 5.04 minutes 43.20 seconds 99.99%(Four Nines) 52.60 minutes 4.38 minutes 1.01 minutes 8.64 seconds 99.995%(Four and a half Nines) 26.30 minutes 2.19 minutes 30.24 seconds 4.32 seconds 99.999%(Five Nines) 5.26 minutes 26.30 seconds 6.05 seconds 864.0 ms Refer https://en.wikipedia.org/wiki/High_availability#Percentage_calculation HA - Availability Serial Components A System with components is operating in the series If the failure of a part leads to the combination becoming inoperable. For example, if LB in our architecture fails, all access to app tiers will fail. LB and app tiers are connected serially. The combined availability of the system is the product of individual components availability A = Ax x Ay x \u2026.. Refer http://www.eventhelix.com/RealtimeMantra/FaultHandling/system_reliability_availability.htm HA - Availability Parallel Components A System with components is operating in parallel If the failure of a part leads to the other part taking over the operations of the failed part. If we have more than one LB and if the rest of the LBs can take over the traffic during one LB failure then LBs are operating in parallel The combined availability of the system is A = 1 - ( (1-Ax) x (1-Ax) x \u2026.. ) Refer http://www.eventhelix.com/RealtimeMantra/FaultHandling/system_reliability_availability.htm HA - Core Principles Elimination of single points of failure (SPOF) This means adding redundancy to the system so that the failure of a component does not mean failure of the entire system. Reliable crossover In redundant systems, the crossover point itself tends to become a single point of failure. Reliable systems must provide for reliable crossover. Detection of failures as they occur If the two principles above are observed, then a user may never see a failure Refer https://en.wikipedia.org/wiki/High_availability#Principles HA - SPOF WHAT: Never implement and always eliminate single points of failure. WHEN TO USE: During architecture reviews and new designs. HOW TO USE: Identify single instances on architectural diagrams. Strive for active/active configurations. At the very least we should have a standby to take control when active instances fail. WHY: Maximize availability through multiple instances. KEY TAKEAWAYS: Strive for active/active rather than active/passive solutions. Use load balancers to balance traffic across instances of a service. Use control services with active/passive instances for patterns that require singletons. HA - Reliable Crossover WHAT: Ensure when system components failover they do so reliably. WHEN TO USE: During architecture reviews, failure modeling, and designs. HOW TO USE: Identify how available a system is during the crossover and ensure it is within acceptable limits. WHY: Maximize availability and ensure data handling semantics are preserved. KEY TAKEAWAYS: Strive for active/active rather than active/passive solutions, they have a lesser risk of cross over being unreliable. Use LB and the right load balancing methods to ensure reliable failover. Model and build your data systems to ensure data is correctly handled when crossover happens. Generally, DB systems follow active/passive semantics for writes. Masters accept writes and when the master goes down, the follower is promoted to master(active from being passive) to accept writes. We have to be careful here that the cutover never introduces more than one master. This problem is called a split brain. Applications in SRE role SRE works on deciding an acceptable SLA and make sure the system is available to achieve the SLA SRE is involved in architecture design right from building the data center to make sure the site is not affected by a network switch, hardware, power, or software failures SRE also run mock drills of failures to see how the system behaves in uncharted territory and comes up with a plan to improve availability if there are misses. https://engineering.linkedin.com/blog/2017/11/resilience-engineering-at-linkedin-with-project-waterbear Post our understanding about HA, our architecture diagram looks something like this below","title":"Availability"},{"location":"level101/systems_design/availability/#ha-availability-common-nines","text":"Availability is generally expressed as \u201cNines\u201d, common \u2018Nines\u2019 are listed below. Availability % Downtime per year Downtime per month Downtime per week Downtime per day 99%(Two Nines) 3.65 days 7.31 hours 1.68 hours 14.40 minutes 99.5%(Two and a half Nines) 1.83 days 3.65 hours 50.40 minutes 7.20 minutes 99.9%(Three Nines) 8.77 hours 43.83 minutes 10.08 minutes 1.44 minutes 99.95%(Three and a half Nines) 4.38 hours 21.92 minutes 5.04 minutes 43.20 seconds 99.99%(Four Nines) 52.60 minutes 4.38 minutes 1.01 minutes 8.64 seconds 99.995%(Four and a half Nines) 26.30 minutes 2.19 minutes 30.24 seconds 4.32 seconds 99.999%(Five Nines) 5.26 minutes 26.30 seconds 6.05 seconds 864.0 ms","title":"HA - Availability - Common \u201cNines\u201d"},{"location":"level101/systems_design/availability/#refer","text":"https://en.wikipedia.org/wiki/High_availability#Percentage_calculation","title":"Refer"},{"location":"level101/systems_design/availability/#ha-availability-serial-components","text":"A System with components is operating in the series If the failure of a part leads to the combination becoming inoperable. For example, if LB in our architecture fails, all access to app tiers will fail. LB and app tiers are connected serially. The combined availability of the system is the product of individual components availability A = Ax x Ay x \u2026..","title":"HA - Availability Serial Components"},{"location":"level101/systems_design/availability/#refer_1","text":"http://www.eventhelix.com/RealtimeMantra/FaultHandling/system_reliability_availability.htm","title":"Refer"},{"location":"level101/systems_design/availability/#ha-availability-parallel-components","text":"A System with components is operating in parallel If the failure of a part leads to the other part taking over the operations of the failed part. If we have more than one LB and if the rest of the LBs can take over the traffic during one LB failure then LBs are operating in parallel The combined availability of the system is A = 1 - ( (1-Ax) x (1-Ax) x \u2026.. )","title":"HA - Availability Parallel Components"},{"location":"level101/systems_design/availability/#refer_2","text":"http://www.eventhelix.com/RealtimeMantra/FaultHandling/system_reliability_availability.htm","title":"Refer"},{"location":"level101/systems_design/availability/#ha-core-principles","text":"Elimination of single points of failure (SPOF) This means adding redundancy to the system so that the failure of a component does not mean failure of the entire system. Reliable crossover In redundant systems, the crossover point itself tends to become a single point of failure. Reliable systems must provide for reliable crossover. Detection of failures as they occur If the two principles above are observed, then a user may never see a failure","title":"HA - Core Principles"},{"location":"level101/systems_design/availability/#refer_3","text":"https://en.wikipedia.org/wiki/High_availability#Principles","title":"Refer"},{"location":"level101/systems_design/availability/#ha-spof","text":"WHAT: Never implement and always eliminate single points of failure. WHEN TO USE: During architecture reviews and new designs. HOW TO USE: Identify single instances on architectural diagrams. Strive for active/active configurations. At the very least we should have a standby to take control when active instances fail. WHY: Maximize availability through multiple instances. KEY TAKEAWAYS: Strive for active/active rather than active/passive solutions. Use load balancers to balance traffic across instances of a service. Use control services with active/passive instances for patterns that require singletons.","title":"HA - SPOF"},{"location":"level101/systems_design/availability/#ha-reliable-crossover","text":"WHAT: Ensure when system components failover they do so reliably. WHEN TO USE: During architecture reviews, failure modeling, and designs. HOW TO USE: Identify how available a system is during the crossover and ensure it is within acceptable limits. WHY: Maximize availability and ensure data handling semantics are preserved. KEY TAKEAWAYS: Strive for active/active rather than active/passive solutions, they have a lesser risk of cross over being unreliable. Use LB and the right load balancing methods to ensure reliable failover. Model and build your data systems to ensure data is correctly handled when crossover happens. Generally, DB systems follow active/passive semantics for writes. Masters accept writes and when the master goes down, the follower is promoted to master(active from being passive) to accept writes. We have to be careful here that the cutover never introduces more than one master. This problem is called a split brain.","title":"HA - Reliable Crossover"},{"location":"level101/systems_design/availability/#applications-in-sre-role","text":"SRE works on deciding an acceptable SLA and make sure the system is available to achieve the SLA SRE is involved in architecture design right from building the data center to make sure the site is not affected by a network switch, hardware, power, or software failures SRE also run mock drills of failures to see how the system behaves in uncharted territory and comes up with a plan to improve availability if there are misses. https://engineering.linkedin.com/blog/2017/11/resilience-engineering-at-linkedin-with-project-waterbear Post our understanding about HA, our architecture diagram looks something like this below","title":"Applications in SRE role"},{"location":"level101/systems_design/conclusion/","text":"Conclusion Armed with these principles, we hope the course will give a fresh perspective to design software systems. It might be over-engineering to get all this on day zero. But some are really important from day 0 like eliminating single points of failure, making scalable services by just increasing replicas. As a bottleneck is reached, we can split code by services, shard data to scale. As the organization matures, bringing in chaos engineering to measure how systems react to failure will help in designing robust software systems.","title":"Conclusion"},{"location":"level101/systems_design/conclusion/#conclusion","text":"Armed with these principles, we hope the course will give a fresh perspective to design software systems. It might be over-engineering to get all this on day zero. But some are really important from day 0 like eliminating single points of failure, making scalable services by just increasing replicas. As a bottleneck is reached, we can split code by services, shard data to scale. As the organization matures, bringing in chaos engineering to measure how systems react to failure will help in designing robust software systems.","title":"Conclusion"},{"location":"level101/systems_design/fault-tolerance/","text":"Fault Tolerance Failures are not avoidable in any system and will happen all the time, hence we need to build systems that can tolerate failures or recover from them. In systems, failure is the norm rather than the exception. \"Anything that can go wrong will go wrong\u201d -- Murphy\u2019s Law \u201cComplex systems contain changing mixtures of failures latent within them\u201d -- How Complex Systems Fail. Fault Tolerance - Failure Metrics Common failure metrics that get measured and tracked for any system. Mean time to repair (MTTR): The average time to repair and restore a failed system. Mean time between failures (MTBF): The average operational time between one device failure or system breakdown and the next. Mean time to failure (MTTF): The average time a device or system is expected to function before it fails. Mean time to detect (MTTD): The average time between the onset of a problem and when the organization detects it. Mean time to investigate (MTTI): The average time between the detection of an incident and when the organization begins to investigate its cause and solution. Mean time to restore service (MTRS): The average elapsed time from the detection of an incident until the affected system or component is again available to users. Mean time between system incidents (MTBSI): The average elapsed time between the detection of two consecutive incidents. MTBSI can be calculated by adding MTBF and MTRS (MTBSI = MTBF + MTRS). Failure rate: Another reliability metric, which measures the frequency with which a component or system fails. It is expressed as a number of failures over a unit of time. Refer https://www.splunk.com/en_us/data-insider/what-is-mean-time-to-repair.html Fault Tolerance - Fault Isolation Terms Systems should have a short circuit. Say in our content sharing system, if \u201cNotifications\u201d is not working, the site should gracefully handle that failure by removing the functionality instead of taking the whole site down. Swimlane is one of the commonly used fault isolation methodologies. Swimlane adds a barrier to the service from other services so that failure on either of them won\u2019t affect the other. Say we roll out a new feature \u2018Advertisement\u2019 in our content sharing app. We can have two architectures If Ads are generated on the fly synchronously during each Newsfeed request, the faults in the Ads feature get propagated to the Newsfeed feature. Instead if we swimlane the \u201cGeneration of Ads\u201d service and use a shared storage to populate Newsfeed App, Ads failures won\u2019t cascade to Newsfeed, and worst case if Ads don\u2019t meet SLA , we can have Newsfeed without Ads. Let's take another example, we have come up with a new model for our Content sharing App. Here we roll out an enterprise content sharing App where enterprises pay for the service and the content should never be shared outside the enterprise. Swimlane Principles Principle 1: Nothing is shared (also known as \u201cshare as little as possible\u201d). The less that is shared within a swim lane, the more fault isolative the swim lane becomes. (as shown in Enterprise use-case) Principle 2: Nothing crosses a swim lane boundary. Synchronous (defined by expecting a request\u2014not the transfer protocol) communication never crosses a swim lane boundary; if it does, the boundary is drawn incorrectly. (as shown in Ads feature) Swimlane Approaches Approach 1: Swim lane the money-maker. Never allow your cash register to be compromised by other systems. (Tier 1 vs Tier 2 in enterprise use case) Approach 2: Swim lane the biggest sources of incidents. Identify the recurring causes of pain and isolate them. (if Ads feature is in code yellow, swim laning it is the best option) Approach 3: Swim lane natural barriers. Customer boundaries make good swim lanes. (Public vs Enterprise customers) Refer https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch21.html#ch21 Applications in SRE role Work with the DC tech or cloud team to distribute infrastructure such that its immune to switch or power failures by creating fault zones within a Data Center https://docs.microsoft.com/en-us/azure/virtual-machines/manage-availability#use-availability-zones-to-protect-from-datacenter-level-failures Work with the partners and design interaction between services such that one service breakdown is not amplified in a cascading fashion to all upstreams","title":"Fault Tolerance"},{"location":"level101/systems_design/fault-tolerance/#fault-tolerance","text":"Failures are not avoidable in any system and will happen all the time, hence we need to build systems that can tolerate failures or recover from them. In systems, failure is the norm rather than the exception. \"Anything that can go wrong will go wrong\u201d -- Murphy\u2019s Law \u201cComplex systems contain changing mixtures of failures latent within them\u201d -- How Complex Systems Fail.","title":"Fault Tolerance"},{"location":"level101/systems_design/fault-tolerance/#fault-tolerance-failure-metrics","text":"Common failure metrics that get measured and tracked for any system. Mean time to repair (MTTR): The average time to repair and restore a failed system. Mean time between failures (MTBF): The average operational time between one device failure or system breakdown and the next. Mean time to failure (MTTF): The average time a device or system is expected to function before it fails. Mean time to detect (MTTD): The average time between the onset of a problem and when the organization detects it. Mean time to investigate (MTTI): The average time between the detection of an incident and when the organization begins to investigate its cause and solution. Mean time to restore service (MTRS): The average elapsed time from the detection of an incident until the affected system or component is again available to users. Mean time between system incidents (MTBSI): The average elapsed time between the detection of two consecutive incidents. MTBSI can be calculated by adding MTBF and MTRS (MTBSI = MTBF + MTRS). Failure rate: Another reliability metric, which measures the frequency with which a component or system fails. It is expressed as a number of failures over a unit of time.","title":"Fault Tolerance - Failure Metrics"},{"location":"level101/systems_design/fault-tolerance/#refer","text":"https://www.splunk.com/en_us/data-insider/what-is-mean-time-to-repair.html","title":"Refer"},{"location":"level101/systems_design/fault-tolerance/#fault-tolerance-fault-isolation-terms","text":"Systems should have a short circuit. Say in our content sharing system, if \u201cNotifications\u201d is not working, the site should gracefully handle that failure by removing the functionality instead of taking the whole site down. Swimlane is one of the commonly used fault isolation methodologies. Swimlane adds a barrier to the service from other services so that failure on either of them won\u2019t affect the other. Say we roll out a new feature \u2018Advertisement\u2019 in our content sharing app. We can have two architectures If Ads are generated on the fly synchronously during each Newsfeed request, the faults in the Ads feature get propagated to the Newsfeed feature. Instead if we swimlane the \u201cGeneration of Ads\u201d service and use a shared storage to populate Newsfeed App, Ads failures won\u2019t cascade to Newsfeed, and worst case if Ads don\u2019t meet SLA , we can have Newsfeed without Ads. Let's take another example, we have come up with a new model for our Content sharing App. Here we roll out an enterprise content sharing App where enterprises pay for the service and the content should never be shared outside the enterprise.","title":"Fault Tolerance - Fault Isolation Terms"},{"location":"level101/systems_design/fault-tolerance/#swimlane-principles","text":"Principle 1: Nothing is shared (also known as \u201cshare as little as possible\u201d). The less that is shared within a swim lane, the more fault isolative the swim lane becomes. (as shown in Enterprise use-case) Principle 2: Nothing crosses a swim lane boundary. Synchronous (defined by expecting a request\u2014not the transfer protocol) communication never crosses a swim lane boundary; if it does, the boundary is drawn incorrectly. (as shown in Ads feature)","title":"Swimlane Principles"},{"location":"level101/systems_design/fault-tolerance/#swimlane-approaches","text":"Approach 1: Swim lane the money-maker. Never allow your cash register to be compromised by other systems. (Tier 1 vs Tier 2 in enterprise use case) Approach 2: Swim lane the biggest sources of incidents. Identify the recurring causes of pain and isolate them. (if Ads feature is in code yellow, swim laning it is the best option) Approach 3: Swim lane natural barriers. Customer boundaries make good swim lanes. (Public vs Enterprise customers)","title":"Swimlane Approaches"},{"location":"level101/systems_design/fault-tolerance/#refer_1","text":"https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch21.html#ch21","title":"Refer"},{"location":"level101/systems_design/fault-tolerance/#applications-in-sre-role","text":"Work with the DC tech or cloud team to distribute infrastructure such that its immune to switch or power failures by creating fault zones within a Data Center https://docs.microsoft.com/en-us/azure/virtual-machines/manage-availability#use-availability-zones-to-protect-from-datacenter-level-failures Work with the partners and design interaction between services such that one service breakdown is not amplified in a cascading fashion to all upstreams","title":"Applications in SRE role"},{"location":"level101/systems_design/intro/","text":"Systems Design Prerequisites Fundamentals of common software system components: Linux Basics Linux Networking Databases RDBMS NoSQL Concepts What to expect from this course Thinking about and designing for scalability, availability, and reliability of large scale software systems. What is not covered under this course Individual software components\u2019 scalability and reliability concerns like e.g. Databases, while the same scalability principles and thinking can be applied, these individual components have their own specific nuances when scaling them and thinking about their reliability. More light will be shed on concepts rather than on setting up and configuring components like Loadbalancers to achieve scalability, availability, and reliability of systems Course Contents Introduction Scalability High Availability Fault Tolerance Introduction So, how do you go about learning to design a system? \u201d Like most great questions, it showed a level of naivety that was breathtaking. The only short answer I could give was, essentially, that you learned how to design a system by designing systems and finding out what works and what doesn\u2019t work.\u201d Jim Waldo, Sun Microsystems, On System Design As software and hardware systems have multiple moving parts, we need to think about how those parts will grow, their failure modes, their inter-dependencies, how it will impact the users and the business. There is no one-shot method or way to learn or do system design, we only learn to design systems by designing and iterating on them. This course will be a starter to make one think about scalability, availability, and fault tolerance during systems design. Backstory Let\u2019s design a simple content sharing application where users can share photos, media in our application which can be liked by their friends. Let\u2019s start with a simple design of the application and evolve it as we learn system design concepts","title":"Introduction"},{"location":"level101/systems_design/intro/#systems-design","text":"","title":"Systems Design"},{"location":"level101/systems_design/intro/#prerequisites","text":"Fundamentals of common software system components: Linux Basics Linux Networking Databases RDBMS NoSQL Concepts","title":"Prerequisites"},{"location":"level101/systems_design/intro/#what-to-expect-from-this-course","text":"Thinking about and designing for scalability, availability, and reliability of large scale software systems.","title":"What to expect from this course"},{"location":"level101/systems_design/intro/#what-is-not-covered-under-this-course","text":"Individual software components\u2019 scalability and reliability concerns like e.g. Databases, while the same scalability principles and thinking can be applied, these individual components have their own specific nuances when scaling them and thinking about their reliability. More light will be shed on concepts rather than on setting up and configuring components like Loadbalancers to achieve scalability, availability, and reliability of systems","title":"What is not covered under this course"},{"location":"level101/systems_design/intro/#course-contents","text":"Introduction Scalability High Availability Fault Tolerance","title":"Course Contents"},{"location":"level101/systems_design/intro/#introduction","text":"So, how do you go about learning to design a system? \u201d Like most great questions, it showed a level of naivety that was breathtaking. The only short answer I could give was, essentially, that you learned how to design a system by designing systems and finding out what works and what doesn\u2019t work.\u201d Jim Waldo, Sun Microsystems, On System Design As software and hardware systems have multiple moving parts, we need to think about how those parts will grow, their failure modes, their inter-dependencies, how it will impact the users and the business. There is no one-shot method or way to learn or do system design, we only learn to design systems by designing and iterating on them. This course will be a starter to make one think about scalability, availability, and fault tolerance during systems design.","title":"Introduction"},{"location":"level101/systems_design/intro/#backstory","text":"Let\u2019s design a simple content sharing application where users can share photos, media in our application which can be liked by their friends. Let\u2019s start with a simple design of the application and evolve it as we learn system design concepts","title":"Backstory"},{"location":"level101/systems_design/scalability/","text":"Scalability What does scalability mean for a system/service? A system is composed of services/components, each service/component scalability needs to be tackled separately, and the scalability of the system as a whole. A service is said to be scalable if, as resources are added to the system, it results in increased performance in a manner proportional to resources added An always-on service is said to be scalable if adding resources to facilitate redundancy does not result in a loss of performance Refer https://www.allthingsdistributed.com/2006/03/a_word_on_scalability.html Scalability - AKF Scale Cube The Scale Cube is a model for segmenting services, defining microservices, and scaling products. It also creates a common language for teams to discuss scale related options in designing solutions. The following section talks about certain scaling patterns based on our inferences from the AKF cube Scalability - Horizontal scaling Horizontal scaling stands for cloning of an application or service such that work can easily be distributed across instances with absolutely no bias. Let's see how our monolithic application improves with this principle Here DB is scaled separately from the application. This is to let you know each component\u2019s scaling capabilities can be different. Usually, web applications can be scaled by adding resources unless there is state stored inside the application. But DBs can be scaled only for Reads by adding more followers but Writes have to go to only one leader to make sure data is consistent. There are some DBs that support multi-leader writes but we are keeping them out of scope at this point. Apps should be able to differentiate between Reads and Writes to choose appropriate DB servers. Load balancers can split traffic between identical servers transparently. WHAT: Duplication of services or databases to spread transaction load. WHEN TO USE: Databases with a very high read-to-write ratio (5:1 or greater\u2014the higher the better). Because only read replicas of DBs can be scaled, not the Leader. HOW TO USE: Simply clone services and implement a load balancer. For databases, ensure that the accessing code understands the difference between a read and a write. WHY: Allows for the fast scale of transactions at the cost of duplicated data and functionality. KEY TAKEAWAYS: This is fast to implement, is a low cost from a developer effort perspective, and can scale transaction volumes nicely. However, they tend to be high cost from the perspective of the operational cost of data. The cost here means if we have 3 followers and 1 Leader DB, the same database will be stored as 4 copies in the 4 servers. Hence added storage cost Refer https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html Scalability Pattern - Load Balancing Improves the distribution of workloads across multiple computing resources, such as computers, a computer cluster, network links, central processing units, or disk drives. A commonly used technique is load balancing traffic across identical server clusters. A similar philosophy is used to load balance traffic across network links by ECMP , disk drives by RAID ,etc Aims to optimize resource use, maximize throughput, minimize response time, and avoid overload of any single resource. Using multiple components with load balancing instead of a single component may increase reliability and availability through redundancy. In our updated architecture diagram we have 4 servers to handle app traffic instead of a single server The device or system that performs load balancing is called a load balancer, abbreviated as LB. Refer https://en.wikipedia.org/wiki/Load_balancing_(computing) https://blog.envoyproxy.io/introduction-to-modern-network-load-balancing-and-proxying-a57f6ff80236 https://learning.oreilly.com/library/view/load-balancing-in/9781492038009/ https://learning.oreilly.com/library/view/practical-load-balancing/9781430236801/ http://shop.oreilly.com/product/9780596000509.do Scalability Pattern - LB Tasks What does an LB do? Service discovery: What backends are available in the system? In our architecture, 4 servers are available to serve App traffic. LB acts as a single endpoint that clients can use transparently to reach one of the 4 servers. Health checking: What backends are currently healthy and available to accept requests? If one out of the 4 App servers turns bad, LB should automatically short circuit the path so that clients don\u2019t sense any application downtime Load balancing: What algorithm should be used to balance individual requests across the healthy backends? There are many algorithms to distribute traffic across one of the four servers. Based on observations/experience, SRE can pick the algorithm that suits their pattern Scalability Pattern - LB Methods Common Load Balancing Methods Least Connection Method directs traffic to the server with the fewest active connections. Most useful when there are a large number of persistent connections in the traffic unevenly distributed between the servers. Works if clients maintain long-lived connections Least Response Time Method directs traffic to the server with the fewest active connections and the lowest average response time. Here response time is used to provide feedback of the server\u2019s health Round Robin Method rotates servers by directing traffic to the first available server and then moves that server to the bottom of the queue. Most useful when servers are of equal specification and there are not many persistent connections. IP Hash the IP address of the client determines which server receives the request. This can sometimes cause skewness in distribution but is useful if apps store some state locally and need some stickiness More advanced client/server-side example techniques - https://docs.nginx.com/nginx/admin-guide/load-balancer/ - http://cbonte.github.io/haproxy-dconv/2.2/intro.html#3.3.5 - https://twitter.github.io/finagle/guide/Clients.html#load-balancing Scalability Pattern - Caching - Content Delivery Networks (CDN) CDNs are added closer to the client\u2019s location. If the app has static data like images, Javascript, CSS which don\u2019t change very often, they can be cached. Since our example is a content sharing site, static content can be cached in CDNs with a suitable expiry. WHAT: Use CDNs (content delivery networks) to offload traffic from your site. WHEN TO USE: When speed improvements and scale warrant the additional cost. HOW TO USE: Most CDNs leverage DNS to serve content on your site\u2019s behalf. Thus you may need to make minor DNS changes or additions and move content to be served from new subdomains. Eg media-exp1.licdn.com is a domain used by Linkedin to serve static content Here a CNAME points the domain to the DNS of the CDN provider dig media-exp1.licdn.com +short 2-01-2c3e-005c.cdx.cedexis.net. WHY: CDNs help offload traffic spikes and are often economical ways to scale parts of a site\u2019s traffic. They also often substantially improve page download times. KEY TAKEAWAYS: CDNs are a fast and simple way to offset the spikiness of traffic as well as traffic growth in general. Make sure you perform a cost-benefit analysis and monitor the CDN usage. If CDNs have a lot of cache misses, then we don\u2019t gain much from CDN and are still serving requests using our compute resources. Scalability - Microservices This pattern represents the separation of work by service or function within the application. Microservices are meant to address the issues associated with growth and complexity in the code base and data sets. The intent is to create fault isolation as well as to reduce response times. Microservices can scale transactions, data sizes, and codebase sizes. They are most effective in scaling the size and complexity of your codebase. They tend to cost a bit more than horizontal scaling because the engineering team needs to rewrite services or, at the very least, disaggregate them from the original monolithic application. WHAT: Sometimes referred to as scale through services or resources, this rule focuses on scaling by splitting data sets, transactions, and engineering teams along verb (services) or noun (resources) boundaries. WHEN TO USE: Very large data sets where relations between data are not necessary. Large, complex systems where scaling engineering resources requires specialization. HOW TO USE: Split up actions by using verbs, or resources by using nouns, or use a mix. Split both the services and the data along the lines defined by the verb/noun approach. WHY: Allows for efficient scaling of not only transactions but also very large data sets associated with those transactions. It also allows for the efficient scaling of teams. KEY TAKEAWAYS: Microservices allow for efficient scaling of transactions, large data sets, and can help with fault isolation. It helps reduce the communication overhead of teams. The codebase becomes less complex as disjoint features are decoupled and spun as new services thereby letting each service scale independently specific to its requirement. Refer https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html Scalability - Sharding This pattern represents the separation of work based on attributes that are looked up to or determined at the time of the transaction. Most often, these are implemented as splits by requestor, customer, or client. Very often, a lookup service or deterministic algorithm will need to be written for these types of splits. Sharding aids in scaling transaction growth, scaling instruction sets, and decreasing processing time (the last by limiting the data necessary to perform any transaction). This is more effective at scaling growth in customers or clients. It can aid with disaster recovery efforts, and limit the impact of incidents to only a specific segment of customers. Here the auth data is sharded based on user names so that DBs can respond faster as the amount of data DBs have to work on has drastically reduced during queries. There can be other ways to split Here the whole data center is split and replicated and clients are directed to a data center based on their geography. This helps in improving performance as clients are directed to the closest data center and performance increases as we add more data centers. There are some replication and consistency overhead with this approach one needs to be aware of. This also gives fault tolerance by rolling out test features to one site and rollback if there is an impact to that geography WHAT: This is very often a split by some unique aspect of the customer such as customer ID, name, geography, and so on. WHEN TO USE: Very large, similar data sets such as large and rapidly growing customer bases or when the response time for a geographically distributed customer base is important. HOW TO USE: Identify something you know about the customer, such as customer ID, last name, geography, or device, and split or partition both data and services based on that attribute. WHY: Rapid customer growth exceeds other forms of data growth, or you have the need to perform fault isolation between certain customer groups as you scale. KEY TAKEAWAYS: Shards are effective at helping you to scale customer bases but can also be applied to other very large data sets that can\u2019t be pulled apart using the microservices methodology. Refer https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html Applications in SRE role SREs in coordination with the network team work on how to map users' traffic to a particular site. https://engineering.linkedin.com/blog/2017/05/trafficshift--load-testing-at-scale SREs work closely with the Dev team to split monoliths to multiple microservices that are easy to run and manage SREs work on improving Load Balancers' reliability, service discovery, and performance SREs work closely to split Data into shards and manage data integrity and consistency. https://engineering.linkedin.com/espresso/introducing-espresso-linkedins-hot-new-distributed-document-store SREs work to set up, configure, and improve the CDN cache hit rate.","title":"Scalability"},{"location":"level101/systems_design/scalability/#scalability","text":"What does scalability mean for a system/service? A system is composed of services/components, each service/component scalability needs to be tackled separately, and the scalability of the system as a whole. A service is said to be scalable if, as resources are added to the system, it results in increased performance in a manner proportional to resources added An always-on service is said to be scalable if adding resources to facilitate redundancy does not result in a loss of performance","title":"Scalability"},{"location":"level101/systems_design/scalability/#refer","text":"https://www.allthingsdistributed.com/2006/03/a_word_on_scalability.html","title":"Refer"},{"location":"level101/systems_design/scalability/#scalability-akf-scale-cube","text":"The Scale Cube is a model for segmenting services, defining microservices, and scaling products. It also creates a common language for teams to discuss scale related options in designing solutions. The following section talks about certain scaling patterns based on our inferences from the AKF cube","title":"Scalability - AKF Scale Cube"},{"location":"level101/systems_design/scalability/#scalability-horizontal-scaling","text":"Horizontal scaling stands for cloning of an application or service such that work can easily be distributed across instances with absolutely no bias. Let's see how our monolithic application improves with this principle Here DB is scaled separately from the application. This is to let you know each component\u2019s scaling capabilities can be different. Usually, web applications can be scaled by adding resources unless there is state stored inside the application. But DBs can be scaled only for Reads by adding more followers but Writes have to go to only one leader to make sure data is consistent. There are some DBs that support multi-leader writes but we are keeping them out of scope at this point. Apps should be able to differentiate between Reads and Writes to choose appropriate DB servers. Load balancers can split traffic between identical servers transparently. WHAT: Duplication of services or databases to spread transaction load. WHEN TO USE: Databases with a very high read-to-write ratio (5:1 or greater\u2014the higher the better). Because only read replicas of DBs can be scaled, not the Leader. HOW TO USE: Simply clone services and implement a load balancer. For databases, ensure that the accessing code understands the difference between a read and a write. WHY: Allows for the fast scale of transactions at the cost of duplicated data and functionality. KEY TAKEAWAYS: This is fast to implement, is a low cost from a developer effort perspective, and can scale transaction volumes nicely. However, they tend to be high cost from the perspective of the operational cost of data. The cost here means if we have 3 followers and 1 Leader DB, the same database will be stored as 4 copies in the 4 servers. Hence added storage cost","title":"Scalability - Horizontal scaling"},{"location":"level101/systems_design/scalability/#refer_1","text":"https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html","title":"Refer"},{"location":"level101/systems_design/scalability/#scalability-pattern-load-balancing","text":"Improves the distribution of workloads across multiple computing resources, such as computers, a computer cluster, network links, central processing units, or disk drives. A commonly used technique is load balancing traffic across identical server clusters. A similar philosophy is used to load balance traffic across network links by ECMP , disk drives by RAID ,etc Aims to optimize resource use, maximize throughput, minimize response time, and avoid overload of any single resource. Using multiple components with load balancing instead of a single component may increase reliability and availability through redundancy. In our updated architecture diagram we have 4 servers to handle app traffic instead of a single server The device or system that performs load balancing is called a load balancer, abbreviated as LB.","title":"Scalability Pattern - Load Balancing"},{"location":"level101/systems_design/scalability/#refer_2","text":"https://en.wikipedia.org/wiki/Load_balancing_(computing) https://blog.envoyproxy.io/introduction-to-modern-network-load-balancing-and-proxying-a57f6ff80236 https://learning.oreilly.com/library/view/load-balancing-in/9781492038009/ https://learning.oreilly.com/library/view/practical-load-balancing/9781430236801/ http://shop.oreilly.com/product/9780596000509.do","title":"Refer"},{"location":"level101/systems_design/scalability/#scalability-pattern-lb-tasks","text":"What does an LB do?","title":"Scalability Pattern - LB Tasks"},{"location":"level101/systems_design/scalability/#service-discovery","text":"What backends are available in the system? In our architecture, 4 servers are available to serve App traffic. LB acts as a single endpoint that clients can use transparently to reach one of the 4 servers.","title":"Service discovery:"},{"location":"level101/systems_design/scalability/#health-checking","text":"What backends are currently healthy and available to accept requests? If one out of the 4 App servers turns bad, LB should automatically short circuit the path so that clients don\u2019t sense any application downtime","title":"Health checking:"},{"location":"level101/systems_design/scalability/#load-balancing","text":"What algorithm should be used to balance individual requests across the healthy backends? There are many algorithms to distribute traffic across one of the four servers. Based on observations/experience, SRE can pick the algorithm that suits their pattern","title":"Load balancing:"},{"location":"level101/systems_design/scalability/#scalability-pattern-lb-methods","text":"Common Load Balancing Methods","title":"Scalability Pattern - LB Methods"},{"location":"level101/systems_design/scalability/#least-connection-method","text":"directs traffic to the server with the fewest active connections. Most useful when there are a large number of persistent connections in the traffic unevenly distributed between the servers. Works if clients maintain long-lived connections","title":"Least Connection Method"},{"location":"level101/systems_design/scalability/#least-response-time-method","text":"directs traffic to the server with the fewest active connections and the lowest average response time. Here response time is used to provide feedback of the server\u2019s health","title":"Least Response Time Method"},{"location":"level101/systems_design/scalability/#round-robin-method","text":"rotates servers by directing traffic to the first available server and then moves that server to the bottom of the queue. Most useful when servers are of equal specification and there are not many persistent connections.","title":"Round Robin Method"},{"location":"level101/systems_design/scalability/#ip-hash","text":"the IP address of the client determines which server receives the request. This can sometimes cause skewness in distribution but is useful if apps store some state locally and need some stickiness More advanced client/server-side example techniques - https://docs.nginx.com/nginx/admin-guide/load-balancer/ - http://cbonte.github.io/haproxy-dconv/2.2/intro.html#3.3.5 - https://twitter.github.io/finagle/guide/Clients.html#load-balancing","title":"IP Hash"},{"location":"level101/systems_design/scalability/#scalability-pattern-caching-content-delivery-networks-cdn","text":"CDNs are added closer to the client\u2019s location. If the app has static data like images, Javascript, CSS which don\u2019t change very often, they can be cached. Since our example is a content sharing site, static content can be cached in CDNs with a suitable expiry. WHAT: Use CDNs (content delivery networks) to offload traffic from your site. WHEN TO USE: When speed improvements and scale warrant the additional cost. HOW TO USE: Most CDNs leverage DNS to serve content on your site\u2019s behalf. Thus you may need to make minor DNS changes or additions and move content to be served from new subdomains. Eg media-exp1.licdn.com is a domain used by Linkedin to serve static content Here a CNAME points the domain to the DNS of the CDN provider dig media-exp1.licdn.com +short 2-01-2c3e-005c.cdx.cedexis.net. WHY: CDNs help offload traffic spikes and are often economical ways to scale parts of a site\u2019s traffic. They also often substantially improve page download times. KEY TAKEAWAYS: CDNs are a fast and simple way to offset the spikiness of traffic as well as traffic growth in general. Make sure you perform a cost-benefit analysis and monitor the CDN usage. If CDNs have a lot of cache misses, then we don\u2019t gain much from CDN and are still serving requests using our compute resources.","title":"Scalability Pattern - Caching - Content Delivery Networks (CDN)"},{"location":"level101/systems_design/scalability/#scalability-microservices","text":"This pattern represents the separation of work by service or function within the application. Microservices are meant to address the issues associated with growth and complexity in the code base and data sets. The intent is to create fault isolation as well as to reduce response times. Microservices can scale transactions, data sizes, and codebase sizes. They are most effective in scaling the size and complexity of your codebase. They tend to cost a bit more than horizontal scaling because the engineering team needs to rewrite services or, at the very least, disaggregate them from the original monolithic application. WHAT: Sometimes referred to as scale through services or resources, this rule focuses on scaling by splitting data sets, transactions, and engineering teams along verb (services) or noun (resources) boundaries. WHEN TO USE: Very large data sets where relations between data are not necessary. Large, complex systems where scaling engineering resources requires specialization. HOW TO USE: Split up actions by using verbs, or resources by using nouns, or use a mix. Split both the services and the data along the lines defined by the verb/noun approach. WHY: Allows for efficient scaling of not only transactions but also very large data sets associated with those transactions. It also allows for the efficient scaling of teams. KEY TAKEAWAYS: Microservices allow for efficient scaling of transactions, large data sets, and can help with fault isolation. It helps reduce the communication overhead of teams. The codebase becomes less complex as disjoint features are decoupled and spun as new services thereby letting each service scale independently specific to its requirement.","title":"Scalability - Microservices"},{"location":"level101/systems_design/scalability/#refer_3","text":"https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html","title":"Refer"},{"location":"level101/systems_design/scalability/#scalability-sharding","text":"This pattern represents the separation of work based on attributes that are looked up to or determined at the time of the transaction. Most often, these are implemented as splits by requestor, customer, or client. Very often, a lookup service or deterministic algorithm will need to be written for these types of splits. Sharding aids in scaling transaction growth, scaling instruction sets, and decreasing processing time (the last by limiting the data necessary to perform any transaction). This is more effective at scaling growth in customers or clients. It can aid with disaster recovery efforts, and limit the impact of incidents to only a specific segment of customers. Here the auth data is sharded based on user names so that DBs can respond faster as the amount of data DBs have to work on has drastically reduced during queries. There can be other ways to split Here the whole data center is split and replicated and clients are directed to a data center based on their geography. This helps in improving performance as clients are directed to the closest data center and performance increases as we add more data centers. There are some replication and consistency overhead with this approach one needs to be aware of. This also gives fault tolerance by rolling out test features to one site and rollback if there is an impact to that geography WHAT: This is very often a split by some unique aspect of the customer such as customer ID, name, geography, and so on. WHEN TO USE: Very large, similar data sets such as large and rapidly growing customer bases or when the response time for a geographically distributed customer base is important. HOW TO USE: Identify something you know about the customer, such as customer ID, last name, geography, or device, and split or partition both data and services based on that attribute. WHY: Rapid customer growth exceeds other forms of data growth, or you have the need to perform fault isolation between certain customer groups as you scale. KEY TAKEAWAYS: Shards are effective at helping you to scale customer bases but can also be applied to other very large data sets that can\u2019t be pulled apart using the microservices methodology.","title":"Scalability - Sharding"},{"location":"level101/systems_design/scalability/#refer_4","text":"https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html","title":"Refer"},{"location":"level101/systems_design/scalability/#applications-in-sre-role","text":"SREs in coordination with the network team work on how to map users' traffic to a particular site. https://engineering.linkedin.com/blog/2017/05/trafficshift--load-testing-at-scale SREs work closely with the Dev team to split monoliths to multiple microservices that are easy to run and manage SREs work on improving Load Balancers' reliability, service discovery, and performance SREs work closely to split Data into shards and manage data integrity and consistency. https://engineering.linkedin.com/espresso/introducing-espresso-linkedins-hot-new-distributed-document-store SREs work to set up, configure, and improve the CDN cache hit rate.","title":"Applications in SRE role"},{"location":"level102/containerization_and_orchestration/conclusion/","text":"Conclusion In this sub-module we have toured the world of containers starting from why we use containers, how containers evolved from the virtual machine past (though they are, in no means, obsolete) and how they are different from virtual machines. We then saw how containers are implemented with emphasis on cgroups and namespaces along with some hands-on exercises. Finally we concluded our journey with container orchestration where we learnt a bit of Kubernetes with some practical examples. Hope this module gives you enough knowledge and interest to continue learning and applying these technologies in greater depth!","title":"Conclusion"},{"location":"level102/containerization_and_orchestration/conclusion/#conclusion","text":"In this sub-module we have toured the world of containers starting from why we use containers, how containers evolved from the virtual machine past (though they are, in no means, obsolete) and how they are different from virtual machines. We then saw how containers are implemented with emphasis on cgroups and namespaces along with some hands-on exercises. Finally we concluded our journey with container orchestration where we learnt a bit of Kubernetes with some practical examples. Hope this module gives you enough knowledge and interest to continue learning and applying these technologies in greater depth!","title":"Conclusion"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/","text":"Introduction Docker has gained huge popularity among other container engines since it was released to the public in 2013. Here are some of the reasons why Docker so popular: Improved portability Docker containers can be shipped and run across environments be it local machine, on-prem or cloud instances in the form of Docker images. Compared to docker containers, LXC containers have more machine specifications. - Lighter weight Docker images are light weight compared to VM images. For example, an Ubuntu 18.04 VM size is about 3GB whereas the docker image is 45MB! Versioning of container images Docker supports maintaining multiple versions of images which makes it easier to look up the history of an image and even rollback. Reuse of images Since Docker images are in the form of layers, one image can be used as base on top of which new images are built. For example, Alpine is a light weight image (5MB) which is commonly used as a base image. Docker layers are managed using storage drivers . Community support Docker hub is a container registry where anyone logged in can upload or download a container image. Docker images of popular OS distros are regularly updated in docker hub and receive large community support. Let\u2019s look at some terms which come up during our discussion of Docker. Docker terminology Docker images Docker image contains the executable version of the application along with the dependencies (config files, libraries, binaries) required for the application to run as a standalone container. It can be understood as a snapshot of a container. Docker images are present as layers on top of the base layer. These layers are the ones that are versioned. The most recent version of layer is the one that is used on top of the base image. docker image ls lists the images present in the host machine. Docker containers Docker container is the running instance of the docker image. While images are static, containers created from the images can be executed into and interacted with. This is actually the \u201ccontainer\u201d from the previous sections of the module. docker run is the command used to instantiate containers from images. docker ps lists docker containers currently running in the host machine. Docker file It is a plain text file of instructions based on which an image is assembled by docker engine (daemon, to be precise). It contains information on base image, ENV variables to be injected. docker build is used to build images from dockerfile. Docker hub It is Docker\u2019s official container registry of images. Any user with a docker login can upload custom images to Docker hub using docker push and fetch images using docker pull . Having known the basic terminologies let\u2019s look at how docker engine works; how CLI commands are interpreted and container life-cycle is managed. Components of Docker engine Let\u2019s start with the diagram of Docker Engine to understand better: The docker engine follows a client-server architecture. It consists of 3 components: Docker client This is the component the user directly interacts with. When you execute docker commands which we saw earlier (push, pull, container ls, image ls) , we are actually using the docker client. A single docker client can communicate with multiple docker daemons. REST API Provides an interface for the docker client and daemon to communicate. Docker Daemon (server) This is the main component of the docker engine. It builds images from dockerfile, fetches images from docker registry, pushes images to the registry, stops, starts containers etc. It also manages networking between containers. LAB The official docker github provides labs at several levels for learning Docker. We're linking one of the labs which we found great for people beginning from scratch. Please follow the labs in this order: Setting up local environment for the labs Basics for using docker CLI Creating and containerizing a basic Flask app Here is another beginner level lab from Katacoda for dockerizing a node js application. You don\u2019t even need a local setup for this and it\u2019s easy to follow along. Advanced features of Docker While we have covered the basics of containerization and how a standalone application can be dockerized, processes in the real world need to communicate with each other. This need is particularly prevalent in applications which follow a microservice architecture. Docker networks Docker networks facilitate the interaction between containers running on the same hosts or even different hosts. There are several options provided through docker network command which specifies how the container interacts with the host and with other containers. The host option allows sharing of network stack with the host, bridge allows communication between containers running on the same host but not external to the host, overlay facilitates interaction between containers across hosts attached to the same network and macvlan which assigns a separate MAC address to a container for legacy containers are some important types of networks supported by Docker. This however is outside the scope of this module. The official documentation on docker networks itself is a good place to start. Volumes Apart from images, containers and networks, Docker also provides the option to create and mount volumes within containers. Generally, data within docker containers is non-persistent i.e once you kill the container the data is lost. Volumes are used for storing persistent data in containers. This KataKoda lab is a great place to start playing with volumes. In the next section we see how container deployments are orchestrated with Kubernetes.","title":"Containerization With Docker"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/#introduction","text":"Docker has gained huge popularity among other container engines since it was released to the public in 2013. Here are some of the reasons why Docker so popular: Improved portability Docker containers can be shipped and run across environments be it local machine, on-prem or cloud instances in the form of Docker images. Compared to docker containers, LXC containers have more machine specifications. - Lighter weight Docker images are light weight compared to VM images. For example, an Ubuntu 18.04 VM size is about 3GB whereas the docker image is 45MB! Versioning of container images Docker supports maintaining multiple versions of images which makes it easier to look up the history of an image and even rollback. Reuse of images Since Docker images are in the form of layers, one image can be used as base on top of which new images are built. For example, Alpine is a light weight image (5MB) which is commonly used as a base image. Docker layers are managed using storage drivers . Community support Docker hub is a container registry where anyone logged in can upload or download a container image. Docker images of popular OS distros are regularly updated in docker hub and receive large community support. Let\u2019s look at some terms which come up during our discussion of Docker.","title":"Introduction"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/#docker-terminology","text":"Docker images Docker image contains the executable version of the application along with the dependencies (config files, libraries, binaries) required for the application to run as a standalone container. It can be understood as a snapshot of a container. Docker images are present as layers on top of the base layer. These layers are the ones that are versioned. The most recent version of layer is the one that is used on top of the base image. docker image ls lists the images present in the host machine. Docker containers Docker container is the running instance of the docker image. While images are static, containers created from the images can be executed into and interacted with. This is actually the \u201ccontainer\u201d from the previous sections of the module. docker run is the command used to instantiate containers from images. docker ps lists docker containers currently running in the host machine. Docker file It is a plain text file of instructions based on which an image is assembled by docker engine (daemon, to be precise). It contains information on base image, ENV variables to be injected. docker build is used to build images from dockerfile. Docker hub It is Docker\u2019s official container registry of images. Any user with a docker login can upload custom images to Docker hub using docker push and fetch images using docker pull . Having known the basic terminologies let\u2019s look at how docker engine works; how CLI commands are interpreted and container life-cycle is managed.","title":"Docker terminology"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/#components-of-docker-engine","text":"Let\u2019s start with the diagram of Docker Engine to understand better: The docker engine follows a client-server architecture. It consists of 3 components: Docker client This is the component the user directly interacts with. When you execute docker commands which we saw earlier (push, pull, container ls, image ls) , we are actually using the docker client. A single docker client can communicate with multiple docker daemons. REST API Provides an interface for the docker client and daemon to communicate. Docker Daemon (server) This is the main component of the docker engine. It builds images from dockerfile, fetches images from docker registry, pushes images to the registry, stops, starts containers etc. It also manages networking between containers.","title":"Components of Docker engine"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/#lab","text":"The official docker github provides labs at several levels for learning Docker. We're linking one of the labs which we found great for people beginning from scratch. Please follow the labs in this order: Setting up local environment for the labs Basics for using docker CLI Creating and containerizing a basic Flask app Here is another beginner level lab from Katacoda for dockerizing a node js application. You don\u2019t even need a local setup for this and it\u2019s easy to follow along.","title":"LAB"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/#advanced-features-of-docker","text":"While we have covered the basics of containerization and how a standalone application can be dockerized, processes in the real world need to communicate with each other. This need is particularly prevalent in applications which follow a microservice architecture. Docker networks Docker networks facilitate the interaction between containers running on the same hosts or even different hosts. There are several options provided through docker network command which specifies how the container interacts with the host and with other containers. The host option allows sharing of network stack with the host, bridge allows communication between containers running on the same host but not external to the host, overlay facilitates interaction between containers across hosts attached to the same network and macvlan which assigns a separate MAC address to a container for legacy containers are some important types of networks supported by Docker. This however is outside the scope of this module. The official documentation on docker networks itself is a good place to start. Volumes Apart from images, containers and networks, Docker also provides the option to create and mount volumes within containers. Generally, data within docker containers is non-persistent i.e once you kill the container the data is lost. Volumes are used for storing persistent data in containers. This KataKoda lab is a great place to start playing with volumes. In the next section we see how container deployments are orchestrated with Kubernetes.","title":"Advanced features of Docker"},{"location":"level102/containerization_and_orchestration/intro/","text":"Containers and orchestration Introduction Containers, Docker and Kubernetes are \"cool\" terms that are being spoken of by everyone involved with software in some way. Let's dive into each of these pieces of technology at enough depth to understand what the whole deal is about! In this module we talk about the ins and outs of containers: the internals and usage of containers; how they are implemented, how to containerize your application and finally, how to deploy containerized applications on a large scale without losing your sleep. We'll also get our hands dirty by trying out a few lab exercises. Prerequisites Basic knowledge of linux will be helpful understanding the internals of containers Basic knowledge of shell commands (will come handy when we're containerizing applications) Knowledge of running a basic web application. You can go through our Python And Web module to gain familiarity with this. What to expect from this course This module is divided into 3 sub-modules. In the first sub module, we will cover the internals of containerization and why they\u2019re used for. The second sub-module introduces Docker, a popular container engine and contains lab exercises on dockerizing a basic webapp. The last module talks about container orchestration with Kubernetes and some lab exercises to show how it makes the lives of SREs easy. What is not covered under this course We will not cover advanced docker and kubernetes concepts. However, we will be leading you to links and references from where you can pick them up as per your interest. Course Contents The following topics has been covered in this course: Introduction to containers What are containers Why containers Difference between virtual machines and containers How are containers implemented Namespaces Cgroups Container engines Containerization with Docker Introduction Basic docker terminology Components of Docker engine Hands-on Introduction to Advanced Docker Container orchestration with Kubernetes Introduction Motivation to use Kubernetes Kubernetes Architecture Hands-on Introduction to Advanced Kubernetes concepts Conclusion","title":"Introduction"},{"location":"level102/containerization_and_orchestration/intro/#containers-and-orchestration","text":"","title":"Containers and orchestration"},{"location":"level102/containerization_and_orchestration/intro/#introduction","text":"Containers, Docker and Kubernetes are \"cool\" terms that are being spoken of by everyone involved with software in some way. Let's dive into each of these pieces of technology at enough depth to understand what the whole deal is about! In this module we talk about the ins and outs of containers: the internals and usage of containers; how they are implemented, how to containerize your application and finally, how to deploy containerized applications on a large scale without losing your sleep. We'll also get our hands dirty by trying out a few lab exercises.","title":"Introduction"},{"location":"level102/containerization_and_orchestration/intro/#prerequisites","text":"Basic knowledge of linux will be helpful understanding the internals of containers Basic knowledge of shell commands (will come handy when we're containerizing applications) Knowledge of running a basic web application. You can go through our Python And Web module to gain familiarity with this.","title":"Prerequisites"},{"location":"level102/containerization_and_orchestration/intro/#what-to-expect-from-this-course","text":"This module is divided into 3 sub-modules. In the first sub module, we will cover the internals of containerization and why they\u2019re used for. The second sub-module introduces Docker, a popular container engine and contains lab exercises on dockerizing a basic webapp. The last module talks about container orchestration with Kubernetes and some lab exercises to show how it makes the lives of SREs easy.","title":"What to expect from this course"},{"location":"level102/containerization_and_orchestration/intro/#what-is-not-covered-under-this-course","text":"We will not cover advanced docker and kubernetes concepts. However, we will be leading you to links and references from where you can pick them up as per your interest.","title":"What is not covered under this course"},{"location":"level102/containerization_and_orchestration/intro/#course-contents","text":"The following topics has been covered in this course: Introduction to containers What are containers Why containers Difference between virtual machines and containers How are containers implemented Namespaces Cgroups Container engines Containerization with Docker Introduction Basic docker terminology Components of Docker engine Hands-on Introduction to Advanced Docker Container orchestration with Kubernetes Introduction Motivation to use Kubernetes Kubernetes Architecture Hands-on Introduction to Advanced Kubernetes concepts Conclusion","title":"Course Contents"},{"location":"level102/containerization_and_orchestration/intro_to_containers/","text":"What are containers Here's a popular definition of containers according to Docker , a popular containerization engine : A container is a standard unit of software that packages up code and all its dependencies so the application runs quickly and reliably from one computing environment to another Let's break this down. A container is your code bundled along with its entire runtime environment. That includes your system libraries, binaries and config files needed for your application to run. Why containers You might wonder why we need to pack your application along with its dependencies. This is where the second part of the definition comes, ...so the application runs quickly and reliably from one computing environment to another. Developers usually write code in their dev environment (or local machine), test it in one or two staging/test environments before pushing their code into production. Ideally, for reliably testing applications before pushing to production, we need all these environments to be uniform to a tee (underlying OS, system libraries etc). Of course, the ideal is hard to achieve especially when we're using a mix of on-prem (complete control) and cloud infrastructure providers (more restrictive in terms of control of hardware and security options), a scenario which is more common today. This is exactly why we need to package not only the code but also the dependencies; so that your application runs reliably irrespective of which infrastructure or environment it runs on. We can run several containers on a single host. Due to how containers are implemented, each container has its own isolated environment within the same host. This means that a monolithic application can be broken down into micro-services and packaged into containers. Each microservice runs in the host machine in isolated environments. This is another reason why containers are used: separation of concerns . Providing isolated environments does not let the failure of one application in one container affect the other. This is called fault isolation . Isolation also gives the added benefit of increased security due to restricted visibility of processes in a container. Due to how most of the containerization solutions are implemented, we also have the option to cap the amount of resources consumed by applications running within a container. This is called resource limiting . Will will discuss this feature in more detail in the section on cgroups. Difference between virtual machines and containers Let's digress a little and go into some history. In the previous section we talked about how containers help us in achieving separation of concerns. Before the wide-spread usage of containers, virtualization was used for running applications in isolated environments in the same host (it\u2019s still being used today in some cases). In plain terms, virtualization is where we package software along with a copy of the OS on which it runs. This package is called a virtual machine (VM). The image of the OS bundled in the VM is called Guest OS. A component called Hypervisor sits between the Guest and the Host OS and is responsible for facilitating the access of the underlying OS\u2019s hardware to the Guest OS. You can learn more about hypervisors here . Similar to how multiple containers can be run in a single host machine, multiple VMs can be run on a single host and in this way, it\u2019s possible to run applications (or each microservice) in a separate VM and achieve separation of concerns. The main focus here is on the size of the VMs and containers. VMs come along with a copy of the guest operating system and therefore are heavy-weight compared to containers. If you\u2019re more interested in comparison of VMs and containers, you can check these articles from Backblaze and NetApp . While it is possible to run an operating system on a host with an incompatible kernel using hypervisors (e.g Windows 10 VM on CentOS 7), in cases where kernels can be shared (e.g Ubuntu on CentOS 7) containers are preferred over VMs due to the size factor. Sharing kernels, as you will see later, also gives containers many performance benefits over VMs like quicker boot-ups. Let\u2019s look at the diagram of how containers work. Comparing the two diagrams, we notice two things: Containers do not have a separate (guest) OS Container engine is the intermediary between containers and Host OS. It is used to facilitate the life-cycle of a container on the Host OS (it is not a necessity, however). The next section explains in detail how containers share the same operating system (kernel, to be precise) as the host machine and yet provide isolated environments for applications to run. How are containers implemented We\u2019ve talked about how containers, unlike virtual machines, share the same kernel as the host operating system and provide isolated environments for applications to run. This is achieved without the overhead of running a guest operating system on the host OS, thanks to two features of linux kernel called cgroups and kernel namespaces. Now that we are touching upon the internals of containers, it would be appropriate to give a more technically accurate representation of what they are. A container is a linux process or a group of linux processes which is restricted in - visibility into processes outside the container (implemented using namespace) - quantity of resources it can use (implemented using cgroups) and - system calls that can be made from the container. Refer seccomp , if interested in knowing more. These restrictions are what make a containerized application remain isolated from other processes running in the same host. Now let\u2019s talk about namespaces and cgroup in a little more detail. Namespaces Visibility of processes inside a container should be restricted within itself. This is what linux namespaces do. The idea is that processes within a namespace can\u2019t affect those which it can\u2019t \u201csee\u201d. Processes sharing a single namespace have identities, service and/or interfaces unique to the namespace they exist in. Here\u2019s a list of namespaces in linux: Mount Process groups sharing a mount namespace share a separate, private set of mount points and file system view. Any modifications made to these namespaced mount points are not visible outside the namespace. For example it is possible to have a /var within the a mount namespace which is different from /var in the host. PID A processes in a pid namespace have process ids which are unique only within the namespace. A process can be a root process (pid 1) in its own pid namespace and have an entire tree of processes under it. Network Each network namespace will have its own network device instances that can be configured with individual network addresses. Processes in the same network namespace can have their own ports and route tables. User User namespaces can have their own users and group ids. It\u2019s possible for a process using a non-privileged user in the host machine to have a root user identity within a user namespace. Cgroup Allows creation of cgroups which can be used only within the cgroup namespace. Cgroups will be covered in more detail in the following section. UTS This namespace has its own hostname and domain name IPC. Each IPC namespace has its own System V and POSIX message queues. As complex as it seems, creating namespaces in linux is quite simple. Let\u2019s see a quick demo to create a PID namespace. You\u2019ll need a linux based OS with sudoers permission to follow along. DEMO: namespaces First we check which processes are running in the host system (output varies from system to system). Note the process with pid 1. Let\u2019s create a PID namespace with the unshare command and create a bash process in the namespace You can see that ps aux (which itself is a process launched in the PID namespace so created) can only see processes within its own namespace. Hence, the output shows only 2 processes running within the namespace. Also note, the root process (pid 1) in the namespace is not init but it is the bash shell which we specified while creating the namespace. Let\u2019s create another process in the same namespace which sleeps for 1000 seconds in the background. In my case the pid of the sleep process is 44 within the PID namespace . On a separate terminal, check for the process id of the sleep process as seen from the host. Note the difference in pid (23844 in the host and 44 within the namespace) though both refer to the same process (start time and all other attributes are same). It\u2019s also possible to nest namespaces i.e create a pid namespace from another pid namespace. Try out sudo nsenter -t 23844 --pid -r bash to reenter the namespace and create another pid namespace within it. It should be fun to do! Cgroups A cgroup can be defined as a set of processes whose usage of resources is metered and monitored. The resources can be memory pages, disk i/o, CPU etc. In fact, cgroups are classified based on which resource the limit is imposed on and nature of action taken when a limit is violated. The component in the cgroup which tracks resource utilization and controls the behaviour of processes in a cgroup is called resource-subsystem or resource controller. Following is the set of resource controllers and their function according to RHEL\u2019s introduction to cgroups : blkio \u2014 this subsystem sets limits on input/output access to and from block devices such as physical drives (disk, solid state, or USB). cpu \u2014 this subsystem uses the scheduler to provide cgroup processes access to the CPU. cpuacct \u2014 this subsystem generates automatic reports on CPU resources used by processes in a cgroup. cpuset \u2014 this subsystem assigns individual CPUs (on a multicore system) and memory nodes to processes in a cgroup. devices \u2014 this subsystem allows or denies access to devices by processes in a cgroup. freezer \u2014 this subsystem suspends or resumes processes in a cgroup. memory \u2014 this subsystem sets limits on memory use by processes in a cgroup and generates automatic reports on memory resources used by those processes. Cgroups follow a hierarchical, tree-like structure for each resource controller i.e one cgroup exists for each controller. Each cgroup in a hierarchy inherits certain attributes (e.g limits) from its parent cgroup. Let\u2019s try out a quick demo with memory cgroups to wrap our heads around the above ideas. You\u2019ll need a linux based OS (here, RedHat) with sudo permission to follow along. DEMO: cgroups Let\u2019s start by checking if cgroup tools are installed in your machine. Execute mount | grep \"^cgroup\" . If you have the tools installed you\u2019ll see a output like this: If not, install the tools with sudo yum install libcgroup-tools -y . Now, we create a memory cgroup called mem_group with \u201croot\u201d as the owner of the cgroup. Command executed sudo cgcreate -a root -g memory:mem_group . Verify that cgroup is created. /sys/fs/cgroup/ is the pseudo filesystem where a newly created cgroup is added as a sub-group. Memory cgroup puts a limit on the memory usage of processes in the cgroup. Let\u2019s see what the limits are for mem_group. The file for checking the memory limit is memory.limit_in_bytes( more information here , if you\u2019re interested). Note that mem_group has inherited the limit from its parent cgroup Now, let\u2019s reduce the memory usage limit to 20KB for the purpose of our demo (the actual limit is rounded off to the nearest power of 2). This limit is too low and hence most of the processes attached to mem_group should be OOM killed. Create a new shell and attach it to the cgroup. We need sudo permissions for this. The process is OOM killed as expected. You can confirm the same with dmesg logs (mm_fault_error). If you want to try out a more in-depth exercise on cgroups, check out this tutorial from Geeks for Geeks . Let\u2019s come back to containers again. Containers share the same kernel as the underlying host operating system and provide an isolated environment of the application within. Cgroups help in managing resources used by processes within a container and namespaces help isolate network stack, pids, users, group ids and mount points in a container from another container running on the same host. Of course, there are more components to containers which truly make it fully functional but that discussion is out of scope of this module. Container engine Container engines ease the process of creating and managing containers in a host machine. How? The container creation workflow typically begins with a container image. A container image is a packaged, portable version of the target application bundled with all dependencies for it to run. These container images are either available on the host machine (container host) from previous builds or need to be pulled from a remote repository of images. Sometimes the container engine might need to build the container image from a set of instructions. Finally once the container image is fetched/built, the container engine unpacks the image and creates an isolated environment for the application as per the image specifications. The files in the container image are then mounted to the isolated environment to get the application up and running within the container. There are several container engines available like Docker, RKT, LXC (one of the first container engines) which require different image formats (Docker, LXD). OCI (Open Container Initiative) is a collaborative project started by Docker that aims to standardize container runtime specifications and image formats across vendors. OCI FAQ section is a good place to start if you\u2019re curious about this project. We will focus on Docker in the next section .","title":"Introduction To Containers"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#what-are-containers","text":"Here's a popular definition of containers according to Docker , a popular containerization engine : A container is a standard unit of software that packages up code and all its dependencies so the application runs quickly and reliably from one computing environment to another Let's break this down. A container is your code bundled along with its entire runtime environment. That includes your system libraries, binaries and config files needed for your application to run.","title":"What are containers"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#why-containers","text":"You might wonder why we need to pack your application along with its dependencies. This is where the second part of the definition comes, ...so the application runs quickly and reliably from one computing environment to another. Developers usually write code in their dev environment (or local machine), test it in one or two staging/test environments before pushing their code into production. Ideally, for reliably testing applications before pushing to production, we need all these environments to be uniform to a tee (underlying OS, system libraries etc). Of course, the ideal is hard to achieve especially when we're using a mix of on-prem (complete control) and cloud infrastructure providers (more restrictive in terms of control of hardware and security options), a scenario which is more common today. This is exactly why we need to package not only the code but also the dependencies; so that your application runs reliably irrespective of which infrastructure or environment it runs on. We can run several containers on a single host. Due to how containers are implemented, each container has its own isolated environment within the same host. This means that a monolithic application can be broken down into micro-services and packaged into containers. Each microservice runs in the host machine in isolated environments. This is another reason why containers are used: separation of concerns . Providing isolated environments does not let the failure of one application in one container affect the other. This is called fault isolation . Isolation also gives the added benefit of increased security due to restricted visibility of processes in a container. Due to how most of the containerization solutions are implemented, we also have the option to cap the amount of resources consumed by applications running within a container. This is called resource limiting . Will will discuss this feature in more detail in the section on cgroups.","title":"Why containers"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#difference-between-virtual-machines-and-containers","text":"Let's digress a little and go into some history. In the previous section we talked about how containers help us in achieving separation of concerns. Before the wide-spread usage of containers, virtualization was used for running applications in isolated environments in the same host (it\u2019s still being used today in some cases). In plain terms, virtualization is where we package software along with a copy of the OS on which it runs. This package is called a virtual machine (VM). The image of the OS bundled in the VM is called Guest OS. A component called Hypervisor sits between the Guest and the Host OS and is responsible for facilitating the access of the underlying OS\u2019s hardware to the Guest OS. You can learn more about hypervisors here . Similar to how multiple containers can be run in a single host machine, multiple VMs can be run on a single host and in this way, it\u2019s possible to run applications (or each microservice) in a separate VM and achieve separation of concerns. The main focus here is on the size of the VMs and containers. VMs come along with a copy of the guest operating system and therefore are heavy-weight compared to containers. If you\u2019re more interested in comparison of VMs and containers, you can check these articles from Backblaze and NetApp . While it is possible to run an operating system on a host with an incompatible kernel using hypervisors (e.g Windows 10 VM on CentOS 7), in cases where kernels can be shared (e.g Ubuntu on CentOS 7) containers are preferred over VMs due to the size factor. Sharing kernels, as you will see later, also gives containers many performance benefits over VMs like quicker boot-ups. Let\u2019s look at the diagram of how containers work. Comparing the two diagrams, we notice two things: Containers do not have a separate (guest) OS Container engine is the intermediary between containers and Host OS. It is used to facilitate the life-cycle of a container on the Host OS (it is not a necessity, however). The next section explains in detail how containers share the same operating system (kernel, to be precise) as the host machine and yet provide isolated environments for applications to run.","title":"Difference between virtual machines and containers"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#how-are-containers-implemented","text":"We\u2019ve talked about how containers, unlike virtual machines, share the same kernel as the host operating system and provide isolated environments for applications to run. This is achieved without the overhead of running a guest operating system on the host OS, thanks to two features of linux kernel called cgroups and kernel namespaces. Now that we are touching upon the internals of containers, it would be appropriate to give a more technically accurate representation of what they are. A container is a linux process or a group of linux processes which is restricted in - visibility into processes outside the container (implemented using namespace) - quantity of resources it can use (implemented using cgroups) and - system calls that can be made from the container. Refer seccomp , if interested in knowing more. These restrictions are what make a containerized application remain isolated from other processes running in the same host. Now let\u2019s talk about namespaces and cgroup in a little more detail.","title":"How are containers implemented"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#namespaces","text":"Visibility of processes inside a container should be restricted within itself. This is what linux namespaces do. The idea is that processes within a namespace can\u2019t affect those which it can\u2019t \u201csee\u201d. Processes sharing a single namespace have identities, service and/or interfaces unique to the namespace they exist in. Here\u2019s a list of namespaces in linux: Mount Process groups sharing a mount namespace share a separate, private set of mount points and file system view. Any modifications made to these namespaced mount points are not visible outside the namespace. For example it is possible to have a /var within the a mount namespace which is different from /var in the host. PID A processes in a pid namespace have process ids which are unique only within the namespace. A process can be a root process (pid 1) in its own pid namespace and have an entire tree of processes under it. Network Each network namespace will have its own network device instances that can be configured with individual network addresses. Processes in the same network namespace can have their own ports and route tables. User User namespaces can have their own users and group ids. It\u2019s possible for a process using a non-privileged user in the host machine to have a root user identity within a user namespace. Cgroup Allows creation of cgroups which can be used only within the cgroup namespace. Cgroups will be covered in more detail in the following section. UTS This namespace has its own hostname and domain name IPC. Each IPC namespace has its own System V and POSIX message queues. As complex as it seems, creating namespaces in linux is quite simple. Let\u2019s see a quick demo to create a PID namespace. You\u2019ll need a linux based OS with sudoers permission to follow along.","title":"Namespaces"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#demo-namespaces","text":"First we check which processes are running in the host system (output varies from system to system). Note the process with pid 1. Let\u2019s create a PID namespace with the unshare command and create a bash process in the namespace You can see that ps aux (which itself is a process launched in the PID namespace so created) can only see processes within its own namespace. Hence, the output shows only 2 processes running within the namespace. Also note, the root process (pid 1) in the namespace is not init but it is the bash shell which we specified while creating the namespace. Let\u2019s create another process in the same namespace which sleeps for 1000 seconds in the background. In my case the pid of the sleep process is 44 within the PID namespace . On a separate terminal, check for the process id of the sleep process as seen from the host. Note the difference in pid (23844 in the host and 44 within the namespace) though both refer to the same process (start time and all other attributes are same). It\u2019s also possible to nest namespaces i.e create a pid namespace from another pid namespace. Try out sudo nsenter -t 23844 --pid -r bash to reenter the namespace and create another pid namespace within it. It should be fun to do!","title":"DEMO: namespaces"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#cgroups","text":"A cgroup can be defined as a set of processes whose usage of resources is metered and monitored. The resources can be memory pages, disk i/o, CPU etc. In fact, cgroups are classified based on which resource the limit is imposed on and nature of action taken when a limit is violated. The component in the cgroup which tracks resource utilization and controls the behaviour of processes in a cgroup is called resource-subsystem or resource controller. Following is the set of resource controllers and their function according to RHEL\u2019s introduction to cgroups : blkio \u2014 this subsystem sets limits on input/output access to and from block devices such as physical drives (disk, solid state, or USB). cpu \u2014 this subsystem uses the scheduler to provide cgroup processes access to the CPU. cpuacct \u2014 this subsystem generates automatic reports on CPU resources used by processes in a cgroup. cpuset \u2014 this subsystem assigns individual CPUs (on a multicore system) and memory nodes to processes in a cgroup. devices \u2014 this subsystem allows or denies access to devices by processes in a cgroup. freezer \u2014 this subsystem suspends or resumes processes in a cgroup. memory \u2014 this subsystem sets limits on memory use by processes in a cgroup and generates automatic reports on memory resources used by those processes. Cgroups follow a hierarchical, tree-like structure for each resource controller i.e one cgroup exists for each controller. Each cgroup in a hierarchy inherits certain attributes (e.g limits) from its parent cgroup. Let\u2019s try out a quick demo with memory cgroups to wrap our heads around the above ideas. You\u2019ll need a linux based OS (here, RedHat) with sudo permission to follow along.","title":"Cgroups"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#demo-cgroups","text":"Let\u2019s start by checking if cgroup tools are installed in your machine. Execute mount | grep \"^cgroup\" . If you have the tools installed you\u2019ll see a output like this: If not, install the tools with sudo yum install libcgroup-tools -y . Now, we create a memory cgroup called mem_group with \u201croot\u201d as the owner of the cgroup. Command executed sudo cgcreate -a root -g memory:mem_group . Verify that cgroup is created. /sys/fs/cgroup/ is the pseudo filesystem where a newly created cgroup is added as a sub-group. Memory cgroup puts a limit on the memory usage of processes in the cgroup. Let\u2019s see what the limits are for mem_group. The file for checking the memory limit is memory.limit_in_bytes( more information here , if you\u2019re interested). Note that mem_group has inherited the limit from its parent cgroup Now, let\u2019s reduce the memory usage limit to 20KB for the purpose of our demo (the actual limit is rounded off to the nearest power of 2). This limit is too low and hence most of the processes attached to mem_group should be OOM killed. Create a new shell and attach it to the cgroup. We need sudo permissions for this. The process is OOM killed as expected. You can confirm the same with dmesg logs (mm_fault_error). If you want to try out a more in-depth exercise on cgroups, check out this tutorial from Geeks for Geeks . Let\u2019s come back to containers again. Containers share the same kernel as the underlying host operating system and provide an isolated environment of the application within. Cgroups help in managing resources used by processes within a container and namespaces help isolate network stack, pids, users, group ids and mount points in a container from another container running on the same host. Of course, there are more components to containers which truly make it fully functional but that discussion is out of scope of this module.","title":"DEMO: cgroups"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#container-engine","text":"Container engines ease the process of creating and managing containers in a host machine. How? The container creation workflow typically begins with a container image. A container image is a packaged, portable version of the target application bundled with all dependencies for it to run. These container images are either available on the host machine (container host) from previous builds or need to be pulled from a remote repository of images. Sometimes the container engine might need to build the container image from a set of instructions. Finally once the container image is fetched/built, the container engine unpacks the image and creates an isolated environment for the application as per the image specifications. The files in the container image are then mounted to the isolated environment to get the application up and running within the container. There are several container engines available like Docker, RKT, LXC (one of the first container engines) which require different image formats (Docker, LXD). OCI (Open Container Initiative) is a collaborative project started by Docker that aims to standardize container runtime specifications and image formats across vendors. OCI FAQ section is a good place to start if you\u2019re curious about this project. We will focus on Docker in the next section .","title":"Container engine"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/","text":"Introduction Now we finally arrive at the most awaited part: running and managing containers at scale. So far, we have seen how Docker facilitates managing the life-cycle of containers and provides improved portability of applications. Docker does provide a solution for easing the deployment of containers on a large scale ( you can check out Docker Swarm, if interested) which integrates well with Docker containers. However, Kubernetes has become the de-facto tool for orchestrating the management of microservices (as containers) in large distributed environments. Let\u2019s see the points of interest for us, SREs, to use container orchestration tools and Kubernetes in particular. Motivation to use Kubernetes Ease of usage Though there is a steep learning curve associated with Kubernetes, once learnt , can be used as a one stop tool to manage your microservices. With a single command it is possible to deploy full fledged production ready environments. The desired state of an application needs to be recorded as a YAML manifest and Kubernetes manages the application for you. Ensure optimum usage of resources We can specify limits on resources used by each container in a deployment. We can also specify our choice of nodes where Kubernetes can schedule nodes to be deployed (e.g microservices with high CPU consumption can be instructed to be deployed in high compute nodes). Fault tolerance Self-healing is built into basic resource types of Kubernetes. This removes the headache of designing a fault tolerant application system from scratch. This applies especially to stateless applications. Infrastructure agnostic Kubernetes does not have vendor lock-in. It can be set up in multiple cloud environments or in on-prem data centers. Strong community support and documentation Kubernetes is open-source and many technologies like operators, service mesh etc. have been built by the community to manage and monitor Kubernetes-orchestrated applications better. Extensible and customisable We can build our custom resource definitions which fit our use case for managing applications and use Kubernetes to manage them (with custom controllers). You can check out this article if you are more interested in this topic. Architecture of Kubernetes Here\u2019s a diagram (from the official Kubernetes documentation ) containing different components which make Kubernetes work: Kubernetes components can be divided into two parts: control plane components and data plane components . A Kubernetes cluster consists of 1 or more host machines (called nodes) where the containers managed by Kubernetes are run. This constitutes the data plane (or node plane). The brain of Kuberentes which responds to events from the node plane (e.g create a pod, replicas mismatch) and does the main orchestration is called the control plane. All control plane components are typically installed in a master node. This master node does not run any user containers. The Kubernetes components themselves are run as containers wrapped in Pods (which is the most basic kubernetes resource object). Control plane components: kube-apiserver etcd kube-scheduler kube-controller-manager Node plane components kubelet kube-proxy This workflow might help you understand the working on components better: An SRE installs kubectl in their local machine. This is the client which interacts with the Kubernetes control plane (and hence the cluster). They create a YAML file, called manifest which specifies the desired state of the resource (e.g a deployment names \u201cfrontend\u201d needs 3 pods to always be running) When they issue a command to create objects based in the YAML file, the kubectl CLI tool sends a rest API request to the kube-apiserver . If the manifest is valid, it is stored as key value pairs in the etcd server on the control plane. kube-scheduler chooses which nodes to put the containers on (basically schedules them) There are controller processes (managed by kube-controller manager) which makes sure the current state of the cluster is equivalent to the desired state (here, 3 pods are indeed running in the cluster -> all is fine). On the node plane side, kubelet makes sure that pods are locally kept in running state. LAB Prerequisites The best way to start this exercise is to use a Katacoda kubernetes playground . A single node kubernetes cluster is already set up for you here for quick experimentation. You can also use this to play with docker. The environment gets torn down after 10 mins. So make sure that you save your files if you want to resume them. For persistent kubernetes clusters, you can set it up either in your local (using minikube ) or you can create a kubernetes cluster in Azure , GCP or any other cloud provider. Knowledge of YAML is nice to have for understanding the manifest files. Hands-on Lab 1: We are going to create an object called Pod which is the most basic unit for running a container in Kubernetes. Here, we will create a pod called \u2018nginx-pod\u201d which contains an nginx container called \u201cweb\u201d. We will also expose port 80 in the container so that we can interact with the nginx container. Save the below manifest in a file called nginx-pod.yaml apiVersion: v1 #[1] kind: Pod #[2] metadata: #[3] name: nginx-pod #[4] labels: #[5] app: nginx spec: #[6] containers: #[7] - name: web #[8] image: nginx #[9] ports: #[10] - name: web #[11] containerPort: 80 #[12] protocol: TCP #[13] Let\u2019s very briefly understand what\u2019s here: #[2] - kind: The \u201ckind\u201d of object that\u2019s being created. Here it is a Pod #[1] - apiVersion: The apiVersion of the \u201cPod\u201d resource. There could be minor changes in the values or keys in the yaml file if the version varies. #[3] - metadata: The metadata section of the file where pod labels and name is given #[6] - spec: This is the main part where the things inside the pod are defined These are not random key value pairs! They have to be interpretable by the kubeapiserver. You can check which key value pairs are optional/mandatory using kubectl explain pod command. Do try it out! Apply the manifest using the command kubectl apply -f nginx-pod.yaml . This creates the \u201cnginx-pod\u201d pod in the kubernetes cluster. Verify that the pod is in running state using kubectl get pod . It shows that nginx-pod is in Running state. 1/1 indicates that out of 1 out of 1 container(s) inside the pod is healthy. To check if the container running in \u201cnginx-pod\u201d is indeed \u201cweb\u201d we do the kubectl describe pod/nginx-pod command. This gives a lengthy output with a detailed description of the pod and the events that happened since the pod was created. This command is very useful for debugging. The part we are concerned here is this: You can see \u201cweb\u201d under the Containers section with Image as nginx. This is what we are looking for. How do we access the welcome page of nginx \u201cweb\u201d container? In the describe command you can see the IP address of the pod. Each pod is assigned an IP address on creation. Here, this is 10.244.1.3 Issue a curl request from the host curl 10.244.1.3:80 . You will get the welcome page! Let\u2019s say we want to use a specific tag of nginx (say 1.20.1) in the same pod i.e we want to modify some property of the pod. You can try editing nginx-pod.yaml (image: nginx:1.20.1 in #[9])and reapplying (step 2.). It will create a new container in the same pod with the new image. A container is created within the pod but the pod is the same. You can verify by checking the pod start time in describe command. It would show a much older time. You can actually see the nginx container by doing docker ps on the node01 terminal (if you\u2019re using Katacoda). What if we want to change the image to 1.20.1 for 1000 nginx pods? Stepping a little back, what if we want to create 1000 nginx pods. Of course, we can write a script but Kubernetes already offers a resource type called \u201cdeployment\u201d to manage large scale deployments better. Lab 2: We\u2019ll go a step further to see how we can create more than a single instance of the nginx pod at the same time. We will first create Save the below manifest in a file called nginx-deploy.yaml apiVersion: apps/v1 kind: Deployment #[1] metadata: name: nginx-deployment labels: app: nginx spec: replicas: 3 #[2] selector: matchLabels: app: nginx #[3] template: #[4] metadata: labels: app: nginx #[5] spec: containers: - name: web image: nginx ports: - name: web containerPort: 80 protocol: \"TCP\" You can see that it is similar to a pod definition till spec ( #[1] has Deployment as kind, api version is also different). Another thing interesting observation is the metadata and spec parts under #[4] is almost the same as the metadata and spec section under the Pod definition in Lab 1 (do go up and cross check this). What this implies is that we are deploying 3 nginx pods similar to Lab1. Also, the labels in matchLabels should be the same as labels under #[4] . Now apply the manifest using kubectl apply -f nginx-deploy.yaml Verify that 3 pods are indeed created. If you\u2019re curious, check the output of kubectl get deploy and kubectl describe deploy nginx-deployment . Delete one of the 3 pods using kubectl delete pod . After a few seconds again do kubectl get pod . You can see that a new pod is spawned to keep the total number of pods as 3 (see AGE 15s compared to others created 27 minutes ago)! This is a demonstration of how Kubernetes does fault tolerance. This is a property of Kubernetes deployment object (kill the pod from Lab1, it won\u2019t be respawned :) ) Let\u2019s say we want to increase the number of pods to 10. Try out kubectl scale deploy --replicas=10 nginx-deployment . You can see that 3/10 pods are older than the rest. This means Kubernetes has added 7 extra pods to scale the deployment to 10. This shows how simple it is to scale up and scale down containers using Kubernetes. Let\u2019s put all these pods behind a ClusterIP service. Execute kubectl expose deployment nginx-deployment --name=nginx-service . Curl the IP corresponding to 10.96.114.184. This curl request reaches one of the 10 pods in the deployment \u201cnginx-deployment\u201d in a round robin fashion. What happens when we execute the expose command is that a kubernetes Service is created of type Cluster IP so that all the pods behind this service are accessible through a single local IP (10.96.114.184, here). It is possible to have a public IP instead (i.e an actual external load balancer) by creating a Service of type LoadBalancer . Do feel free to play around with it! The above exercises a pretty good exposure to using Kubernetes to manage large scale deployments. Trust me, the process is very similar to the above for operating 1000 deployments and containers too! While a Deployment object is good enough for managing stateless applications, Kuberenetes provides other resources like Job, Daemonset, Cronjob, Statefulset etc. to manage special use cases. eAdditional labs: https://www.katacoda.com/lizrice/scenarios/kube-web https://www.katacoda.com/courses/kubernetes (Huge number of free follow-along exercises to play with Kubernetes) Advanced topics Most often than not, microservices orchestrated with Kubernetes contain dozens of instances of resources like deployment, services and configs. The manifests for these applications can be auto- generated with Helm templates and passed on as Helm charts. Similar to how we have PiPy for python packages there are remote repositories like Bitnami where Helm charts (e.g for setting up a production-ready Prometheus or Kafka with a single click) can be downloaded and used. This is a good place to begin . Kuberenetes provides the flexibility to create our custom resources (similar to Deployment or the Pod which we saw). For instance, if you want to create 5 instances of a resource with kind as SchoolOfSre you can! The only thing is that you have to write your custom resource for it. You can also build a custom operator for your custom resource to take certain actions on the resource instance. You can check here for more information.","title":"Orchestration With Kubernetes"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#introduction","text":"Now we finally arrive at the most awaited part: running and managing containers at scale. So far, we have seen how Docker facilitates managing the life-cycle of containers and provides improved portability of applications. Docker does provide a solution for easing the deployment of containers on a large scale ( you can check out Docker Swarm, if interested) which integrates well with Docker containers. However, Kubernetes has become the de-facto tool for orchestrating the management of microservices (as containers) in large distributed environments. Let\u2019s see the points of interest for us, SREs, to use container orchestration tools and Kubernetes in particular.","title":"Introduction"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#motivation-to-use-kubernetes","text":"Ease of usage Though there is a steep learning curve associated with Kubernetes, once learnt , can be used as a one stop tool to manage your microservices. With a single command it is possible to deploy full fledged production ready environments. The desired state of an application needs to be recorded as a YAML manifest and Kubernetes manages the application for you. Ensure optimum usage of resources We can specify limits on resources used by each container in a deployment. We can also specify our choice of nodes where Kubernetes can schedule nodes to be deployed (e.g microservices with high CPU consumption can be instructed to be deployed in high compute nodes). Fault tolerance Self-healing is built into basic resource types of Kubernetes. This removes the headache of designing a fault tolerant application system from scratch. This applies especially to stateless applications. Infrastructure agnostic Kubernetes does not have vendor lock-in. It can be set up in multiple cloud environments or in on-prem data centers. Strong community support and documentation Kubernetes is open-source and many technologies like operators, service mesh etc. have been built by the community to manage and monitor Kubernetes-orchestrated applications better. Extensible and customisable We can build our custom resource definitions which fit our use case for managing applications and use Kubernetes to manage them (with custom controllers). You can check out this article if you are more interested in this topic.","title":"Motivation to use Kubernetes"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#architecture-of-kubernetes","text":"Here\u2019s a diagram (from the official Kubernetes documentation ) containing different components which make Kubernetes work: Kubernetes components can be divided into two parts: control plane components and data plane components . A Kubernetes cluster consists of 1 or more host machines (called nodes) where the containers managed by Kubernetes are run. This constitutes the data plane (or node plane). The brain of Kuberentes which responds to events from the node plane (e.g create a pod, replicas mismatch) and does the main orchestration is called the control plane. All control plane components are typically installed in a master node. This master node does not run any user containers. The Kubernetes components themselves are run as containers wrapped in Pods (which is the most basic kubernetes resource object). Control plane components: kube-apiserver etcd kube-scheduler kube-controller-manager Node plane components kubelet kube-proxy This workflow might help you understand the working on components better: An SRE installs kubectl in their local machine. This is the client which interacts with the Kubernetes control plane (and hence the cluster). They create a YAML file, called manifest which specifies the desired state of the resource (e.g a deployment names \u201cfrontend\u201d needs 3 pods to always be running) When they issue a command to create objects based in the YAML file, the kubectl CLI tool sends a rest API request to the kube-apiserver . If the manifest is valid, it is stored as key value pairs in the etcd server on the control plane. kube-scheduler chooses which nodes to put the containers on (basically schedules them) There are controller processes (managed by kube-controller manager) which makes sure the current state of the cluster is equivalent to the desired state (here, 3 pods are indeed running in the cluster -> all is fine). On the node plane side, kubelet makes sure that pods are locally kept in running state.","title":"Architecture of Kubernetes"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#lab","text":"","title":"LAB"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#prerequisites","text":"The best way to start this exercise is to use a Katacoda kubernetes playground . A single node kubernetes cluster is already set up for you here for quick experimentation. You can also use this to play with docker. The environment gets torn down after 10 mins. So make sure that you save your files if you want to resume them. For persistent kubernetes clusters, you can set it up either in your local (using minikube ) or you can create a kubernetes cluster in Azure , GCP or any other cloud provider. Knowledge of YAML is nice to have for understanding the manifest files.","title":"Prerequisites"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#hands-on","text":"","title":"Hands-on"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#lab-1","text":"We are going to create an object called Pod which is the most basic unit for running a container in Kubernetes. Here, we will create a pod called \u2018nginx-pod\u201d which contains an nginx container called \u201cweb\u201d. We will also expose port 80 in the container so that we can interact with the nginx container. Save the below manifest in a file called nginx-pod.yaml apiVersion: v1 #[1] kind: Pod #[2] metadata: #[3] name: nginx-pod #[4] labels: #[5] app: nginx spec: #[6] containers: #[7] - name: web #[8] image: nginx #[9] ports: #[10] - name: web #[11] containerPort: 80 #[12] protocol: TCP #[13] Let\u2019s very briefly understand what\u2019s here: #[2] - kind: The \u201ckind\u201d of object that\u2019s being created. Here it is a Pod #[1] - apiVersion: The apiVersion of the \u201cPod\u201d resource. There could be minor changes in the values or keys in the yaml file if the version varies. #[3] - metadata: The metadata section of the file where pod labels and name is given #[6] - spec: This is the main part where the things inside the pod are defined These are not random key value pairs! They have to be interpretable by the kubeapiserver. You can check which key value pairs are optional/mandatory using kubectl explain pod command. Do try it out! Apply the manifest using the command kubectl apply -f nginx-pod.yaml . This creates the \u201cnginx-pod\u201d pod in the kubernetes cluster. Verify that the pod is in running state using kubectl get pod . It shows that nginx-pod is in Running state. 1/1 indicates that out of 1 out of 1 container(s) inside the pod is healthy. To check if the container running in \u201cnginx-pod\u201d is indeed \u201cweb\u201d we do the kubectl describe pod/nginx-pod command. This gives a lengthy output with a detailed description of the pod and the events that happened since the pod was created. This command is very useful for debugging. The part we are concerned here is this: You can see \u201cweb\u201d under the Containers section with Image as nginx. This is what we are looking for. How do we access the welcome page of nginx \u201cweb\u201d container? In the describe command you can see the IP address of the pod. Each pod is assigned an IP address on creation. Here, this is 10.244.1.3 Issue a curl request from the host curl 10.244.1.3:80 . You will get the welcome page! Let\u2019s say we want to use a specific tag of nginx (say 1.20.1) in the same pod i.e we want to modify some property of the pod. You can try editing nginx-pod.yaml (image: nginx:1.20.1 in #[9])and reapplying (step 2.). It will create a new container in the same pod with the new image. A container is created within the pod but the pod is the same. You can verify by checking the pod start time in describe command. It would show a much older time. You can actually see the nginx container by doing docker ps on the node01 terminal (if you\u2019re using Katacoda). What if we want to change the image to 1.20.1 for 1000 nginx pods? Stepping a little back, what if we want to create 1000 nginx pods. Of course, we can write a script but Kubernetes already offers a resource type called \u201cdeployment\u201d to manage large scale deployments better.","title":"Lab 1:"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#lab-2","text":"We\u2019ll go a step further to see how we can create more than a single instance of the nginx pod at the same time. We will first create Save the below manifest in a file called nginx-deploy.yaml apiVersion: apps/v1 kind: Deployment #[1] metadata: name: nginx-deployment labels: app: nginx spec: replicas: 3 #[2] selector: matchLabels: app: nginx #[3] template: #[4] metadata: labels: app: nginx #[5] spec: containers: - name: web image: nginx ports: - name: web containerPort: 80 protocol: \"TCP\" You can see that it is similar to a pod definition till spec ( #[1] has Deployment as kind, api version is also different). Another thing interesting observation is the metadata and spec parts under #[4] is almost the same as the metadata and spec section under the Pod definition in Lab 1 (do go up and cross check this). What this implies is that we are deploying 3 nginx pods similar to Lab1. Also, the labels in matchLabels should be the same as labels under #[4] . Now apply the manifest using kubectl apply -f nginx-deploy.yaml Verify that 3 pods are indeed created. If you\u2019re curious, check the output of kubectl get deploy and kubectl describe deploy nginx-deployment . Delete one of the 3 pods using kubectl delete pod . After a few seconds again do kubectl get pod . You can see that a new pod is spawned to keep the total number of pods as 3 (see AGE 15s compared to others created 27 minutes ago)! This is a demonstration of how Kubernetes does fault tolerance. This is a property of Kubernetes deployment object (kill the pod from Lab1, it won\u2019t be respawned :) ) Let\u2019s say we want to increase the number of pods to 10. Try out kubectl scale deploy --replicas=10 nginx-deployment . You can see that 3/10 pods are older than the rest. This means Kubernetes has added 7 extra pods to scale the deployment to 10. This shows how simple it is to scale up and scale down containers using Kubernetes. Let\u2019s put all these pods behind a ClusterIP service. Execute kubectl expose deployment nginx-deployment --name=nginx-service . Curl the IP corresponding to 10.96.114.184. This curl request reaches one of the 10 pods in the deployment \u201cnginx-deployment\u201d in a round robin fashion. What happens when we execute the expose command is that a kubernetes Service is created of type Cluster IP so that all the pods behind this service are accessible through a single local IP (10.96.114.184, here). It is possible to have a public IP instead (i.e an actual external load balancer) by creating a Service of type LoadBalancer . Do feel free to play around with it! The above exercises a pretty good exposure to using Kubernetes to manage large scale deployments. Trust me, the process is very similar to the above for operating 1000 deployments and containers too! While a Deployment object is good enough for managing stateless applications, Kuberenetes provides other resources like Job, Daemonset, Cronjob, Statefulset etc. to manage special use cases. eAdditional labs: https://www.katacoda.com/lizrice/scenarios/kube-web https://www.katacoda.com/courses/kubernetes (Huge number of free follow-along exercises to play with Kubernetes)","title":"Lab 2:"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#advanced-topics","text":"Most often than not, microservices orchestrated with Kubernetes contain dozens of instances of resources like deployment, services and configs. The manifests for these applications can be auto- generated with Helm templates and passed on as Helm charts. Similar to how we have PiPy for python packages there are remote repositories like Bitnami where Helm charts (e.g for setting up a production-ready Prometheus or Kafka with a single click) can be downloaded and used. This is a good place to begin . Kuberenetes provides the flexibility to create our custom resources (similar to Deployment or the Pod which we saw). For instance, if you want to create 5 instances of a resource with kind as SchoolOfSre you can! The only thing is that you have to write your custom resource for it. You can also build a custom operator for your custom resource to take certain actions on the resource instance. You can check here for more information.","title":"Advanced topics"},{"location":"level102/linux_intermediate/archiving_backup/","text":"Archiving and Backup Introduction One of the things SREs make sure of is the services are up all the time (at least 99.99% of the time), but the amount of data generated at each server running those services are immense. This data could be logs, user data in the database, or any other kind of metadata. Hence we need to compress, archive, rotate, and Backup the data in a timely manner for data safety and to make sure we don\u2019t run out of space. Archiving We usually archive the data that are no longer needed but are kept mostly for compliance purposes. This helps in storing the data into compressed format saving a lot of space. Below section is to familiarize with the archiving tools and commands. gzip gzip is a program used to compress one or more files, it replaces the original file with a compressed version of the original file. Here we can see that the messages log file is compressed to almost one-fifth of the original size and replaced with messages.gz. We can uncompress this file using gunzip command. tar tar program is a tool for archiving files and directories into a single file (often called tarball). This tool is usually used to prepare archives of files before it is transferred to a long term backup server. tar doesn\u2019t replace the existing files and folders but creates a new file with extension .tar . It provides lot of flag to choose from for archiving Flags Description -c Creates archive -x Extracts the archive -f Creates archive with the given filename -t Displays or lists files in archived file -u Archives and adds to an existing archive file -v Displays verbose information -A Concatenates the archived file -z Compresses the tar file using gzip -j Compresses the tar file using bzip2 -W Verifies an archive file -r Updates or adds file or directory in already existing .tar file Create an archive with files and folder Flag c is used for creating the archive where f is the filename. Listing files in the archive We can use flag t for listing out what an archive contains. Extract files from the archive We can use flag x to unarchive the archive. Backup Backup is a process of copying/duplicating the existing data, This backup can be used to restore the dataset in case of data loss. Data backup also becomes critical when the data is not needed in a day to day job but can be referred to as a source of truth and for compliance reasons in future. Different types of backup are : Incremental backup Incremental backup is the backup of data since the last backup, this reduces data redundancy and storage efficiency. Differential backup Sometimes our data keeps on modifying/updating. In that case we take backup of changes that occurred since the last backup called differential backup. Network backup Network backup refers to sending out data over the network from the source to a backup destination in a client-server model. This backup destination can be centralized or decentralized. Decentralized backups are useful for disaster recovery scenarios. rsync is one of the linux command which sync up file from one server to the destination server over the network. The syntax for rsync goes like rsync \\[options\\] . We can locate the file on the path specified after : (colon) in the \u201c destination\u201d . If nothing is specified the default path is the home directory of the user used for backup. /home/azureuser in this case. You can always look for different options for rsync using the man rsync command. Cloud Backup There are various third parties which provide the backup of data to the cloud. These cloud backups are much more reliable than stored backups on local machines or any server without RAID configuration as these providers manage redundancy of data, data recovery along with the data security. Two most widely used cloud backup options are Azure backup (from Microsoft) and Amazon Glacier backup (from AWS).","title":"Archiving and Backup"},{"location":"level102/linux_intermediate/archiving_backup/#archiving-and-backup","text":"","title":"Archiving and Backup"},{"location":"level102/linux_intermediate/archiving_backup/#introduction","text":"One of the things SREs make sure of is the services are up all the time (at least 99.99% of the time), but the amount of data generated at each server running those services are immense. This data could be logs, user data in the database, or any other kind of metadata. Hence we need to compress, archive, rotate, and Backup the data in a timely manner for data safety and to make sure we don\u2019t run out of space.","title":"Introduction"},{"location":"level102/linux_intermediate/archiving_backup/#archiving","text":"We usually archive the data that are no longer needed but are kept mostly for compliance purposes. This helps in storing the data into compressed format saving a lot of space. Below section is to familiarize with the archiving tools and commands.","title":"Archiving"},{"location":"level102/linux_intermediate/archiving_backup/#gzip","text":"gzip is a program used to compress one or more files, it replaces the original file with a compressed version of the original file. Here we can see that the messages log file is compressed to almost one-fifth of the original size and replaced with messages.gz. We can uncompress this file using gunzip command.","title":"gzip"},{"location":"level102/linux_intermediate/archiving_backup/#tar","text":"tar program is a tool for archiving files and directories into a single file (often called tarball). This tool is usually used to prepare archives of files before it is transferred to a long term backup server. tar doesn\u2019t replace the existing files and folders but creates a new file with extension .tar . It provides lot of flag to choose from for archiving Flags Description -c Creates archive -x Extracts the archive -f Creates archive with the given filename -t Displays or lists files in archived file -u Archives and adds to an existing archive file -v Displays verbose information -A Concatenates the archived file -z Compresses the tar file using gzip -j Compresses the tar file using bzip2 -W Verifies an archive file -r Updates or adds file or directory in already existing .tar file","title":"tar"},{"location":"level102/linux_intermediate/archiving_backup/#create-an-archive-with-files-and-folder","text":"Flag c is used for creating the archive where f is the filename.","title":"Create an archive with files and folder"},{"location":"level102/linux_intermediate/archiving_backup/#listing-files-in-the-archive","text":"We can use flag t for listing out what an archive contains.","title":"Listing files in the archive"},{"location":"level102/linux_intermediate/archiving_backup/#extract-files-from-the-archive","text":"We can use flag x to unarchive the archive.","title":"Extract files from the archive"},{"location":"level102/linux_intermediate/archiving_backup/#backup","text":"Backup is a process of copying/duplicating the existing data, This backup can be used to restore the dataset in case of data loss. Data backup also becomes critical when the data is not needed in a day to day job but can be referred to as a source of truth and for compliance reasons in future. Different types of backup are :","title":"Backup"},{"location":"level102/linux_intermediate/archiving_backup/#incremental-backup","text":"Incremental backup is the backup of data since the last backup, this reduces data redundancy and storage efficiency.","title":"Incremental backup"},{"location":"level102/linux_intermediate/archiving_backup/#differential-backup","text":"Sometimes our data keeps on modifying/updating. In that case we take backup of changes that occurred since the last backup called differential backup.","title":"Differential backup"},{"location":"level102/linux_intermediate/archiving_backup/#network-backup","text":"Network backup refers to sending out data over the network from the source to a backup destination in a client-server model. This backup destination can be centralized or decentralized. Decentralized backups are useful for disaster recovery scenarios. rsync is one of the linux command which sync up file from one server to the destination server over the network. The syntax for rsync goes like rsync \\[options\\] . We can locate the file on the path specified after : (colon) in the \u201c destination\u201d . If nothing is specified the default path is the home directory of the user used for backup. /home/azureuser in this case. You can always look for different options for rsync using the man rsync command.","title":"Network backup"},{"location":"level102/linux_intermediate/archiving_backup/#cloud-backup","text":"There are various third parties which provide the backup of data to the cloud. These cloud backups are much more reliable than stored backups on local machines or any server without RAID configuration as these providers manage redundancy of data, data recovery along with the data security. Two most widely used cloud backup options are Azure backup (from Microsoft) and Amazon Glacier backup (from AWS).","title":"Cloud Backup"},{"location":"level102/linux_intermediate/bashscripting/","text":"Bash Scripting Introduction As an SRE, the Linux system sits at the core of our day to day work and so is bash scripting. It\u2019s a scripting language that is run by Linux Bash Interpreter. Until now we have covered a lot of features mostly on a command line, now we will use this command line as an interpreter to write programs that will ease our day to day job as an SRE. Writing the first bash script: We will start with a simple program, we will use Vim as the editor during the whole journey. #!/bin/bash # This if my first bash script # Line starting with # is commented echo \"Hello world!\" The first line of the script starting with \u201c#!\u201d is called she-bang. This is simply to let the system which interpreter to use while executing the script. Any Line starting with \u201c#\u201d (other than #!) is referred to as comments in script and is ignored by the interpreter while executing the script. Line 6 shows the \u201cecho\u201d command that we would be running. We will save this script as \u201cfirstscript.sh\u201d and make the script executable using chmod . Next thing is to run the script with the explicit path. We can see the desired \u201cHello World!\u201d as output. Taking user input and working with variables: Taking standard input using the read command and working with variables in bash. #!/bin/bash #We will take standard input #Will list all files at the path #We will concate variable and string echo \"Enter the path\" read path echo \"How deep in directory you want to go:\" read depth echo \"All files at path \" $path du -d $depth -all -h $path We are reading path in variable \u201c path \u201d and variable \u201c depth \u201d to list files and directories up to that depth. We concatenated strings with variables. We always use $ (dollar-sign) to reference the value it contains. We pass these variables to the du command to list out all the files and directories in that path upto the desired depth. Exit status: Every command and script when it completes executing, returns an integer in the range from 0 to 255 to the system, this is called exit status. \u201c0\u201d denotes success of the command while non-zero return code usually indicates various kinds of errors. We use $? special shell variable to get exit status of the last executed script or command. Command line arguments and understanding If \u2026 else branching: Another way to pass some values to the script is using command line arguments. Usually command line arguments in bash are accessed by $ followed by the index. The 0th index refers to the file itself, $1 to the first argument and so on. We use $# to check the count of arguments passed to the script. Making decisions in the programming language is it\u2019s integral part, and to tackle different conditions we use if \u2026 else statements or some more nested variant of it. The below script uses multiple concepts in one script. The aim of the script is to get some properties of the file. Line 4 to 7 is the standard example of \"if statement\" in bash. Syntax is as explained below: If [ condition ]; then If_block_to_execute else else_block_to_execute fi fi is to close the if \u2026 else block. We are comparing count of argument($#) if it is equal to 1 or not. If not we prompt for only one argument and exit the script with status code 1(not a success). One or more if statements can exist without else statement but vice versa doesn\u2019t make any sense. Operator -ne is used to compare two integers, read as \u201cinteger1 not equal to integer 2\u201d. Other comparison operators are: Operations Description num1 -eq num2 check if 1st number is equal to 2nd number num1 -ge num2 checks if 1st number is greater than or equal to 2nd number num1 -gt num2 checks if 1st number is greater than 2nd number num1 -le num2 checks if 1st number is less than or equal to 2nd number num1 -lt num2 checks if 1st number is less than 2nd number #!/bin/bash # This script evaluate the status of a file if [ $# -ne 1 ]; then echo \"Please pass one file name as argument\" exit 1 fi FILE=$1 if [ -e \"$FILE\" ]; then if [ -f \"$FILE\" ]; then echo \"$FILE is a regular file.\" fi if [ -d \"$FILE\" ]; then echo \"$FILE is a directory.\" fi if [ -r \"$FILE\" ]; then echo \"$FILE is readable.\" fi if [ -w \"$FILE\" ]; then echo \"$FILE is writable.\" fi if [ -x \"$FILE\" ]; then echo \"$FILE is executable/searchable.\" fi else echo \"$FILE does not exist\" exit 2 fi exit 0 There are lots of file expressions to evaluate file,like in bash script \u201c-e\u201d in line 10 returns true if the file passed as argument exist, false otherwise. Below are the some widely used file expressions: File Operations Description -e file File exists -d file File exists and is directory -f file File exists and is regular file -L file File exists and is symbolic link -r file File exists and has readable permission -w file File exists and has writable permission -x file File exists and has executable permission -s file File exists and size is greater than zero -S file File exists and is a network socket. Exit status is 2 when the file is not found. And if the file is found it prints out the properties it holds with exit status 0(success). Looping over to do a repeated task. We usually come up with tasks that are mostly repetitive, looping helps us to code those repetitive tasks in a more formal manner. There are different types of loop statement we can use in bash: Loop Syntax while while [ expression ] do [ while_block_to_execute ] done for for variable in 1,2,3 .. n do [ for_block_to_execute ] done until until [ expression ] do [ until_block_to_execute ] done !/bin/bash #Script to monitor the server hosts=`cat host_list` while true do for i in $hosts do h=\"$i\" ping -c 1 -q \"$h\" &>/dev/null if [ $? -eq 0 ] then echo `date` \"server $h alive\" else echo `date` \"server $h is dead\" fi done sleep 60 done Monitoring a server is an important part of being an SRE. The file \u201chost_list\u201d contains the list of host which we want to monitor. We used an infinite \u201cwhile\u201d loop that will sleep every 60seconds. And for each host in the host_list we want to ping that host and check if that ping was successful with its exit status, if it\u2019s successful we say server is live or it\u2019s dead. The output of the script shows it is running every minute with the timestamp. Function Developers always try to make their applications/programs in modular fashion so that they don\u2019t have to write the same code every time and everywhere to carry out similar tasks. Functions help us achieve this. We usually call functions with some arguments and expect result based on that argument. The backup process we discussed in earlier section, we will try to automate that process using the below script and also get familiar with some more concepts like string comparison, functions and logical AND and OR operations. In the below code \u201clog_backup\u201d is a function which won\u2019t be executed until it is called. Line37 will be executed first where we will check the no. of arguments passed to the script. There are many logical operators like AND,OR, XOR etc. Logical Operator Symbol AND && OR | NOT ! Passing the wrong argument to script \u201cbackup.sh\u201d will prompt for correct usage. We have to pass whether we want to have incremental backup of the directory or the full backup along with the path of the directory we want to backup. If we want the incremental backup we will an additional argument as a meta file which is used to store the information of previous backed up files.(usually a metafile is .snar extension). #!/bin/bash #Scripts to take incremental and full backup backup_dir=\"/mnt/backup/\" time_stamp=\"`date +%d-%m-%Y-%Hh-%Mm-%Ss`\" log_backup(){ if [ $# -lt 2 ]; then echo \"Usage: ./backup.sh [backup_type] [log_path]\" exit 1; fi if [ $1 == \"incremental\" ]; then if [ $# -ne 3 ]; then echo \"Usage: ./backup.sh [backup_type] [log_path] [meta_file]\" exit 3; fi tar --create --listed-incremental=$3 --verbose --verbose --file=\"${backup_dir}incremental-${time_stamp}.tar\" $2 if [ $? -eq 0 ]; then echo \"Incremental backup succesful at '${backup_dir}incremental-${time_stamp}.tar'\" else echo \"Incremental Backup Failure\" fi elif [ $1 == \"full\" ];then tar cf \"${backup_dir}fullbackup-${time_stamp}.tar\" $2 if [ $? -eq 0 ];then echo \"Full backup successful at '${backup_dir}fullbackup-${time_stamp}.tar'\" else echo \"Full Backup Failure\" fi else echo \"Unknown parameter passed\" echo \"Usage: ./backup.sh [incremental|full] [log_path]\" exit 2; fi } if [ $# -lt 2 ] || [ $# -gt 3 ];then echo \"Usage: ./backup.sh [incremental|full] [log_path]\" exit 1 elif [ $# -eq 2 ];then log_backup $1 $2 elif [ $# -eq 3 ];then log_backup $1 $2 $3 fi exit 0 Passing all 3 arguments for incremental backup will take incremental backup at \u201c/mnt/backup/\u201d with each archive having timestamp concatenated to each file. The arguments passed inside the function can be accessed via $ followed by the index. The 0th index refers to the function itself, $1 to the first argument and so on. We use #$ to check the count of arguments passed to the function. Once we pass the string \u201cincremental\u201d or \u201cfull\u201d it gets compared inside the function and the specific block is executed. Below are some more operations that can be performed over strings. String Operations Description string1 == string2 Returns true if string1 equals string 2 otherwise false. string1 != string2 Returns true if string NOT equal string 2 otherwise false. string1 ~= regex Returns true if string1 matches the extended regular expression. -z string Returns true if string length is zero otherwise false. -n string Returns true if string length is non-zero otherwise false.","title":"Bash Scripting"},{"location":"level102/linux_intermediate/bashscripting/#bash-scripting","text":"","title":"Bash Scripting"},{"location":"level102/linux_intermediate/bashscripting/#introduction","text":"As an SRE, the Linux system sits at the core of our day to day work and so is bash scripting. It\u2019s a scripting language that is run by Linux Bash Interpreter. Until now we have covered a lot of features mostly on a command line, now we will use this command line as an interpreter to write programs that will ease our day to day job as an SRE.","title":"Introduction"},{"location":"level102/linux_intermediate/bashscripting/#writing-the-first-bash-script","text":"We will start with a simple program, we will use Vim as the editor during the whole journey. #!/bin/bash # This if my first bash script # Line starting with # is commented echo \"Hello world!\" The first line of the script starting with \u201c#!\u201d is called she-bang. This is simply to let the system which interpreter to use while executing the script. Any Line starting with \u201c#\u201d (other than #!) is referred to as comments in script and is ignored by the interpreter while executing the script. Line 6 shows the \u201cecho\u201d command that we would be running. We will save this script as \u201cfirstscript.sh\u201d and make the script executable using chmod . Next thing is to run the script with the explicit path. We can see the desired \u201cHello World!\u201d as output.","title":"Writing the first bash script:"},{"location":"level102/linux_intermediate/bashscripting/#taking-user-input-and-working-with-variables","text":"Taking standard input using the read command and working with variables in bash. #!/bin/bash #We will take standard input #Will list all files at the path #We will concate variable and string echo \"Enter the path\" read path echo \"How deep in directory you want to go:\" read depth echo \"All files at path \" $path du -d $depth -all -h $path We are reading path in variable \u201c path \u201d and variable \u201c depth \u201d to list files and directories up to that depth. We concatenated strings with variables. We always use $ (dollar-sign) to reference the value it contains. We pass these variables to the du command to list out all the files and directories in that path upto the desired depth.","title":"Taking user input and working with variables:"},{"location":"level102/linux_intermediate/bashscripting/#exit-status","text":"Every command and script when it completes executing, returns an integer in the range from 0 to 255 to the system, this is called exit status. \u201c0\u201d denotes success of the command while non-zero return code usually indicates various kinds of errors. We use $? special shell variable to get exit status of the last executed script or command.","title":"Exit status:"},{"location":"level102/linux_intermediate/bashscripting/#command-line-arguments-and-understanding-if-else-branching","text":"Another way to pass some values to the script is using command line arguments. Usually command line arguments in bash are accessed by $ followed by the index. The 0th index refers to the file itself, $1 to the first argument and so on. We use $# to check the count of arguments passed to the script. Making decisions in the programming language is it\u2019s integral part, and to tackle different conditions we use if \u2026 else statements or some more nested variant of it. The below script uses multiple concepts in one script. The aim of the script is to get some properties of the file. Line 4 to 7 is the standard example of \"if statement\" in bash. Syntax is as explained below: If [ condition ]; then If_block_to_execute else else_block_to_execute fi fi is to close the if \u2026 else block. We are comparing count of argument($#) if it is equal to 1 or not. If not we prompt for only one argument and exit the script with status code 1(not a success). One or more if statements can exist without else statement but vice versa doesn\u2019t make any sense. Operator -ne is used to compare two integers, read as \u201cinteger1 not equal to integer 2\u201d. Other comparison operators are: Operations Description num1 -eq num2 check if 1st number is equal to 2nd number num1 -ge num2 checks if 1st number is greater than or equal to 2nd number num1 -gt num2 checks if 1st number is greater than 2nd number num1 -le num2 checks if 1st number is less than or equal to 2nd number num1 -lt num2 checks if 1st number is less than 2nd number #!/bin/bash # This script evaluate the status of a file if [ $# -ne 1 ]; then echo \"Please pass one file name as argument\" exit 1 fi FILE=$1 if [ -e \"$FILE\" ]; then if [ -f \"$FILE\" ]; then echo \"$FILE is a regular file.\" fi if [ -d \"$FILE\" ]; then echo \"$FILE is a directory.\" fi if [ -r \"$FILE\" ]; then echo \"$FILE is readable.\" fi if [ -w \"$FILE\" ]; then echo \"$FILE is writable.\" fi if [ -x \"$FILE\" ]; then echo \"$FILE is executable/searchable.\" fi else echo \"$FILE does not exist\" exit 2 fi exit 0 There are lots of file expressions to evaluate file,like in bash script \u201c-e\u201d in line 10 returns true if the file passed as argument exist, false otherwise. Below are the some widely used file expressions: File Operations Description -e file File exists -d file File exists and is directory -f file File exists and is regular file -L file File exists and is symbolic link -r file File exists and has readable permission -w file File exists and has writable permission -x file File exists and has executable permission -s file File exists and size is greater than zero -S file File exists and is a network socket. Exit status is 2 when the file is not found. And if the file is found it prints out the properties it holds with exit status 0(success).","title":"Command line arguments and understanding If \u2026 else branching:"},{"location":"level102/linux_intermediate/bashscripting/#looping-over-to-do-a-repeated-task","text":"We usually come up with tasks that are mostly repetitive, looping helps us to code those repetitive tasks in a more formal manner. There are different types of loop statement we can use in bash: Loop Syntax while while [ expression ] do [ while_block_to_execute ] done for for variable in 1,2,3 .. n do [ for_block_to_execute ] done until until [ expression ] do [ until_block_to_execute ] done !/bin/bash #Script to monitor the server hosts=`cat host_list` while true do for i in $hosts do h=\"$i\" ping -c 1 -q \"$h\" &>/dev/null if [ $? -eq 0 ] then echo `date` \"server $h alive\" else echo `date` \"server $h is dead\" fi done sleep 60 done Monitoring a server is an important part of being an SRE. The file \u201chost_list\u201d contains the list of host which we want to monitor. We used an infinite \u201cwhile\u201d loop that will sleep every 60seconds. And for each host in the host_list we want to ping that host and check if that ping was successful with its exit status, if it\u2019s successful we say server is live or it\u2019s dead. The output of the script shows it is running every minute with the timestamp.","title":"Looping over to do a repeated task."},{"location":"level102/linux_intermediate/bashscripting/#function","text":"Developers always try to make their applications/programs in modular fashion so that they don\u2019t have to write the same code every time and everywhere to carry out similar tasks. Functions help us achieve this. We usually call functions with some arguments and expect result based on that argument. The backup process we discussed in earlier section, we will try to automate that process using the below script and also get familiar with some more concepts like string comparison, functions and logical AND and OR operations. In the below code \u201clog_backup\u201d is a function which won\u2019t be executed until it is called. Line37 will be executed first where we will check the no. of arguments passed to the script. There are many logical operators like AND,OR, XOR etc. Logical Operator Symbol AND && OR | NOT ! Passing the wrong argument to script \u201cbackup.sh\u201d will prompt for correct usage. We have to pass whether we want to have incremental backup of the directory or the full backup along with the path of the directory we want to backup. If we want the incremental backup we will an additional argument as a meta file which is used to store the information of previous backed up files.(usually a metafile is .snar extension). #!/bin/bash #Scripts to take incremental and full backup backup_dir=\"/mnt/backup/\" time_stamp=\"`date +%d-%m-%Y-%Hh-%Mm-%Ss`\" log_backup(){ if [ $# -lt 2 ]; then echo \"Usage: ./backup.sh [backup_type] [log_path]\" exit 1; fi if [ $1 == \"incremental\" ]; then if [ $# -ne 3 ]; then echo \"Usage: ./backup.sh [backup_type] [log_path] [meta_file]\" exit 3; fi tar --create --listed-incremental=$3 --verbose --verbose --file=\"${backup_dir}incremental-${time_stamp}.tar\" $2 if [ $? -eq 0 ]; then echo \"Incremental backup succesful at '${backup_dir}incremental-${time_stamp}.tar'\" else echo \"Incremental Backup Failure\" fi elif [ $1 == \"full\" ];then tar cf \"${backup_dir}fullbackup-${time_stamp}.tar\" $2 if [ $? -eq 0 ];then echo \"Full backup successful at '${backup_dir}fullbackup-${time_stamp}.tar'\" else echo \"Full Backup Failure\" fi else echo \"Unknown parameter passed\" echo \"Usage: ./backup.sh [incremental|full] [log_path]\" exit 2; fi } if [ $# -lt 2 ] || [ $# -gt 3 ];then echo \"Usage: ./backup.sh [incremental|full] [log_path]\" exit 1 elif [ $# -eq 2 ];then log_backup $1 $2 elif [ $# -eq 3 ];then log_backup $1 $2 $3 fi exit 0 Passing all 3 arguments for incremental backup will take incremental backup at \u201c/mnt/backup/\u201d with each archive having timestamp concatenated to each file. The arguments passed inside the function can be accessed via $ followed by the index. The 0th index refers to the function itself, $1 to the first argument and so on. We use #$ to check the count of arguments passed to the function. Once we pass the string \u201cincremental\u201d or \u201cfull\u201d it gets compared inside the function and the specific block is executed. Below are some more operations that can be performed over strings. String Operations Description string1 == string2 Returns true if string1 equals string 2 otherwise false. string1 != string2 Returns true if string NOT equal string 2 otherwise false. string1 ~= regex Returns true if string1 matches the extended regular expression. -z string Returns true if string length is zero otherwise false. -n string Returns true if string length is non-zero otherwise false.","title":"Function"},{"location":"level102/linux_intermediate/conclusion/","text":"Conclusion Understanding package management is very crucial as an SRE, we always want the right set of software with their compatible versions to work in harmony to drive the big infrastructure and organization. We also saw how we can configure and use storage drives and how we can have redundancy of data using RAID to avoid the data loss, how data is placed over disk and use of file systems. Archiving and Backup is also a crucial part of being an SRE, It\u2019s our responsibility to keep the data safe and in a more efficient manner. Bash is very useful to automate the day to day toil that an SRE stumbles into. The above walkthrough of bash gives us an idea to get started, but mere reading through it won\u2019t take you much further. I believe \u201ctaking action and practicing the topic\u201d would give you confidence and will help you become a better SRE.","title":"Conclusion"},{"location":"level102/linux_intermediate/conclusion/#conclusion","text":"Understanding package management is very crucial as an SRE, we always want the right set of software with their compatible versions to work in harmony to drive the big infrastructure and organization. We also saw how we can configure and use storage drives and how we can have redundancy of data using RAID to avoid the data loss, how data is placed over disk and use of file systems. Archiving and Backup is also a crucial part of being an SRE, It\u2019s our responsibility to keep the data safe and in a more efficient manner. Bash is very useful to automate the day to day toil that an SRE stumbles into. The above walkthrough of bash gives us an idea to get started, but mere reading through it won\u2019t take you much further. I believe \u201ctaking action and practicing the topic\u201d would give you confidence and will help you become a better SRE.","title":"Conclusion"},{"location":"level102/linux_intermediate/introduction/","text":"Linux-Intermediate Prerequisites Expect to have gone through the School Of SRE Linux Basics . What to expect from this course This course is divided into two sections. In the first section we will cover where we left off the Linux Basics, earlier in the School of SRE curriculum, we will deep dive into some of the more advanced linux commands and concepts. In this second section we will discuss how we use Bash scripting in day to day work, automation and toil reduction as an SRE with the help of real life examples of any SRE. What is not covered under this course This course aims to make you familiar with the intersection of Linux commands, shell scripting and how SRE uses it. We would not be covering Linux internals. Lab Environment Setup Install docker on your system. https://docs.docker.com/engine/install/ We would be using RedHat Enterprise Linux (RHEL) 8. We would be running most of the commands in the above docker container. __________________________________________________________________________ Course Content Package Management Package: Dependencies Repository High Level and Low-Level Package management tools Storage Media Listing the mounted storage devices Creating a FileSystem Mounting the device Unmounting the device Making it easier with /etc/fstab file? Checking and Repairing FS RAID RAID levels RAID 0 (Striping) RAID 1(Mirroring) RAID 5(Striping with distributed parity) RAID 6(Striping with double parity) RAID 10(RAID 1+0 : Mirroring and Striping) Commands to monitor RAID LVM Archiving and Backup Archiving gzip tar Create an archive with files and folder Listing files in the archive Extract files from the archive Backup Incremental backup Differential backup Network backup Cloud Backup Introduction to Vim Opening a file and using insert mode Saving a file Exiting the VIM editor Bash Scripting Writing the first bash script Taking user input and working with variables Exit status Command line arguments and understanding If \u2026 else branching Looping over to do a repeated task Function Conclusion","title":"Introduction"},{"location":"level102/linux_intermediate/introduction/#linux-intermediate","text":"","title":"Linux-Intermediate"},{"location":"level102/linux_intermediate/introduction/#prerequisites","text":"Expect to have gone through the School Of SRE Linux Basics .","title":"Prerequisites"},{"location":"level102/linux_intermediate/introduction/#what-to-expect-from-this-course","text":"This course is divided into two sections. In the first section we will cover where we left off the Linux Basics, earlier in the School of SRE curriculum, we will deep dive into some of the more advanced linux commands and concepts. In this second section we will discuss how we use Bash scripting in day to day work, automation and toil reduction as an SRE with the help of real life examples of any SRE.","title":"What to expect from this course"},{"location":"level102/linux_intermediate/introduction/#what-is-not-covered-under-this-course","text":"This course aims to make you familiar with the intersection of Linux commands, shell scripting and how SRE uses it. We would not be covering Linux internals.","title":"What is not covered under this course"},{"location":"level102/linux_intermediate/introduction/#lab-environment-setup","text":"Install docker on your system. https://docs.docker.com/engine/install/ We would be using RedHat Enterprise Linux (RHEL) 8. We would be running most of the commands in the above docker container. __________________________________________________________________________","title":"Lab Environment Setup"},{"location":"level102/linux_intermediate/introduction/#course-content","text":"Package Management Package: Dependencies Repository High Level and Low-Level Package management tools Storage Media Listing the mounted storage devices Creating a FileSystem Mounting the device Unmounting the device Making it easier with /etc/fstab file? Checking and Repairing FS RAID RAID levels RAID 0 (Striping) RAID 1(Mirroring) RAID 5(Striping with distributed parity) RAID 6(Striping with double parity) RAID 10(RAID 1+0 : Mirroring and Striping) Commands to monitor RAID LVM Archiving and Backup Archiving gzip tar Create an archive with files and folder Listing files in the archive Extract files from the archive Backup Incremental backup Differential backup Network backup Cloud Backup Introduction to Vim Opening a file and using insert mode Saving a file Exiting the VIM editor Bash Scripting Writing the first bash script Taking user input and working with variables Exit status Command line arguments and understanding If \u2026 else branching Looping over to do a repeated task Function Conclusion","title":"Course Content"},{"location":"level102/linux_intermediate/introvim/","text":"Introduction to Vim Introduction As an SRE we several times log into into the servers and make changes to the config file, edit and modify scripts and the editor which comes handy and available in almost all linux distribution is Vim. Vim is an open-source and free command line editor, widely accepted and used. We will see some basics of how to use vim for creating and editing files. This knowledge will help us in understanding the next section, Scripting. Opening a file and using insert mode We use the command vim filename to open a file filename . The terminal will open an editor but once you start writing, it won\u2019t work. It\u2019s because we are not in \"INSERT\" mode in vim. Press i and get into insert mode and start writing. You will see on the bottom left \u201cINSERT\u201d after pressing \u201c i \u201d . You can use * ESC \u201d key to get back to normal mode. Saving a file After you insert your text in INSERT mode press ESC(escape) key on your keyboard to get out of it. Press : (colon shift +;) and press w and hit enter, the text you entered will get written in the file. Exiting the VIM editor Exiting vim can get real challenging for the beginners. There are various ways you can exit the Vim like exit without saving the work, exit with saving the work. Try below commands after exiting insert mode and pressing : (colon). Vim Commands Description :q Exit the file but won\u2019t exit if file has unsaved changes :wq Write(save) and exit the file. :q! Exit without saving the changes. This is basic we would be needing in bash scripting in the next section. You can always visit tutorial for learning more. For quick practice of vim commands visit: https://www.openvim.com/","title":"Introduction to Vim"},{"location":"level102/linux_intermediate/introvim/#introduction-to-vim","text":"","title":"Introduction to Vim"},{"location":"level102/linux_intermediate/introvim/#introduction","text":"As an SRE we several times log into into the servers and make changes to the config file, edit and modify scripts and the editor which comes handy and available in almost all linux distribution is Vim. Vim is an open-source and free command line editor, widely accepted and used. We will see some basics of how to use vim for creating and editing files. This knowledge will help us in understanding the next section, Scripting.","title":"Introduction"},{"location":"level102/linux_intermediate/introvim/#opening-a-file-and-using-insert-mode","text":"We use the command vim filename to open a file filename . The terminal will open an editor but once you start writing, it won\u2019t work. It\u2019s because we are not in \"INSERT\" mode in vim. Press i and get into insert mode and start writing. You will see on the bottom left \u201cINSERT\u201d after pressing \u201c i \u201d . You can use * ESC \u201d key to get back to normal mode.","title":"Opening a file and using insert mode"},{"location":"level102/linux_intermediate/introvim/#saving-a-file","text":"After you insert your text in INSERT mode press ESC(escape) key on your keyboard to get out of it. Press : (colon shift +;) and press w and hit enter, the text you entered will get written in the file.","title":"Saving a file"},{"location":"level102/linux_intermediate/introvim/#exiting-the-vim-editor","text":"Exiting vim can get real challenging for the beginners. There are various ways you can exit the Vim like exit without saving the work, exit with saving the work. Try below commands after exiting insert mode and pressing : (colon). Vim Commands Description :q Exit the file but won\u2019t exit if file has unsaved changes :wq Write(save) and exit the file. :q! Exit without saving the changes. This is basic we would be needing in bash scripting in the next section. You can always visit tutorial for learning more. For quick practice of vim commands visit: https://www.openvim.com/","title":"Exiting the VIM editor"},{"location":"level102/linux_intermediate/package_management/","text":"Package Management Introduction One of the main features of any operating system is the ability to run other programs and softwares, and hence Package management comes into picture. Package management is a method of installing and maintaining software programs on any operating system. Package In the early days of Linux, one had to download source code of any software and compile it to install and run the software. As the Linux space became more mature, it is understood the software landscape is very dynamic and started distributing software in the form of packages. Package file is a compressed collection of files that contains software, its dependencies, installation instructions and metadata about the package. Dependencies It is rare that a software package is stand-alone, it depends on the different software, libraries and modules. These subroutines are stored and made available in the form of shared libraries which may serve more than one program. These shared resources are called dependencies. Package management does this hard job of resolving dependencies and installing them for the user along with the software. Repository Repository is a storage location where all the packages, updates, dependencies are stored. Each repository can contain thousands of software packages hosted on a remote server intended to be installed and updated on linux systems. We usually update the package information ( often referred to as metadata ) by running \u201c sudo dnf update\u201d. Try out sudo dnf repolist all to list all the repositories. We usually add repositories for installing packages from third party vendors. dnf config-manager --add-repo http://www.example.com/example.repo High Level and Low-Level Package management tools There are mainly two types of packages management tools: 1. Low-level tools : This is mostly used for installing, removing and upgrading package files. 2. High-Level tools : In addition to Low-level tools, High-level tools do metadata searching and dependency resolution as well. Linux Distribution Low-Level Tools High-Level tools Debian dpkg apt-get Fedora, RedHat dnf dnf","title":"Package Management"},{"location":"level102/linux_intermediate/package_management/#package-management","text":"","title":"Package Management"},{"location":"level102/linux_intermediate/package_management/#introduction","text":"One of the main features of any operating system is the ability to run other programs and softwares, and hence Package management comes into picture. Package management is a method of installing and maintaining software programs on any operating system.","title":"Introduction"},{"location":"level102/linux_intermediate/package_management/#package","text":"In the early days of Linux, one had to download source code of any software and compile it to install and run the software. As the Linux space became more mature, it is understood the software landscape is very dynamic and started distributing software in the form of packages. Package file is a compressed collection of files that contains software, its dependencies, installation instructions and metadata about the package.","title":"Package"},{"location":"level102/linux_intermediate/package_management/#dependencies","text":"It is rare that a software package is stand-alone, it depends on the different software, libraries and modules. These subroutines are stored and made available in the form of shared libraries which may serve more than one program. These shared resources are called dependencies. Package management does this hard job of resolving dependencies and installing them for the user along with the software.","title":"Dependencies"},{"location":"level102/linux_intermediate/package_management/#repository","text":"Repository is a storage location where all the packages, updates, dependencies are stored. Each repository can contain thousands of software packages hosted on a remote server intended to be installed and updated on linux systems. We usually update the package information ( often referred to as metadata ) by running \u201c sudo dnf update\u201d. Try out sudo dnf repolist all to list all the repositories. We usually add repositories for installing packages from third party vendors. dnf config-manager --add-repo http://www.example.com/example.repo","title":"Repository"},{"location":"level102/linux_intermediate/package_management/#high-level-and-low-level-package-management-tools","text":"There are mainly two types of packages management tools: 1. Low-level tools : This is mostly used for installing, removing and upgrading package files. 2. High-Level tools : In addition to Low-level tools, High-level tools do metadata searching and dependency resolution as well. Linux Distribution Low-Level Tools High-Level tools Debian dpkg apt-get Fedora, RedHat dnf dnf","title":"High Level and Low-Level Package management tools"},{"location":"level102/linux_intermediate/storage_media/","text":"Storage Media Introduction Storage media are devices which are used to store data and information. Linux has amazing capabilities when it comes to handling external devices including storage devices. There are many kinds of storage devices physical storage devices like hard drives, virtual storage devices like RAID or LVM, network storage and so on. In this section we will learn to work with any storage device and configure it to our needs. Listing the mounted storage devices: We can use command mount to list all the storage devices mounted to your computer. The format in which we see above output is: device on mount_point type file\\_system\\_type (options) For example in the first line the device virtual sysfs is mounted at /sys path and has a sysfs file system. Now let\u2019s see what and how a filesystem is created. Creating a FileSystem Imagine a disk where all the data stored in the disk is in the form of one large chunk, there is nothing to figure out where one piece of data starts and ends, which piece of data is located at which place of the whole chunk of data and hence the File System comes into picture. File System(fs) is responsible for data storage, indexing and retrieval on any storage device. Below are the most popularly used file systems: FS Type Description FAT File Allocation Table, initially used on DOS and Microsoft Windows and now widely used for portable USB storage NTFS (New Technology File System) Used on Microsoft\u2019s Windows based operating systems ext Extended file system, designed for Linux systems. ext4 Fourth extended filesystem, is a journaled file system that is commonly used by the Linux kernel. HFS Hierarchical File System, in use until HFS+ was introduced on Mac OS 8.1. HFS+ Supports file system journaling, enabling recovery of data after a system crash. NFS Network File System originally from Sun Microsystems is the standard in UNIX-based networks. We will try to create an ext4 file system which is linux native fs using mkfs . Discalimer: Run this command on empty disk as this will wipe out the existing data. Here the device /dev/sdb1 is formatted and it\u2019s filesystem is changed to ext4 . Mounting the device: In Linux systems all files are arranged in a tree structure with (/) as root. Mounting a fs simply means making that fs accessible to a certain point in the Linux directory tree. We need a mount point(location) where we want to mount the above formatted device. We created a mount point /mount and used the mount command to attach the filesystem. Here -t flag specifies what is the fs type and after that the /dev/sdb1 (device name) and /mount (mount point we created earlier). Unmounting the device: Now let\u2019s see how we can unmount the device, which is equally important if we have removable storage media and want to mount on another host. We use umount for unmounting the device. Our first attempt did not unmount the /sdb1 because we were inside the storage device and it was being used. Once we jumped back to the home directory we were successfully able to unmount the device. Making it easier with /etc/fstab file? In our production environment, we can have servers with many storage devices that need to be mounted, and it is not feasible to mount each device using the command every time we reboot the system. To ease this burden, we can make use of configuration table called \u201cfstab\u201d usually found in /etc/fstab on Linux systems. Here on the first line we have /dev/mapper/rootvg-rootlv (storage device ) mounted on / (root mount point) which has the xfs filesystem type followed by options. We can run mount -a to reload this file after making changes. Checking and Repairing FS Filesystems encounter issues in case of any hardware failure, power failure and sometimes due to improper shutdown. Linux usually checks and repairs the corrupted disk if any during startup. We can also manually check for filesystem corruption using the command fsck . We can repair the same filesystem using fsck -y /dev/sdb1 . There are error codes attached to each kind of file system error ,and A sum of active errors is returned. Error Codes Description 0 No errors 1 Filesystem errors corrected 2 System should be rebooted 4 Filesystem errors left uncorrected 8 Operational error 16 Usage or syntax error 32 Checking canceled by user request 128 Shared-library error In the above fs check we got return code as 12 which is the sum of error code 8(operational error) and 4(uncorrected FS error). RAID RAID or \u201cRedundant Arrays of Independent Disks\u201d is a technique that distributes I/O across multiple disks to achieve increased performance and data redundancy. RAID has the ability to increase overall disk performance and survive disk failures. Software RAID uses the computer\u2019s CPU to carry out RAID operations whereas hardware RAID uses specialized processors, on disk controllers, to manage the disks. Three essential features of RAID are mirroring, striping and parity. RAID levels The below section discusses the RAID levels that are commonly used. For information on all RAID levels, please refer to here . RAID 0 (Striping) Striping is the method by which data is split up into \u201cblocks\u201d and written across all the disks present in the array. By spreading data across multiple drives, it means multiple disks can access the file, resulting in faster read/write speeds. The first disk in the array is not reused until an equal amount of data is written to each of the other disks in the array. Advantages It can be easily implemented. Bottlenecks caused due to I/O operations from the same disk are avoided, increasing the performance of such operations. Disadvantages It does not offer any kind of redundancy. If any one of the disks fails, then the data of the entire disk is lost and cannot be recovered. Use cases RAID 0 can be used for systems with non-critical data that has to be read at high speed, such as a video/audio editing station or gaming environments. RAID 1(Mirroring) Mirroring writes a copy of data to each disk which is part of the array. This means that the data is written as many times as disks in the array . It stores an exact replica of all data on a separate disk or disks. As expected, this would result in a slow write performance compared to that of a single disk. On the other hand, read operations can be done parallelly improving read performance. Advantages RAID 1 offers a better read performance than RAID 0 or single disk. It can survive multiple disk failures without the need for special data recovery algorithms Disadvantages It is costly since the effective storage capacity is only half of the number of disks due to replication of data. Use cases Applications that require low downtime but can have a slight hit on write performance. RAID 4(Striping with dedicated parity) RAID 4 works uses block-level striping (data can be striped in blocks of a variety of sizes depending on the applications and data to be stored) and a dedicated drive used to store parity information.The parity information is generated by an algorithm every time data is written to an array disk. The use of a parity bit is a way of adding checksums into data that can enable the target device to determine whether the data has been received correctly. In the event of a drive failure , the algorithm can be reversed and missing data can be generated based on the remaining data and parity information. Advantages Each drive in a RAID 4 array operates independently so I/O requests take place in parallel, speeding up performance over previous RAID levels. It can survive multiple disk failures without the need for special data recovery algorithms Disadvantages A minimum of 3 disks is required for setup. It needs hardware support for parity calculation. Write speeds are slow since parity relies on a single disk drive and carry out modifications of parity blocks for each I/O session. Use cases Operations dealing with really large files \u2013 when sequential read and write data process is used RAID 5(Striping with distributed parity) RAID 5 is similar to RAID 4, except that the parity information is spread across all drives in the array. This helps reduce the bottleneck inherent in writing parity information to a single drive during each write operation. RAID 5 is the most common secure RAID level. Advantages Read data transactions are fast as compared to write data transactions that are somewhat slow due to the calculation of parity. Data remains accessible even after drive failure and during replacement of a failed hard drive because the storage controller rebuilds the data on the new drive. Disadvantages RAID 5 requires a minimum of 3 drives and can work up to a maximum of 16 drives It needs hardware support for parity calculation. More than two drive failures can cause data loss. Use cases File storage and application servers, such as email, general storage servers, etc. RAID 6(Striping with double parity) RAID 6 is similar to RAID 5 with an added advantage of double distributed parity, which provides fault tolerance up to two failed drives. Advantages Read data transactions are fast. This provides a fault tolerance up to 2 failed drives. RAID 6 is more resilient than RAID 5. Disadvantages Write data transactions are slow due to double parity. Rebuilding the RAID array takes a longer time because of complex structure. Use cases Office automation, online customer service, and applications that require very high availability. RAID 10(RAID 1+0 : Mirroring and Striping) RAID 10 is a combination of RAID 0 and RAID 1. It means that both mirroring and striping in one single RAID array. Advantages Rebuilding the RAID array is fast. Read and write operations performance are good. Disadvantages Just like RAID 1, only half the drive capacity is available. It can be expensive to implement RAID 10. Use cases Transactional databases with sensitive information that require high performance and high data security. Commands to monitor RAID The command cat /proc/mdstat will give the status of a software RAID. Let us examine the output of the command: Personalities : [raid1] md0 : active raid1 sdb1[2] sda1[0] 10476544 blocks super 1.1 [2/2] [UU] bitmap: 0/1 pages [0KB], 65536KB chunk md1 : active raid1 sdb2[2] sda2[0] 10476544 blocks super 1.1 [2/2] [UU] bitmap: 1/1 pages [4KB], 65536KB chunk md2 : active raid1 sdb3[2] 41909248 blocks super 1.1 [2/1] [_U] bitmap: 1/1 pages [4KB], 65536KB chunk The \u201cpersonalities\u201d gives us the raid level that the raid is configured. In the above example, the raid is configured with RAID 1. md0 : active raid1 sdb1[2] sda1[0] tells us that there is an active raid of RAID 1 between sdb1(which is device 2) and sda1(which is device 0).An inactive array generally means that one of the disks are faulty. Md2 in the above example shows that we have 41909248 blocks super 1.1 [2/1] [_U] , this means that one disk is down in this particular raid. The command mdadm --detail /dev/ gives detailed information about that particular array. sudo mdadm --detail /dev/md0 /dev/md0: Version : 1.1 Creation Time : Fri Nov 17 11:49:20 2019 Raid Level : raid1 Array Size : 10476544 (9.99 GiB 10.32 GB) Used Dev Size : 10476544 (9.99 GiB 10.32 GB) Raid Devices : 2 Total Devices : 2 Persistence : Superblock is persistent Intent Bitmap : Internal Update Time : Sun Dec 2 01:00:53 2019 State : clean Active Devices : 2 Working Devices : 2 Failed Devices : 0 Spare Devices : 0 UUID : xxxxxxx:yyyyyy:zzzzzz:ffffff Events : 987 Number Major Minor RaidDevice State 0 8 1 0 active sync /dev/sda1 1 8 49 1 active sync /dev/sdb1 Incase of a missing disk in the above example, the State of the raid would be \u2018dirty\u2019 and Active Devices and Working Devices would be reduced to one. One of the entries(either /dev/sda1 or /dev/sdb1 depending on the missing disk) would have their RaidDevice changed to faulty. LVM LVM stands for Logical Volume Management. In the above section we saw how we can create FS and use individual disks according to our need the traditional way but using LVM we can achieve more flexibility in storage allocation like we can stitch three 2TB disks to make one single partition of 6TB, or we can attach another physical disk of 4TB to the server and add that disk to the logical volume group to make it 10TB in total. Refer to know more about LVM: https://www.redhat.com/sysadmin/lvm-vs-partitioning","title":"Storage Media"},{"location":"level102/linux_intermediate/storage_media/#storage-media","text":"","title":"Storage Media"},{"location":"level102/linux_intermediate/storage_media/#introduction","text":"Storage media are devices which are used to store data and information. Linux has amazing capabilities when it comes to handling external devices including storage devices. There are many kinds of storage devices physical storage devices like hard drives, virtual storage devices like RAID or LVM, network storage and so on. In this section we will learn to work with any storage device and configure it to our needs.","title":"Introduction"},{"location":"level102/linux_intermediate/storage_media/#listing-the-mounted-storage-devices","text":"We can use command mount to list all the storage devices mounted to your computer. The format in which we see above output is: device on mount_point type file\\_system\\_type (options) For example in the first line the device virtual sysfs is mounted at /sys path and has a sysfs file system. Now let\u2019s see what and how a filesystem is created.","title":"Listing the mounted storage devices:"},{"location":"level102/linux_intermediate/storage_media/#creating-a-filesystem","text":"Imagine a disk where all the data stored in the disk is in the form of one large chunk, there is nothing to figure out where one piece of data starts and ends, which piece of data is located at which place of the whole chunk of data and hence the File System comes into picture. File System(fs) is responsible for data storage, indexing and retrieval on any storage device. Below are the most popularly used file systems: FS Type Description FAT File Allocation Table, initially used on DOS and Microsoft Windows and now widely used for portable USB storage NTFS (New Technology File System) Used on Microsoft\u2019s Windows based operating systems ext Extended file system, designed for Linux systems. ext4 Fourth extended filesystem, is a journaled file system that is commonly used by the Linux kernel. HFS Hierarchical File System, in use until HFS+ was introduced on Mac OS 8.1. HFS+ Supports file system journaling, enabling recovery of data after a system crash. NFS Network File System originally from Sun Microsystems is the standard in UNIX-based networks. We will try to create an ext4 file system which is linux native fs using mkfs . Discalimer: Run this command on empty disk as this will wipe out the existing data. Here the device /dev/sdb1 is formatted and it\u2019s filesystem is changed to ext4 .","title":"Creating a FileSystem"},{"location":"level102/linux_intermediate/storage_media/#mounting-the-device","text":"In Linux systems all files are arranged in a tree structure with (/) as root. Mounting a fs simply means making that fs accessible to a certain point in the Linux directory tree. We need a mount point(location) where we want to mount the above formatted device. We created a mount point /mount and used the mount command to attach the filesystem. Here -t flag specifies what is the fs type and after that the /dev/sdb1 (device name) and /mount (mount point we created earlier).","title":"Mounting the device:"},{"location":"level102/linux_intermediate/storage_media/#unmounting-the-device","text":"Now let\u2019s see how we can unmount the device, which is equally important if we have removable storage media and want to mount on another host. We use umount for unmounting the device. Our first attempt did not unmount the /sdb1 because we were inside the storage device and it was being used. Once we jumped back to the home directory we were successfully able to unmount the device.","title":"Unmounting the device:"},{"location":"level102/linux_intermediate/storage_media/#making-it-easier-with-etcfstab-file","text":"In our production environment, we can have servers with many storage devices that need to be mounted, and it is not feasible to mount each device using the command every time we reboot the system. To ease this burden, we can make use of configuration table called \u201cfstab\u201d usually found in /etc/fstab on Linux systems. Here on the first line we have /dev/mapper/rootvg-rootlv (storage device ) mounted on / (root mount point) which has the xfs filesystem type followed by options. We can run mount -a to reload this file after making changes.","title":"Making it easier with /etc/fstab file?"},{"location":"level102/linux_intermediate/storage_media/#checking-and-repairing-fs","text":"Filesystems encounter issues in case of any hardware failure, power failure and sometimes due to improper shutdown. Linux usually checks and repairs the corrupted disk if any during startup. We can also manually check for filesystem corruption using the command fsck . We can repair the same filesystem using fsck -y /dev/sdb1 . There are error codes attached to each kind of file system error ,and A sum of active errors is returned. Error Codes Description 0 No errors 1 Filesystem errors corrected 2 System should be rebooted 4 Filesystem errors left uncorrected 8 Operational error 16 Usage or syntax error 32 Checking canceled by user request 128 Shared-library error In the above fs check we got return code as 12 which is the sum of error code 8(operational error) and 4(uncorrected FS error).","title":"Checking and Repairing FS"},{"location":"level102/linux_intermediate/storage_media/#raid","text":"RAID or \u201cRedundant Arrays of Independent Disks\u201d is a technique that distributes I/O across multiple disks to achieve increased performance and data redundancy. RAID has the ability to increase overall disk performance and survive disk failures. Software RAID uses the computer\u2019s CPU to carry out RAID operations whereas hardware RAID uses specialized processors, on disk controllers, to manage the disks. Three essential features of RAID are mirroring, striping and parity.","title":"RAID"},{"location":"level102/linux_intermediate/storage_media/#raid-levels","text":"The below section discusses the RAID levels that are commonly used. For information on all RAID levels, please refer to here .","title":"RAID levels"},{"location":"level102/linux_intermediate/storage_media/#raid-0-striping","text":"Striping is the method by which data is split up into \u201cblocks\u201d and written across all the disks present in the array. By spreading data across multiple drives, it means multiple disks can access the file, resulting in faster read/write speeds. The first disk in the array is not reused until an equal amount of data is written to each of the other disks in the array. Advantages It can be easily implemented. Bottlenecks caused due to I/O operations from the same disk are avoided, increasing the performance of such operations. Disadvantages It does not offer any kind of redundancy. If any one of the disks fails, then the data of the entire disk is lost and cannot be recovered. Use cases RAID 0 can be used for systems with non-critical data that has to be read at high speed, such as a video/audio editing station or gaming environments.","title":"RAID 0 (Striping)"},{"location":"level102/linux_intermediate/storage_media/#raid-1mirroring","text":"Mirroring writes a copy of data to each disk which is part of the array. This means that the data is written as many times as disks in the array . It stores an exact replica of all data on a separate disk or disks. As expected, this would result in a slow write performance compared to that of a single disk. On the other hand, read operations can be done parallelly improving read performance. Advantages RAID 1 offers a better read performance than RAID 0 or single disk. It can survive multiple disk failures without the need for special data recovery algorithms Disadvantages It is costly since the effective storage capacity is only half of the number of disks due to replication of data. Use cases Applications that require low downtime but can have a slight hit on write performance.","title":"RAID 1(Mirroring)"},{"location":"level102/linux_intermediate/storage_media/#raid-4striping-with-dedicated-parity","text":"RAID 4 works uses block-level striping (data can be striped in blocks of a variety of sizes depending on the applications and data to be stored) and a dedicated drive used to store parity information.The parity information is generated by an algorithm every time data is written to an array disk. The use of a parity bit is a way of adding checksums into data that can enable the target device to determine whether the data has been received correctly. In the event of a drive failure , the algorithm can be reversed and missing data can be generated based on the remaining data and parity information. Advantages Each drive in a RAID 4 array operates independently so I/O requests take place in parallel, speeding up performance over previous RAID levels. It can survive multiple disk failures without the need for special data recovery algorithms Disadvantages A minimum of 3 disks is required for setup. It needs hardware support for parity calculation. Write speeds are slow since parity relies on a single disk drive and carry out modifications of parity blocks for each I/O session. Use cases Operations dealing with really large files \u2013 when sequential read and write data process is used","title":"RAID 4(Striping with dedicated parity)"},{"location":"level102/linux_intermediate/storage_media/#raid-5striping-with-distributed-parity","text":"RAID 5 is similar to RAID 4, except that the parity information is spread across all drives in the array. This helps reduce the bottleneck inherent in writing parity information to a single drive during each write operation. RAID 5 is the most common secure RAID level. Advantages Read data transactions are fast as compared to write data transactions that are somewhat slow due to the calculation of parity. Data remains accessible even after drive failure and during replacement of a failed hard drive because the storage controller rebuilds the data on the new drive. Disadvantages RAID 5 requires a minimum of 3 drives and can work up to a maximum of 16 drives It needs hardware support for parity calculation. More than two drive failures can cause data loss. Use cases File storage and application servers, such as email, general storage servers, etc.","title":"RAID 5(Striping with distributed parity)"},{"location":"level102/linux_intermediate/storage_media/#raid-6striping-with-double-parity","text":"RAID 6 is similar to RAID 5 with an added advantage of double distributed parity, which provides fault tolerance up to two failed drives. Advantages Read data transactions are fast. This provides a fault tolerance up to 2 failed drives. RAID 6 is more resilient than RAID 5. Disadvantages Write data transactions are slow due to double parity. Rebuilding the RAID array takes a longer time because of complex structure. Use cases Office automation, online customer service, and applications that require very high availability.","title":"RAID 6(Striping with double parity)"},{"location":"level102/linux_intermediate/storage_media/#raid-10raid-10-mirroring-and-striping","text":"RAID 10 is a combination of RAID 0 and RAID 1. It means that both mirroring and striping in one single RAID array. Advantages Rebuilding the RAID array is fast. Read and write operations performance are good. Disadvantages Just like RAID 1, only half the drive capacity is available. It can be expensive to implement RAID 10. Use cases Transactional databases with sensitive information that require high performance and high data security.","title":"RAID 10(RAID 1+0 : Mirroring and Striping)"},{"location":"level102/linux_intermediate/storage_media/#commands-to-monitor-raid","text":"The command cat /proc/mdstat will give the status of a software RAID. Let us examine the output of the command: Personalities : [raid1] md0 : active raid1 sdb1[2] sda1[0] 10476544 blocks super 1.1 [2/2] [UU] bitmap: 0/1 pages [0KB], 65536KB chunk md1 : active raid1 sdb2[2] sda2[0] 10476544 blocks super 1.1 [2/2] [UU] bitmap: 1/1 pages [4KB], 65536KB chunk md2 : active raid1 sdb3[2] 41909248 blocks super 1.1 [2/1] [_U] bitmap: 1/1 pages [4KB], 65536KB chunk The \u201cpersonalities\u201d gives us the raid level that the raid is configured. In the above example, the raid is configured with RAID 1. md0 : active raid1 sdb1[2] sda1[0] tells us that there is an active raid of RAID 1 between sdb1(which is device 2) and sda1(which is device 0).An inactive array generally means that one of the disks are faulty. Md2 in the above example shows that we have 41909248 blocks super 1.1 [2/1] [_U] , this means that one disk is down in this particular raid. The command mdadm --detail /dev/ gives detailed information about that particular array. sudo mdadm --detail /dev/md0 /dev/md0: Version : 1.1 Creation Time : Fri Nov 17 11:49:20 2019 Raid Level : raid1 Array Size : 10476544 (9.99 GiB 10.32 GB) Used Dev Size : 10476544 (9.99 GiB 10.32 GB) Raid Devices : 2 Total Devices : 2 Persistence : Superblock is persistent Intent Bitmap : Internal Update Time : Sun Dec 2 01:00:53 2019 State : clean Active Devices : 2 Working Devices : 2 Failed Devices : 0 Spare Devices : 0 UUID : xxxxxxx:yyyyyy:zzzzzz:ffffff Events : 987 Number Major Minor RaidDevice State 0 8 1 0 active sync /dev/sda1 1 8 49 1 active sync /dev/sdb1 Incase of a missing disk in the above example, the State of the raid would be \u2018dirty\u2019 and Active Devices and Working Devices would be reduced to one. One of the entries(either /dev/sda1 or /dev/sdb1 depending on the missing disk) would have their RaidDevice changed to faulty.","title":"Commands to monitor RAID"},{"location":"level102/linux_intermediate/storage_media/#lvm","text":"LVM stands for Logical Volume Management. In the above section we saw how we can create FS and use individual disks according to our need the traditional way but using LVM we can achieve more flexibility in storage allocation like we can stitch three 2TB disks to make one single partition of 6TB, or we can attach another physical disk of 4TB to the server and add that disk to the logical volume group to make it 10TB in total. Refer to know more about LVM: https://www.redhat.com/sysadmin/lvm-vs-partitioning","title":"LVM"},{"location":"level102/networking/conclusion/","text":"This course would have given some background on deploying services in datacentre and various parameters to consider and available solutions. It has to be noted that, each of the solution discussed here have various pros and cons, so specific to the scenario/requirement, the right fit among these are to be identified and used. As we didnt go the depth of various technologies/solution in this course, it might have made the reader curious to know about some of the topics. Here are some of the reference or online training content, for further learning. linked engineering blog : has information about how Linkedin datacentres are setup and some of the key problems are solved. IPSpace blog : Has lot of articles about datacentre networking. Networking Basics course in edx. Happy learning !!","title":"Conclusion"},{"location":"level102/networking/infrastructure-features/","text":"Some of the aspects to consider are, whether the underlying data centre infrastructure supports ToR resiliency, i.e. features like link bundling (bonds), BGP, support for anycast service, load balancer, firewall, Quality of Service. As seen in previous sections, to deploy applications at scale, it will need certain capabilities to be supported from the infrastructure. This section will cover different options available, and their suitability. ToR connectivity This being one of the most frequent points of failure (considering the scale of deployment), there are different options available to connect the servers to the ToR. We are going to see them in detail below, Single ToR This is the simplest of all the options. Where a NIC of the server is connected to one ToR. The advantage of this approach is, there is a minimal number of switch ports used, allowing the DC fabric to support the rapid growth of server infrastructure (Note: Not only the ToR ports are used efficiently, but the upper switching layer in DC fabric as well, the port usage will be efficient). On the downside, the servers can be unreachable if there is an issue with the ToR, link or NIC. This will impact the stateful apps more, as the existing connections get abruptly disconnected. Fig 4: Single ToR design Dual ToR In this option, each server is connected to two ToR, of the same cabinet. This can be set up in active/passive mode, thereby providing resiliency during ToR/link/NIC failures. The resiliency can be achieved either in layer 2 or in layer 3. Layer 2 In this case, both the links are bundled together as a bond on the server side (with one NIC taking the active role and the other being passive). On the switch side, these two links are made part of multi-chassis lag (similar to bonding, but spread across switches). The prerequisite here is, both the ToR should be part of the same layer 2 domain. The IP addresses are configured on the bond interface on the server and SVI on the switch side. Note: In this, the ToR 2 role is only to provide resiliency. Fig 5: Dual ToR layer 2 setup Layer 3 In this case, both the links are configured as separate layer 3 interfaces. The resiliency is achieved by setting up a routing protocol (like BGP). Wherein one link is given higher preference over the other. In this case, the two ToR's can be set up independently, in layer 3 mode. The servers would need a virtual address, to which the services have to be bound. Note: In this, the ToR 2 role is only to provide resiliency. Fig 6: Dual ToR layer 3 setup Though the resiliency is better with dual ToR, the drawback is, the number of ports being used. As the access port in the ToR doubles up, the number of ports required in the Spine layer also doubles up, and this keeps cascading to higher layers. Type Single ToR Dual ToR (layer 2) Dual ToR (layer 3) Resiliency 1 No 2 Yes Yes Port usage 1:1 1:2 1:2 Cabling Less More More Cost of DC fabric Low High High ToR features required Low High Medium 1 Resiliency in terms of ToR/Link/NIC 2 As an alternative, resiliency can be addressed at the application layer. Along with the above-mentioned ones, an application might need more capabilities out of the infrastructure to deploy at scale. Some of them are, Anycast As seen in the previous section, of deploying at scale, anycast is one of the means to have services distributed across cabinets and still have traffic flowing to each one of the servers. To achieve this, two things are required Routing protocol between ToR and server (to announce the anycast address) Support for ECMP (Equal Cost Multi-Path) load balancing in the infrastructure, to distribute the flows across the cabinets. Load balancing Similar to Anycast, another means to achieve load balancing across servers (host a particular app), is using load balancers. These could be implemented in different ways Hardware load balancers: A LB device is placed inline of the traffic flow, and looks at the layer 3 and layer 4 information in an incoming packet. Then determine the set of real hosts, to which the connections are to be redirected. As covered in the Scale topic, these load balancers can be set up in two ways, Single-arm mode: In this mode, the load balancer handles only the incoming requests to the VIP. The response from the server goes directly to the clients. There are two ways to implement this, L2 DSR: Where the load balancer and the real servers remain in the same VLAN. Upon getting an incoming request, the load balancer identifies the real server to redirect the request and then modifies the destination mac address of that Ethernet frame. Upon processing this packet, the real server responds directly to the client. L3 DSR : In this case, the load balancer and real servers need not be in the same VLAN (does away with layer 2 complexities like running STP, managing wider broadcast domain, etc). Upon incoming request, the load balancer redirects to the real server, by modifying the destination IP address of the packet. Along with this, the DSCP value of the packet is set to a predefined value (mapped for that VIP). Upon receipt of this packet, the real server uses the DSCP value to determine the loopback address (VIP address). The response again goes directly to the client. Two arm mode: In this case, the load balancer is in line for incoming and outgoing traffic. DNS based load balancer: Here the DNS servers keep a check of the health of the real servers and resolve the domain in such a way that the client can connect to different servers in that cluster. This part was explained in detail in the deployment at scale section. IPVS based load balancing: This is another means, where an IPVS server presents itself as the service endpoint to the clients. Upon incoming request, the IPVS directs the request to the real servers. The IPVS can be set up to do health for the real servers. NAT Network Address Translation (NAT) will be required for hosts that need to connect to destinations on the Internet, but don't want to expose their configured NIC address. In this case, the address (of the internal server) is translated to a public address by a firewall. Few examples of this are proxy servers, mail servers, etc. QoS Quality of Service is a means to provide, differentiate treatment to few packets over others. These could provide priority in forwarding queues, or bandwidth reservations. In the data centre scenario, depending upon the bandwidth subscription ratio, the need for QoS varies, 1:1 bandwidth subscription ratio: In this case, the server to ToR connectivity (all servers in that cabinet) bandwidth should be equivalent to the ToR to Spine switch connectivity. Similarly for the upper layers as well. In this design, congestion on a link is not going to happen, as enough bandwidth will always be available. In this case, the only difference QoS can bring, it provides priority treatment for certain packets in the forwarding queue. Note: Packet buffering happens, when the packet moves between ports of different speeds, like 100Gbps, 10Gbps. Oversubscribed network: In this case, not all layers maintain a bandwidth subscription ratio, for example, the ToR uplink may be of lower bandwidth, compared to ToR to Server bandwidth (This is sometimes referred to as oversubscription ratio). In this case, there is a possibility of congestion. Here QoS might be required, to give priority as well as bandwidth reservation, for certain types of traffic flows.","title":"Infrastructure Services"},{"location":"level102/networking/infrastructure-features/#tor-connectivity","text":"This being one of the most frequent points of failure (considering the scale of deployment), there are different options available to connect the servers to the ToR. We are going to see them in detail below,","title":"ToR connectivity"},{"location":"level102/networking/infrastructure-features/#single-tor","text":"This is the simplest of all the options. Where a NIC of the server is connected to one ToR. The advantage of this approach is, there is a minimal number of switch ports used, allowing the DC fabric to support the rapid growth of server infrastructure (Note: Not only the ToR ports are used efficiently, but the upper switching layer in DC fabric as well, the port usage will be efficient). On the downside, the servers can be unreachable if there is an issue with the ToR, link or NIC. This will impact the stateful apps more, as the existing connections get abruptly disconnected. Fig 4: Single ToR design","title":"Single ToR"},{"location":"level102/networking/infrastructure-features/#dual-tor","text":"In this option, each server is connected to two ToR, of the same cabinet. This can be set up in active/passive mode, thereby providing resiliency during ToR/link/NIC failures. The resiliency can be achieved either in layer 2 or in layer 3.","title":"Dual ToR"},{"location":"level102/networking/infrastructure-features/#layer-2","text":"In this case, both the links are bundled together as a bond on the server side (with one NIC taking the active role and the other being passive). On the switch side, these two links are made part of multi-chassis lag (similar to bonding, but spread across switches). The prerequisite here is, both the ToR should be part of the same layer 2 domain. The IP addresses are configured on the bond interface on the server and SVI on the switch side. Note: In this, the ToR 2 role is only to provide resiliency. Fig 5: Dual ToR layer 2 setup","title":"Layer 2"},{"location":"level102/networking/infrastructure-features/#layer-3","text":"In this case, both the links are configured as separate layer 3 interfaces. The resiliency is achieved by setting up a routing protocol (like BGP). Wherein one link is given higher preference over the other. In this case, the two ToR's can be set up independently, in layer 3 mode. The servers would need a virtual address, to which the services have to be bound. Note: In this, the ToR 2 role is only to provide resiliency. Fig 6: Dual ToR layer 3 setup Though the resiliency is better with dual ToR, the drawback is, the number of ports being used. As the access port in the ToR doubles up, the number of ports required in the Spine layer also doubles up, and this keeps cascading to higher layers. Type Single ToR Dual ToR (layer 2) Dual ToR (layer 3) Resiliency 1 No 2 Yes Yes Port usage 1:1 1:2 1:2 Cabling Less More More Cost of DC fabric Low High High ToR features required Low High Medium 1 Resiliency in terms of ToR/Link/NIC 2 As an alternative, resiliency can be addressed at the application layer. Along with the above-mentioned ones, an application might need more capabilities out of the infrastructure to deploy at scale. Some of them are,","title":"Layer 3"},{"location":"level102/networking/infrastructure-features/#anycast","text":"As seen in the previous section, of deploying at scale, anycast is one of the means to have services distributed across cabinets and still have traffic flowing to each one of the servers. To achieve this, two things are required Routing protocol between ToR and server (to announce the anycast address) Support for ECMP (Equal Cost Multi-Path) load balancing in the infrastructure, to distribute the flows across the cabinets.","title":"Anycast"},{"location":"level102/networking/infrastructure-features/#load-balancing","text":"Similar to Anycast, another means to achieve load balancing across servers (host a particular app), is using load balancers. These could be implemented in different ways Hardware load balancers: A LB device is placed inline of the traffic flow, and looks at the layer 3 and layer 4 information in an incoming packet. Then determine the set of real hosts, to which the connections are to be redirected. As covered in the Scale topic, these load balancers can be set up in two ways, Single-arm mode: In this mode, the load balancer handles only the incoming requests to the VIP. The response from the server goes directly to the clients. There are two ways to implement this, L2 DSR: Where the load balancer and the real servers remain in the same VLAN. Upon getting an incoming request, the load balancer identifies the real server to redirect the request and then modifies the destination mac address of that Ethernet frame. Upon processing this packet, the real server responds directly to the client. L3 DSR : In this case, the load balancer and real servers need not be in the same VLAN (does away with layer 2 complexities like running STP, managing wider broadcast domain, etc). Upon incoming request, the load balancer redirects to the real server, by modifying the destination IP address of the packet. Along with this, the DSCP value of the packet is set to a predefined value (mapped for that VIP). Upon receipt of this packet, the real server uses the DSCP value to determine the loopback address (VIP address). The response again goes directly to the client. Two arm mode: In this case, the load balancer is in line for incoming and outgoing traffic. DNS based load balancer: Here the DNS servers keep a check of the health of the real servers and resolve the domain in such a way that the client can connect to different servers in that cluster. This part was explained in detail in the deployment at scale section. IPVS based load balancing: This is another means, where an IPVS server presents itself as the service endpoint to the clients. Upon incoming request, the IPVS directs the request to the real servers. The IPVS can be set up to do health for the real servers.","title":"Load balancing"},{"location":"level102/networking/infrastructure-features/#nat","text":"Network Address Translation (NAT) will be required for hosts that need to connect to destinations on the Internet, but don't want to expose their configured NIC address. In this case, the address (of the internal server) is translated to a public address by a firewall. Few examples of this are proxy servers, mail servers, etc.","title":"NAT"},{"location":"level102/networking/infrastructure-features/#qos","text":"Quality of Service is a means to provide, differentiate treatment to few packets over others. These could provide priority in forwarding queues, or bandwidth reservations. In the data centre scenario, depending upon the bandwidth subscription ratio, the need for QoS varies, 1:1 bandwidth subscription ratio: In this case, the server to ToR connectivity (all servers in that cabinet) bandwidth should be equivalent to the ToR to Spine switch connectivity. Similarly for the upper layers as well. In this design, congestion on a link is not going to happen, as enough bandwidth will always be available. In this case, the only difference QoS can bring, it provides priority treatment for certain packets in the forwarding queue. Note: Packet buffering happens, when the packet moves between ports of different speeds, like 100Gbps, 10Gbps. Oversubscribed network: In this case, not all layers maintain a bandwidth subscription ratio, for example, the ToR uplink may be of lower bandwidth, compared to ToR to Server bandwidth (This is sometimes referred to as oversubscription ratio). In this case, there is a possibility of congestion. Here QoS might be required, to give priority as well as bandwidth reservation, for certain types of traffic flows.","title":"QoS"},{"location":"level102/networking/introduction/","text":"Prerequisites It is recommended to have basic knowledge of network security, TCP and datacenter setup and the common terminologies used in them. Also, the readers are expected to go through the School of Sre contents - Linux Networking system design security What to expect from this course This part will cover how a datacenter infrastructure is segregated for different application needs as well as the consideration of deciding where to place an application. These will be broadly based on, Security, Scale, RTT (latency), Infrastructure features. Each of these topics will be covered in detail, Security - Will cover threat vectors faced by services facing external/internal clients. Potential mitigation options to consider while deploying them. This will touch upon perimeter security, DDoS protection, Network demarcation and ring-fencing the server clusters. Scale - Deploying large scale applications, require a better understanding of infrastructure capabilities, in terms of resource availability, failure domains, scaling options like using anycast, layer 4/7 load balancer, DNS based load balancing. RTT (latency) - Latency plays a key role in determining the overall performance of the distributed service/application, where calls are made between hosts to serve the users. Infrastructure features - Some of the aspects to consider are, whether the underlying data centre infrastructure supports ToR resiliency, i.e., features like link bundling (bonds), BGP (Border Gateway Protocol), support for anycast service, load balancer, firewall, Quality of Service. What is not covered under this course Though these parameters play a role in designing an application, we will not go into the details of the design. Each of these topics are vast, hence the objective is to introduce the terms and relevance of the parameters in them, and not to provide extensive details about each one of them. Course Contents Security Scale RTT Infrastructure features Conclusion Terminology Before discussing each of the topics, it is important to get familiar with few commonly used terms Cloud This refers to hosted solutions from different providers like Azure, AWS, GCP. Wherein enterprises can host their applications for either public or private usage. On-prem This term refers to physical Data Center(DC) infrastructure, built and managed by enterprises themselves. This can be used for private access as well as public (like users connecting over the Internet). Leaf switch (ToR) This refers to the switch, where the servers connect to, in a DC. They are called by many names, like access switch, Top of the Rack switch, Leaf switch. The term leaf switch comes from the Spine-leaf architecture , where the access switches are called leaf switches. Spine-leaf architecture is commonly used in large/hyper-scale data centres, which brings very high scalability options for the DC switching layer and is also more efficient in building and implementing these switches. Sometimes these are referred to as Clos architecture. Spine switch Spine switches are the aggregation point of several leaf switches, they provide the inter-leaf communication and also connect to the upper layer of DC infrastructure. DC fabric As the data centre grows, multiple Clos networks need to be interconnected, to support the scale, and fabric switches help to interconnect them. Cabinet This refers to the rack, where the servers and ToR are installed. One cabinet refers to the entire rack. BGP It is the Border Gateway Protocol, used to exchange routing information between routers and switches. This is one of the common protocols used in the Internet and as well Data Centers as well. Other protocols are also used in place of BGP, like OSPF. VPN A Virtual Private Network is a tunnel solution, where two private networks (like offices, datacentres, etc) can be interconnected over a public network (internet). These VPN tunnels encrypt the traffic before sending over the Internet, as a security measure. NIC Network Interface Card refers to the module in Servers, which consists of the Ethernet port and the interconnection to the system bus. It is used to connect to the switches (commonly ToR switches). Flow Flows refer to a traffic exchange between two nodes (could be servers, switches, routers, etc), which has common parameters like source/destination IP address, source/destination port number, IP Protocol number. This helps in traffic a particular traffic exchange session, between two nodes (like a file copy session, or an HTTP connection, etc). ECMP Equal Cost Multi-Path means, a switch/router can distribute the traffic to a destination, among multiple exit interfaces. The flow information is used to build a hash value and based on that, exit interfaces are selected. Once a flow is mapped to a particular exit interface, all the packets of that flow exit via the same interface only. This helps in preventing out of order delivery of packets. RTT This is a measure of the time it takes for a packet from the source to reach the destination and return to the source. This is most commonly used in measuring network performance and also troubleshooting. TCP throughput This is the measure of the data transfer rate achieved between two nodes. This is impacted by many parameters like RTT, packet size, window size, etc. Unicast This refers to the traffic flow between a single source to a single destination (i.e.) like ssh sessions, where there is one to one communication. Anycast This refers to one-to-one traffic flow as above, but endpoints could be multiple (i.e.) a single source can send traffic to any one of the destination hosts in that group. This is achieved by having the same IP address configured in multiple servers and every new traffic flow is mapped to one of the servers. Multicast This refers to one-to-many traffic flow (i.e.) a single source can send traffic to multiple destinations. To make it feasible, the network routers replicate the traffic to different hosts (which register as members of that particular multicast group).","title":"Introduction"},{"location":"level102/networking/introduction/#prerequisites","text":"It is recommended to have basic knowledge of network security, TCP and datacenter setup and the common terminologies used in them. Also, the readers are expected to go through the School of Sre contents - Linux Networking system design security","title":"Prerequisites"},{"location":"level102/networking/introduction/#what-to-expect-from-this-course","text":"This part will cover how a datacenter infrastructure is segregated for different application needs as well as the consideration of deciding where to place an application. These will be broadly based on, Security, Scale, RTT (latency), Infrastructure features. Each of these topics will be covered in detail, Security - Will cover threat vectors faced by services facing external/internal clients. Potential mitigation options to consider while deploying them. This will touch upon perimeter security, DDoS protection, Network demarcation and ring-fencing the server clusters. Scale - Deploying large scale applications, require a better understanding of infrastructure capabilities, in terms of resource availability, failure domains, scaling options like using anycast, layer 4/7 load balancer, DNS based load balancing. RTT (latency) - Latency plays a key role in determining the overall performance of the distributed service/application, where calls are made between hosts to serve the users. Infrastructure features - Some of the aspects to consider are, whether the underlying data centre infrastructure supports ToR resiliency, i.e., features like link bundling (bonds), BGP (Border Gateway Protocol), support for anycast service, load balancer, firewall, Quality of Service.","title":"What to expect from this course"},{"location":"level102/networking/introduction/#what-is-not-covered-under-this-course","text":"Though these parameters play a role in designing an application, we will not go into the details of the design. Each of these topics are vast, hence the objective is to introduce the terms and relevance of the parameters in them, and not to provide extensive details about each one of them.","title":"What is not covered under this course"},{"location":"level102/networking/introduction/#course-contents","text":"Security Scale RTT Infrastructure features Conclusion","title":"Course Contents"},{"location":"level102/networking/introduction/#terminology","text":"Before discussing each of the topics, it is important to get familiar with few commonly used terms Cloud This refers to hosted solutions from different providers like Azure, AWS, GCP. Wherein enterprises can host their applications for either public or private usage. On-prem This term refers to physical Data Center(DC) infrastructure, built and managed by enterprises themselves. This can be used for private access as well as public (like users connecting over the Internet). Leaf switch (ToR) This refers to the switch, where the servers connect to, in a DC. They are called by many names, like access switch, Top of the Rack switch, Leaf switch. The term leaf switch comes from the Spine-leaf architecture , where the access switches are called leaf switches. Spine-leaf architecture is commonly used in large/hyper-scale data centres, which brings very high scalability options for the DC switching layer and is also more efficient in building and implementing these switches. Sometimes these are referred to as Clos architecture. Spine switch Spine switches are the aggregation point of several leaf switches, they provide the inter-leaf communication and also connect to the upper layer of DC infrastructure. DC fabric As the data centre grows, multiple Clos networks need to be interconnected, to support the scale, and fabric switches help to interconnect them. Cabinet This refers to the rack, where the servers and ToR are installed. One cabinet refers to the entire rack. BGP It is the Border Gateway Protocol, used to exchange routing information between routers and switches. This is one of the common protocols used in the Internet and as well Data Centers as well. Other protocols are also used in place of BGP, like OSPF. VPN A Virtual Private Network is a tunnel solution, where two private networks (like offices, datacentres, etc) can be interconnected over a public network (internet). These VPN tunnels encrypt the traffic before sending over the Internet, as a security measure. NIC Network Interface Card refers to the module in Servers, which consists of the Ethernet port and the interconnection to the system bus. It is used to connect to the switches (commonly ToR switches). Flow Flows refer to a traffic exchange between two nodes (could be servers, switches, routers, etc), which has common parameters like source/destination IP address, source/destination port number, IP Protocol number. This helps in traffic a particular traffic exchange session, between two nodes (like a file copy session, or an HTTP connection, etc). ECMP Equal Cost Multi-Path means, a switch/router can distribute the traffic to a destination, among multiple exit interfaces. The flow information is used to build a hash value and based on that, exit interfaces are selected. Once a flow is mapped to a particular exit interface, all the packets of that flow exit via the same interface only. This helps in preventing out of order delivery of packets. RTT This is a measure of the time it takes for a packet from the source to reach the destination and return to the source. This is most commonly used in measuring network performance and also troubleshooting. TCP throughput This is the measure of the data transfer rate achieved between two nodes. This is impacted by many parameters like RTT, packet size, window size, etc. Unicast This refers to the traffic flow between a single source to a single destination (i.e.) like ssh sessions, where there is one to one communication. Anycast This refers to one-to-one traffic flow as above, but endpoints could be multiple (i.e.) a single source can send traffic to any one of the destination hosts in that group. This is achieved by having the same IP address configured in multiple servers and every new traffic flow is mapped to one of the servers. Multicast This refers to one-to-many traffic flow (i.e.) a single source can send traffic to multiple destinations. To make it feasible, the network routers replicate the traffic to different hosts (which register as members of that particular multicast group).","title":"Terminology"},{"location":"level102/networking/rtt/","text":"Latency plays a key role in determining the overall performance of the distributed service/application, where calls are made between hosts to serve the users. RTT is a measure of time, it takes for a packet to reach B from A, and return to A. It is measured in milliseconds. This measure plays a role in determining the performance of the services. Its impact is seen in calls made between different servers/services, to serve the user, as well as the TCP throughput that can be achieved. It is fairly common that service makes multiple calls to servers within its cluster or to different services like authentication, logging, database, etc, to respond to each user/client request. These servers can be spread across different cabinets, at times even between different data centres in the same region. Such cases are quite possible in cloud solutions, where the deployment spreads across different sites within a region. As the RTT increases, the response time for each of the calls gets longer and thereby has a cascading effect on the end response being sent to the user. Relation of RTT and throughput RTT is inversely proportional to the TCP throughput. As RTT increases, it reduces the TCP throughput, just like packet loss. Below is a formula to estimate the TCP throughput, based on TCP mss, RTT and packet loss. As within a data centre, these calculations are also, important for communication over the internet, where a client can connect to the DC hosted services, over different telco networks and the RTT is not very stable, due to the unpredictability of the Internet routing policies.","title":"RTT"},{"location":"level102/networking/rtt/#relation-of-rtt-and-throughput","text":"RTT is inversely proportional to the TCP throughput. As RTT increases, it reduces the TCP throughput, just like packet loss. Below is a formula to estimate the TCP throughput, based on TCP mss, RTT and packet loss. As within a data centre, these calculations are also, important for communication over the internet, where a client can connect to the DC hosted services, over different telco networks and the RTT is not very stable, due to the unpredictability of the Internet routing policies.","title":"Relation of RTT and throughput"},{"location":"level102/networking/scale/","text":"Deploying large scale applications, require a better understanding of infrastructure capabilities, in terms of resource availability, failure domains, scaling options like using anycast, layer 4/7 load balancer, DNS based load balancing. Building large scale applications is a complex activity, which should cover many aspects in design, development and as well as operationalisation. This section will talk about the considerations to look for while deploying them. Failure domains In any infrastructure, failures due to hardware or software issues are common. Though these may be a pain from a service availability perspective, these failures do happen and a pragmatic goal would be to, try to keep these failures to the minimum. Hence while deploying any service, failures/non-availability of some of the nodes to be factored in. Server failures A server could fail, due to power or NIC or software bug. And at times it may not be a complete failure but could be an error in the NIC, which causes some packet loss. This is a very common scenario and will impact the stateful services more. While designing such services, it is important to accommodate some level of tolerance to such failures. ToR failures This is one of the common scenarios, where the leaf switch connecting the servers goes down, along with it taking down the entire cabinet. There could be more than one server of the same service that can go down in this case. It requires planning to decide how much server loss can be handled without overloading other servers. Based on this, the service can be distributed across many cabinets. These calculations may vary, depending upon the resiliency in the ToR design, which will be covered in ToR connectivity section. Site failures Here site failure is a generic term, which could mean, a particular service is down in a site, maybe due to new version rollout, or failures of devices like firewall, load balancer, if the service depends on them, or loss of connectivity to remote sites (which might have limited options for resiliency) or issues with critical services like DNS, etc. Though these events may not be common, they can have a significant impact. In summary, handling these failure scenarios has to be thought about while designing the application itself. That will provide the tolerance required within the application to recover from unexpected failures. This will help not only for failures, even for planned maintenance work, as it will be easier to take part of the infrastructure, out of service. Resource availability The other aspect to consider while deploying applications at scale is the availability of the required infrastructure and the features the service is dependent upon. For example, for the resiliency of a cabinet, if one decides to distribute the service to 5 cabinets, but the service needs a load balancer (to distribute incoming connections to different servers), it may become challenging if load balancers are not supported in all cabinets. Or there could be a case that there are not enough cabinets available (that meet the minimum required specification for service to be set up). The best approach in these cases is to identify the requirements and gaps and then work with the Infrastructure team to best solve them. Scaling options While distributing the application to different cabinets, the incoming traffic to these services has to be distributed across these servers. To achieve this, the following may be considered Anycast This is one of the quickest ways to roll out traffic distribution across multiple cabinets. In this, each server, part of the cluster (where the service is set up), advertises a loopback address (/32 IPv4 or /128 IPv6 address), to the DC switch fabric (most commonly BGP is used for this purpose). The service has to be set up to be listening to this loopback address. When the clients try to connect to the service, get resolved to this virtual address and forward their queries. The DC switch fabric distributes each flow into different available next hops (eventually to all the servers in that service cluster). Note: The DC switch computes a hash, based on the IP packet header, this could include any combination of source and destination addresses, source and destination port, mac address and IP protocol number. Based on this hash value, a particular next-hop is picked up. Since all the packets in a traffic flow, carry the same values for these headers, all the packets in that flow will be mapped to the same path. Fig 1: Anycast setup To achieve a proportionate distribution of flows across these servers, it is important to maintain uniformity in each of the cabinets and pods. But remember, the distribution happens only based on flows, and if there are any elephant (large) flows, some servers might receive a higher volume of traffic. If there are any server or ToR failures, the advertisement of loopback address to the switches will stop, and thereby the new packets will be forwarded to the remaining available servers. Load balancer Another common approach is to use a load balancer. A Virtual IP is set up in the load balancers, to which the client connects while trying to access the service. The load balancer, in turn, redirects these connections to, one of the actual servers, where the service is running. In order to, verify the server is in the serviceable state, the load balancer does periodic health checks, and if it fails, the LB stops redirecting the connection to these servers. The load balancer can be deployed in single-arm mode, where the traffic to the VIP is redirected by the LB, and the return traffic from the server to the client is sent directly. The other option is the two-arm mode, where the return traffic is also passed through the LB. Fig 2: Single-arm mode Fig 3: Two-arm mode One of the cons of this approach is, at a higher scale, the load balancer can become the bottleneck, to support higher traffic volumes or concurrent connections per second. DNS based load balancing This is similar to the above approach, with the only difference is instead of an appliance, the load balancing is done at the DNS. The clients get different IP's to connect when they query for the DNS records of the service. The DNS server has to do a health check, to know which servers are in a good state. This approach alleviates the bottleneck of the load balancer solution. But require shorter TTL for the DNS records, so that problematic servers can be taken out of rotation quickly, which means, there will be far more DNS queries.","title":"Scale"},{"location":"level102/networking/scale/#failure-domains","text":"In any infrastructure, failures due to hardware or software issues are common. Though these may be a pain from a service availability perspective, these failures do happen and a pragmatic goal would be to, try to keep these failures to the minimum. Hence while deploying any service, failures/non-availability of some of the nodes to be factored in.","title":"Failure domains"},{"location":"level102/networking/scale/#server-failures","text":"A server could fail, due to power or NIC or software bug. And at times it may not be a complete failure but could be an error in the NIC, which causes some packet loss. This is a very common scenario and will impact the stateful services more. While designing such services, it is important to accommodate some level of tolerance to such failures.","title":"Server failures"},{"location":"level102/networking/scale/#tor-failures","text":"This is one of the common scenarios, where the leaf switch connecting the servers goes down, along with it taking down the entire cabinet. There could be more than one server of the same service that can go down in this case. It requires planning to decide how much server loss can be handled without overloading other servers. Based on this, the service can be distributed across many cabinets. These calculations may vary, depending upon the resiliency in the ToR design, which will be covered in ToR connectivity section.","title":"ToR failures"},{"location":"level102/networking/scale/#site-failures","text":"Here site failure is a generic term, which could mean, a particular service is down in a site, maybe due to new version rollout, or failures of devices like firewall, load balancer, if the service depends on them, or loss of connectivity to remote sites (which might have limited options for resiliency) or issues with critical services like DNS, etc. Though these events may not be common, they can have a significant impact. In summary, handling these failure scenarios has to be thought about while designing the application itself. That will provide the tolerance required within the application to recover from unexpected failures. This will help not only for failures, even for planned maintenance work, as it will be easier to take part of the infrastructure, out of service.","title":"Site failures"},{"location":"level102/networking/scale/#resource-availability","text":"The other aspect to consider while deploying applications at scale is the availability of the required infrastructure and the features the service is dependent upon. For example, for the resiliency of a cabinet, if one decides to distribute the service to 5 cabinets, but the service needs a load balancer (to distribute incoming connections to different servers), it may become challenging if load balancers are not supported in all cabinets. Or there could be a case that there are not enough cabinets available (that meet the minimum required specification for service to be set up). The best approach in these cases is to identify the requirements and gaps and then work with the Infrastructure team to best solve them.","title":"Resource availability"},{"location":"level102/networking/scale/#scaling-options","text":"While distributing the application to different cabinets, the incoming traffic to these services has to be distributed across these servers. To achieve this, the following may be considered","title":"Scaling options"},{"location":"level102/networking/scale/#anycast","text":"This is one of the quickest ways to roll out traffic distribution across multiple cabinets. In this, each server, part of the cluster (where the service is set up), advertises a loopback address (/32 IPv4 or /128 IPv6 address), to the DC switch fabric (most commonly BGP is used for this purpose). The service has to be set up to be listening to this loopback address. When the clients try to connect to the service, get resolved to this virtual address and forward their queries. The DC switch fabric distributes each flow into different available next hops (eventually to all the servers in that service cluster). Note: The DC switch computes a hash, based on the IP packet header, this could include any combination of source and destination addresses, source and destination port, mac address and IP protocol number. Based on this hash value, a particular next-hop is picked up. Since all the packets in a traffic flow, carry the same values for these headers, all the packets in that flow will be mapped to the same path. Fig 1: Anycast setup To achieve a proportionate distribution of flows across these servers, it is important to maintain uniformity in each of the cabinets and pods. But remember, the distribution happens only based on flows, and if there are any elephant (large) flows, some servers might receive a higher volume of traffic. If there are any server or ToR failures, the advertisement of loopback address to the switches will stop, and thereby the new packets will be forwarded to the remaining available servers.","title":"Anycast"},{"location":"level102/networking/scale/#load-balancer","text":"Another common approach is to use a load balancer. A Virtual IP is set up in the load balancers, to which the client connects while trying to access the service. The load balancer, in turn, redirects these connections to, one of the actual servers, where the service is running. In order to, verify the server is in the serviceable state, the load balancer does periodic health checks, and if it fails, the LB stops redirecting the connection to these servers. The load balancer can be deployed in single-arm mode, where the traffic to the VIP is redirected by the LB, and the return traffic from the server to the client is sent directly. The other option is the two-arm mode, where the return traffic is also passed through the LB. Fig 2: Single-arm mode Fig 3: Two-arm mode One of the cons of this approach is, at a higher scale, the load balancer can become the bottleneck, to support higher traffic volumes or concurrent connections per second.","title":"Load balancer"},{"location":"level102/networking/scale/#dns-based-load-balancing","text":"This is similar to the above approach, with the only difference is instead of an appliance, the load balancing is done at the DNS. The clients get different IP's to connect when they query for the DNS records of the service. The DNS server has to do a health check, to know which servers are in a good state. This approach alleviates the bottleneck of the load balancer solution. But require shorter TTL for the DNS records, so that problematic servers can be taken out of rotation quickly, which means, there will be far more DNS queries.","title":"DNS based load balancing"},{"location":"level102/networking/security/","text":"This section will cover threat vectors faced by services facing external/internal clients. Potential mitigation options to consider while deploying them. This will touch upon perimeter security, DDoS protection, Network demarcation and operational practices. Security Threat Security is one of the major considerations in any infrastructure. There are various security threats, which could amount to data theft, loss of service, fraudulent activity, etc. An attacker can use techniques like phishing, spamming, malware, Dos/DDoS, exploiting vulnerabilities, man-in-the-middle attack, and many more. In this section, we will cover some of these threats and possible mitigation. As there are numerous means to attack and secure the infrastructure, we will only focus on some of the most common ones. Phishing is mostly done via email (and other mass communication methods), where an attacker provides links to fake websites/URLs. Upon accessing that, victim's sensitive information like login credentials or personal data is collected and can be misused. Spamming is also similar to phishing, but the attacker doesn't collect data from users but tries to spam a particular website and probably overwhelm them (to cause slowness) and well use that opportunity to, compromise the security of the attacked website. Malware is like a trojan horse, where an attacker manages to install a piece of code on the secured systems in the infrastructure. Using this, the hacker can collect sensitive data and as well infect the critical services of the target company. Exploiting vulnerabilities is another method an attacker can gain access to the systems. These could be bugs or misconfiguration in web servers, internet-facing routers/switches/firewalls, etc. DoS/DDoS is one of the common attacks seen on internet-based services/solutions, especially those businesses based on eyeball traffic. Here the attacker tries to overwhelm the resources of the victim by generating spurious traffic to the external-facing services. By this, primarily the services turn slow or non-responsive, during this time, the attacker could try to hack into the network, if some of the security mechanism fails to filter through the attack traffic due to overload. Securing the infrastructure The first and foremost aspect for any infrastructure administration is to identify the various security threats that could affect the business running over this infrastructure. Once different threats are known, the security defence mechanism has to be designed and implemented. Some of the common means to securing the infrastructure are Perimeter security This is the first line of defence in any infrastructure, where unwanted/unexpected traffic flows into the infrastructure are filtered/blocked. These could be filters in the edge routers, that allow expected services (like port 443 traffic for web service running on HTTPS), or this filter can be set up to block unwanted traffic, like blocking UDP ports, if the services are not dependent on UDP. Similar to the application traffic entering the network, there could be other traffic like BGP messages for Internet peers, VPN tunnels traffic, as well other services like email/DNS, etc. There are means to protect every one of these, like using authentication mechanisms (password or key-based) for peers of BGP, VPN, and whitelisting these specific peers to make inbound connections (in perimeter filters). Along with these, the amount of messages/traffic can be rate-limited to known scale or expected load, so the resources are not overwhelmed. DDoS mitigation Protecting against a DDoS attack is another important aspect. The attack traffic will look similar to the genuine users/client request, but with the intention to flood the externally exposed app, which could be a web server, DNS, etc. Therefore it is essential to differentiate between the attack traffic and genuine traffic, for this, there are different methods to do at the application level, one such example using Captcha on a web service, to catch traffic originating from bots. For these methods to be useful, the nodes should be capable of handling both the attack traffic and genuine traffic. It may be possible in cloud-based infrastructure to dynamically add more virtual machines/resources, to handle the sudden spike in volume of traffic, but on-prem, the option to add additional resources might be challenging. To handle a large volume of attack traffic, there are solutions available, which can inspect the packets/traffic flows and identify anomalies (i.e.) traffic patterns that don't resemble a genuine connection, like client initiating TCP connection, but fail to complete the handshake, or set of sources, which have abnormally huge traffic flow. Once this unwanted traffic is identified, these are dropped at the edge of the network itself, thereby protecting the resources of app nodes. This topic alone can be discussed more in detail, but that will be beyond the scope of this section. Network Demarcation Network demarcation is another common strategy deployed in different networks when applications are grouped based on their security needs and vulnerability to an attack. Some common demarcations are, the external/internet facing nodes are grouped into a separate zone, whereas those nodes having sensitive data are segregated into a separate zone. And any communication between these zones is restricted with the help of security tools to limit exposure to unwanted hosts/ports. These inter-zone communication filters are sometimes called ring-fencing. The number of zones to be created, varies for different deployments, for example, there could be a host which should be able to communicate to the external world as well as internal servers, like proxy, email, in this case, these can be grouped under one zone, say De-Militarized Zones (DMZ). The main advantage of creating zones is that, even if there is a compromised host, that doesn't act as a back door entry for the rest of the infrastructure. Node protection Be it server, router, switches, load balancers, firewall, etc, each of these devices come with certain capabilities to secure themselves, like support for filters (e.g. Access-list, Iptables) to control what traffic to process and what to drop, anti-virus software can be used in servers to check on the software installed in them. Operational practices There are numerous security threats for infrastructure, and there are different solutions to defend them. The key part to the defence, is not only identifying the right solution and the tools for it but also making sure there are robust operational procedures in place, to respond promptly, decisively and with clarity, for any security incident. Standard Operating Procedures (SOP) SOP need to be well defined and act as a reference for on-call to follow during a security incident. This SoP should cover things like, When a security incident happens, how it will be alerted, to whom it will be alerted. Identify the scale and severity of the security incident. Who are the points of escalation and the threshold/time to intimate them, there could be other concerned teams or to the management or even to the security operations in-charge. Which solutions to use (and the procedure to follow in them) to mitigate the security incident. Also the data about the security incident has to be collated for further analysis. Many organisations have a dedicated team focused on security, and they drive most of the activities, during an attack and even before, to come up with best practices, guidelines and compliance audits. It is the responsibility of respective technical teams, to ensure the infrastructure meets these recommendations and gaps are fixed. Periodic review Along with defining SoP's, the entire security of the infrastructure has to be reviewed periodically. This review should include, Identifying any new/improved security threat that could potentially target the infrastructure. The SoP's have to be reviewed periodically, depending upon new security threats or changes in the procedure (to implement the solutions) Ensuring software upgrades/patches are done in a timely manner. Audit the infrastructure for any non-compliance of the security standards. Review of recent security incidents and find means to improvise the defence mechanisms.","title":"Security"},{"location":"level102/networking/security/#security-threat","text":"Security is one of the major considerations in any infrastructure. There are various security threats, which could amount to data theft, loss of service, fraudulent activity, etc. An attacker can use techniques like phishing, spamming, malware, Dos/DDoS, exploiting vulnerabilities, man-in-the-middle attack, and many more. In this section, we will cover some of these threats and possible mitigation. As there are numerous means to attack and secure the infrastructure, we will only focus on some of the most common ones. Phishing is mostly done via email (and other mass communication methods), where an attacker provides links to fake websites/URLs. Upon accessing that, victim's sensitive information like login credentials or personal data is collected and can be misused. Spamming is also similar to phishing, but the attacker doesn't collect data from users but tries to spam a particular website and probably overwhelm them (to cause slowness) and well use that opportunity to, compromise the security of the attacked website. Malware is like a trojan horse, where an attacker manages to install a piece of code on the secured systems in the infrastructure. Using this, the hacker can collect sensitive data and as well infect the critical services of the target company. Exploiting vulnerabilities is another method an attacker can gain access to the systems. These could be bugs or misconfiguration in web servers, internet-facing routers/switches/firewalls, etc. DoS/DDoS is one of the common attacks seen on internet-based services/solutions, especially those businesses based on eyeball traffic. Here the attacker tries to overwhelm the resources of the victim by generating spurious traffic to the external-facing services. By this, primarily the services turn slow or non-responsive, during this time, the attacker could try to hack into the network, if some of the security mechanism fails to filter through the attack traffic due to overload.","title":"Security Threat"},{"location":"level102/networking/security/#securing-the-infrastructure","text":"The first and foremost aspect for any infrastructure administration is to identify the various security threats that could affect the business running over this infrastructure. Once different threats are known, the security defence mechanism has to be designed and implemented. Some of the common means to securing the infrastructure are","title":"Securing the infrastructure"},{"location":"level102/networking/security/#perimeter-security","text":"This is the first line of defence in any infrastructure, where unwanted/unexpected traffic flows into the infrastructure are filtered/blocked. These could be filters in the edge routers, that allow expected services (like port 443 traffic for web service running on HTTPS), or this filter can be set up to block unwanted traffic, like blocking UDP ports, if the services are not dependent on UDP. Similar to the application traffic entering the network, there could be other traffic like BGP messages for Internet peers, VPN tunnels traffic, as well other services like email/DNS, etc. There are means to protect every one of these, like using authentication mechanisms (password or key-based) for peers of BGP, VPN, and whitelisting these specific peers to make inbound connections (in perimeter filters). Along with these, the amount of messages/traffic can be rate-limited to known scale or expected load, so the resources are not overwhelmed.","title":"Perimeter security"},{"location":"level102/networking/security/#ddos-mitigation","text":"Protecting against a DDoS attack is another important aspect. The attack traffic will look similar to the genuine users/client request, but with the intention to flood the externally exposed app, which could be a web server, DNS, etc. Therefore it is essential to differentiate between the attack traffic and genuine traffic, for this, there are different methods to do at the application level, one such example using Captcha on a web service, to catch traffic originating from bots. For these methods to be useful, the nodes should be capable of handling both the attack traffic and genuine traffic. It may be possible in cloud-based infrastructure to dynamically add more virtual machines/resources, to handle the sudden spike in volume of traffic, but on-prem, the option to add additional resources might be challenging. To handle a large volume of attack traffic, there are solutions available, which can inspect the packets/traffic flows and identify anomalies (i.e.) traffic patterns that don't resemble a genuine connection, like client initiating TCP connection, but fail to complete the handshake, or set of sources, which have abnormally huge traffic flow. Once this unwanted traffic is identified, these are dropped at the edge of the network itself, thereby protecting the resources of app nodes. This topic alone can be discussed more in detail, but that will be beyond the scope of this section.","title":"DDoS mitigation"},{"location":"level102/networking/security/#network-demarcation","text":"Network demarcation is another common strategy deployed in different networks when applications are grouped based on their security needs and vulnerability to an attack. Some common demarcations are, the external/internet facing nodes are grouped into a separate zone, whereas those nodes having sensitive data are segregated into a separate zone. And any communication between these zones is restricted with the help of security tools to limit exposure to unwanted hosts/ports. These inter-zone communication filters are sometimes called ring-fencing. The number of zones to be created, varies for different deployments, for example, there could be a host which should be able to communicate to the external world as well as internal servers, like proxy, email, in this case, these can be grouped under one zone, say De-Militarized Zones (DMZ). The main advantage of creating zones is that, even if there is a compromised host, that doesn't act as a back door entry for the rest of the infrastructure.","title":"Network Demarcation"},{"location":"level102/networking/security/#node-protection","text":"Be it server, router, switches, load balancers, firewall, etc, each of these devices come with certain capabilities to secure themselves, like support for filters (e.g. Access-list, Iptables) to control what traffic to process and what to drop, anti-virus software can be used in servers to check on the software installed in them.","title":"Node protection"},{"location":"level102/networking/security/#operational-practices","text":"There are numerous security threats for infrastructure, and there are different solutions to defend them. The key part to the defence, is not only identifying the right solution and the tools for it but also making sure there are robust operational procedures in place, to respond promptly, decisively and with clarity, for any security incident.","title":"Operational practices"},{"location":"level102/networking/security/#standard-operating-procedures-sop","text":"SOP need to be well defined and act as a reference for on-call to follow during a security incident. This SoP should cover things like, When a security incident happens, how it will be alerted, to whom it will be alerted. Identify the scale and severity of the security incident. Who are the points of escalation and the threshold/time to intimate them, there could be other concerned teams or to the management or even to the security operations in-charge. Which solutions to use (and the procedure to follow in them) to mitigate the security incident. Also the data about the security incident has to be collated for further analysis. Many organisations have a dedicated team focused on security, and they drive most of the activities, during an attack and even before, to come up with best practices, guidelines and compliance audits. It is the responsibility of respective technical teams, to ensure the infrastructure meets these recommendations and gaps are fixed.","title":"Standard Operating Procedures (SOP)"},{"location":"level102/networking/security/#periodic-review","text":"Along with defining SoP's, the entire security of the infrastructure has to be reviewed periodically. This review should include, Identifying any new/improved security threat that could potentially target the infrastructure. The SoP's have to be reviewed periodically, depending upon new security threats or changes in the procedure (to implement the solutions) Ensuring software upgrades/patches are done in a timely manner. Audit the infrastructure for any non-compliance of the security standards. Review of recent security incidents and find means to improvise the defence mechanisms.","title":"Periodic review"},{"location":"level102/system_calls_and_signals/conclusion/","text":"Conclusion One of the main goals of a SRE is to improve the reliability of high scale systems. Inorder to achieve this, a basic understanding of the internal workings of a system is necessary. Getting to know about how signals work is important since they play a big role in the lifecycle of processes. We see the use of signals in a range of operations on processes : from creating a process to killing a process. Knowledge of signals is important especially when handling them in programs. If you anticipate an event that causes signals, you can define a handler function and tell the operating system to run it when that particular type of signal arrives. Understanding system calls is especially useful to SRE's while debugging any Linux process. System calls provide precise knowledge of the internal functionalities of an operating system. It gives an in-depth understanding for programmers about C library functions which implement system calls at a lower level. With the use of strace command, one may easily debug slow or hung processes. Further Reading https://www.oreilly.com/library/view/understanding-the-linux/0596002130/ch01s06.html https://jvns.ca/blog/2021/04/03/what-problems-do-people-solve-with-strace/ https://medium.com/@akhandmishra/important-system-calls-every-programmer-should-know-8884381ceadb https://www.brendangregg.com/blog/2014-05-11/strace-wow-much-syscall.html","title":"Conclusion"},{"location":"level102/system_calls_and_signals/conclusion/#conclusion","text":"One of the main goals of a SRE is to improve the reliability of high scale systems. Inorder to achieve this, a basic understanding of the internal workings of a system is necessary. Getting to know about how signals work is important since they play a big role in the lifecycle of processes. We see the use of signals in a range of operations on processes : from creating a process to killing a process. Knowledge of signals is important especially when handling them in programs. If you anticipate an event that causes signals, you can define a handler function and tell the operating system to run it when that particular type of signal arrives. Understanding system calls is especially useful to SRE's while debugging any Linux process. System calls provide precise knowledge of the internal functionalities of an operating system. It gives an in-depth understanding for programmers about C library functions which implement system calls at a lower level. With the use of strace command, one may easily debug slow or hung processes.","title":"Conclusion"},{"location":"level102/system_calls_and_signals/conclusion/#further-reading","text":"https://www.oreilly.com/library/view/understanding-the-linux/0596002130/ch01s06.html https://jvns.ca/blog/2021/04/03/what-problems-do-people-solve-with-strace/ https://medium.com/@akhandmishra/important-system-calls-every-programmer-should-know-8884381ceadb https://www.brendangregg.com/blog/2014-05-11/strace-wow-much-syscall.html","title":"Further Reading"},{"location":"level102/system_calls_and_signals/intro/","text":"System Calls and Signals Prerequisites Linux Basics Python Basics What to expect from this course The course covers a fundamental understanding of signals and system calls. It sheds light on how the knowledge of signals and system calls can be helpful for an SRE. What is not covered under this course The course does not discuss any other interrupts or interrupt handling apart from signals. The course will not deep dive into signal handler and GNU C library. Course Contents Signals Introduction to interrupts and signals Types of signals Sending signals to process Handling signals Role of signals in system calls with the example of wait() System calls Introduction Types of system calls User mode,kernel mode and their transitions Working of write() system call Debugging in Linux with strace","title":"Introduction"},{"location":"level102/system_calls_and_signals/intro/#system-calls-and-signals","text":"","title":"System Calls and Signals"},{"location":"level102/system_calls_and_signals/intro/#prerequisites","text":"Linux Basics Python Basics","title":"Prerequisites"},{"location":"level102/system_calls_and_signals/intro/#what-to-expect-from-this-course","text":"The course covers a fundamental understanding of signals and system calls. It sheds light on how the knowledge of signals and system calls can be helpful for an SRE.","title":"What to expect from this course"},{"location":"level102/system_calls_and_signals/intro/#what-is-not-covered-under-this-course","text":"The course does not discuss any other interrupts or interrupt handling apart from signals. The course will not deep dive into signal handler and GNU C library.","title":"What is not covered under this course"},{"location":"level102/system_calls_and_signals/intro/#course-contents","text":"Signals Introduction to interrupts and signals Types of signals Sending signals to process Handling signals Role of signals in system calls with the example of wait() System calls Introduction Types of system calls User mode,kernel mode and their transitions Working of write() system call Debugging in Linux with strace","title":"Course Contents"},{"location":"level102/system_calls_and_signals/signals/","text":"Introduction to interrupts and signals An interrupt is an event that alters the normal execution flow of a program and can be generated by hardware devices or even by the CPU itself. When an interrupt occurs the current flow of execution is suspended and the interrupt handler runs. After the interrupt handler runs the previous execution flow is resumed. There are three types of events that can cause the CPU to interrupt: hardware interrupts, software interrupts, and exceptions. Signals are nothing but software interrupts that notifies a process that an event has occurred. These events might be requests from users or indications that a system problem (such as a memory access error) has occurred. Every signal has a signal number and a default action defined. A process can react to them in any of the following ways: a default (OS-provided) way catch the signal and handle them in a program-defined way ignore the signal entirely Types of signals To list available signals in a Linux system, you can use the command kill -l . The table below lists the signals 1 to 20. To get a full list of signals, you can refer here . Signal name Signal number Default Action Meaning SIGHUP 1 Terminate Hangup detected on controlling terminal or death of controlling process SIGINT 2 Terminate Interrupt from keyboard SIGQUIT 3 Core dump Quit from keyboard SIGILL 4 Core dump Illegal instruction SIGTRAP 5 Core dump Trace/breakpoint trap for debugging SIGABRT , SIGIOT 6 Core dump Abnormal termination SIGBUS 7 Core dump Bus error SIGFPE 8 Core dump Floating point exception SIGKILL 9 Terminate Kill signal(cannot be caught or ignored) SIGUSR1 10 Terminate User-defined signal 1 SIGSEGV 11 Core dump Invalid memory reference SIGUSR2 12 Terminate User-defined signal 2 SIGPIPE 13 Terminate Broken pipe;write pipe with no readers SIGALRM 14 Terminate Timer signal from alarm SIGTERM 15 Terminate Process termination SIGSTKFLT 16 Terminate Stack fault on math co-processor SIGCHLD 17 Ignore Child stopped or terminated SIGCONT 18 Continue Continue if stopped SIGSTOP 19 Stop Stop process (can not be caught or ignore) SIGTSTP 20 Stop Stop types at tty Sending signals to process There are three different ways to send signals to processes: Sending signal to process using kill Kill command can be used to send signals to process. By default a SIGTERM signal is sent but a different type of signal can be sent to the process by defining the signal number(or signal name). For example, the command kill -9 367 sends SIGKILL to the process with PID 367 Sending signal to process via keyboard Signals can be sent to a running process by pressing some specific keys. For example, holding Ctrl+C sends SIGINT to the process which kills it. Sending signal to process via another process A process can send a signal to another process via the kill() system call. int kill(pid_t pid, int sig) system call takes 2 arguments, pid of the process you wish to send the signal to and the signal number of the desired signal. Handling signals Referring to the table of signals in the previous section, you can see that there are default handlers attached to all signals when the program is started. When we invoke signal to attach our own handler, we are over-riding the default behaviour of the program in response to that signal. Specifically, if we attach a handler to SIGINT, the program will no longer terminate when you press +C (or send the program a SIGINT by any other means); rather, the function specified as the handler will be invoked instead which will define the behaviour of the program in response to that signal. Let\u2019s take an example of handling SIGINT signal and terminating a program. We will use Python\u2019s signal library to achieve this. When we press Ctrl+C, SIGINT signal is sent. From the signals table, we see that the default action for SIGINT is to terminate the process. To illustrate how the process reacts to the default action and a signal handler, let us consider the below example. Default Action of SIGINT: Let us first run the below lines in a python environment: while 1: continue Now let us press \"Ctrl+C\". On pressing \"Ctrl+C\" , a SIGINT interrupt is sent to the process and the default action for SIGINT as per the table we saw in the previous section is to terminate the process. We see that the while loop is terminated and we get the below on our console: ^CTraceback (most recent call last): File \"\", line 2, in KeyboardInterrupt The process terminated(default action) since it received a SIGINT(Keyboard Interrupt) when we pressed Ctrl+C. Signal Handler for SIGINT: Let us run the below lines of code in the Python environment. import signal import sys #Start of signal_handler function def signal_handler(signal, frame): print ('You pressed Ctrl+C!') # End of signal_handler function signal.signal(signal.SIGINT, signal_handler) This is an example of a program that defines its own signal handler for SIGINT , overriding the default action. Now let us run the while and continue statement as we did previously. while 1: continue Do we see any changes when Ctrl+C is pressed? Does the program terminate? We see the below output: ^CYou pressed Ctrl+C! Everytime we press Ctrl+C, we just the see the above message and the program does not terminate. Inorder to terminate the program, you can press Ctrl+Z which sends the SIGSTOP signal whose default action is to stop the process. In the case of the signal handler, we define a function signal_handler() which prints \u201cYou pressed Ctrl+C!\u201d and does not terminate the program. The handler is called with two arguments, the signal number and the current stack frame (None or a frame object ). signal.signal() allows defining custom handlers to be executed when a signal is received. Its two arguments are the signal number(name) you want to trap and the name of the signal handler. Role of signals in system calls with the example of wait() The wait() system call waits for one of the children of the calling process to terminate and returns the termination status of that child in the buffer pointed to by statusPtr . If the parent process calls the wait() system call, then the execution of the parent is suspended until the child is terminated. At the termination of the child, a SIGCHLD signal is generated which is delivered to the parent by the kernel. SIGCHLD signal indicates to the parent that there is some information on the child that needs to be collected. Parent, on receipt of SIGCHLD , reaps the status of the child from the process table. Even though the child is terminated, there is an entry in the process table corresponding to the child where the process entry and PID is stored. When the parent collects the status, this entry is deleted. Thus, all the traces of the child process are removed from the system. If the parent decides not to wait for the child\u2019s termination and it executes its subsequent task, or fails to read the exit status of the child, there remains an entry in the process table even after the termination of the child. This state of the child process is known as the Zombie state. In order to avoid long-lasting zombies, we need to have code that calls wait() after the child process is created. It is generally good to create a signal handler for the SIGCHLD signal, calling one of the wait-family functions in a loop, until no uncollected child data remains. A child process becomes orphaned, if its parent process terminates before the child .The orphaned child is adopted by init/systemd, the ancestor of all processes, whose process ID is 1. Further calls to fetch the parent pid of this process returns 1.","title":"Signals"},{"location":"level102/system_calls_and_signals/signals/#introduction-to-interrupts-and-signals","text":"An interrupt is an event that alters the normal execution flow of a program and can be generated by hardware devices or even by the CPU itself. When an interrupt occurs the current flow of execution is suspended and the interrupt handler runs. After the interrupt handler runs the previous execution flow is resumed. There are three types of events that can cause the CPU to interrupt: hardware interrupts, software interrupts, and exceptions. Signals are nothing but software interrupts that notifies a process that an event has occurred. These events might be requests from users or indications that a system problem (such as a memory access error) has occurred. Every signal has a signal number and a default action defined. A process can react to them in any of the following ways: a default (OS-provided) way catch the signal and handle them in a program-defined way ignore the signal entirely","title":"Introduction to interrupts and signals"},{"location":"level102/system_calls_and_signals/signals/#types-of-signals","text":"To list available signals in a Linux system, you can use the command kill -l . The table below lists the signals 1 to 20. To get a full list of signals, you can refer here . Signal name Signal number Default Action Meaning SIGHUP 1 Terminate Hangup detected on controlling terminal or death of controlling process SIGINT 2 Terminate Interrupt from keyboard SIGQUIT 3 Core dump Quit from keyboard SIGILL 4 Core dump Illegal instruction SIGTRAP 5 Core dump Trace/breakpoint trap for debugging SIGABRT , SIGIOT 6 Core dump Abnormal termination SIGBUS 7 Core dump Bus error SIGFPE 8 Core dump Floating point exception SIGKILL 9 Terminate Kill signal(cannot be caught or ignored) SIGUSR1 10 Terminate User-defined signal 1 SIGSEGV 11 Core dump Invalid memory reference SIGUSR2 12 Terminate User-defined signal 2 SIGPIPE 13 Terminate Broken pipe;write pipe with no readers SIGALRM 14 Terminate Timer signal from alarm SIGTERM 15 Terminate Process termination SIGSTKFLT 16 Terminate Stack fault on math co-processor SIGCHLD 17 Ignore Child stopped or terminated SIGCONT 18 Continue Continue if stopped SIGSTOP 19 Stop Stop process (can not be caught or ignore) SIGTSTP 20 Stop Stop types at tty","title":"Types of signals"},{"location":"level102/system_calls_and_signals/signals/#sending-signals-to-process","text":"There are three different ways to send signals to processes: Sending signal to process using kill Kill command can be used to send signals to process. By default a SIGTERM signal is sent but a different type of signal can be sent to the process by defining the signal number(or signal name). For example, the command kill -9 367 sends SIGKILL to the process with PID 367 Sending signal to process via keyboard Signals can be sent to a running process by pressing some specific keys. For example, holding Ctrl+C sends SIGINT to the process which kills it. Sending signal to process via another process A process can send a signal to another process via the kill() system call. int kill(pid_t pid, int sig) system call takes 2 arguments, pid of the process you wish to send the signal to and the signal number of the desired signal.","title":"Sending signals to process"},{"location":"level102/system_calls_and_signals/signals/#handling-signals","text":"Referring to the table of signals in the previous section, you can see that there are default handlers attached to all signals when the program is started. When we invoke signal to attach our own handler, we are over-riding the default behaviour of the program in response to that signal. Specifically, if we attach a handler to SIGINT, the program will no longer terminate when you press +C (or send the program a SIGINT by any other means); rather, the function specified as the handler will be invoked instead which will define the behaviour of the program in response to that signal. Let\u2019s take an example of handling SIGINT signal and terminating a program. We will use Python\u2019s signal library to achieve this. When we press Ctrl+C, SIGINT signal is sent. From the signals table, we see that the default action for SIGINT is to terminate the process. To illustrate how the process reacts to the default action and a signal handler, let us consider the below example. Default Action of SIGINT: Let us first run the below lines in a python environment: while 1: continue Now let us press \"Ctrl+C\". On pressing \"Ctrl+C\" , a SIGINT interrupt is sent to the process and the default action for SIGINT as per the table we saw in the previous section is to terminate the process. We see that the while loop is terminated and we get the below on our console: ^CTraceback (most recent call last): File \"\", line 2, in KeyboardInterrupt The process terminated(default action) since it received a SIGINT(Keyboard Interrupt) when we pressed Ctrl+C. Signal Handler for SIGINT: Let us run the below lines of code in the Python environment. import signal import sys #Start of signal_handler function def signal_handler(signal, frame): print ('You pressed Ctrl+C!') # End of signal_handler function signal.signal(signal.SIGINT, signal_handler) This is an example of a program that defines its own signal handler for SIGINT , overriding the default action. Now let us run the while and continue statement as we did previously. while 1: continue Do we see any changes when Ctrl+C is pressed? Does the program terminate? We see the below output: ^CYou pressed Ctrl+C! Everytime we press Ctrl+C, we just the see the above message and the program does not terminate. Inorder to terminate the program, you can press Ctrl+Z which sends the SIGSTOP signal whose default action is to stop the process. In the case of the signal handler, we define a function signal_handler() which prints \u201cYou pressed Ctrl+C!\u201d and does not terminate the program. The handler is called with two arguments, the signal number and the current stack frame (None or a frame object ). signal.signal() allows defining custom handlers to be executed when a signal is received. Its two arguments are the signal number(name) you want to trap and the name of the signal handler.","title":"Handling signals"},{"location":"level102/system_calls_and_signals/signals/#role-of-signals-in-system-calls-with-the-example-of-wait","text":"The wait() system call waits for one of the children of the calling process to terminate and returns the termination status of that child in the buffer pointed to by statusPtr . If the parent process calls the wait() system call, then the execution of the parent is suspended until the child is terminated. At the termination of the child, a SIGCHLD signal is generated which is delivered to the parent by the kernel. SIGCHLD signal indicates to the parent that there is some information on the child that needs to be collected. Parent, on receipt of SIGCHLD , reaps the status of the child from the process table. Even though the child is terminated, there is an entry in the process table corresponding to the child where the process entry and PID is stored. When the parent collects the status, this entry is deleted. Thus, all the traces of the child process are removed from the system. If the parent decides not to wait for the child\u2019s termination and it executes its subsequent task, or fails to read the exit status of the child, there remains an entry in the process table even after the termination of the child. This state of the child process is known as the Zombie state. In order to avoid long-lasting zombies, we need to have code that calls wait() after the child process is created. It is generally good to create a signal handler for the SIGCHLD signal, calling one of the wait-family functions in a loop, until no uncollected child data remains. A child process becomes orphaned, if its parent process terminates before the child .The orphaned child is adopted by init/systemd, the ancestor of all processes, whose process ID is 1. Further calls to fetch the parent pid of this process returns 1.","title":"Role of signals in system calls with the example of wait()"},{"location":"level102/system_calls_and_signals/system_calls/","text":"Introduction A system call is a controlled entry point into the kernel, allowing a process to request the kernel to perform some action on the process\u2019s behalf. The kernel makes a range of services accessible to programs via the system call application programming interface (API). Application developers often do not have direct access to the system calls, but can access them through this API. These services include, for example, creating a new process, performing I/O, and creating a pipe for interprocess communication. The set of system calls is fixed. Each system call is identified by a unique number. The list of different system calls can be found here . A system call changes the processor state from user mode to kernel mode, so that the CPU can access protected kernel memory. Each system call may have a set of arguments that specify information to be transferred from user space (i.e., the process\u2019s virtual address space) to kernel space and vice versa. From a programming point of view, invoking a system call looks much like calling a C function. Types of system calls There are mainly 5 types of different system calls. They are : Process Control: These system calls are used to handle tasks related to a process such as process creation, termination,etc. File Management: These system calls are used for operations on files such as reading/writing a file. Device Management: These system calls are used to deal with devices such as reading/writing into device buffers. Information Maintenance: These system calls handle information and its transfer between the operating system and the user program. Communication: These system calls are useful for inter-process communication. They are also used for creating and deleting a communication connection. Types Of System Calls Examples in Linux Process Control fork(),exit(),wait() File Management open(), read(),write() Device Management ioctl(),read(),write() Information Maintenance getpid(),alarm(),sleep() Communication pipe(),shmget(),mmap() User mode, kernel mode and their transitions Modern processor architectures typically allow the CPU to operate in at least two different modes: user mode and kernel mode . Correspondingly, areas of virtual memory can be marked as being part of user space or kernel space. When running in user mode, the CPU can access only memory that is marked as being in user space; attempts to access memory in kernel space result in a hardware exception. At any given time, a process may be executing in either user mode or kernel mode. The type of instructions that can be executed depends on the mode and this is enforced at the hardware level. CPU modes (also called processor modes, CPU states, CPU privilege levels) are operating modes for the central processing unit of some computer architectures that place restrictions on the type and scope of operations that can be performed by certain processes being run by the CPU. The kernel itself is not a process but a process manager. The kernel model assumes that processes that require a kernel service use specific programming constructs called system calls. When a program is executed in user mode, it cannot directly access the kernel data structures or the kernel programs. When an application executes in kernel mode, however, these restrictions no longer apply. A program usually executes in user mode and switches to kernel mode only when requesting a service provided by the kernel. If an application needs access to hardware resources on the system(like peripherals,memory,disks), it must issue a system call, which causes a context switch from user mode to kernel mode. This procedure is followed when reading/writing from/to files, etc. It is only the system call itself which runs in kernel mode, not the application code. When the system call is complete, the process returns to the user mode with the return value using an inverse context switch. Apart from system calls, kernel routines can be activated in the below ways as well: The CPU executing the process signals an exception , which is an unusual condition such as an invalid instruction. The kernel handles the exception on behalf of the process that caused it. A peripheral device issues an interrupt signal to the CPU to notify it of an event such as a request for attention, a status change, or the completion of an I/O operation. Each interrupt signal is dealt by a kernel program called an interrupt handler . Since peripheral devices operate asynchronously with respect to the CPU, interrupts occur at unpredictable times. A kernel thread is executed. Since it runs in kernel Mode, the corresponding program must be considered part of the kernel. In the above diagram, Process 1 in User Mode issues a system call, after which the process switches to Kernel Mode and the system call is serviced. Process 1 then resumes execution in User Mode until a timer interrupt occurs and the scheduler is activated in Kernel Mode. A process switch takes place and Process 2 starts its execution in User Mode until a hardware device raises an interrupt. As a consequence of the interrupt, Process 2 switches to Kernel Mode and services the interrupt. Working of write() system call The write() system call writes data to an open file. # include ssize_t write(int fd, void *buffer, size_t count); buffer is the address of the data to be written; count is the number of bytes to write from buffer; and fd is a file descriptor referring to the file to which data is to be written. write() call writes up to count bytes from buffer to the open file referred to by fd . On success, write() call returns the number of bytes actually written, which may be less than count and returns -1 on error. When performing I/O on a disk file, a successful return from write() doesn\u2019t guarantee that the data has been transferred to disk, because the kernel performs buffering of disk I/O in order to reduce disk activity and expedite write() calls. It simply copies data between a user-space buffer and a buffer in the kernel buffer cache. At some later point, the kernel writes (flushes) its buffer to the disk. If, in the interim, another process attempts to read these bytes of the file, then the kernel automatically supplies the data from the buffer cache, rather than from (the outdated contents of) the file. The aim of this design is to allow write() to be fast, since they don\u2019t need to wait on a (slow) disk operation. This design is also efficient, since it reduces the number of disk transfers that the kernel must perform. Debugging in Linux with strace strace is a tool used to trace the transition between user processes and the Linux kernel. Inorder to use the tool, we need ensure that it is installed in the system by running the command: $ rpm -qa | grep -i strace strace-4.12-9.el7.x86_64 If the above command does not give any output, you can install the tool via: $ yum install strace The functions which are a part of standard C library are known as library functions. The purposes of these functions are very diverse, including such tasks as opening a file, converting a time to a human-readable format, and comparing two character strings. Some library functions are layered on top of system calls. Often, library functions are designed to provide a more caller-friendly interface than the underlying system call. For example, the printf() function provides output formatting and data buffering, whereas the write() system call just outputs a block of bytes.The most commonly used implementation of the standard C library on Linux is the GNU C library glibc . The C programming language gives printf() that lets the user write data in many different formats. So printf() as a function converts your data into a formatted sequence of bytes and that calls write() to write those bytes onto the output. Let us examine what happens when a printf() statement is executed with the use of strace command : strace printf %s \u201cHello world\u201d ~]$ strace printf %s \"Hello world\" execve(\"/usr/bin/printf\", [\"printf\", \"%s\", \"Hello world\"], [/* 47 vars */]) = 0 brk(NULL) = 0x90d000 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672f000 access(\"/etc/ld.so.preload\", R_OK) = -1 ENOENT (No such file or directory) open(\"/etc/ld.so.cache\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=98854, ...}) = 0 mmap(NULL, 98854, PROT_READ, MAP_PRIVATE, 3, 0) = 0x7f8fc6716000 close(3) = 0 open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 read(3, \"\\177ELF\\2\\1\\1\\3\\0\\0\\0\\0\\0\\0\\0\\0\\3\\0>\\0\\1\\0\\0\\0\\20&\\2\\0\\0\\0\\0\\0\"..., 832) = 832 fstat(3, {st_mode=S_IFREG|0755, st_size=2156160, ...}) = 0 mmap(NULL, 3985888, PROT_READ|PROT_EXEC, MAP_PRIVATE|MAP_DENYWRITE, 3, 0) = 0x7f8fc6141000 mprotect(0x7f8fc6304000, 2097152, PROT_NONE) = 0 mmap(0x7f8fc6504000, 24576, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_DENYWRITE, 3, 0x1c3000) = 0x7f8fc6504000 mmap(0x7f8fc650a000, 16864, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_ANONYMOUS, -1, 0) = 0x7f8fc650a000 close(3) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc6715000 mmap(NULL, 8192, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc6713000 arch_prctl(ARCH_SET_FS, 0x7f8fc6713740) = 0 mprotect(0x7f8fc6504000, 16384, PROT_READ) = 0 mprotect(0x60a000, 4096, PROT_READ) = 0 mprotect(0x7f8fc6730000, 4096, PROT_READ) = 0 munmap(0x7f8fc6716000, 98854) = 0 brk(NULL) = 0x90d000 brk(0x92e000) = 0x92e000 brk(NULL) = 0x92e000 open(\"/usr/lib/locale/locale-archive\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=106075056, ...}) = 0 mmap(NULL, 106075056, PROT_READ, MAP_PRIVATE, 3, 0) = 0x7f8fbfc17000 close(3) = 0 open(\"/usr/share/locale/locale.alias\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=2502, ...}) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672e000 read(3, \"# Locale name alias data base.\\n#\"..., 4096) = 2502 read(3, \"\", 4096) = 0 close(3) = 0 munmap(0x7f8fc672e000, 4096) = 0 open(\"/usr/lib/locale/UTF-8/LC_CTYPE\", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory) fstat(1, {st_mode=S_IFCHR|0620, st_rdev=makedev(136, 1), ...}) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672e000 write(1, \"Hello world\", 11Hello world) = 11 close(1) = 0 munmap(0x7f8fc672e000, 4096) = 0 close(2) = 0 exit_group(0) = ? +++ exited with 0 +++ execve(\"/usr/bin/printf\", [\"printf\", \"%s\", \"Hello world\"], [/ 47 vars /]) = 0 The first system call made is execve() and does three things: The operating system (OS) stops the duplicated process (of the parent). OS loads up the new program (in this case: printf() ), and starts the new program. execve() replaces defining parts of the current process's memory stack with the new stuff loaded from the printf executable file. The first word of the line, execve, is the name of the system call being executed. The first parameter must be the path of a binary executable or a script. The second is an array of argument strings passed to the new program. By convention, the first of these strings should contain the filename associated with the file being executed. The third parameter must be an environment variable. The number after the = sign (which is 0 in this case) is a value returned by the execve system call which indicates that the call was successful. open(\"/usr/lib/locale/UTF-8/LC_CTYPE\", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory) In this line, the program tried to open() file /usr/lib/locale/UTF-8/LC_CTYPE . However the system call failed (with -1 status) with the descriptive error message No such file or directory , as the file wasn\u2019t found (ENOENT). brk(NULL) = 0x90d000 brk(0x92e000) = 0x92e000 brk(NULL) = 0x92e000 The system call brk() is used to increase or decrease the process\u2019s data segment. It returns the new address where the data segment of the process is to end. open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 read(3, \"\\177ELF\\2\\1\\1\\3\\0\\0\\0\\0\\0\\0\\0\\0\\3\\0>\\0\\1\\0\\0\\0\\20&\\2\\0\\0\\0\\0\\0\"..., 832) = 832 In the above lines of the console output, we see that a successful open() call is made, followed by read() system call. In open() , the first parameter is the path to file which you want to use and the second parameter defines the permissions. In this example, O_RDONLY which means the file is read only and O_CLOEXEC which enables the close-on-exec flag for the opened file. This is useful to avoid race conditions in multithreaded programs where one thread opens a file descriptor at the same time as another thread. 3 indicates the file descriptor used to open the file. Since fd 0, 1, 2 are already taken by stdin, stdout and stderr. So first unused file descriptor is 3 in file descriptor table. If open() In read() , the first parameter is the file descriptor which is 3(the file was opened using this file descriptor by open() . The second parameter is the buffer to read data from and the third parameter is the length of the buffer. The return value is 832 which is the number of bytes read. close(3) = 0 A close system call is used to close a file descriptor by the kernel. For most file systems, a program terminates access to a file in a filesystem using the close system call. 0 after the = sign indicates that the system call was successful. write(1, \"Hello world\", 11Hello world) = 11 In the previous section, we described the write() system call and the arguments that it takes. Whenever we see any output to the video screen, it\u2019s from the file named /dev/tty and written to stdout on screen through fd 1. The first parameter is the file descriptor , second parameter is the buffer containing the information to be written and the last parameter contains the count of characters. On success, the number of bytes written are returned (zero indicates nothing was written) which is 11 in this example. +++ exited with 0 +++ This indicates that the program exited successfully with exit code 0. An exit code of 0 generally indicates successful execution and termination in Linux programs. You don't need to memorize all the system calls or what they do, because you can refer to documentation when you need to. Ensure the following package is installed before running the man command: $ rpm -qa | grep -i man-pages man-pages-3.53-5.el7.noarch Run the following man command with the system call name to see the documentation for that system call(for eg, execve): man 2 execve Apart from system calls, strace can be used to detect the files that are being accessed by the program. In the above trace, we have a system call open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 which is opening the libc shared object /lib64/libc.so.6 which is the C implementation of various standard functions. It is the file where we see the printf() definition needed for printing Hello World . Strace can also be used to check if a program is hanging or stuck. When we have the trace, we can observe at which operation the program is stuck as well. Furthermore, as we go through the trace, we can also find errors(if there are any) to point out why the program is hung/stuck. Strace can be very helpful in finding the reason behind slow performance of a program. Alhough strace has the aforementioned uses to it, if you're running a trace in a production environment, strace is not a good choice. It introduces a substantial amount of overhead. According to a performance test conducted by Arnaldo Carvalho de Melo, a senior software engineer at Red Hat, the process traced using strace ran 173 times slower, which can be disastrous for a production environment.","title":"System Calls"},{"location":"level102/system_calls_and_signals/system_calls/#introduction","text":"A system call is a controlled entry point into the kernel, allowing a process to request the kernel to perform some action on the process\u2019s behalf. The kernel makes a range of services accessible to programs via the system call application programming interface (API). Application developers often do not have direct access to the system calls, but can access them through this API. These services include, for example, creating a new process, performing I/O, and creating a pipe for interprocess communication. The set of system calls is fixed. Each system call is identified by a unique number. The list of different system calls can be found here . A system call changes the processor state from user mode to kernel mode, so that the CPU can access protected kernel memory. Each system call may have a set of arguments that specify information to be transferred from user space (i.e., the process\u2019s virtual address space) to kernel space and vice versa. From a programming point of view, invoking a system call looks much like calling a C function.","title":"Introduction"},{"location":"level102/system_calls_and_signals/system_calls/#types-of-system-calls","text":"There are mainly 5 types of different system calls. They are : Process Control: These system calls are used to handle tasks related to a process such as process creation, termination,etc. File Management: These system calls are used for operations on files such as reading/writing a file. Device Management: These system calls are used to deal with devices such as reading/writing into device buffers. Information Maintenance: These system calls handle information and its transfer between the operating system and the user program. Communication: These system calls are useful for inter-process communication. They are also used for creating and deleting a communication connection. Types Of System Calls Examples in Linux Process Control fork(),exit(),wait() File Management open(), read(),write() Device Management ioctl(),read(),write() Information Maintenance getpid(),alarm(),sleep() Communication pipe(),shmget(),mmap()","title":"Types of system calls"},{"location":"level102/system_calls_and_signals/system_calls/#user-mode-kernel-mode-and-their-transitions","text":"Modern processor architectures typically allow the CPU to operate in at least two different modes: user mode and kernel mode . Correspondingly, areas of virtual memory can be marked as being part of user space or kernel space. When running in user mode, the CPU can access only memory that is marked as being in user space; attempts to access memory in kernel space result in a hardware exception. At any given time, a process may be executing in either user mode or kernel mode. The type of instructions that can be executed depends on the mode and this is enforced at the hardware level. CPU modes (also called processor modes, CPU states, CPU privilege levels) are operating modes for the central processing unit of some computer architectures that place restrictions on the type and scope of operations that can be performed by certain processes being run by the CPU. The kernel itself is not a process but a process manager. The kernel model assumes that processes that require a kernel service use specific programming constructs called system calls. When a program is executed in user mode, it cannot directly access the kernel data structures or the kernel programs. When an application executes in kernel mode, however, these restrictions no longer apply. A program usually executes in user mode and switches to kernel mode only when requesting a service provided by the kernel. If an application needs access to hardware resources on the system(like peripherals,memory,disks), it must issue a system call, which causes a context switch from user mode to kernel mode. This procedure is followed when reading/writing from/to files, etc. It is only the system call itself which runs in kernel mode, not the application code. When the system call is complete, the process returns to the user mode with the return value using an inverse context switch. Apart from system calls, kernel routines can be activated in the below ways as well: The CPU executing the process signals an exception , which is an unusual condition such as an invalid instruction. The kernel handles the exception on behalf of the process that caused it. A peripheral device issues an interrupt signal to the CPU to notify it of an event such as a request for attention, a status change, or the completion of an I/O operation. Each interrupt signal is dealt by a kernel program called an interrupt handler . Since peripheral devices operate asynchronously with respect to the CPU, interrupts occur at unpredictable times. A kernel thread is executed. Since it runs in kernel Mode, the corresponding program must be considered part of the kernel. In the above diagram, Process 1 in User Mode issues a system call, after which the process switches to Kernel Mode and the system call is serviced. Process 1 then resumes execution in User Mode until a timer interrupt occurs and the scheduler is activated in Kernel Mode. A process switch takes place and Process 2 starts its execution in User Mode until a hardware device raises an interrupt. As a consequence of the interrupt, Process 2 switches to Kernel Mode and services the interrupt.","title":"User mode, kernel mode and their transitions"},{"location":"level102/system_calls_and_signals/system_calls/#working-of-write-system-call","text":"The write() system call writes data to an open file. # include ssize_t write(int fd, void *buffer, size_t count); buffer is the address of the data to be written; count is the number of bytes to write from buffer; and fd is a file descriptor referring to the file to which data is to be written. write() call writes up to count bytes from buffer to the open file referred to by fd . On success, write() call returns the number of bytes actually written, which may be less than count and returns -1 on error. When performing I/O on a disk file, a successful return from write() doesn\u2019t guarantee that the data has been transferred to disk, because the kernel performs buffering of disk I/O in order to reduce disk activity and expedite write() calls. It simply copies data between a user-space buffer and a buffer in the kernel buffer cache. At some later point, the kernel writes (flushes) its buffer to the disk. If, in the interim, another process attempts to read these bytes of the file, then the kernel automatically supplies the data from the buffer cache, rather than from (the outdated contents of) the file. The aim of this design is to allow write() to be fast, since they don\u2019t need to wait on a (slow) disk operation. This design is also efficient, since it reduces the number of disk transfers that the kernel must perform.","title":"Working of write() system call"},{"location":"level102/system_calls_and_signals/system_calls/#debugging-in-linux-with-strace","text":"strace is a tool used to trace the transition between user processes and the Linux kernel. Inorder to use the tool, we need ensure that it is installed in the system by running the command: $ rpm -qa | grep -i strace strace-4.12-9.el7.x86_64 If the above command does not give any output, you can install the tool via: $ yum install strace The functions which are a part of standard C library are known as library functions. The purposes of these functions are very diverse, including such tasks as opening a file, converting a time to a human-readable format, and comparing two character strings. Some library functions are layered on top of system calls. Often, library functions are designed to provide a more caller-friendly interface than the underlying system call. For example, the printf() function provides output formatting and data buffering, whereas the write() system call just outputs a block of bytes.The most commonly used implementation of the standard C library on Linux is the GNU C library glibc . The C programming language gives printf() that lets the user write data in many different formats. So printf() as a function converts your data into a formatted sequence of bytes and that calls write() to write those bytes onto the output. Let us examine what happens when a printf() statement is executed with the use of strace command : strace printf %s \u201cHello world\u201d ~]$ strace printf %s \"Hello world\" execve(\"/usr/bin/printf\", [\"printf\", \"%s\", \"Hello world\"], [/* 47 vars */]) = 0 brk(NULL) = 0x90d000 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672f000 access(\"/etc/ld.so.preload\", R_OK) = -1 ENOENT (No such file or directory) open(\"/etc/ld.so.cache\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=98854, ...}) = 0 mmap(NULL, 98854, PROT_READ, MAP_PRIVATE, 3, 0) = 0x7f8fc6716000 close(3) = 0 open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 read(3, \"\\177ELF\\2\\1\\1\\3\\0\\0\\0\\0\\0\\0\\0\\0\\3\\0>\\0\\1\\0\\0\\0\\20&\\2\\0\\0\\0\\0\\0\"..., 832) = 832 fstat(3, {st_mode=S_IFREG|0755, st_size=2156160, ...}) = 0 mmap(NULL, 3985888, PROT_READ|PROT_EXEC, MAP_PRIVATE|MAP_DENYWRITE, 3, 0) = 0x7f8fc6141000 mprotect(0x7f8fc6304000, 2097152, PROT_NONE) = 0 mmap(0x7f8fc6504000, 24576, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_DENYWRITE, 3, 0x1c3000) = 0x7f8fc6504000 mmap(0x7f8fc650a000, 16864, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_ANONYMOUS, -1, 0) = 0x7f8fc650a000 close(3) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc6715000 mmap(NULL, 8192, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc6713000 arch_prctl(ARCH_SET_FS, 0x7f8fc6713740) = 0 mprotect(0x7f8fc6504000, 16384, PROT_READ) = 0 mprotect(0x60a000, 4096, PROT_READ) = 0 mprotect(0x7f8fc6730000, 4096, PROT_READ) = 0 munmap(0x7f8fc6716000, 98854) = 0 brk(NULL) = 0x90d000 brk(0x92e000) = 0x92e000 brk(NULL) = 0x92e000 open(\"/usr/lib/locale/locale-archive\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=106075056, ...}) = 0 mmap(NULL, 106075056, PROT_READ, MAP_PRIVATE, 3, 0) = 0x7f8fbfc17000 close(3) = 0 open(\"/usr/share/locale/locale.alias\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=2502, ...}) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672e000 read(3, \"# Locale name alias data base.\\n#\"..., 4096) = 2502 read(3, \"\", 4096) = 0 close(3) = 0 munmap(0x7f8fc672e000, 4096) = 0 open(\"/usr/lib/locale/UTF-8/LC_CTYPE\", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory) fstat(1, {st_mode=S_IFCHR|0620, st_rdev=makedev(136, 1), ...}) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672e000 write(1, \"Hello world\", 11Hello world) = 11 close(1) = 0 munmap(0x7f8fc672e000, 4096) = 0 close(2) = 0 exit_group(0) = ? +++ exited with 0 +++ execve(\"/usr/bin/printf\", [\"printf\", \"%s\", \"Hello world\"], [/ 47 vars /]) = 0 The first system call made is execve() and does three things: The operating system (OS) stops the duplicated process (of the parent). OS loads up the new program (in this case: printf() ), and starts the new program. execve() replaces defining parts of the current process's memory stack with the new stuff loaded from the printf executable file. The first word of the line, execve, is the name of the system call being executed. The first parameter must be the path of a binary executable or a script. The second is an array of argument strings passed to the new program. By convention, the first of these strings should contain the filename associated with the file being executed. The third parameter must be an environment variable. The number after the = sign (which is 0 in this case) is a value returned by the execve system call which indicates that the call was successful. open(\"/usr/lib/locale/UTF-8/LC_CTYPE\", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory) In this line, the program tried to open() file /usr/lib/locale/UTF-8/LC_CTYPE . However the system call failed (with -1 status) with the descriptive error message No such file or directory , as the file wasn\u2019t found (ENOENT). brk(NULL) = 0x90d000 brk(0x92e000) = 0x92e000 brk(NULL) = 0x92e000 The system call brk() is used to increase or decrease the process\u2019s data segment. It returns the new address where the data segment of the process is to end. open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 read(3, \"\\177ELF\\2\\1\\1\\3\\0\\0\\0\\0\\0\\0\\0\\0\\3\\0>\\0\\1\\0\\0\\0\\20&\\2\\0\\0\\0\\0\\0\"..., 832) = 832 In the above lines of the console output, we see that a successful open() call is made, followed by read() system call. In open() , the first parameter is the path to file which you want to use and the second parameter defines the permissions. In this example, O_RDONLY which means the file is read only and O_CLOEXEC which enables the close-on-exec flag for the opened file. This is useful to avoid race conditions in multithreaded programs where one thread opens a file descriptor at the same time as another thread. 3 indicates the file descriptor used to open the file. Since fd 0, 1, 2 are already taken by stdin, stdout and stderr. So first unused file descriptor is 3 in file descriptor table. If open() In read() , the first parameter is the file descriptor which is 3(the file was opened using this file descriptor by open() . The second parameter is the buffer to read data from and the third parameter is the length of the buffer. The return value is 832 which is the number of bytes read. close(3) = 0 A close system call is used to close a file descriptor by the kernel. For most file systems, a program terminates access to a file in a filesystem using the close system call. 0 after the = sign indicates that the system call was successful. write(1, \"Hello world\", 11Hello world) = 11 In the previous section, we described the write() system call and the arguments that it takes. Whenever we see any output to the video screen, it\u2019s from the file named /dev/tty and written to stdout on screen through fd 1. The first parameter is the file descriptor , second parameter is the buffer containing the information to be written and the last parameter contains the count of characters. On success, the number of bytes written are returned (zero indicates nothing was written) which is 11 in this example. +++ exited with 0 +++ This indicates that the program exited successfully with exit code 0. An exit code of 0 generally indicates successful execution and termination in Linux programs. You don't need to memorize all the system calls or what they do, because you can refer to documentation when you need to. Ensure the following package is installed before running the man command: $ rpm -qa | grep -i man-pages man-pages-3.53-5.el7.noarch Run the following man command with the system call name to see the documentation for that system call(for eg, execve): man 2 execve Apart from system calls, strace can be used to detect the files that are being accessed by the program. In the above trace, we have a system call open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 which is opening the libc shared object /lib64/libc.so.6 which is the C implementation of various standard functions. It is the file where we see the printf() definition needed for printing Hello World . Strace can also be used to check if a program is hanging or stuck. When we have the trace, we can observe at which operation the program is stuck as well. Furthermore, as we go through the trace, we can also find errors(if there are any) to point out why the program is hung/stuck. Strace can be very helpful in finding the reason behind slow performance of a program. Alhough strace has the aforementioned uses to it, if you're running a trace in a production environment, strace is not a good choice. It introduces a substantial amount of overhead. According to a performance test conducted by Arnaldo Carvalho de Melo, a senior software engineer at Red Hat, the process traced using strace ran 173 times slower, which can be disastrous for a production environment.","title":"Debugging in Linux with strace"},{"location":"level102/system_design/conclusion/","text":"We have looked at designing a sytem from the scratch, scaling it up from a single server to multiple datacenters and hundreds of thousands of users. However, you might have (rightly!) guessed that there is a lot more to system design than what we have covered so far. This course should give you a sweeping glance at the things that are fundamental to any system design process. Specific solutions implemented, frameworks and orchestration systems used evolve rapidly. However, the guiding principles remain the same. We hope you this course helped in getting you started along the right direction and that you have fun designing systems and solving interesting problems.","title":"Conclusion"},{"location":"level102/system_design/intro/","text":"System Design Prerequisites School of SRE - System Design - Phase I What to expect from this course The aim is to empower the reader to understand the building blocks of a well-designed system, evaluate existing systems, understand the trade-offs, come up with their own design, and to explore the various tools available to implement such a system. In phase one of this module, we talked about the fundamentals of system design including concepts like scalability, availability and reliability. We continue to build on those fundamentals in this phase. Throughout the course, there are callout sections that appear like this, and talk about things that are closely related to the system design process, but don\u2019t form a part of the system itself. They also have information about some common issues that crop up in system design. Watch out for them. What is not covered under this course While this course covers many aspects of system design, it does not cover the most fundamental concepts. For such topics, it is advised to go through the prerequisites. In general, this module will not go into actually implementing the architecture - we will not talk about choosing a hosting/cloud provider or an orchestration setup or a CI/CD system. Instead, we try to focus on the fundamental considerations that need to go into system design. Course Contents Introduction Large system Design Scaling Scaling beyond the datacentre Design patterns for resiliency Conclusion Introduction We talked about building a basic photo sharing application in the previous phase of this course. Our basic requirements for the application were that It should work for a reasonably large number of users Avoid service failures/cluster crash in case of any issues In other words, we wanted to build a system that was available, scalable and fault tolerant. We will continue designing that application, and cover additional concepts in the course of doing so. The photo sharing application is a web application that will handle everything from user sign up, log in, uploads, feed generation, user interaction and interaction with uploaded content. Also a database to store this information. In the simplest design, both the web app and the database can run on the same server. Recall this initial design from Phase 1. Building on that, we will talk about performance elements in system design - setting the right performance measurement metrics and using them to drive our design decisions, improving performance using caching, Content Delivery Networks (CDNs), etc. We will also talk about how to design for resilience by looking at some system design patterns - graceful degradation, time-outs and circuit breakers. Cost System design considerations like availability, scalability cannot exist in isolation. When operating outside the lab, we have other considerations / the existing considerations take on a different hue. One such consideration is cost. Real world systems almost always have budget constraints. System design, implementation and continued operation needs to have predictable costs per unit output. The output is usually the business problem you are trying to solve. Striking a balance between the two is very important. Understanding the capabilities of your system A well designed system requires understanding the building blocks intimately in terms of their capabilities. Not all components are created equal, and understanding what a single component can do is very important - for e.g., in the photo upload application it is important to know what a single database instance is capable of, in terms of read or write transactions per second and what would be a reasonable expectation be. This helps in building systems that are appropriately weighted - and will eliminate obvious sources of bottlenecks. On a lower level, even understanding the capabilities of the underlying hardware (or a VM instance if you are on cloud) is important. For eg., all disks don\u2019t perform the same, and all disks don\u2019t perform the same per dollar. If we are planning to have an API that is expected to return a response in 100ms under normal circumstances, then it is important to know how much of it will be spent in which parts of the system. The following link will help in getting a sense of each component\u2019s performance, all the way from the CPU cache to the network link to our end user. Numbers every programmer should know","title":"Introduction"},{"location":"level102/system_design/intro/#system-design","text":"","title":"System Design"},{"location":"level102/system_design/intro/#prerequisites","text":"School of SRE - System Design - Phase I","title":"Prerequisites"},{"location":"level102/system_design/intro/#what-to-expect-from-this-course","text":"The aim is to empower the reader to understand the building blocks of a well-designed system, evaluate existing systems, understand the trade-offs, come up with their own design, and to explore the various tools available to implement such a system. In phase one of this module, we talked about the fundamentals of system design including concepts like scalability, availability and reliability. We continue to build on those fundamentals in this phase. Throughout the course, there are callout sections that appear like this, and talk about things that are closely related to the system design process, but don\u2019t form a part of the system itself. They also have information about some common issues that crop up in system design. Watch out for them.","title":"What to expect from this course"},{"location":"level102/system_design/intro/#what-is-not-covered-under-this-course","text":"While this course covers many aspects of system design, it does not cover the most fundamental concepts. For such topics, it is advised to go through the prerequisites. In general, this module will not go into actually implementing the architecture - we will not talk about choosing a hosting/cloud provider or an orchestration setup or a CI/CD system. Instead, we try to focus on the fundamental considerations that need to go into system design.","title":"What is not covered under this course"},{"location":"level102/system_design/intro/#course-contents","text":"Introduction Large system Design Scaling Scaling beyond the datacentre Design patterns for resiliency Conclusion","title":"Course Contents"},{"location":"level102/system_design/intro/#introduction","text":"We talked about building a basic photo sharing application in the previous phase of this course. Our basic requirements for the application were that It should work for a reasonably large number of users Avoid service failures/cluster crash in case of any issues In other words, we wanted to build a system that was available, scalable and fault tolerant. We will continue designing that application, and cover additional concepts in the course of doing so. The photo sharing application is a web application that will handle everything from user sign up, log in, uploads, feed generation, user interaction and interaction with uploaded content. Also a database to store this information. In the simplest design, both the web app and the database can run on the same server. Recall this initial design from Phase 1. Building on that, we will talk about performance elements in system design - setting the right performance measurement metrics and using them to drive our design decisions, improving performance using caching, Content Delivery Networks (CDNs), etc. We will also talk about how to design for resilience by looking at some system design patterns - graceful degradation, time-outs and circuit breakers.","title":"Introduction"},{"location":"level102/system_design/large-system-design/","text":"Designing a system usually starts out to be abstract - we have large functional blocks that need to work together and are abstracted away into frontend, backend and database layers. However, when it is time to implement the system, especially as an SRE we have no other choice but to think in specific terms. Servers have a fixed amount of memory, storage capacity and processing power. So we need to think about the realistic expectations from our system, assess the requirements, translate them into specific requirements from each component of the system like network, storage and compute. This is typically how almost all large scale systems are built. The folks over at Google have formalized this approach to designing systems as \u2018Non abstract large system design\u2019 (NALSD). According to the Google site reliability workbook, \u201cPractically, NALSD combines elements of capacity planning, component isolation, and graceful system degradation that are crucial to highly available production systems.\u201d We will be using an approach similar to this to build our system. Application requirements Let us define our application requirements in more concrete terms i.e., specific functions: Our photo sharing application must let the user Sign up to become a member, and login to the application Upload photographs, and optionally add a description and tag location and/or people Follow other users on the platform See a feed comprising of photos from other users that they follow View their own profile page, and manage who they follow Let us define expectations for the application\u2019s performance for a better user experience. We also need to define the health of the system. SLIs and SLOs help us do just that. SLIs and SLOs The Google SRE book defines service level indicator(SLI) as \u201ca carefully defined quantitative measure of some aspect of the level of service that is provided.\u201d For our application, we can define multiple SLIs. One indicator can be the response time for loading the feed for our photo sharing application. Picking the right set of SLIs is very important since they essentially help us define the health of the system as a whole using concrete data. SLIs for an application are defined by the owners of the service, in consultation with the SREs. Service level objective (SLO) is defined as \u201ca target value or range of values for a service level that is measured by an SLI\u201d. SLO is a way for us to anchor ourselves to an optimal user experience by defining SLI boundaries. If our application takes a long time to load the feed, users might not open it very often. As a result, an example of SLO can be that at least 99% of the users should see their feed loaded within 1 second. Now that we have defined SLIs and SLOs, let us define the application\u2019s scalability, reliability and performance characteristics in terms of specific SLI and SLO levels. Defining application requirements in terms of SLIs and SLOs The following can be some of the expectations for our application: Once the user successfully uploads the image, it should be accessible to the user and their followers 100% of the time, barring user elected deletion. At least 50000 unique visitors should be able to visit the site at any given time and view their feed. 99% of the users should be able to view their feeds in less than 1 second. Upon uploading a new image, it should show up in the feed of the user\u2019s followers within 15 minutes. Users should be able to upload potentially thousands of images. (as long as they are not abusing the service) Since our ultimate aim is to learn system design, we will arbitrarily limit the functionalities of the system. This will help us keep sight of our aim, and keep us focussed. Having defined the functionalities and expectations for our system, let us quickly sketch an initial design. As of now, all the functionalities are residing on a single server, which has endpoints for all of these functions. We will attempt to build a system that satisfies our SLOs, is able to serve 50k concurrent users, and about a million total users. In the course of this attempt, we will discuss a string of concepts, some of which we have already seen in Phase 1 of this course. Caution Note that the numbers we have picked in the following sections are completely arbitrary. They have been chosen to demonstrate thinking about system design in a non-abstract manner. They have not been benchmarked, and bear no real world resemblance. Do not use them in any real world systems that you may be designing. You should come up with your own numbers, using the guiding principles we have relied upon here. Estimating resource requirements Single Computer If we wished to run the application on a single server, we would need to perform all the above functionalities from the diagram on this server itself. Let us perform some calculations to figure out what kind of resources we will need. Before anything else, we need to store the data about users, their uploads, follower information and any other metadata. We will choose a relational DB to store this information, like MySQL. Do note that we can also choose to use a NOSQL solution here. That would require a similar approach to calculate the requirements. Let us represent the users like so: UserID(int) UserName(varchar) DisplayName(varchar) YearOfBirth(year) Email(varchar) Photos can be represented like this: PhotoID(int) PhotoHash(varchar) Uploadtime(datetime) Location(varchar) OptionalFlag(varchar) Followers can be represented like this: Follower(int) Followee(int) Let us quickly estimate the storage needed for a hundred million total users. A single user would need 4B + 32B + 32B + 4B + 32B = 104 bytes. A hundred million users would need 10.4 GB storage. A single photo would need about 4B + 20B + 4B + 32B + 4B = 64 bytes of storage to store the metadata related to the photo. Assuming a million photos uploaded in one day, we would need about 64 MB of storage per day, just for the metadata. For the photo storage itself, we will need about 300GB per day, assuming 300KB average photo size. A single visitor opening our application simply hits our /get_feed endpoint upon logging in to the application. Let us quickly calculate the resources needed to serve this request. Assuming the initial feed loads 5 images (of 300 KB size on an average) and then does lazy loading to infinitely scroll, we will need to send about 1.5 megabytes of images to the user for his initial call. With a 1000 Mbps* network link to the server, we can send only about (1000/8)/1.5 or about 83 users all loading the feed at the same time, before we saturate the network link. If we needed to serve 50k concurrent users every second, we would need 1.5*50000*8 = 600000 Mbps network throughput needed for every 5 images sent, assuming we send out all 5 images in a single second. If we are reading all of it from disk, we would likely hit disk throughput limits far before approaching anywhere near this amount of traffic. So in order to meet our application requirements, we would need a server that has ~310GB storage for the database and the images of one day, and about 600 Gbps link to serve 50k users concurrently, along with CPU required to perform all this. Clearly not the task for a single server. And do note that we have severely limited the information we are storing in the database. We would likely need an order of magnitude more information to be stored. While we clearly do not have any real world server that has the resources we calculated above, this exercise provides us some valuable data points about what the resource cost is. Armed with this information, let us work on scaling our system through system design to get us as close as possible to our goals for the application. * Modern servers even have multi-gigabit links, but it is highly unlikely that such a huge server will be serving our application alone. Modern cloud providers have VMs that also boast several gigabits of bandwidth, but they usually end up being throttled after certain limits. References: SQL vs NoSQL databases Introducing Non-Abstract Large System Design","title":"Large System Design"},{"location":"level102/system_design/large-system-design/#application-requirements","text":"Let us define our application requirements in more concrete terms i.e., specific functions: Our photo sharing application must let the user Sign up to become a member, and login to the application Upload photographs, and optionally add a description and tag location and/or people Follow other users on the platform See a feed comprising of photos from other users that they follow View their own profile page, and manage who they follow Let us define expectations for the application\u2019s performance for a better user experience. We also need to define the health of the system. SLIs and SLOs help us do just that.","title":"Application requirements"},{"location":"level102/system_design/large-system-design/#slis-and-slos","text":"The Google SRE book defines service level indicator(SLI) as \u201ca carefully defined quantitative measure of some aspect of the level of service that is provided.\u201d For our application, we can define multiple SLIs. One indicator can be the response time for loading the feed for our photo sharing application. Picking the right set of SLIs is very important since they essentially help us define the health of the system as a whole using concrete data. SLIs for an application are defined by the owners of the service, in consultation with the SREs. Service level objective (SLO) is defined as \u201ca target value or range of values for a service level that is measured by an SLI\u201d. SLO is a way for us to anchor ourselves to an optimal user experience by defining SLI boundaries. If our application takes a long time to load the feed, users might not open it very often. As a result, an example of SLO can be that at least 99% of the users should see their feed loaded within 1 second. Now that we have defined SLIs and SLOs, let us define the application\u2019s scalability, reliability and performance characteristics in terms of specific SLI and SLO levels.","title":"SLIs and SLOs"},{"location":"level102/system_design/large-system-design/#defining-application-requirements-in-terms-of-slis-and-slos","text":"The following can be some of the expectations for our application: Once the user successfully uploads the image, it should be accessible to the user and their followers 100% of the time, barring user elected deletion. At least 50000 unique visitors should be able to visit the site at any given time and view their feed. 99% of the users should be able to view their feeds in less than 1 second. Upon uploading a new image, it should show up in the feed of the user\u2019s followers within 15 minutes. Users should be able to upload potentially thousands of images. (as long as they are not abusing the service) Since our ultimate aim is to learn system design, we will arbitrarily limit the functionalities of the system. This will help us keep sight of our aim, and keep us focussed. Having defined the functionalities and expectations for our system, let us quickly sketch an initial design. As of now, all the functionalities are residing on a single server, which has endpoints for all of these functions. We will attempt to build a system that satisfies our SLOs, is able to serve 50k concurrent users, and about a million total users. In the course of this attempt, we will discuss a string of concepts, some of which we have already seen in Phase 1 of this course.","title":"Defining application requirements in terms of SLIs and SLOs"},{"location":"level102/system_design/large-system-design/#estimating-resource-requirements","text":"Single Computer If we wished to run the application on a single server, we would need to perform all the above functionalities from the diagram on this server itself. Let us perform some calculations to figure out what kind of resources we will need. Before anything else, we need to store the data about users, their uploads, follower information and any other metadata. We will choose a relational DB to store this information, like MySQL. Do note that we can also choose to use a NOSQL solution here. That would require a similar approach to calculate the requirements. Let us represent the users like so: UserID(int) UserName(varchar) DisplayName(varchar) YearOfBirth(year) Email(varchar) Photos can be represented like this: PhotoID(int) PhotoHash(varchar) Uploadtime(datetime) Location(varchar) OptionalFlag(varchar) Followers can be represented like this: Follower(int) Followee(int) Let us quickly estimate the storage needed for a hundred million total users. A single user would need 4B + 32B + 32B + 4B + 32B = 104 bytes. A hundred million users would need 10.4 GB storage. A single photo would need about 4B + 20B + 4B + 32B + 4B = 64 bytes of storage to store the metadata related to the photo. Assuming a million photos uploaded in one day, we would need about 64 MB of storage per day, just for the metadata. For the photo storage itself, we will need about 300GB per day, assuming 300KB average photo size. A single visitor opening our application simply hits our /get_feed endpoint upon logging in to the application. Let us quickly calculate the resources needed to serve this request. Assuming the initial feed loads 5 images (of 300 KB size on an average) and then does lazy loading to infinitely scroll, we will need to send about 1.5 megabytes of images to the user for his initial call. With a 1000 Mbps* network link to the server, we can send only about (1000/8)/1.5 or about 83 users all loading the feed at the same time, before we saturate the network link. If we needed to serve 50k concurrent users every second, we would need 1.5*50000*8 = 600000 Mbps network throughput needed for every 5 images sent, assuming we send out all 5 images in a single second. If we are reading all of it from disk, we would likely hit disk throughput limits far before approaching anywhere near this amount of traffic. So in order to meet our application requirements, we would need a server that has ~310GB storage for the database and the images of one day, and about 600 Gbps link to serve 50k users concurrently, along with CPU required to perform all this. Clearly not the task for a single server. And do note that we have severely limited the information we are storing in the database. We would likely need an order of magnitude more information to be stored. While we clearly do not have any real world server that has the resources we calculated above, this exercise provides us some valuable data points about what the resource cost is. Armed with this information, let us work on scaling our system through system design to get us as close as possible to our goals for the application. * Modern servers even have multi-gigabit links, but it is highly unlikely that such a huge server will be serving our application alone. Modern cloud providers have VMs that also boast several gigabits of bandwidth, but they usually end up being throttled after certain limits.","title":"Estimating resource requirements"},{"location":"level102/system_design/large-system-design/#references","text":"SQL vs NoSQL databases Introducing Non-Abstract Large System Design","title":"References:"},{"location":"level102/system_design/resiliency/","text":"A resilient system is one that can keep functioning in the face of adversity. With our application, there can be numerous failures that act as adversities. There can be network level failures that take out entire data centres, there might be issues at the rack level or at the server level, or there might be something wrong with the cloud provider. We may also run out of capacity, or there might be a wrong code push that breaks the system. We will talk about a couple of such issues, and understand how we might design a system to work around such things. In some cases, a workaround might not be possible. However it is still valuable to know potential vulnerabilities to the system stability. Resilient architectures leverage system design patterns such as graceful degradation, quotas, timeouts and circuit breakers. Let us look at some of them in this section. Quotas A system may have a component or an endpoint that is consumed by multiple components and endpoints. It is important to have something in place that will prevent one consumer or client from overwhelming such a system. Quotas are one way to do this - we simply assign a specific quota for each component - by way of specifying requests per unit time. Anyone who breaches the quota is either warned or dropped, depending on the implementation. This way, one of our own systems misbehaving cannot result in denial of service to others. Quotas also help us prevent cascading failures. Graceful Degradation When a system with multiple dependencies encounters failure in one of the dependencies, gracefully degrading to minimum viable functionality would be a lot better than grinding the entire system to a halt. For example, let us assume there is an endpoint (an URL for a service or a specific function) in our application whose responsibility is to parse the location information in an user uploaded image from the image's metadata and provide suggestions for location tagging to the user. Rather than failing the entire upload, it is much better to skip over this functionality and still give the user an option to manually tag a location. Gracefully degrading is always better compared to total failures. Timeouts We sometimes call other services or resources like databases or API endpoints in our application. When calling such a resource from our application, it is important to always have a reasonable timeout. It doesn\u2019t necessarily even have to be that the resource will fail for all requests. It just might be that a specific request falls in the high tail latency category. A reasonable time out is helpful to keep the user experience consistent - it is better to fail rather than to have frustratingly long delays, in some cases. Exponential back-offs When a service endpoint fails, retries are one way to see if it was a momentary failure. However, if the retry is also going to fail, there is no point in endlessly retrying. At large enough scale, the retries can compete with the new requests (which might very well be served as expected) and saturate the system. To avoid this, we can look at exponential back-off for retries. This essentially decreases the rate at which the clients retry, upon encountering consecutive failures on retries. Circuit breakers While exponential back off is one way to deal with retry storms, circuit breakers can be another. Circuit breakers can help failures from percolating the entire system. Else, an unmitigated failure that flows through the system may result in false alerts, worsening the mean time to detection(MTTD) and mean time to resolution(MTTR). For example, in case one of the in-memory cache nodes fails resulting in requests reaching the database post the initial timeouts for cache, it might end up overloading the database. If the initial connection between cache node failure and DB node failure is not made, then it might result in increased MTTD of the actual cause and consequently the MTTR. Self healing systems A traditionally load-balanced application with multiple instances might fail when more than a threshold of instances stop responding to requests - either because they are down, or suddenly there is a huge influx of requests, resulting in degraded performance. A self-healing system adds more instances in this scenario to replace the failed instances. Auto-scaling like this can also help when there is a sudden spike in query. If our application runs on a public cloud, it might simply be a matter of spinning up more virtual machines . If we are running on-premise out of our data center, then we will want to think about capacity planning much more carefully. Regardless of how we handle adding additional capacity - simply addition may not be enough. We should also think about additional potential failure modes that might be encountered. For example, the load balancing layer itself might need scaling up, to handle the influx of new backends. Continuous Deployment and Integration A well designed system also needs to take into account the need for a proper staging setup that can mimic the production environment as closely as possible. There should also be a way for us to replay production traffic in the staging environment to test changes to production thoroughly.","title":"Resiliency"},{"location":"level102/system_design/resiliency/#quotas","text":"A system may have a component or an endpoint that is consumed by multiple components and endpoints. It is important to have something in place that will prevent one consumer or client from overwhelming such a system. Quotas are one way to do this - we simply assign a specific quota for each component - by way of specifying requests per unit time. Anyone who breaches the quota is either warned or dropped, depending on the implementation. This way, one of our own systems misbehaving cannot result in denial of service to others. Quotas also help us prevent cascading failures.","title":"Quotas"},{"location":"level102/system_design/resiliency/#graceful-degradation","text":"When a system with multiple dependencies encounters failure in one of the dependencies, gracefully degrading to minimum viable functionality would be a lot better than grinding the entire system to a halt. For example, let us assume there is an endpoint (an URL for a service or a specific function) in our application whose responsibility is to parse the location information in an user uploaded image from the image's metadata and provide suggestions for location tagging to the user. Rather than failing the entire upload, it is much better to skip over this functionality and still give the user an option to manually tag a location. Gracefully degrading is always better compared to total failures.","title":"Graceful Degradation"},{"location":"level102/system_design/resiliency/#timeouts","text":"We sometimes call other services or resources like databases or API endpoints in our application. When calling such a resource from our application, it is important to always have a reasonable timeout. It doesn\u2019t necessarily even have to be that the resource will fail for all requests. It just might be that a specific request falls in the high tail latency category. A reasonable time out is helpful to keep the user experience consistent - it is better to fail rather than to have frustratingly long delays, in some cases.","title":"Timeouts"},{"location":"level102/system_design/resiliency/#exponential-back-offs","text":"When a service endpoint fails, retries are one way to see if it was a momentary failure. However, if the retry is also going to fail, there is no point in endlessly retrying. At large enough scale, the retries can compete with the new requests (which might very well be served as expected) and saturate the system. To avoid this, we can look at exponential back-off for retries. This essentially decreases the rate at which the clients retry, upon encountering consecutive failures on retries.","title":"Exponential back-offs"},{"location":"level102/system_design/resiliency/#circuit-breakers","text":"While exponential back off is one way to deal with retry storms, circuit breakers can be another. Circuit breakers can help failures from percolating the entire system. Else, an unmitigated failure that flows through the system may result in false alerts, worsening the mean time to detection(MTTD) and mean time to resolution(MTTR). For example, in case one of the in-memory cache nodes fails resulting in requests reaching the database post the initial timeouts for cache, it might end up overloading the database. If the initial connection between cache node failure and DB node failure is not made, then it might result in increased MTTD of the actual cause and consequently the MTTR.","title":"Circuit breakers"},{"location":"level102/system_design/resiliency/#self-healing-systems","text":"A traditionally load-balanced application with multiple instances might fail when more than a threshold of instances stop responding to requests - either because they are down, or suddenly there is a huge influx of requests, resulting in degraded performance. A self-healing system adds more instances in this scenario to replace the failed instances. Auto-scaling like this can also help when there is a sudden spike in query. If our application runs on a public cloud, it might simply be a matter of spinning up more virtual machines . If we are running on-premise out of our data center, then we will want to think about capacity planning much more carefully. Regardless of how we handle adding additional capacity - simply addition may not be enough. We should also think about additional potential failure modes that might be encountered. For example, the load balancing layer itself might need scaling up, to handle the influx of new backends.","title":"Self healing systems"},{"location":"level102/system_design/resiliency/#continuous-deployment-and-integration","text":"A well designed system also needs to take into account the need for a proper staging setup that can mimic the production environment as closely as possible. There should also be a way for us to replay production traffic in the staging environment to test changes to production thoroughly.","title":"Continuous Deployment and Integration"},{"location":"level102/system_design/scaling-beyond-the-datacenter/","text":"Caching static assets Extending the existing caching solution a bit, we arrive at Content Delivery Networks(CDNs). CDNs are the caching layer that is closest to the user. A significant chunk of resources served in a webpage, may not be changing on an hourly or even a daily basis. In those cases, we would want to cache these at the CDN level, reducing our load. CDNs not only help reduce the load on our servers by removing the burden of serving static / bandwidth intensive resources, they also let us be present closer to our users, by way of points of presence(POPs). CDNs also let us do geo-load balancing, in case we have multiple data centres around the world, and would want to serve from the closest data center (DC) possible. Taking it a step further With the addition of caching and distributing our application into simpler services, we have solved the problem of scaling to 50000 users. However, our users may be geographically distributed locations and may not be at the same distance from our data centre or our cloud region. Consistency in user experience is important, else we are excluding users who are far away from our location, potentially eliminating a significant chunk of potential users. However, it is not impractical to have data centers all over the world, or even in more than a couple of locations in the world. This is where CDNs and POPs come into picture. Points of Presence CDN POPs are geographically distributed data centers aimed at being close to users. POPs reduce the round trip time by delivering content from a location that is nearest to the user. POPs typically may not have all the content, but have caching servers that cache the static assets, and fetch the rest of the content from the origin server where the application actually resides. Their main function is to reduce round trip time by bringing the content closer to the website\u2019s visitor. POPs can also route traffic to one of the multiple origin DCs possible. This way, POPs can be leveraged to add resiliency as well as load-balancing. Now, with our image sharing application becoming more popular by the day, let us assume that we have hit 100,000 concurrent users. And we have built another data center, predicting this increase in traffic. Now we need to be able to route the service to both of these data centers in a reliable manner, while also retaining the ability to fall back to a single data center in case there is an issue with one of the two DCs. This is where sticky routing comes into play. Sticky Routing When an user sends a request, there are cases in which we might want to serve a specific user\u2019s requests from a DC if we have multiple DCs, or a specific server inside a DC. We may also wish to serve all requests from a specific POP by a single data center. Sticky routing helps us do exactly that. It might be simply pinning all users to a specific DC or pinning specific users to specific servers. This is typically done from the POP, so that as soon as the user enters reaches our servers, we can route them to the nearest DC possible. Geo DNS When a user opens the application, the user can be directed to one of the multiple globally distributed POPs. This can be done using GeoDNS , which simply put, gives out a different IP address(which are distributed geographically), depending on the location of the user making the DNS request. GeoDNS is the first step in distributing users to different locations - it is not 100% accurate, and typically makes use of IP address allotment information for guessing the location of the user. However, it works well enough for >90% of the users. After this, we can have a sticky routing service that assigns each user to a specific DC, which we can use to assign a DC to this user, and set a cookie. When the user next visits, the cookie can be read at the POP to decide which data center the user\u2019s traffic must be directed to. Having multiple DCs and leveraging sticky routing has not only scaling benefits, but also adds to the resiliency of the service, albeit at the cost of additional complexity. Let us consider another use case in which an user uploads a new profile picture for themselves. If we have multiple data centres or POPs which are not synced in real time - not all of them might have the newer picture. In such a case, it would make sense to tie that user to a specific DC/region until the update has propagated to all regions. Sticky routing would enable us to do this. References CDNs LinkedIn's TrafficShift blog talks about sticky routing","title":"Scaling Beyond the Data Center"},{"location":"level102/system_design/scaling-beyond-the-datacenter/#caching-static-assets","text":"Extending the existing caching solution a bit, we arrive at Content Delivery Networks(CDNs). CDNs are the caching layer that is closest to the user. A significant chunk of resources served in a webpage, may not be changing on an hourly or even a daily basis. In those cases, we would want to cache these at the CDN level, reducing our load. CDNs not only help reduce the load on our servers by removing the burden of serving static / bandwidth intensive resources, they also let us be present closer to our users, by way of points of presence(POPs). CDNs also let us do geo-load balancing, in case we have multiple data centres around the world, and would want to serve from the closest data center (DC) possible. Taking it a step further With the addition of caching and distributing our application into simpler services, we have solved the problem of scaling to 50000 users. However, our users may be geographically distributed locations and may not be at the same distance from our data centre or our cloud region. Consistency in user experience is important, else we are excluding users who are far away from our location, potentially eliminating a significant chunk of potential users. However, it is not impractical to have data centers all over the world, or even in more than a couple of locations in the world. This is where CDNs and POPs come into picture.","title":"Caching static assets"},{"location":"level102/system_design/scaling-beyond-the-datacenter/#points-of-presence","text":"CDN POPs are geographically distributed data centers aimed at being close to users. POPs reduce the round trip time by delivering content from a location that is nearest to the user. POPs typically may not have all the content, but have caching servers that cache the static assets, and fetch the rest of the content from the origin server where the application actually resides. Their main function is to reduce round trip time by bringing the content closer to the website\u2019s visitor. POPs can also route traffic to one of the multiple origin DCs possible. This way, POPs can be leveraged to add resiliency as well as load-balancing. Now, with our image sharing application becoming more popular by the day, let us assume that we have hit 100,000 concurrent users. And we have built another data center, predicting this increase in traffic. Now we need to be able to route the service to both of these data centers in a reliable manner, while also retaining the ability to fall back to a single data center in case there is an issue with one of the two DCs. This is where sticky routing comes into play.","title":"Points of Presence"},{"location":"level102/system_design/scaling-beyond-the-datacenter/#sticky-routing","text":"When an user sends a request, there are cases in which we might want to serve a specific user\u2019s requests from a DC if we have multiple DCs, or a specific server inside a DC. We may also wish to serve all requests from a specific POP by a single data center. Sticky routing helps us do exactly that. It might be simply pinning all users to a specific DC or pinning specific users to specific servers. This is typically done from the POP, so that as soon as the user enters reaches our servers, we can route them to the nearest DC possible.","title":"Sticky Routing"},{"location":"level102/system_design/scaling-beyond-the-datacenter/#geo-dns","text":"When a user opens the application, the user can be directed to one of the multiple globally distributed POPs. This can be done using GeoDNS , which simply put, gives out a different IP address(which are distributed geographically), depending on the location of the user making the DNS request. GeoDNS is the first step in distributing users to different locations - it is not 100% accurate, and typically makes use of IP address allotment information for guessing the location of the user. However, it works well enough for >90% of the users. After this, we can have a sticky routing service that assigns each user to a specific DC, which we can use to assign a DC to this user, and set a cookie. When the user next visits, the cookie can be read at the POP to decide which data center the user\u2019s traffic must be directed to. Having multiple DCs and leveraging sticky routing has not only scaling benefits, but also adds to the resiliency of the service, albeit at the cost of additional complexity. Let us consider another use case in which an user uploads a new profile picture for themselves. If we have multiple data centres or POPs which are not synced in real time - not all of them might have the newer picture. In such a case, it would make sense to tie that user to a specific DC/region until the update has propagated to all regions. Sticky routing would enable us to do this.","title":"Geo DNS"},{"location":"level102/system_design/scaling-beyond-the-datacenter/#references","text":"CDNs LinkedIn's TrafficShift blog talks about sticky routing","title":"References"},{"location":"level102/system_design/scaling/","text":"In the Phase 1 of this course, we had seen AKF scale cube and how it can help in segmenting services, defining microservices and scaling the overall application. We will use a similar strategy to scale our application - while using the estimates from the previous section, so that we can have a data driven design rather than arbitrarily choosing scaling patterns. Splitting the application Considering the huge volume of traffic that might be generated by our application, and the related resource requirements in terms of memory and CPU, let us split the application into smaller chunks. One of the simplest ways to do this would be to simply divide the application along the endpoints, and spin them up as separate instances. In reality, this decision would probably be a little more complicated, and you might end up having multiple endpoints running from the same instance. The images can be stored in an object store that can be scaled independently, rather than locating it on the servers where the application or the database resides. This would reduce the resource requirements for the servers. Stateful vs Stateless services A stateless process or service doesn\u2019t rely on stored data of it\u2019s past invocations. A stateful service on the other hand stores its state in a datastore, and typically uses the state on every call or transaction. In some cases, there are options for us to design services in such a way that certain components can be made stateless and this helps in multiple ways. Applications can be containerized easily if they are stateless. Containerized applications are also easier to scale. Stateful services require you to scale the datastore with the state as well. However, containerizing databases or scaling databases is out of the scope of this module. The resulting design after such distribution of workloads might look something like this. You might notice that the diagram also has multiple databases. We will see more about this in the following sharding section. Now that we have split the application into smaller services, we need to look at scaling up the capacity of each of these endpoints. The popular Pareto principle states that \u201c80% of consequences come from 20% of the causes\u201d. Modifying it slightly, we can say that 80% of the traffic will be for 20% of images. The no. of images uploaded vs the no. of images seen by the user is going to be similarly skewed. An user is much more likely to view images on a daily basis than they are to upload new ones. In our simple design, generating the feed page with initial 5 images will be a matter of choosing 5 recently uploaded images from fellow users whom this user follows. While we can dynamically fetch the images from the database and generate the page on the fly once the user logs on, we might soon overwhelm the database in case a large number of users choose to login at the same time and load their feeds. There are two things we can do here, one is caching, and the other one is ahead of time generation of user feeds. An user with a million followers can potentially lead to hundreds of thousands of calls to the DB, simply to fetch the latest photoID that the user has uploaded. This can quickly overwhelm any DB, and can potentially bring down the DB itself. Sharding One way to solve the problem of DB limitation is scaling up the DB write and reads. Sharding is one way to scale the DB writes, where the DB would be split into parts that reside in different instances of the DB running on separate machines. DB reads can be scaled up similarly by using read replicas as we had seen in Phase 1 of this module. Compared to the number of images the popular user uploads, the number of views generated would be massive. In that case, we should cache the photoIDs of the user\u2019s uploads, to be returned without having to perform a potentially expensive call to the DB. Let us consider another endpoint in our application named /get_user_details . It simply returns the page an user would see upon clicking another user\u2019s name. This endpoint will return a list of posts that the user has created. Normally, a call to that endpoint will involve the application talking to the DB, fetching a list of all the posts by the user and returning the result. If someone\u2019s profile is viewed thousands of times that means there are thousands of calls to the DB - which may result in issues like hot keys and hot partitions. As with all other systems, an increase in load may result in worsening response times, resulting in inconsistent and potentially bad user experience. A simple solution here would be a cache layer - one that would return the user\u2019s profile with posts without having to call the DB everytime. Caching A cache is used for the temporary storage of data that is likely to be accessed again, often repetitively. When the data requested is found in the cache, it is termed as a `cache hit\u2019. A \u2018cache miss\u2019 is the obvious complement. A well positioned cache can greatly reduce the query response time as well as improve the scalability of a system. Caches can be placed at multiple levels between the user and the application. In Phase 1, we saw how we could use caches / CDNs to service static resources of the application, resulting in quicker response times as well as lesser burden on the application servers. Let us look at more situations where caching can play a role. In-memory caching: In memory caching is when the information to be cached is kept in the main memory of the server, allowing it to be retrieved much faster than a DB residing on a disk. We cache arbitrary text (which can be HTML fragments or may be JSON objects) and fetch it back really fast. An in memory cache is the quickest way to add a layer of fast cache that can optionally be persisted to disk as well. While caching can aid significantly in scaling up and improving performance, there are situations where cache is suddenly not in place. It might be that the cache was accidentally wiped, leading to all the queries falling through to the DB layer, often multiple calls for the same piece of information. It is important to be aware of this potential \u2018thundering herd\u2019 problem and design your system accordingly. Caching proxies: There are cases where you may want to cache entire webpages / responses of other upstream resources that you need to respond to requests. There are also cases where you want to let your upstream tell you what to cache and how long to cache it for. In such cases, it might be a good idea to have a caching solution that understands Cache related HTTP headers. One example for our usecase can be when users search for a specific term in our application - if there is a frequent enough search for a user or a term, it might be more efficient to cache the responses for some duration rather than performing the search anew everytime. Let\u2019s recap one of the goals - Atleast 50000 unique visitors should be able to visit the site at any given time and view their feed. With the implementation of caching, we have removed one potential bottleneck - the DB. We also decomposed the monolith into smaller chunks that provide individual services. Another step closer to our goal is to simply horizontally scale the services needed for feed viewing and putting them behind a load balancer. Please recall the scaling concepts discussed in Phase 1 of this module. Cache managment While caching sounds like a simple, easy solution for a hard problem, an even harder problem is to manage the cache efficiently. Like most things in your system, the cache layer is not infinite. Effective cache management means removing things from the cache at the right time, to ensure the cache hit rate remains high. There are many strategies to invalidate cache after a certain time period or below certain usage thresholds. It is important to keep an eye on cache-hit rate and fine tune your caching strategy accordingly. References There are many object storage solutions available. Minio is one self hosted solution. There are also vendor-specific solutions for the cloud like Azure Blob storage and Amazon S3 . Microservices architecture style - Azure architecture guide There are many in-memory caching solutions. Some of the most popular ones include redis and memcached . Cloud vendors also have their managed cache solutions. Some of the most popular proxies include squid and Apache Traffic Server Thundering herd problem - how instagram tackled it .","title":"Scaling"},{"location":"level102/system_design/scaling/#splitting-the-application","text":"Considering the huge volume of traffic that might be generated by our application, and the related resource requirements in terms of memory and CPU, let us split the application into smaller chunks. One of the simplest ways to do this would be to simply divide the application along the endpoints, and spin them up as separate instances. In reality, this decision would probably be a little more complicated, and you might end up having multiple endpoints running from the same instance. The images can be stored in an object store that can be scaled independently, rather than locating it on the servers where the application or the database resides. This would reduce the resource requirements for the servers.","title":"Splitting the application"},{"location":"level102/system_design/scaling/#stateful-vs-stateless-services","text":"A stateless process or service doesn\u2019t rely on stored data of it\u2019s past invocations. A stateful service on the other hand stores its state in a datastore, and typically uses the state on every call or transaction. In some cases, there are options for us to design services in such a way that certain components can be made stateless and this helps in multiple ways. Applications can be containerized easily if they are stateless. Containerized applications are also easier to scale. Stateful services require you to scale the datastore with the state as well. However, containerizing databases or scaling databases is out of the scope of this module. The resulting design after such distribution of workloads might look something like this. You might notice that the diagram also has multiple databases. We will see more about this in the following sharding section. Now that we have split the application into smaller services, we need to look at scaling up the capacity of each of these endpoints. The popular Pareto principle states that \u201c80% of consequences come from 20% of the causes\u201d. Modifying it slightly, we can say that 80% of the traffic will be for 20% of images. The no. of images uploaded vs the no. of images seen by the user is going to be similarly skewed. An user is much more likely to view images on a daily basis than they are to upload new ones. In our simple design, generating the feed page with initial 5 images will be a matter of choosing 5 recently uploaded images from fellow users whom this user follows. While we can dynamically fetch the images from the database and generate the page on the fly once the user logs on, we might soon overwhelm the database in case a large number of users choose to login at the same time and load their feeds. There are two things we can do here, one is caching, and the other one is ahead of time generation of user feeds. An user with a million followers can potentially lead to hundreds of thousands of calls to the DB, simply to fetch the latest photoID that the user has uploaded. This can quickly overwhelm any DB, and can potentially bring down the DB itself.","title":"Stateful vs Stateless services"},{"location":"level102/system_design/scaling/#sharding","text":"One way to solve the problem of DB limitation is scaling up the DB write and reads. Sharding is one way to scale the DB writes, where the DB would be split into parts that reside in different instances of the DB running on separate machines. DB reads can be scaled up similarly by using read replicas as we had seen in Phase 1 of this module. Compared to the number of images the popular user uploads, the number of views generated would be massive. In that case, we should cache the photoIDs of the user\u2019s uploads, to be returned without having to perform a potentially expensive call to the DB. Let us consider another endpoint in our application named /get_user_details . It simply returns the page an user would see upon clicking another user\u2019s name. This endpoint will return a list of posts that the user has created. Normally, a call to that endpoint will involve the application talking to the DB, fetching a list of all the posts by the user and returning the result. If someone\u2019s profile is viewed thousands of times that means there are thousands of calls to the DB - which may result in issues like hot keys and hot partitions. As with all other systems, an increase in load may result in worsening response times, resulting in inconsistent and potentially bad user experience. A simple solution here would be a cache layer - one that would return the user\u2019s profile with posts without having to call the DB everytime.","title":"Sharding"},{"location":"level102/system_design/scaling/#caching","text":"A cache is used for the temporary storage of data that is likely to be accessed again, often repetitively. When the data requested is found in the cache, it is termed as a `cache hit\u2019. A \u2018cache miss\u2019 is the obvious complement. A well positioned cache can greatly reduce the query response time as well as improve the scalability of a system. Caches can be placed at multiple levels between the user and the application. In Phase 1, we saw how we could use caches / CDNs to service static resources of the application, resulting in quicker response times as well as lesser burden on the application servers. Let us look at more situations where caching can play a role.","title":"Caching"},{"location":"level102/system_design/scaling/#in-memory-caching","text":"In memory caching is when the information to be cached is kept in the main memory of the server, allowing it to be retrieved much faster than a DB residing on a disk. We cache arbitrary text (which can be HTML fragments or may be JSON objects) and fetch it back really fast. An in memory cache is the quickest way to add a layer of fast cache that can optionally be persisted to disk as well. While caching can aid significantly in scaling up and improving performance, there are situations where cache is suddenly not in place. It might be that the cache was accidentally wiped, leading to all the queries falling through to the DB layer, often multiple calls for the same piece of information. It is important to be aware of this potential \u2018thundering herd\u2019 problem and design your system accordingly. Caching proxies: There are cases where you may want to cache entire webpages / responses of other upstream resources that you need to respond to requests. There are also cases where you want to let your upstream tell you what to cache and how long to cache it for. In such cases, it might be a good idea to have a caching solution that understands Cache related HTTP headers. One example for our usecase can be when users search for a specific term in our application - if there is a frequent enough search for a user or a term, it might be more efficient to cache the responses for some duration rather than performing the search anew everytime. Let\u2019s recap one of the goals - Atleast 50000 unique visitors should be able to visit the site at any given time and view their feed. With the implementation of caching, we have removed one potential bottleneck - the DB. We also decomposed the monolith into smaller chunks that provide individual services. Another step closer to our goal is to simply horizontally scale the services needed for feed viewing and putting them behind a load balancer. Please recall the scaling concepts discussed in Phase 1 of this module.","title":"In-memory caching:"},{"location":"level102/system_design/scaling/#cache-managment","text":"While caching sounds like a simple, easy solution for a hard problem, an even harder problem is to manage the cache efficiently. Like most things in your system, the cache layer is not infinite. Effective cache management means removing things from the cache at the right time, to ensure the cache hit rate remains high. There are many strategies to invalidate cache after a certain time period or below certain usage thresholds. It is important to keep an eye on cache-hit rate and fine tune your caching strategy accordingly.","title":"Cache managment"},{"location":"level102/system_design/scaling/#references","text":"There are many object storage solutions available. Minio is one self hosted solution. There are also vendor-specific solutions for the cloud like Azure Blob storage and Amazon S3 . Microservices architecture style - Azure architecture guide There are many in-memory caching solutions. Some of the most popular ones include redis and memcached . Cloud vendors also have their managed cache solutions. Some of the most popular proxies include squid and Apache Traffic Server Thundering herd problem - how instagram tackled it .","title":"References"},{"location":"level102/system_troubleshooting_and_performance/conclusion/","text":"Complex systems have many factors which can go wrong. It can be a bad design & architecture, poorly managed code, poor policies around different caches, bad DB queries or architecture, improper use of resources, or bad OS version, poorly monitored system, datacenter issues, network faults, and many more, Any of these can go wrong. As an SRE, Knowing important tools/commands, best practices, profiling, benchmarking and scaling can help you with faster troubleshooting and performance improvement of the overall system. Further readings Here are some links from the LinkedIn Engineering Blog, as written by LinkedIn engineers, about firefighting they did, ensuring site up 24x7x365. Taming memory fragmentation in Venice with Jemalloc Intro: Every Day Is Monday in Operations Fixing Linux filesystem performance regressions The impact of slow NFS on data systems","title":"Conclusion"},{"location":"level102/system_troubleshooting_and_performance/conclusion/#further-readings","text":"Here are some links from the LinkedIn Engineering Blog, as written by LinkedIn engineers, about firefighting they did, ensuring site up 24x7x365. Taming memory fragmentation in Venice with Jemalloc Intro: Every Day Is Monday in Operations Fixing Linux filesystem performance regressions The impact of slow NFS on data systems","title":"Further readings"},{"location":"level102/system_troubleshooting_and_performance/important-tools/","text":"Important linux commands Having knowledge of following commands will help find issues faster. Elaborating each command in detail is out of scope, please look for man pages or online for more information and examples around the same. For logs parsing -: grep, sed, awk, cut, tail, head For network checks -: nc, netstat, traceroute/6, mtr, ping/6, route, tcpdump, ss, ip For DNS -: dig, host, nslookup For tracing system call -: strace For parallel executions over ssh -: gnu parallel, xargs + ssh. For http/s checks -: curl, wget For list of open files -: lsof For modifying attributes of the system kernel -: sysctl In case of distributed systems, some good third party tools can help to execute commands/instructions on many hosts at once, like: SSH based tools ClusterSSH : Cluster ssh can help you run a command in parallel on many hosts at once. Ansible : It allows you to write ansible playbooks which you can run on hundreds/thousands of hosts at the same time. Agent Based tools Saltstack : Is a configuration, state and remote execution framework, provides a wide variety of flexibility to users to execute modules on large numbers of hosts at once. Puppet : Is an automated administrative engine for your Linux, Unix, and Windows systems, performs administrative tasks. Log analysis tools These can help in writing SQL type queries for parsing, analysing logs and provide an easy UI interface to create dashboards which can render various types of charts based on defined queries. ELK : Elasticsearch, Logstash and Kibana, provide package of tools and services to allow, parse logs, index logs and analyse logs easily and quickly. Once logs/data is parsed/filtered through logstash and indexed in elasticsearch, one can create dynamic dashboards in Kibana in a matter of minutes. Such provides easy analysis and correlation on application errors/exceptions/warnings. Azure kusto : Azure kusto is a cloud based service similar to Elasticsearch and Kibana, it allows easy indexing of heavy logs, provides SQL type interface for writing queries, and an interface to create dynamic dashboards.","title":"Important Tools"},{"location":"level102/system_troubleshooting_and_performance/important-tools/#important-linux-commands","text":"Having knowledge of following commands will help find issues faster. Elaborating each command in detail is out of scope, please look for man pages or online for more information and examples around the same. For logs parsing -: grep, sed, awk, cut, tail, head For network checks -: nc, netstat, traceroute/6, mtr, ping/6, route, tcpdump, ss, ip For DNS -: dig, host, nslookup For tracing system call -: strace For parallel executions over ssh -: gnu parallel, xargs + ssh. For http/s checks -: curl, wget For list of open files -: lsof For modifying attributes of the system kernel -: sysctl In case of distributed systems, some good third party tools can help to execute commands/instructions on many hosts at once, like: SSH based tools ClusterSSH : Cluster ssh can help you run a command in parallel on many hosts at once. Ansible : It allows you to write ansible playbooks which you can run on hundreds/thousands of hosts at the same time. Agent Based tools Saltstack : Is a configuration, state and remote execution framework, provides a wide variety of flexibility to users to execute modules on large numbers of hosts at once. Puppet : Is an automated administrative engine for your Linux, Unix, and Windows systems, performs administrative tasks.","title":"Important linux commands"},{"location":"level102/system_troubleshooting_and_performance/important-tools/#log-analysis-tools","text":"These can help in writing SQL type queries for parsing, analysing logs and provide an easy UI interface to create dashboards which can render various types of charts based on defined queries. ELK : Elasticsearch, Logstash and Kibana, provide package of tools and services to allow, parse logs, index logs and analyse logs easily and quickly. Once logs/data is parsed/filtered through logstash and indexed in elasticsearch, one can create dynamic dashboards in Kibana in a matter of minutes. Such provides easy analysis and correlation on application errors/exceptions/warnings. Azure kusto : Azure kusto is a cloud based service similar to Elasticsearch and Kibana, it allows easy indexing of heavy logs, provides SQL type interface for writing queries, and an interface to create dynamic dashboards.","title":"Log analysis tools"},{"location":"level102/system_troubleshooting_and_performance/introduction/","text":"System troubleshooting and performance improvements Prerequisites Linux Basics System design Basic Networking Metrics and Monitoring What to expect from this course This brief course tries to provide a general introduction on how to troubleshoot system issues, like analysing api failures, resource utilization, network issues, hardware and OS issues. Course also briefs on profiling and benchmarking to measure overall system performance. What is not covered under this course This course does not cover following -: System Design and Architecture. Programming practices. Metrics and Monitoring. OS basics. Course Contents Introduction Troubleshooting Troubleshooting Flowchart General Practices General Host issues Important tools to know Important linux commands Log analysis tools Performance improvements Performance analysis commands Profiling tools Benchmarking Scaling Troubleshooting Example Conclusion Further readings Introduction Troubleshooting is an important part of operations & development. It can\u2019t be learned by just reading one article or completing a course online, Its a continuous learning process, one learns it during :- Daily operations and development. Finding & Fixing application bugs. Finding & Fixing system & network issues. Performance analysis and improvements. And more. From an SRE\u2019s perspective, It is expected that they are aware of certain topics upfront to be able to troubleshoot problems around single or distributed systems. Know your resources well, understand host specifications, liks CPU, Memory, Network, Disk etc. Understand system design and architecture. Ensure important metrics are being collected/rendered properly. There was a famous quote by HP founders - \u201cWhat gets measured gets fixed\u201d If system components and performance metrics are captured thoroughly then there is a high chance of success in troubleshooting an issue, at its earliest. Scope There is no common approach to troubleshoot different types of applications or services, the failure can occur at any layer of it. We will keep the scope of this work to a web api service type only. Note -: Linux ecosystem is wide, there are hundreds of tools and utilities which can help with system troubleshooting, each comes with its own set of benefits and functionalities. We will cover some of the known tools, either already available with Linux or are available in the open source world. Detailed explanation of mentioned tools in this doc is out of scope, please explore the internet or man pages for more examples and documentation around the same.","title":"Introduction"},{"location":"level102/system_troubleshooting_and_performance/introduction/#system-troubleshooting-and-performance-improvements","text":"","title":"System troubleshooting and performance improvements"},{"location":"level102/system_troubleshooting_and_performance/introduction/#prerequisites","text":"Linux Basics System design Basic Networking Metrics and Monitoring","title":"Prerequisites"},{"location":"level102/system_troubleshooting_and_performance/introduction/#what-to-expect-from-this-course","text":"This brief course tries to provide a general introduction on how to troubleshoot system issues, like analysing api failures, resource utilization, network issues, hardware and OS issues. Course also briefs on profiling and benchmarking to measure overall system performance.","title":"What to expect from this course"},{"location":"level102/system_troubleshooting_and_performance/introduction/#what-is-not-covered-under-this-course","text":"This course does not cover following -: System Design and Architecture. Programming practices. Metrics and Monitoring. OS basics.","title":"What is not covered under this course"},{"location":"level102/system_troubleshooting_and_performance/introduction/#course-contents","text":"Introduction Troubleshooting Troubleshooting Flowchart General Practices General Host issues Important tools to know Important linux commands Log analysis tools Performance improvements Performance analysis commands Profiling tools Benchmarking Scaling Troubleshooting Example Conclusion Further readings","title":"Course Contents"},{"location":"level102/system_troubleshooting_and_performance/introduction/#introduction","text":"Troubleshooting is an important part of operations & development. It can\u2019t be learned by just reading one article or completing a course online, Its a continuous learning process, one learns it during :- Daily operations and development. Finding & Fixing application bugs. Finding & Fixing system & network issues. Performance analysis and improvements. And more. From an SRE\u2019s perspective, It is expected that they are aware of certain topics upfront to be able to troubleshoot problems around single or distributed systems. Know your resources well, understand host specifications, liks CPU, Memory, Network, Disk etc. Understand system design and architecture. Ensure important metrics are being collected/rendered properly. There was a famous quote by HP founders - \u201cWhat gets measured gets fixed\u201d If system components and performance metrics are captured thoroughly then there is a high chance of success in troubleshooting an issue, at its earliest.","title":"Introduction"},{"location":"level102/system_troubleshooting_and_performance/introduction/#scope","text":"There is no common approach to troubleshoot different types of applications or services, the failure can occur at any layer of it. We will keep the scope of this work to a web api service type only. Note -: Linux ecosystem is wide, there are hundreds of tools and utilities which can help with system troubleshooting, each comes with its own set of benefits and functionalities. We will cover some of the known tools, either already available with Linux or are available in the open source world. Detailed explanation of mentioned tools in this doc is out of scope, please explore the internet or man pages for more examples and documentation around the same.","title":"Scope"},{"location":"level102/system_troubleshooting_and_performance/performance-improvements/","text":"Performance tools are an important part of development/operations lifecycle, Its highly important for understanding application behavior. SRE generally uses such tools to evaluate how well service will perform and make/suggest improvements accordingly. Performance analysis commands Most of these commands are a must to know for doing performance analysis of a system or service. top -: shows real-time view of running system, processes, threads etc. htop -: Similar to top command, but a bit more interactive then it. iotop -: An interactive disk I/O monitoring tool. vmstat -: Virtual memory statistics explorer. iostat -: Monitoring tool for input/output statistics for devices and partitions. free -: Tell info about physical memory and swap memory. sar -: System activity report, reports diff metrics such as cpu, disk, mem, network, etc. mpstat -: Display info about CPU utilization and performance. lsof -: Provides info about the list of open files, opened by which processes. perf -: Performance analysing tool. Profiling tools Profiling is an important part of performance analysis of the service. There are various profiler tools available, which can help figure most frequent code-paths, debugging, memory profiling, etc. These can generate the heatmap to understand the code performance when under load. FlameGraph : Flame graphs are a visualization of profiled software, allowing the most frequent code-paths to be identified quickly and accurately. Valgrind : It is a programming tool for memory debugging, memory leak detection, and profiling. Gprof : GNU profiler tool uses a hybrid of instrumentation and sampling. Instrumentation is used to collect function call information, and sampling is used to gather runtime profiling information. To know how LinkedIn performs On-Demand Profiling on its services, Read LinkedIn blog ODP: An Infrastructure for On-Demand Service Profiling Benchmarking It is a process of measuring the best performance of the service. Like how much QPS service can handle, its latency when load is increasing, host resource utilization, loadavg etc etc. The regression testing (i.e load testing) is a must before deploying the service to production. Some of known tools -: Apache Benchmark Tool, ab :, It simulate a high load on webapp and gather data for analysis Httperf : It sends requests to the web server at a specified rate and gathers stats. Increase till one finds the saturation point. Apache JMeter : It is a popular open-source tool to measure web application performance. JMeter is a java based application and not only a web server, but you can use it against PHP, Java, REST, etc. Wrk : It is another modern performance measurement tool to put a load on your web server and give you latency, request per second, transfer per second, etc. details. Locust : Easy to use, scriptable and scalable performance testing tool. Limitation -: Above tools help in synthetic load or stress testing, but such does not measure actual end user experience, It can\u2019t see how end user resources will affect application performance, it is due to lack of memory, CPU, or poor connectivity to the internet. To know how LinkedIn performs load testing across its fleet. Read : Eliminating toil with fully automated load testing And to know how LinkedIn makes use of Real Time Monitoring (RUM) data to overcome the limitations of load testing, and help improve overall experience for end users. Read : Monitor and Improve Web Performance Using RUM Data Visualization Scaling System designed optimally can perform up to a certain limit only, based on availability of resources. Continuous optimization is always needed to ensure optimum use of resources at its peak. With increasing QPS, Systems need to scale up. We can either scale vertically or horizontally. Vertical scalability has its limits as one can increase cpu, memory, disk, GPU and other specifications to certain limit only, whereas horizontal scalability can grow easily and infinitely given limitations imposed by application design and environment attributes. Scaling a web application will require some or all of the following -: Ease the server load by adding more hosts. Distributing the traffic across servers by using Load Balancers. Scale up DB by sharding the data and increasing read replicas. Here\u2019s a good read how LinkedIn scaled its application stack A Brief History of Scaling LinkedIn","title":"Performance Improvements"},{"location":"level102/system_troubleshooting_and_performance/performance-improvements/#performance-analysis-commands","text":"Most of these commands are a must to know for doing performance analysis of a system or service. top -: shows real-time view of running system, processes, threads etc. htop -: Similar to top command, but a bit more interactive then it. iotop -: An interactive disk I/O monitoring tool. vmstat -: Virtual memory statistics explorer. iostat -: Monitoring tool for input/output statistics for devices and partitions. free -: Tell info about physical memory and swap memory. sar -: System activity report, reports diff metrics such as cpu, disk, mem, network, etc. mpstat -: Display info about CPU utilization and performance. lsof -: Provides info about the list of open files, opened by which processes. perf -: Performance analysing tool.","title":"Performance analysis commands"},{"location":"level102/system_troubleshooting_and_performance/performance-improvements/#profiling-tools","text":"Profiling is an important part of performance analysis of the service. There are various profiler tools available, which can help figure most frequent code-paths, debugging, memory profiling, etc. These can generate the heatmap to understand the code performance when under load. FlameGraph : Flame graphs are a visualization of profiled software, allowing the most frequent code-paths to be identified quickly and accurately. Valgrind : It is a programming tool for memory debugging, memory leak detection, and profiling. Gprof : GNU profiler tool uses a hybrid of instrumentation and sampling. Instrumentation is used to collect function call information, and sampling is used to gather runtime profiling information. To know how LinkedIn performs On-Demand Profiling on its services, Read LinkedIn blog ODP: An Infrastructure for On-Demand Service Profiling","title":"Profiling tools"},{"location":"level102/system_troubleshooting_and_performance/performance-improvements/#benchmarking","text":"It is a process of measuring the best performance of the service. Like how much QPS service can handle, its latency when load is increasing, host resource utilization, loadavg etc etc. The regression testing (i.e load testing) is a must before deploying the service to production. Some of known tools -: Apache Benchmark Tool, ab :, It simulate a high load on webapp and gather data for analysis Httperf : It sends requests to the web server at a specified rate and gathers stats. Increase till one finds the saturation point. Apache JMeter : It is a popular open-source tool to measure web application performance. JMeter is a java based application and not only a web server, but you can use it against PHP, Java, REST, etc. Wrk : It is another modern performance measurement tool to put a load on your web server and give you latency, request per second, transfer per second, etc. details. Locust : Easy to use, scriptable and scalable performance testing tool. Limitation -: Above tools help in synthetic load or stress testing, but such does not measure actual end user experience, It can\u2019t see how end user resources will affect application performance, it is due to lack of memory, CPU, or poor connectivity to the internet. To know how LinkedIn performs load testing across its fleet. Read : Eliminating toil with fully automated load testing And to know how LinkedIn makes use of Real Time Monitoring (RUM) data to overcome the limitations of load testing, and help improve overall experience for end users. Read : Monitor and Improve Web Performance Using RUM Data Visualization","title":"Benchmarking"},{"location":"level102/system_troubleshooting_and_performance/performance-improvements/#scaling","text":"System designed optimally can perform up to a certain limit only, based on availability of resources. Continuous optimization is always needed to ensure optimum use of resources at its peak. With increasing QPS, Systems need to scale up. We can either scale vertically or horizontally. Vertical scalability has its limits as one can increase cpu, memory, disk, GPU and other specifications to certain limit only, whereas horizontal scalability can grow easily and infinitely given limitations imposed by application design and environment attributes. Scaling a web application will require some or all of the following -: Ease the server load by adding more hosts. Distributing the traffic across servers by using Load Balancers. Scale up DB by sharding the data and increasing read replicas. Here\u2019s a good read how LinkedIn scaled its application stack A Brief History of Scaling LinkedIn","title":"Scaling"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting-example/","text":"In this section we will see an example of an issue and try to troubleshoot it, and at the end a few famous troubleshooting stories are shared, which were shared by LinkedIn engineers earlier. Example - Memory leak : Often memory leak issues go unnoticed until the service becomes unresponsive after running for some time (days, week or even month) until service is restarted or bug is fixed, In such cases, service memory usage will reflect in increasing order in the metric graph, something like this graph. Memory leak is mismanagement of memory allocations by application, where unneeded memory is not released, over the period of time objects continue to pile up in memory resulting in service crash. Generally such non-released objects get sorted by garbage collector automatically, but sometimes due to a bug it fails. Debugging helps in figuring where much of the application storage memory is being applied. Then, you start tracking and filter everything based on usage. In case, you find objects that aren\u2019t in use, but are referenced, you can get rid of them by deleting them to avoid memory leaks. In the case of python applications, it comes with inbuilt features like tracemalloc . This module can help pinpoint where an object was allocated first. Almost every language comes with a set of tools/libraries (inbuilt or external) which helps find memory issues. Similarly for Java there is a famous memory leak detection tool called Java VisualVM . Let\u2019s see how a dummy flask based web app with a memory leak bug, with every request its memory usage keeps increasing, and how we can use tracemalloc to capture the leak. Assumption -: A python virtual environment is created, and flask is installed in it. A bare minimum flask code with bug, read comments for more info Starting flask app On start, Its memory usage is around 26576 kb, i.e approx 26MB Now with every subsequent GET request, We can notice that process memory usage continues to increase slowly. Now lets try 10000 requests, to see if memory usage increases heavily. To hit a high number of requests, we use an Apache benchmarking tool called \u201cab\u201d . After 10000 hits, we can notice memory usage of flask app is jumped almost 15 times, i.e from initial 26576 KB to 419316 KB, i.e from roughly 26 MB to 419 MB , That\u2019s a huge jump for such a small webapp. Lets try the python tracemalloc module to try to understand the application memory allocations. Tracemalloc takes memory snapshots at a particular point, performing various statistics on the same. Adding a bare minimum code to our app.py file, no change in fetchuserdata.py file, it will allow us to capture tracemalloc snapshots whenever we will hit /capture uri. After restart of app.py (flask run) , we will - First hit http://127.0.0.1:5000/capture - Then hit http://127.0.0.1:5000/ 10000 times, for memory leak/s to take place. - Finally hit http://127.0.0.1:5000/capture again to take a snapshot to know which line has the most allocation. In the final snapshot, we noticed the exact module and lineno where most allocation happened. I.e fetchuserdata.py, line no 6, after 10000 hits, it is holding 419 MB of memory. Summary Above example shows how a bug can lead to memory leak, and how we can use tracemalloc to understand where it is. In real world applications are way more complex than the above dummy example, you must understand that using tracemalloc might degrade application performance somebit, due to tracemalloc own overheads. Be mindful about its use in production environments. If you are interested in digging deeper into Python Object Memory Allocation Internals and debugging memory leak, have a look at an Interesting talk by Sanket Patel in PyCon India 2019, Debug Memory Leak In Python Flask | Python Object Memory Allocation Internals","title":"Troubleshooting Example"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting-example/#example-memory-leak","text":"Often memory leak issues go unnoticed until the service becomes unresponsive after running for some time (days, week or even month) until service is restarted or bug is fixed, In such cases, service memory usage will reflect in increasing order in the metric graph, something like this graph. Memory leak is mismanagement of memory allocations by application, where unneeded memory is not released, over the period of time objects continue to pile up in memory resulting in service crash. Generally such non-released objects get sorted by garbage collector automatically, but sometimes due to a bug it fails. Debugging helps in figuring where much of the application storage memory is being applied. Then, you start tracking and filter everything based on usage. In case, you find objects that aren\u2019t in use, but are referenced, you can get rid of them by deleting them to avoid memory leaks. In the case of python applications, it comes with inbuilt features like tracemalloc . This module can help pinpoint where an object was allocated first. Almost every language comes with a set of tools/libraries (inbuilt or external) which helps find memory issues. Similarly for Java there is a famous memory leak detection tool called Java VisualVM . Let\u2019s see how a dummy flask based web app with a memory leak bug, with every request its memory usage keeps increasing, and how we can use tracemalloc to capture the leak. Assumption -: A python virtual environment is created, and flask is installed in it. A bare minimum flask code with bug, read comments for more info Starting flask app On start, Its memory usage is around 26576 kb, i.e approx 26MB Now with every subsequent GET request, We can notice that process memory usage continues to increase slowly. Now lets try 10000 requests, to see if memory usage increases heavily. To hit a high number of requests, we use an Apache benchmarking tool called \u201cab\u201d . After 10000 hits, we can notice memory usage of flask app is jumped almost 15 times, i.e from initial 26576 KB to 419316 KB, i.e from roughly 26 MB to 419 MB , That\u2019s a huge jump for such a small webapp. Lets try the python tracemalloc module to try to understand the application memory allocations. Tracemalloc takes memory snapshots at a particular point, performing various statistics on the same. Adding a bare minimum code to our app.py file, no change in fetchuserdata.py file, it will allow us to capture tracemalloc snapshots whenever we will hit /capture uri. After restart of app.py (flask run) , we will - First hit http://127.0.0.1:5000/capture - Then hit http://127.0.0.1:5000/ 10000 times, for memory leak/s to take place. - Finally hit http://127.0.0.1:5000/capture again to take a snapshot to know which line has the most allocation. In the final snapshot, we noticed the exact module and lineno where most allocation happened. I.e fetchuserdata.py, line no 6, after 10000 hits, it is holding 419 MB of memory. Summary Above example shows how a bug can lead to memory leak, and how we can use tracemalloc to understand where it is. In real world applications are way more complex than the above dummy example, you must understand that using tracemalloc might degrade application performance somebit, due to tracemalloc own overheads. Be mindful about its use in production environments. If you are interested in digging deeper into Python Object Memory Allocation Internals and debugging memory leak, have a look at an Interesting talk by Sanket Patel in PyCon India 2019, Debug Memory Leak In Python Flask | Python Object Memory Allocation Internals","title":"Example - Memory leak :"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting/","text":"Troubleshooting system failures can be tricky or tedious at times. In this practice we need to examine the end-to-end flow of a service, all its downstreams, analysing logs, memory leak, CPU usage, disk IO, network failures, hosts issues, etc. Knowing certain practices and tools can help figure & mitigate failures faster. Here\u2019s the high level troubleshooting flowchart -: Troubleshooting Flowchart General Practices Different systems require different approaches for finding issues. Scope of this is limited and given a problem, there can be many more points which can be looked into. Following points will look at some high level practices towards finding webapp failures and finding fixes for the same. Reproduce problem Try the broken request to reproduce the issue, Like try Hit http/s request which fails. Check the end to end flow of request and look for return codes, mostly 3xx, 4xx or 5xx . 3xx are mostly about redirections, 4xx are about unauthorized, bad request, forbidden, etc, And 5xx is mostly about server side issues. Based on the return code you can look for the next step. Client side issues are mainly about missing or buggy static contents, like javascript issues, bad image, broken json from an async call etc, such can result in incorrect page rendering on browsers. Gather Information Look for errors/exceptions in application logs, Like \"Can\u2019t Allocate Memory\" or OutOfMemoryError, Or Something like \"disk I/O error\", Or a DNS resolution error. Check application and host metrics, Look for anomalies in service and hosts graphs. Since when CPU usage has increased, since when memory usage increased, since when disk space is reduced Or Disk I/O is increased, when load average start shooting up etc. Please read the School of SRE link for more detail around metrics and monitoring . Look for recent code or config changes which possibly are breaking the system. Understand the problem Try correlating gathered data with recent actions, like an exception showing up in logs after config/code deployment. Is it due to the QPS increase? Is it bad SQL queries? Do recent code changes demand better or more hardware? Find a solution and apply a fix Based on the above findings, look for a quick fix if possible, For example like rolling back changes if errors/exceptions correlate. Try patching or hotfixing the code, probably in staging setup if you want to fix forward. Try to scale up the system, if high QPS is the reason for system failure, then try adding resources (compute, storage, memory, etc) as necessary. Optimize SQL queries if needed. Verify complete request flow Hit requests again and ensure returns are successful (return code 2xx). Check Logs ensure no more exceptions/errors, as found earlier. Ensure metrics are back to normal. General Host issues To Know if host health is fine or not, look for any hardware failures or its performance issues, one can try following -: Dmesg -: Shows recent errors / failures thrown by kernel. This help with knowing hardware failures if any ls commands -: lspci, lsblk, lscpu, lsscsi, These commands list out pci, disk, cpu information. /var/log/messages -: Shows system app/service related errors/warnings, also shows kernel issues. Smartd -: check disk health.","title":"Troubleshooting"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting/#troubleshooting-flowchart","text":"","title":"Troubleshooting Flowchart"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting/#general-practices","text":"Different systems require different approaches for finding issues. Scope of this is limited and given a problem, there can be many more points which can be looked into. Following points will look at some high level practices towards finding webapp failures and finding fixes for the same. Reproduce problem Try the broken request to reproduce the issue, Like try Hit http/s request which fails. Check the end to end flow of request and look for return codes, mostly 3xx, 4xx or 5xx . 3xx are mostly about redirections, 4xx are about unauthorized, bad request, forbidden, etc, And 5xx is mostly about server side issues. Based on the return code you can look for the next step. Client side issues are mainly about missing or buggy static contents, like javascript issues, bad image, broken json from an async call etc, such can result in incorrect page rendering on browsers. Gather Information Look for errors/exceptions in application logs, Like \"Can\u2019t Allocate Memory\" or OutOfMemoryError, Or Something like \"disk I/O error\", Or a DNS resolution error. Check application and host metrics, Look for anomalies in service and hosts graphs. Since when CPU usage has increased, since when memory usage increased, since when disk space is reduced Or Disk I/O is increased, when load average start shooting up etc. Please read the School of SRE link for more detail around metrics and monitoring . Look for recent code or config changes which possibly are breaking the system. Understand the problem Try correlating gathered data with recent actions, like an exception showing up in logs after config/code deployment. Is it due to the QPS increase? Is it bad SQL queries? Do recent code changes demand better or more hardware? Find a solution and apply a fix Based on the above findings, look for a quick fix if possible, For example like rolling back changes if errors/exceptions correlate. Try patching or hotfixing the code, probably in staging setup if you want to fix forward. Try to scale up the system, if high QPS is the reason for system failure, then try adding resources (compute, storage, memory, etc) as necessary. Optimize SQL queries if needed. Verify complete request flow Hit requests again and ensure returns are successful (return code 2xx). Check Logs ensure no more exceptions/errors, as found earlier. Ensure metrics are back to normal.","title":"General Practices"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting/#general-host-issues","text":"To Know if host health is fine or not, look for any hardware failures or its performance issues, one can try following -: Dmesg -: Shows recent errors / failures thrown by kernel. This help with knowing hardware failures if any ls commands -: lspci, lsblk, lscpu, lsscsi, These commands list out pci, disk, cpu information. /var/log/messages -: Shows system app/service related errors/warnings, also shows kernel issues. Smartd -: check disk health.","title":"General Host issues"}]} \ No newline at end of file +{"config":{"lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"School of SRE Site Reliability Engineers (SREs) sits at the intersection of software engineering and systems engineering. While there are potentially infinite permutations and combinations of how infrastructure and software components can be put together to achieve an objective, focusing on foundational skills allows SREs to work with complex systems and software, regardless of whether these systems are proprietary, 3rd party, open systems, run on cloud/on-prem infrastructure, etc. Particularly important is to gain a deep understanding of how these areas of systems and infrastructure relate to each other and interact with each other. The combination of software and systems engineering skills is rare and is generally built over time with exposure to a wide variety of infrastructure, systems, and software. SREs bring in engineering practices to keep the site up. Each distributed system is an agglomeration of many components. SREs validate business requirements, convert them to SLAs for each of the components that constitute the distributed system, monitor and measure adherence to SLAs, re-architect or scale out to mitigate or avoid SLA breaches, add these learnings as feedback to new systems or projects and thereby reduce operational toil. Hence SREs play a vital role right from the day 0 design of the system. In early 2019, we started visiting campuses across India to recruit the best and brightest minds to make sure LinkedIn, and all the services that make up its complex technology stack are always available for everyone. This critical function at LinkedIn falls under the purview of the Site Engineering team and Site Reliability Engineers (SREs) who are Software Engineers, specialized in reliability. As we continued on this journey we started getting a lot of questions from these campuses on what exactly the site reliability engineering role entails? And, how could someone learn the skills and the disciplines involved to become a successful site reliability engineer? Fast forward a few months, and a few of these campus students had joined LinkedIn either as interns or as full-time engineers to become a part of the Site Engineering team; we also had a few lateral hires who joined our organization who were not from a traditional SRE background. That's when a few of us got together and started to think about how we can onboard new graduate engineers to the Site Engineering team. There are very few resources out there guiding someone on the basic skill sets one has to acquire as a beginner SRE. Because of the lack of these resources, we felt that individuals have a tough time getting into open positions in the industry. We created the School Of SRE as a starting point for anyone wanting to build their career as an SRE. In this course, we are focusing on building strong foundational skills. The course is structured in a way to provide more real life examples and how learning each of these topics can play an important role in day to day job responsibilities of an SRE. Currently we are covering the following topics under the School Of SRE: Level 101 Fundamentals Series Linux Basics Git Linux Networking Python and Web Data Relational databases(MySQL) NoSQL concepts Big Data Systems Design Metrics and Monitoring Security Level 102 Linux Intermediate Linux Advanced Containers and orchestration System Calls and Signals Networking System Design System troubleshooting and performance improvements We believe continuous learning will help in acquiring deeper knowledge and competencies in order to expand your skill sets, every module has added references that could be a guide for further learning. Our hope is that by going through these modules we should be able to build the essential skills required for a Site Reliability Engineer. At LinkedIn, we are using this curriculum for onboarding our non-traditional hires and new college grads into the SRE role. We had multiple rounds of successful onboarding experiences with new employees and the course helped them be productive in a very short period of time. This motivated us to open source the content for helping other organizations in onboarding new engineers into the role and provide guidance for aspiring individuals to get into the role. We realize that the initial content we created is just a starting point and we hope that the community can help in the journey of refining and expanding the content. Check out the contributing guide to get started.","title":"Home"},{"location":"#school-of-sre","text":"Site Reliability Engineers (SREs) sits at the intersection of software engineering and systems engineering. While there are potentially infinite permutations and combinations of how infrastructure and software components can be put together to achieve an objective, focusing on foundational skills allows SREs to work with complex systems and software, regardless of whether these systems are proprietary, 3rd party, open systems, run on cloud/on-prem infrastructure, etc. Particularly important is to gain a deep understanding of how these areas of systems and infrastructure relate to each other and interact with each other. The combination of software and systems engineering skills is rare and is generally built over time with exposure to a wide variety of infrastructure, systems, and software. SREs bring in engineering practices to keep the site up. Each distributed system is an agglomeration of many components. SREs validate business requirements, convert them to SLAs for each of the components that constitute the distributed system, monitor and measure adherence to SLAs, re-architect or scale out to mitigate or avoid SLA breaches, add these learnings as feedback to new systems or projects and thereby reduce operational toil. Hence SREs play a vital role right from the day 0 design of the system. In early 2019, we started visiting campuses across India to recruit the best and brightest minds to make sure LinkedIn, and all the services that make up its complex technology stack are always available for everyone. This critical function at LinkedIn falls under the purview of the Site Engineering team and Site Reliability Engineers (SREs) who are Software Engineers, specialized in reliability. As we continued on this journey we started getting a lot of questions from these campuses on what exactly the site reliability engineering role entails? And, how could someone learn the skills and the disciplines involved to become a successful site reliability engineer? Fast forward a few months, and a few of these campus students had joined LinkedIn either as interns or as full-time engineers to become a part of the Site Engineering team; we also had a few lateral hires who joined our organization who were not from a traditional SRE background. That's when a few of us got together and started to think about how we can onboard new graduate engineers to the Site Engineering team. There are very few resources out there guiding someone on the basic skill sets one has to acquire as a beginner SRE. Because of the lack of these resources, we felt that individuals have a tough time getting into open positions in the industry. We created the School Of SRE as a starting point for anyone wanting to build their career as an SRE. In this course, we are focusing on building strong foundational skills. The course is structured in a way to provide more real life examples and how learning each of these topics can play an important role in day to day job responsibilities of an SRE. Currently we are covering the following topics under the School Of SRE: Level 101 Fundamentals Series Linux Basics Git Linux Networking Python and Web Data Relational databases(MySQL) NoSQL concepts Big Data Systems Design Metrics and Monitoring Security Level 102 Linux Intermediate Linux Advanced Containers and orchestration System Calls and Signals Networking System Design System troubleshooting and performance improvements We believe continuous learning will help in acquiring deeper knowledge and competencies in order to expand your skill sets, every module has added references that could be a guide for further learning. Our hope is that by going through these modules we should be able to build the essential skills required for a Site Reliability Engineer. At LinkedIn, we are using this curriculum for onboarding our non-traditional hires and new college grads into the SRE role. We had multiple rounds of successful onboarding experiences with new employees and the course helped them be productive in a very short period of time. This motivated us to open source the content for helping other organizations in onboarding new engineers into the role and provide guidance for aspiring individuals to get into the role. We realize that the initial content we created is just a starting point and we hope that the community can help in the journey of refining and expanding the content. Check out the contributing guide to get started.","title":"School of SRE"},{"location":"CODE_OF_CONDUCT/","text":"This code of conduct outlines expectations for participation in LinkedIn-managed open source communities, as well as steps for reporting unacceptable behavior. We are committed to providing a welcoming and inspiring community for all. People violating this code of conduct may be banned from the community. Our open source communities strive to: Be friendly and patient: Remember you might not be communicating in someone else's primary spoken or programming language, and others may not have your level of understanding. Be welcoming: Our communities welcome and support people of all backgrounds and identities. This includes, but is not limited to members of any race, ethnicity, culture, national origin, color, immigration status, social and economic class, educational level, sex, sexual orientation, gender identity and expression, age, size, family status, political belief, religion, and mental and physical ability. Be respectful: We are a world-wide community of professionals, and we conduct ourselves professionally. Disagreement is no excuse for poor behavior and poor manners. Disrespectful and unacceptable behavior includes, but is not limited to: Violent threats or language. Discriminatory or derogatory jokes and language. Posting sexually explicit or violent material. Posting, or threatening to post, people's personally identifying information (\"doxing\"). Insults, especially those using discriminatory terms or slurs. Behavior that could be perceived as sexual attention. Advocating for or encouraging any of the above behaviors. Understand disagreements: Disagreements, both social and technical, are useful learning opportunities. Seek to understand the other viewpoints and resolve differences constructively. This code is not exhaustive or complete. It serves to capture our common understanding of a productive, collaborative environment. We expect the code to be followed in spirit as much as in the letter. Scope This code of conduct applies to all repos and communities for LinkedIn-managed open source projects regardless of whether or not the repo explicitly calls out its use of this code. The code also applies in public spaces when an individual is representing a project or its community. Examples include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. Note: Some LinkedIn-managed communities have codes of conduct that pre-date this document and issue resolution process. While communities are not required to change their code, they are expected to use the resolution process outlined here. The review team will coordinate with the communities involved to address your concerns. Reporting Code of Conduct Issues We encourage all communities to resolve issues on their own whenever possible. This builds a broader and deeper understanding and ultimately a healthier interaction. In the event that an issue cannot be resolved locally, please feel free to report your concerns by contacting oss@linkedin.com . In your report please include: Your contact information. Names (real, usernames or pseudonyms) of any individuals involved. If there are additional witnesses, please include them as well. Your account of what occurred, and if you believe the incident is ongoing. If there is a publicly available record (e.g. a mailing list archive or a public chat log), please include a link or attachment. Any additional information that may be helpful. All reports will be reviewed by a multi-person team and will result in a response that is deemed necessary and appropriate to the circumstances. Where additional perspectives are needed, the team may seek insight from others with relevant expertise or experience. The confidentiality of the person reporting the incident will be kept at all times. Involved parties are never part of the review team. Anyone asked to stop unacceptable behavior is expected to comply immediately. If an individual engages in unacceptable behavior, the review team may take any action they deem appropriate, including a permanent ban from the community. This code of conduct is based on the Microsoft Open Source Code of Conduct which was based on the template established by the TODO Group and used by numerous other large communities (e.g., Facebook , Yahoo , Twitter , GitHub ) and the Scope section from the Contributor Covenant version 1.4 .","title":"Code of Conduct"},{"location":"CODE_OF_CONDUCT/#scope","text":"This code of conduct applies to all repos and communities for LinkedIn-managed open source projects regardless of whether or not the repo explicitly calls out its use of this code. The code also applies in public spaces when an individual is representing a project or its community. Examples include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. Note: Some LinkedIn-managed communities have codes of conduct that pre-date this document and issue resolution process. While communities are not required to change their code, they are expected to use the resolution process outlined here. The review team will coordinate with the communities involved to address your concerns.","title":"Scope"},{"location":"CODE_OF_CONDUCT/#reporting-code-of-conduct-issues","text":"We encourage all communities to resolve issues on their own whenever possible. This builds a broader and deeper understanding and ultimately a healthier interaction. In the event that an issue cannot be resolved locally, please feel free to report your concerns by contacting oss@linkedin.com . In your report please include: Your contact information. Names (real, usernames or pseudonyms) of any individuals involved. If there are additional witnesses, please include them as well. Your account of what occurred, and if you believe the incident is ongoing. If there is a publicly available record (e.g. a mailing list archive or a public chat log), please include a link or attachment. Any additional information that may be helpful. All reports will be reviewed by a multi-person team and will result in a response that is deemed necessary and appropriate to the circumstances. Where additional perspectives are needed, the team may seek insight from others with relevant expertise or experience. The confidentiality of the person reporting the incident will be kept at all times. Involved parties are never part of the review team. Anyone asked to stop unacceptable behavior is expected to comply immediately. If an individual engages in unacceptable behavior, the review team may take any action they deem appropriate, including a permanent ban from the community. This code of conduct is based on the Microsoft Open Source Code of Conduct which was based on the template established by the TODO Group and used by numerous other large communities (e.g., Facebook , Yahoo , Twitter , GitHub ) and the Scope section from the Contributor Covenant version 1.4 .","title":"Reporting Code of Conduct Issues"},{"location":"CONTRIBUTING/","text":"We realise that the initial content we created is just a starting point and our hope is that the community can help in the journey refining and extending the contents. As a contributor, you represent that the content you submit is not plagiarised. By submitting the content, you (and, if applicable, your employer) are licensing the submitted content to LinkedIn and the open source community subject to the Creative Commons Attribution 4.0 International Public License. Repository URL : https://github.com/linkedin/school-of-sre Contributing Guidelines Ensure that you adhere to the following guidelines: Should be about principles and concepts that can be applied in any company or individual project. Do not focus on particular tools or tech stack(which usually change over time). Adhere to the Code of Conduct . Should be relevant to the roles and responsibilities of an SRE. Should be locally tested (see steps for testing) and well formatted. It is good practice to open an issue first and discuss your changes before submitting a pull request. This way, you can incorporate ideas from others before you even start. Building and testing locally Run the following commands to build and view the site locally before opening a PR. python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt mkdocs build mkdocs serve Opening a PR Follow the GitHub PR workflow for your contributions. Fork this repo, create a feature branch, commit your changes and open a PR to this repo.","title":"Contribute"},{"location":"CONTRIBUTING/#contributing-guidelines","text":"Ensure that you adhere to the following guidelines: Should be about principles and concepts that can be applied in any company or individual project. Do not focus on particular tools or tech stack(which usually change over time). Adhere to the Code of Conduct . Should be relevant to the roles and responsibilities of an SRE. Should be locally tested (see steps for testing) and well formatted. It is good practice to open an issue first and discuss your changes before submitting a pull request. This way, you can incorporate ideas from others before you even start.","title":"Contributing Guidelines"},{"location":"CONTRIBUTING/#building-and-testing-locally","text":"Run the following commands to build and view the site locally before opening a PR. python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt mkdocs build mkdocs serve","title":"Building and testing locally"},{"location":"CONTRIBUTING/#opening-a-pr","text":"Follow the GitHub PR workflow for your contributions. Fork this repo, create a feature branch, commit your changes and open a PR to this repo.","title":"Opening a PR"},{"location":"sre_community/","text":"We are having an active LinkedIn community for School of SRE. Please join the group via : https://www.linkedin.com/groups/12493545/ The group has members with different levels of experience in site reliability engineering. There are active conversation on different technical topics centered around site reliability engineering. We encourage everyone to join the conversation and learn from each other and build a successful career in the SRE space.","title":"SRE Community"},{"location":"level101/big_data/evolution/","text":"Evolution of Hadoop Architecture of Hadoop HDFS The Hadoop Distributed File System (HDFS) is a distributed file system designed to run on commodity hardware. It has many similarities with existing distributed file systems. However, the differences from other distributed file systems are significant. HDFS is highly fault-tolerant and is designed to be deployed on low-cost hardware. HDFS provides high throughput access to application data and is suitable for applications that have large data sets. HDFS is part of the Apache Hadoop Core project . NameNode: is the arbitrator and central repository of file namespace in the cluster. The NameNode executes the operations such as opening, closing, and renaming files and directories. DataNode: manages the storage attached to the node on which it runs. It is responsible for serving all the read and writes requests. It performs operations on instructions on NameNode such as creation, deletion, and replications of blocks. Client: Responsible for getting the required metadata from the namenode and then communicating with the datanodes for reads and writes. YARN YARN stands for \u201cYet Another Resource Negotiator\u201c. It was introduced in Hadoop 2.0 to remove the bottleneck on Job Tracker which was present in Hadoop 1.0. YARN was described as a \u201cRedesigned Resource Manager\u201d at the time of its launching, but it has now evolved to be known as a large-scale distributed operating system used for Big Data processing. The main components of YARN architecture include: Client: It submits map-reduce(MR) jobs to the resource manager. Resource Manager: It is the master daemon of YARN and is responsible for resource assignment and management among all the applications. Whenever it receives a processing request, it forwards it to the corresponding node manager and allocates resources for the completion of the request accordingly. It has two major components: Scheduler: It performs scheduling based on the allocated application and available resources. It is a pure scheduler, which means that it does not perform other tasks such as monitoring or tracking and does not guarantee a restart if a task fails. The YARN scheduler supports plugins such as Capacity Scheduler and Fair Scheduler to partition the cluster resources. Application manager: It is responsible for accepting the application and negotiating the first container from the resource manager. It also restarts the Application Manager container if a task fails. Node Manager: It takes care of individual nodes on the Hadoop cluster and manages application and workflow and that particular node. Its primary job is to keep up with the Node Manager. It monitors resource usage, performs log management, and also kills a container based on directions from the resource manager. It is also responsible for creating the container process and starting it at the request of the Application master. Application Master: An application is a single job submitted to a framework. The application manager is responsible for negotiating resources with the resource manager, tracking the status, and monitoring the progress of a single application. The application master requests the container from the node manager by sending a Container Launch Context(CLC) which includes everything an application needs to run. Once the application is started, it sends the health report to the resource manager from time-to-time. Container: It is a collection of physical resources such as RAM, CPU cores, and disk on a single node. The containers are invoked by Container Launch Context(CLC) which is a record that contains information such as environment variables, security tokens, dependencies, etc. MapReduce framework The term MapReduce represents two separate and distinct tasks Hadoop programs perform-Map Job and Reduce Job. Map jobs take data sets as input and process them to produce key-value pairs. Reduce job takes the output of the Map job i.e. the key-value pairs and aggregates them to produce desired results. Hadoop MapReduce (Hadoop Map/Reduce) is a software framework for distributed processing of large data sets on computing clusters. Mapreduce helps to split the input data set into a number of parts and run a program on all data parts parallel at once. Please find the below Word count example demonstrating the usage of the MapReduce framework: Other tooling around Hadoop Hive Uses a language called HQL which is very SQL like. Gives non-programmers the ability to query and analyze data in Hadoop. Is basically an abstraction layer on top of map-reduce. Ex. HQL query: SELECT pet.name, comment FROM pet JOIN event ON (pet.name = event.name); In mysql: SELECT pet.name, comment FROM pet, event WHERE pet.name = event.name; Pig Uses a scripting language called Pig Latin, which is more workflow driven. Don't need to be an expert Java programmer but need a few coding skills. Is also an abstraction layer on top of map-reduce. Here is a quick question for you: What is the output of running the pig queries in the right column against the data present in the left column in the below image? Output: 7,Komal,Nayak,24,9848022334,trivendram 8,Bharathi,Nambiayar,24,9848022333,Chennai 5,Trupthi,Mohanthy,23,9848022336,Bhuwaneshwar 6,Archana,Mishra,23,9848022335,Chennai Spark Spark provides primitives for in-memory cluster computing that allows user programs to load data into a cluster\u2019s memory and query it repeatedly, making it well suited to machine learning algorithms. Presto Presto is a high performance, distributed SQL query engine for Big Data. Its architecture allows users to query a variety of data sources such as Hadoop, AWS S3, Alluxio, MySQL, Cassandra, Kafka, and MongoDB. Example presto query: use studentDB; show tables; SELECT roll_no, name FROM studentDB.studentDetails where section=\u2019A\u2019 limit 5; Data Serialisation and storage In order to transport the data over the network or to store on some persistent storage, we use the process of translating data structures or objects state into binary or textual form. We call this process serialization.. Avro data is stored in a container file (a .avro file) and its schema (the .avsc file) is stored with the data file. Apache Hive provides support to store a table as Avro and can also query data in this serialisation format.","title":"Evolution and Architecture of Hadoop"},{"location":"level101/big_data/evolution/#evolution-of-hadoop","text":"","title":"Evolution of Hadoop"},{"location":"level101/big_data/evolution/#architecture-of-hadoop","text":"HDFS The Hadoop Distributed File System (HDFS) is a distributed file system designed to run on commodity hardware. It has many similarities with existing distributed file systems. However, the differences from other distributed file systems are significant. HDFS is highly fault-tolerant and is designed to be deployed on low-cost hardware. HDFS provides high throughput access to application data and is suitable for applications that have large data sets. HDFS is part of the Apache Hadoop Core project . NameNode: is the arbitrator and central repository of file namespace in the cluster. The NameNode executes the operations such as opening, closing, and renaming files and directories. DataNode: manages the storage attached to the node on which it runs. It is responsible for serving all the read and writes requests. It performs operations on instructions on NameNode such as creation, deletion, and replications of blocks. Client: Responsible for getting the required metadata from the namenode and then communicating with the datanodes for reads and writes. YARN YARN stands for \u201cYet Another Resource Negotiator\u201c. It was introduced in Hadoop 2.0 to remove the bottleneck on Job Tracker which was present in Hadoop 1.0. YARN was described as a \u201cRedesigned Resource Manager\u201d at the time of its launching, but it has now evolved to be known as a large-scale distributed operating system used for Big Data processing. The main components of YARN architecture include: Client: It submits map-reduce(MR) jobs to the resource manager. Resource Manager: It is the master daemon of YARN and is responsible for resource assignment and management among all the applications. Whenever it receives a processing request, it forwards it to the corresponding node manager and allocates resources for the completion of the request accordingly. It has two major components: Scheduler: It performs scheduling based on the allocated application and available resources. It is a pure scheduler, which means that it does not perform other tasks such as monitoring or tracking and does not guarantee a restart if a task fails. The YARN scheduler supports plugins such as Capacity Scheduler and Fair Scheduler to partition the cluster resources. Application manager: It is responsible for accepting the application and negotiating the first container from the resource manager. It also restarts the Application Manager container if a task fails. Node Manager: It takes care of individual nodes on the Hadoop cluster and manages application and workflow and that particular node. Its primary job is to keep up with the Node Manager. It monitors resource usage, performs log management, and also kills a container based on directions from the resource manager. It is also responsible for creating the container process and starting it at the request of the Application master. Application Master: An application is a single job submitted to a framework. The application manager is responsible for negotiating resources with the resource manager, tracking the status, and monitoring the progress of a single application. The application master requests the container from the node manager by sending a Container Launch Context(CLC) which includes everything an application needs to run. Once the application is started, it sends the health report to the resource manager from time-to-time. Container: It is a collection of physical resources such as RAM, CPU cores, and disk on a single node. The containers are invoked by Container Launch Context(CLC) which is a record that contains information such as environment variables, security tokens, dependencies, etc.","title":"Architecture of Hadoop"},{"location":"level101/big_data/evolution/#mapreduce-framework","text":"The term MapReduce represents two separate and distinct tasks Hadoop programs perform-Map Job and Reduce Job. Map jobs take data sets as input and process them to produce key-value pairs. Reduce job takes the output of the Map job i.e. the key-value pairs and aggregates them to produce desired results. Hadoop MapReduce (Hadoop Map/Reduce) is a software framework for distributed processing of large data sets on computing clusters. Mapreduce helps to split the input data set into a number of parts and run a program on all data parts parallel at once. Please find the below Word count example demonstrating the usage of the MapReduce framework:","title":"MapReduce framework"},{"location":"level101/big_data/evolution/#other-tooling-around-hadoop","text":"Hive Uses a language called HQL which is very SQL like. Gives non-programmers the ability to query and analyze data in Hadoop. Is basically an abstraction layer on top of map-reduce. Ex. HQL query: SELECT pet.name, comment FROM pet JOIN event ON (pet.name = event.name); In mysql: SELECT pet.name, comment FROM pet, event WHERE pet.name = event.name; Pig Uses a scripting language called Pig Latin, which is more workflow driven. Don't need to be an expert Java programmer but need a few coding skills. Is also an abstraction layer on top of map-reduce. Here is a quick question for you: What is the output of running the pig queries in the right column against the data present in the left column in the below image? Output: 7,Komal,Nayak,24,9848022334,trivendram 8,Bharathi,Nambiayar,24,9848022333,Chennai 5,Trupthi,Mohanthy,23,9848022336,Bhuwaneshwar 6,Archana,Mishra,23,9848022335,Chennai Spark Spark provides primitives for in-memory cluster computing that allows user programs to load data into a cluster\u2019s memory and query it repeatedly, making it well suited to machine learning algorithms. Presto Presto is a high performance, distributed SQL query engine for Big Data. Its architecture allows users to query a variety of data sources such as Hadoop, AWS S3, Alluxio, MySQL, Cassandra, Kafka, and MongoDB. Example presto query: use studentDB; show tables; SELECT roll_no, name FROM studentDB.studentDetails where section=\u2019A\u2019 limit 5;","title":"Other tooling around Hadoop"},{"location":"level101/big_data/evolution/#data-serialisation-and-storage","text":"In order to transport the data over the network or to store on some persistent storage, we use the process of translating data structures or objects state into binary or textual form. We call this process serialization.. Avro data is stored in a container file (a .avro file) and its schema (the .avsc file) is stored with the data file. Apache Hive provides support to store a table as Avro and can also query data in this serialisation format.","title":"Data Serialisation and storage"},{"location":"level101/big_data/intro/","text":"Big Data Prerequisites Basics of Linux File systems. Basic understanding of System Design. What to expect from this course This course covers the basics of Big Data and how it has evolved to become what it is today. We will take a look at a few realistic scenarios where Big Data would be a perfect fit. An interesting assignment on designing a Big Data system is followed by understanding the architecture of Hadoop and the tooling around it. What is not covered under this course Writing programs to draw analytics from data. Course Contents Overview of Big Data Usage of Big Data techniques Evolution of Hadoop Architecture of hadoop HDFS Yarn MapReduce framework Other tooling around hadoop Hive Pig Spark Presto Data Serialisation and storage Overview of Big Data Big Data is a collection of large datasets that cannot be processed using traditional computing techniques. It is not a single technique or a tool, rather it has become a complete subject, which involves various tools, techniques, and frameworks. Big Data could consist of Structured data Unstructured data Semi-structured data Characteristics of Big Data: Volume Variety Velocity Variability Examples of Big Data generation include stock exchanges, social media sites, jet engines, etc. Usage of Big Data Techniques Take the example of the traffic lights problem. There are more than 300,000 traffic lights in the US as of 2018. Let us assume that we placed a device on each of them to collect metrics and send it to a central metrics collection system. If each of the IoT devices sends 10 events per minute, we have 300000x10x60x24 = 432x10^7 events per day. How would you go about processing that and telling me how many of the signals were \u201cgreen\u201d at 10:45 am on a particular day? Consider the next example on Unified Payments Interface (UPI) transactions: We had about 1.15 billion UPI transactions in the month of October 2019 in India. If we try to extrapolate this data to about a year and try to find out some common payments that were happening through a particular UPI ID, how do you suggest we go about that?","title":"Introduction"},{"location":"level101/big_data/intro/#big-data","text":"","title":"Big Data"},{"location":"level101/big_data/intro/#prerequisites","text":"Basics of Linux File systems. Basic understanding of System Design.","title":"Prerequisites"},{"location":"level101/big_data/intro/#what-to-expect-from-this-course","text":"This course covers the basics of Big Data and how it has evolved to become what it is today. We will take a look at a few realistic scenarios where Big Data would be a perfect fit. An interesting assignment on designing a Big Data system is followed by understanding the architecture of Hadoop and the tooling around it.","title":"What to expect from this course"},{"location":"level101/big_data/intro/#what-is-not-covered-under-this-course","text":"Writing programs to draw analytics from data.","title":"What is not covered under this course"},{"location":"level101/big_data/intro/#course-contents","text":"Overview of Big Data Usage of Big Data techniques Evolution of Hadoop Architecture of hadoop HDFS Yarn MapReduce framework Other tooling around hadoop Hive Pig Spark Presto Data Serialisation and storage","title":"Course Contents"},{"location":"level101/big_data/intro/#overview-of-big-data","text":"Big Data is a collection of large datasets that cannot be processed using traditional computing techniques. It is not a single technique or a tool, rather it has become a complete subject, which involves various tools, techniques, and frameworks. Big Data could consist of Structured data Unstructured data Semi-structured data Characteristics of Big Data: Volume Variety Velocity Variability Examples of Big Data generation include stock exchanges, social media sites, jet engines, etc.","title":"Overview of Big Data"},{"location":"level101/big_data/intro/#usage-of-big-data-techniques","text":"Take the example of the traffic lights problem. There are more than 300,000 traffic lights in the US as of 2018. Let us assume that we placed a device on each of them to collect metrics and send it to a central metrics collection system. If each of the IoT devices sends 10 events per minute, we have 300000x10x60x24 = 432x10^7 events per day. How would you go about processing that and telling me how many of the signals were \u201cgreen\u201d at 10:45 am on a particular day? Consider the next example on Unified Payments Interface (UPI) transactions: We had about 1.15 billion UPI transactions in the month of October 2019 in India. If we try to extrapolate this data to about a year and try to find out some common payments that were happening through a particular UPI ID, how do you suggest we go about that?","title":"Usage of Big Data Techniques"},{"location":"level101/big_data/tasks/","text":"Tasks and conclusion Post-training tasks: Try setting up your own 3 node Hadoop cluster. A VM based solution can be found here Write a simple spark/MR job of your choice and understand how to generate analytics from data. Sample dataset can be found here References: Hadoop documentation HDFS Architecture YARN Architecture Google GFS paper","title":"Conclusion"},{"location":"level101/big_data/tasks/#tasks-and-conclusion","text":"","title":"Tasks and conclusion"},{"location":"level101/big_data/tasks/#post-training-tasks","text":"Try setting up your own 3 node Hadoop cluster. A VM based solution can be found here Write a simple spark/MR job of your choice and understand how to generate analytics from data. Sample dataset can be found here","title":"Post-training tasks:"},{"location":"level101/big_data/tasks/#references","text":"Hadoop documentation HDFS Architecture YARN Architecture Google GFS paper","title":"References:"},{"location":"level101/databases_nosql/further_reading/","text":"Conclusion We have covered basic concepts of NoSQL databases. There is much more to learn and do. We hope this course gives you a good start and inspires you to explore further. Further reading NoSQL: https://hostingdata.co.uk/nosql-database/ https://www.mongodb.com/nosql-explained https://www.mongodb.com/nosql-explained/nosql-vs-sql Cap Theorem http://www.julianbrowne.com/article/brewers-cap-theorem Scalability http://www.slideshare.net/jboner/scalability-availability-stability-patterns Eventual Consistency https://www.allthingsdistributed.com/2008/12/eventually_consistent.html https://www.toptal.com/big-data/consistent-hashing https://web.stanford.edu/class/cs244/papers/chord_TON_2003.pdf","title":"Conclusion"},{"location":"level101/databases_nosql/further_reading/#conclusion","text":"We have covered basic concepts of NoSQL databases. There is much more to learn and do. We hope this course gives you a good start and inspires you to explore further.","title":"Conclusion"},{"location":"level101/databases_nosql/further_reading/#further-reading","text":"NoSQL: https://hostingdata.co.uk/nosql-database/ https://www.mongodb.com/nosql-explained https://www.mongodb.com/nosql-explained/nosql-vs-sql Cap Theorem http://www.julianbrowne.com/article/brewers-cap-theorem Scalability http://www.slideshare.net/jboner/scalability-availability-stability-patterns Eventual Consistency https://www.allthingsdistributed.com/2008/12/eventually_consistent.html https://www.toptal.com/big-data/consistent-hashing https://web.stanford.edu/class/cs244/papers/chord_TON_2003.pdf","title":"Further reading"},{"location":"level101/databases_nosql/intro/","text":"NoSQL Concepts Prerequisites Relational Databases What to expect from this course At the end of training, you will have an understanding of what a NoSQL database is, what kind of advantages or disadvantages it has over traditional RDBMS, learn about different types of NoSQL databases and understand some of the underlying concepts & trade offs w.r.t to NoSQL. What is not covered under this course We will not be deep diving into any specific NoSQL Database. Course Contents Introduction to NoSQL CAP Theorem Data versioning Partitioning Hashing Quorum Introduction When people use the term \u201cNoSQL database\u201d, they typically use it to refer to any non-relational database. Some say the term \u201cNoSQL\u201d stands for \u201cnon SQL\u201d while others say it stands for \u201cnot only SQL.\u201d Either way, most agree that NoSQL databases are databases that store data in a format other than relational tables. A common misconception is that NoSQL databases or non-relational databases don\u2019t store relationship data well. NoSQL databases can store relationship data\u2014they just store it differently than relational databases do. In fact, when compared with SQL databases, many find modeling relationship data in NoSQL databases to be easier , because related data doesn\u2019t have to be split between tables. Such databases have existed since the late 1960s, but the name \"NoSQL\" was only coined in the early 21st century. NASA used a NoSQL database to track inventory for the Apollo mission. NoSQL databases emerged in the late 2000s as the cost of storage dramatically decreased. Gone were the days of needing to create a complex, difficult-to-manage data model simply for the purposes of reducing data duplication. Developers (rather than storage) were becoming the primary cost of software development, so NoSQL databases optimized for developer productivity. With the rise of Agile development methodology, NoSQL databases were developed with a focus on scaling, fast performance and at the same time allowed for frequent application changes and made programming easier. Types of NoSQL databases: Over time due to the way these NoSQL databases were developed to suit requirements at different companies, we ended up with quite a few types of them. However, they can be broadly classified into 4 types. Some of the databases can overlap between different types. They are Document databases: They store data in documents similar to JSON (JavaScript Object Notation) objects. Each document contains pairs of fields and values. The values can typically be a variety of types including things like strings, numbers, booleans, arrays, or objects, and their structures typically align with objects developers are working with in code. The advantages include intuitive data model & flexible schemas. Because of their variety of field value types and powerful query languages, document databases are great for a wide variety of use cases and can be used as a general purpose database. They can horizontally scale-out to accomodate large data volumes. Ex: MongoDB, Couchbase Key-Value databases: These are a simpler type of databases where each item contains keys and values. A value can typically only be retrieved by referencing its key, so learning how to query for a specific key-value pair is typically simple. Key-value databases are great for use cases where you need to store large amounts of data but you don\u2019t need to perform complex queries to retrieve it. Common use cases include storing user preferences or caching. Ex: Redis , DynamoDB , Voldemort / Venice (Linkedin), Wide-Column stores: They store data in tables, rows, and dynamic columns. Wide-column stores provide a lot of flexibility over relational databases because each row is not required to have the same columns. Many consider wide-column stores to be two-dimensional key-value databases. Wide-column stores are great for when you need to store large amounts of data and you can predict what your query patterns will be. Wide-column stores are commonly used for storing Internet of Things data and user profile data. Cassandra and HBase are two of the most popular wide-column stores. Graph Databases: These databases store data in nodes and edges. Nodes typically store information about people, places, and things while edges store information about the relationships between the nodes. The underlying storage mechanism of graph databases can vary. Some depend on a relational engine and \u201cstore\u201d the graph data in a table (although a table is a logical element, therefore this approach imposes another level of abstraction between the graph database, the graph database management system and the physical devices where the data is actually stored). Others use a key-value store or document-oriented database for storage, making them inherently NoSQL structures. Graph databases excel in use cases where you need to traverse relationships to look for patterns such as social networks, fraud detection, and recommendation engines. Ex: Neo4j Comparison Performance Scalability Flexibility Complexity Functionality Key Value high high high none Variable Document stores high Variable (high) high low Variable (low) Column DB high high moderate low minimal Graph Variable Variable high high Graph theory Differences between SQL and NoSQL The table below summarizes the main differences between SQL and NoSQL databases. SQL Databases NoSQL Databases Data Storage Model Tables with fixed rows and columns Document: JSON documents, Key-value: key-value pairs, Wide-column: tables with rows and dynamic columns, Graph: nodes and edges Primary Purpose General purpose Document: general purpose, Key-value: large amounts of data with simple lookup queries, Wide-column: large amounts of data with predictable query patterns, Graph: analyzing and traversing relationships between connected data Schemas Rigid Flexible Scaling Vertical (scale-up with a larger server) Horizontal (scale-out across commodity servers) Multi-Record ACID Transactions Supported Most do not support multi-record ACID transactions. However, some\u2014like MongoDB\u2014do. Joins Typically required Typically not required Data to Object Mapping Requires ORM (object-relational mapping) Many do not require ORMs. Document DB documents map directly to data structures in most popular programming languages. Advantages Flexible Data Models Most NoSQL systems feature flexible schemas. A flexible schema means you can easily modify your database schema to add or remove fields to support for evolving application requirements. This facilitates with continuous application development of new features without database operation overhead. Horizontal Scaling Most NoSQL systems allow you to scale horizontally, which means you can add in cheaper & commodity hardware, whenever you want to scale a system. On the other hand SQL systems generally scale Vertically (a more powerful server). NoSQL systems can also host huge data sets when compared to traditional SQL systems. Fast Queries NoSQL can generally be a lot faster than traditional SQL systems due to data denormalization and horizontal scaling. Most NoSQL systems also tend to store similar data together facilitating faster query responses. Developer productivity NoSQL systems tend to map data based on the programming data structures. As a result developers need to perform fewer data transformations leading to increased productivity & fewer bugs.","title":"Introduction"},{"location":"level101/databases_nosql/intro/#nosql-concepts","text":"","title":"NoSQL Concepts"},{"location":"level101/databases_nosql/intro/#prerequisites","text":"Relational Databases","title":"Prerequisites"},{"location":"level101/databases_nosql/intro/#what-to-expect-from-this-course","text":"At the end of training, you will have an understanding of what a NoSQL database is, what kind of advantages or disadvantages it has over traditional RDBMS, learn about different types of NoSQL databases and understand some of the underlying concepts & trade offs w.r.t to NoSQL.","title":"What to expect from this course"},{"location":"level101/databases_nosql/intro/#what-is-not-covered-under-this-course","text":"We will not be deep diving into any specific NoSQL Database.","title":"What is not covered under this course"},{"location":"level101/databases_nosql/intro/#course-contents","text":"Introduction to NoSQL CAP Theorem Data versioning Partitioning Hashing Quorum","title":"Course Contents"},{"location":"level101/databases_nosql/intro/#introduction","text":"When people use the term \u201cNoSQL database\u201d, they typically use it to refer to any non-relational database. Some say the term \u201cNoSQL\u201d stands for \u201cnon SQL\u201d while others say it stands for \u201cnot only SQL.\u201d Either way, most agree that NoSQL databases are databases that store data in a format other than relational tables. A common misconception is that NoSQL databases or non-relational databases don\u2019t store relationship data well. NoSQL databases can store relationship data\u2014they just store it differently than relational databases do. In fact, when compared with SQL databases, many find modeling relationship data in NoSQL databases to be easier , because related data doesn\u2019t have to be split between tables. Such databases have existed since the late 1960s, but the name \"NoSQL\" was only coined in the early 21st century. NASA used a NoSQL database to track inventory for the Apollo mission. NoSQL databases emerged in the late 2000s as the cost of storage dramatically decreased. Gone were the days of needing to create a complex, difficult-to-manage data model simply for the purposes of reducing data duplication. Developers (rather than storage) were becoming the primary cost of software development, so NoSQL databases optimized for developer productivity. With the rise of Agile development methodology, NoSQL databases were developed with a focus on scaling, fast performance and at the same time allowed for frequent application changes and made programming easier.","title":"Introduction"},{"location":"level101/databases_nosql/intro/#types-of-nosql-databases","text":"Over time due to the way these NoSQL databases were developed to suit requirements at different companies, we ended up with quite a few types of them. However, they can be broadly classified into 4 types. Some of the databases can overlap between different types. They are Document databases: They store data in documents similar to JSON (JavaScript Object Notation) objects. Each document contains pairs of fields and values. The values can typically be a variety of types including things like strings, numbers, booleans, arrays, or objects, and their structures typically align with objects developers are working with in code. The advantages include intuitive data model & flexible schemas. Because of their variety of field value types and powerful query languages, document databases are great for a wide variety of use cases and can be used as a general purpose database. They can horizontally scale-out to accomodate large data volumes. Ex: MongoDB, Couchbase Key-Value databases: These are a simpler type of databases where each item contains keys and values. A value can typically only be retrieved by referencing its key, so learning how to query for a specific key-value pair is typically simple. Key-value databases are great for use cases where you need to store large amounts of data but you don\u2019t need to perform complex queries to retrieve it. Common use cases include storing user preferences or caching. Ex: Redis , DynamoDB , Voldemort / Venice (Linkedin), Wide-Column stores: They store data in tables, rows, and dynamic columns. Wide-column stores provide a lot of flexibility over relational databases because each row is not required to have the same columns. Many consider wide-column stores to be two-dimensional key-value databases. Wide-column stores are great for when you need to store large amounts of data and you can predict what your query patterns will be. Wide-column stores are commonly used for storing Internet of Things data and user profile data. Cassandra and HBase are two of the most popular wide-column stores. Graph Databases: These databases store data in nodes and edges. Nodes typically store information about people, places, and things while edges store information about the relationships between the nodes. The underlying storage mechanism of graph databases can vary. Some depend on a relational engine and \u201cstore\u201d the graph data in a table (although a table is a logical element, therefore this approach imposes another level of abstraction between the graph database, the graph database management system and the physical devices where the data is actually stored). Others use a key-value store or document-oriented database for storage, making them inherently NoSQL structures. Graph databases excel in use cases where you need to traverse relationships to look for patterns such as social networks, fraud detection, and recommendation engines. Ex: Neo4j","title":"Types of NoSQL databases:"},{"location":"level101/databases_nosql/intro/#comparison","text":"Performance Scalability Flexibility Complexity Functionality Key Value high high high none Variable Document stores high Variable (high) high low Variable (low) Column DB high high moderate low minimal Graph Variable Variable high high Graph theory","title":"Comparison"},{"location":"level101/databases_nosql/intro/#differences-between-sql-and-nosql","text":"The table below summarizes the main differences between SQL and NoSQL databases. SQL Databases NoSQL Databases Data Storage Model Tables with fixed rows and columns Document: JSON documents, Key-value: key-value pairs, Wide-column: tables with rows and dynamic columns, Graph: nodes and edges Primary Purpose General purpose Document: general purpose, Key-value: large amounts of data with simple lookup queries, Wide-column: large amounts of data with predictable query patterns, Graph: analyzing and traversing relationships between connected data Schemas Rigid Flexible Scaling Vertical (scale-up with a larger server) Horizontal (scale-out across commodity servers) Multi-Record ACID Transactions Supported Most do not support multi-record ACID transactions. However, some\u2014like MongoDB\u2014do. Joins Typically required Typically not required Data to Object Mapping Requires ORM (object-relational mapping) Many do not require ORMs. Document DB documents map directly to data structures in most popular programming languages.","title":"Differences between SQL and NoSQL"},{"location":"level101/databases_nosql/intro/#advantages","text":"Flexible Data Models Most NoSQL systems feature flexible schemas. A flexible schema means you can easily modify your database schema to add or remove fields to support for evolving application requirements. This facilitates with continuous application development of new features without database operation overhead. Horizontal Scaling Most NoSQL systems allow you to scale horizontally, which means you can add in cheaper & commodity hardware, whenever you want to scale a system. On the other hand SQL systems generally scale Vertically (a more powerful server). NoSQL systems can also host huge data sets when compared to traditional SQL systems. Fast Queries NoSQL can generally be a lot faster than traditional SQL systems due to data denormalization and horizontal scaling. Most NoSQL systems also tend to store similar data together facilitating faster query responses. Developer productivity NoSQL systems tend to map data based on the programming data structures. As a result developers need to perform fewer data transformations leading to increased productivity & fewer bugs.","title":"Advantages"},{"location":"level101/databases_nosql/key_concepts/","text":"Key Concepts Lets looks at some of the key concepts when we talk about NoSQL or distributed systems CAP Theorem In a keynote titled \u201c Towards Robust Distributed Systems \u201d at ACM\u2019s PODC symposium in 2000 Eric Brewer came up with the so-called CAP-theorem which is widely adopted today by large web companies as well as in the NoSQL community. The CAP acronym stands for C onsistency, A vailability & P artition Tolerance. Consistency It refers to how consistent a system is after an execution. A distributed system is called consistent when a write made by a source is available for all readers of that shared data. Different NoSQL systems support different levels of consistency. Availability It refers to how a system responds to loss of functionality of different systems due to hardware and software failures. A high availability implies that a system is still available to handle operations (reads and writes) when a certain part of the system is down due to a failure or upgrade. Partition Tolerance It is the ability of the system to continue operations in the event of a network partition. A network partition occurs when a failure causes two or more islands of networks where the systems can\u2019t talk to each other across the islands temporarily or permanently. Brewer alleges that one can at most choose two of these three characteristics in a shared-data system. The CAP-theorem states that a choice can only be made for two options out of consistency, availability and partition tolerance. A growing number of use cases in large scale applications tend to value reliability implying that availability & redundancy are more valuable than consistency. As a result these systems struggle to meet ACID properties. They attain this by loosening on the consistency requirement i.e Eventual Consistency. Eventual Consistency means that all readers will see writes, as time goes on: \u201cIn a steady state, the system will eventually return the last written value\u201d. Clients therefore may face an inconsistent state of data as updates are in progress. For instance, in a replicated database updates may go to one node which replicates the latest version to all other nodes that contain a replica of the modified dataset so that the replica nodes eventually will have the latest version. NoSQL systems support different levels of eventual consistency models. For example: Read Your Own Writes Consistency Clients will see their updates immediately after they are written. The reads can hit nodes other than the one where it was written. However they might not see updates by other clients immediately. Session Consistency Clients will see the updates to their data within a session scope. This generally indicates that reads & writes occur on the same server. Other clients using the same nodes will receive the same updates. Casual Consistency A system provides causal consistency if the following condition holds: write operations that are related by potential causality are seen by each process of the system in order. Different processes may observe concurrent writes in different orders Eventual consistency is useful if concurrent updates of the same partitions of data are unlikely and if clients do not immediately depend on reading updates issued by themselves or by other clients. Depending on what consistency model was chosen for the system (or parts of it), determines where the requests are routed, ex: replicas. CAP alternatives illustration Choice Traits Examples Consistency + Availability (Forfeit Partitions) 2-phase commits Cache invalidation protocols Single-site databases Cluster databases LDAP xFS file system Consistency + Partition tolerance (Forfeit Availability) Pessimistic locking Make minority partitions unavailable Distributed databases Distributed locking Majority protocols Availability + Partition tolerance (Forfeit Consistency) expirations/leases conflict resolution optimistic DNS Web caching Versioning of Data in distributed systems When data is distributed across nodes, it can be modified on different nodes at the same time (assuming strict consistency is enforced). Questions arise on conflict resolution for concurrent updates. Some of the popular conflict resolution mechanism are Timestamps This is the most obvious solution. You sort updates based on chronological order and choose the latest update. However this relies on clock synchronization across different parts of the infrastructure. This gets even more complicated when parts of systems are spread across different geographic locations. Optimistic Locking You associate a unique value like a clock or counter with every data update. When a client wants to update data, it has to specify which version of data needs to be updated. This would mean you need to keep track of history of the data versions. Vector Clocks A vector clock is defined as a tuple of clock values from each node. In a distributed environment, each node maintains a tuple of such clock values which represent the state of the nodes itself and its peers/replicas. A clock value may be real timestamps derived from local clock or version no. Vector clocks illustration Vector clocks have the following advantages over other conflict resolution mechanism No dependency on synchronized clocks No total ordering of revision nos required for casual reasoning No need to store and maintain multiple versions of the data on different nodes. Partitioning When the amount of data crosses the capacity of a single node, we need to think of splitting data, creating replicas for load balancing & disaster recovery. Depending on how dynamic the infrastructure is, we have a few approaches that we can take. Memory cached These are partitioned in-memory databases that are primarily used for transient data. These databases are generally used as a front for traditional RDBMS. Most frequently used data is replicated from a rdbms into a memory database to facilitate fast queries and to take the load off from backend DB\u2019s. A very common example is memcached or couchbase. Clustering Traditional cluster mechanisms abstract away the cluster topology from clients. A client need not know where the actual data is residing and which node it is talking to. Clustering is very commonly used in traditional RDBMS where it can help scaling the persistent layer to a certain extent. Separating reads from writes In this method, you will have multiple replicas hosting the same data. The incoming writes are typically sent to a single node (Leader) or multiple nodes (multi-Leader), while the rest of the replicas (Follower) handle reads requests. The leader replicates writes asynchronously to all followers. However the write lag can\u2019t be completely avoided. Sometimes a leader can crash before it replicates all the data to a follower. When this happens, a follower with the most consistent data can be turned into a leader. As you can realize now, it is hard to enforce full consistency in this model. You also need to consider the ratio of read vs write traffic. This model won\u2019t make sense when writes are higher than reads. The replication methods can also vary widely. Some systems do a complete transfer of state periodically, while others use a delta state transfer approach. You could also transfer the state by transferring the operations in order. The followers can then apply the same operations as the leader to catch up. Sharding Sharing refers to dividing data in such a way that data is distributed evenly (both in terms of storage & processing power) across a cluster of nodes. It can also imply data locality, which means similar & related data is stored together to facilitate faster access. A shard in turn can be further replicated to meet load balancing or disaster recovery requirements. A single shard replica might take in all writes (single leader) or multiple replicas can take writes (multi-leader). Reads can be distributed across multiple replicas. Since data is now distributed across multiple nodes, clients should be able to consistently figure out where data is hosted. We will look at some of the common techniques below. The downside of sharding is that joins between shards is not possible. So an upstream/downstream application has to aggregate the results from multiple shards. Sharding example Hashing A hash function is a function that maps one piece of data\u2014typically describing some kind of object, often of arbitrary size\u2014to another piece of data, typically an integer, known as hash code , or simply hash . In a partitioned database, it is important to consistently map a key to a server/replica. For ex: you can use a very simple hash as a modulo function. _p = k mod n_ Where p -> partition, k -> primary key n -> no of nodes The downside of this simple hash is that, whenever the cluster topology changes, the data distribution also changes. When you are dealing with memory caches, it will be easy to distribute partitions around. Whenever a node joins/leaves a topology, partitions can reorder themselves, a cache miss can be re-populated from backend DB. However when you look at persistent data, it is not possible as the new node doesn\u2019t have the data needed to serve it. This brings us to consistent hashing. Consistent Hashing Consistent hashing is a distributed hashing scheme that operates independently of the number of servers or objects in a distributed hash table by assigning them a position on an abstract circle, or hash ring . This allows servers and objects to scale without affecting the overall system. Say that our hash function h() generates a 32-bit integer. Then, to determine to which server we will send a key k, we find the server s whose hash h(s) is the smallest integer that is larger than h(k). To make the process simpler, we assume the table is circular, which means that if we cannot find a server with a hash larger than h(k), we wrap around and start looking from the beginning of the array. Consistent hashing illustration In consistent hashing when a server is removed or added then only the keys from that server are relocated. For example, if server S3 is removed then, all keys from server S3 will be moved to server S4 but keys stored on server S4 and S2 are not relocated. But there is one problem, when server S3 is removed then keys from S3 are not equally distributed among remaining servers S4 and S2. They are only assigned to server S4 which increases the load on server S4. To evenly distribute the load among servers when a server is added or removed, it creates a fixed number of replicas ( known as virtual nodes) of each server and distributes it along the circle. So instead of server labels S1, S2 and S3, we will have S10 S11\u2026S19, S20 S21\u2026S29 and S30 S31\u2026S39. The factor for a number of replicas is also known as weight , depending on the situation. All keys which are mapped to replicas Sij are stored on server Si. To find a key we do the same thing, find the position of the key on the circle and then move forward until you find a server replica. If the server replica is Sij then the key is stored in server Si. Suppose server S3 is removed, then all S3 replicas with labels S30 S31 \u2026 S39 must be removed. Now the objects keys adjacent to S3X labels will be automatically re-assigned to S1X, S2X and S4X. All keys originally assigned to S1, S2 & S4 will not be moved. Similar things happen if we add a server. Suppose we want to add a server S5 as a replacement of S3 then we need to add labels S50 S51 \u2026 S59. In the ideal case, one-fourth of keys from S1, S2 and S4 will be reassigned to S5. When applied to persistent storages, further issues arise: if a node has left the scene, data stored on this node becomes unavailable, unless it has been replicated to other nodes before; in the opposite case of a new node joining the others, adjacent nodes are no longer responsible for some pieces of data which they still store but not get asked for anymore as the corresponding objects are no longer hashed to them by requesting clients. In order to address this issue, a replication factor (r) can be introduced. Introducing replicas in a partitioning scheme\u2014besides reliability benefits\u2014also makes it possible to spread workload for read requests that can go to any physical node responsible for a requested piece of data. Scalability doesn\u2019t work if the clients have to decide between multiple versions of the dataset, because they need to read from a quorum of servers which in turn reduces the efficiency of load balancing. Quorum Quorum is the minimum number of nodes in a cluster that must be online and be able to communicate with each other. If any additional node failure occurs beyond this threshold, the cluster will stop running. To attain a quorum, you need a majority of the nodes. Commonly it is (N/2 + 1), where N is the total no of nodes in the system. For ex, In a 3 node cluster, you need 2 nodes for a majority, In a 5 node cluster, you need 3 nodes for a majority, In a 6 node cluster, you need 4 nodes for a majority. Quorum example Network problems can cause communication failures among cluster nodes. One set of nodes might be able to communicate together across a functioning part of a network but not be able to communicate with a different set of nodes in another part of the network. This is known as split brain in cluster or cluster partitioning. Now the partition which has quorum is allowed to continue running the application. The other partitions are removed from the cluster. Eg: In a 5 node cluster, consider what happens if nodes 1, 2, and 3 can communicate with each other but not with nodes 4 and 5. Nodes 1, 2, and 3 constitute a majority, and they continue running as a cluster. Nodes 4 and 5, being a minority, stop running as a cluster. If node 3 loses communication with other nodes, all nodes stop running as a cluster. However, all functioning nodes will continue to listen for communication, so that when the network begins working again, the cluster can form and begin to run. Below diagram demonstrates Quorum selection on a cluster partitioned into two sets. Cluster Quorum example","title":"Key Concepts"},{"location":"level101/databases_nosql/key_concepts/#key-concepts","text":"Lets looks at some of the key concepts when we talk about NoSQL or distributed systems","title":"Key Concepts"},{"location":"level101/databases_nosql/key_concepts/#cap-theorem","text":"In a keynote titled \u201c Towards Robust Distributed Systems \u201d at ACM\u2019s PODC symposium in 2000 Eric Brewer came up with the so-called CAP-theorem which is widely adopted today by large web companies as well as in the NoSQL community. The CAP acronym stands for C onsistency, A vailability & P artition Tolerance. Consistency It refers to how consistent a system is after an execution. A distributed system is called consistent when a write made by a source is available for all readers of that shared data. Different NoSQL systems support different levels of consistency. Availability It refers to how a system responds to loss of functionality of different systems due to hardware and software failures. A high availability implies that a system is still available to handle operations (reads and writes) when a certain part of the system is down due to a failure or upgrade. Partition Tolerance It is the ability of the system to continue operations in the event of a network partition. A network partition occurs when a failure causes two or more islands of networks where the systems can\u2019t talk to each other across the islands temporarily or permanently. Brewer alleges that one can at most choose two of these three characteristics in a shared-data system. The CAP-theorem states that a choice can only be made for two options out of consistency, availability and partition tolerance. A growing number of use cases in large scale applications tend to value reliability implying that availability & redundancy are more valuable than consistency. As a result these systems struggle to meet ACID properties. They attain this by loosening on the consistency requirement i.e Eventual Consistency. Eventual Consistency means that all readers will see writes, as time goes on: \u201cIn a steady state, the system will eventually return the last written value\u201d. Clients therefore may face an inconsistent state of data as updates are in progress. For instance, in a replicated database updates may go to one node which replicates the latest version to all other nodes that contain a replica of the modified dataset so that the replica nodes eventually will have the latest version. NoSQL systems support different levels of eventual consistency models. For example: Read Your Own Writes Consistency Clients will see their updates immediately after they are written. The reads can hit nodes other than the one where it was written. However they might not see updates by other clients immediately. Session Consistency Clients will see the updates to their data within a session scope. This generally indicates that reads & writes occur on the same server. Other clients using the same nodes will receive the same updates. Casual Consistency A system provides causal consistency if the following condition holds: write operations that are related by potential causality are seen by each process of the system in order. Different processes may observe concurrent writes in different orders Eventual consistency is useful if concurrent updates of the same partitions of data are unlikely and if clients do not immediately depend on reading updates issued by themselves or by other clients. Depending on what consistency model was chosen for the system (or parts of it), determines where the requests are routed, ex: replicas. CAP alternatives illustration Choice Traits Examples Consistency + Availability (Forfeit Partitions) 2-phase commits Cache invalidation protocols Single-site databases Cluster databases LDAP xFS file system Consistency + Partition tolerance (Forfeit Availability) Pessimistic locking Make minority partitions unavailable Distributed databases Distributed locking Majority protocols Availability + Partition tolerance (Forfeit Consistency) expirations/leases conflict resolution optimistic DNS Web caching","title":"CAP Theorem"},{"location":"level101/databases_nosql/key_concepts/#versioning-of-data-in-distributed-systems","text":"When data is distributed across nodes, it can be modified on different nodes at the same time (assuming strict consistency is enforced). Questions arise on conflict resolution for concurrent updates. Some of the popular conflict resolution mechanism are Timestamps This is the most obvious solution. You sort updates based on chronological order and choose the latest update. However this relies on clock synchronization across different parts of the infrastructure. This gets even more complicated when parts of systems are spread across different geographic locations. Optimistic Locking You associate a unique value like a clock or counter with every data update. When a client wants to update data, it has to specify which version of data needs to be updated. This would mean you need to keep track of history of the data versions. Vector Clocks A vector clock is defined as a tuple of clock values from each node. In a distributed environment, each node maintains a tuple of such clock values which represent the state of the nodes itself and its peers/replicas. A clock value may be real timestamps derived from local clock or version no. Vector clocks illustration Vector clocks have the following advantages over other conflict resolution mechanism No dependency on synchronized clocks No total ordering of revision nos required for casual reasoning No need to store and maintain multiple versions of the data on different nodes.","title":"Versioning of Data in distributed systems"},{"location":"level101/databases_nosql/key_concepts/#partitioning","text":"When the amount of data crosses the capacity of a single node, we need to think of splitting data, creating replicas for load balancing & disaster recovery. Depending on how dynamic the infrastructure is, we have a few approaches that we can take. Memory cached These are partitioned in-memory databases that are primarily used for transient data. These databases are generally used as a front for traditional RDBMS. Most frequently used data is replicated from a rdbms into a memory database to facilitate fast queries and to take the load off from backend DB\u2019s. A very common example is memcached or couchbase. Clustering Traditional cluster mechanisms abstract away the cluster topology from clients. A client need not know where the actual data is residing and which node it is talking to. Clustering is very commonly used in traditional RDBMS where it can help scaling the persistent layer to a certain extent. Separating reads from writes In this method, you will have multiple replicas hosting the same data. The incoming writes are typically sent to a single node (Leader) or multiple nodes (multi-Leader), while the rest of the replicas (Follower) handle reads requests. The leader replicates writes asynchronously to all followers. However the write lag can\u2019t be completely avoided. Sometimes a leader can crash before it replicates all the data to a follower. When this happens, a follower with the most consistent data can be turned into a leader. As you can realize now, it is hard to enforce full consistency in this model. You also need to consider the ratio of read vs write traffic. This model won\u2019t make sense when writes are higher than reads. The replication methods can also vary widely. Some systems do a complete transfer of state periodically, while others use a delta state transfer approach. You could also transfer the state by transferring the operations in order. The followers can then apply the same operations as the leader to catch up. Sharding Sharing refers to dividing data in such a way that data is distributed evenly (both in terms of storage & processing power) across a cluster of nodes. It can also imply data locality, which means similar & related data is stored together to facilitate faster access. A shard in turn can be further replicated to meet load balancing or disaster recovery requirements. A single shard replica might take in all writes (single leader) or multiple replicas can take writes (multi-leader). Reads can be distributed across multiple replicas. Since data is now distributed across multiple nodes, clients should be able to consistently figure out where data is hosted. We will look at some of the common techniques below. The downside of sharding is that joins between shards is not possible. So an upstream/downstream application has to aggregate the results from multiple shards. Sharding example","title":"Partitioning"},{"location":"level101/databases_nosql/key_concepts/#hashing","text":"A hash function is a function that maps one piece of data\u2014typically describing some kind of object, often of arbitrary size\u2014to another piece of data, typically an integer, known as hash code , or simply hash . In a partitioned database, it is important to consistently map a key to a server/replica. For ex: you can use a very simple hash as a modulo function. _p = k mod n_ Where p -> partition, k -> primary key n -> no of nodes The downside of this simple hash is that, whenever the cluster topology changes, the data distribution also changes. When you are dealing with memory caches, it will be easy to distribute partitions around. Whenever a node joins/leaves a topology, partitions can reorder themselves, a cache miss can be re-populated from backend DB. However when you look at persistent data, it is not possible as the new node doesn\u2019t have the data needed to serve it. This brings us to consistent hashing.","title":"Hashing"},{"location":"level101/databases_nosql/key_concepts/#consistent-hashing","text":"Consistent hashing is a distributed hashing scheme that operates independently of the number of servers or objects in a distributed hash table by assigning them a position on an abstract circle, or hash ring . This allows servers and objects to scale without affecting the overall system. Say that our hash function h() generates a 32-bit integer. Then, to determine to which server we will send a key k, we find the server s whose hash h(s) is the smallest integer that is larger than h(k). To make the process simpler, we assume the table is circular, which means that if we cannot find a server with a hash larger than h(k), we wrap around and start looking from the beginning of the array. Consistent hashing illustration In consistent hashing when a server is removed or added then only the keys from that server are relocated. For example, if server S3 is removed then, all keys from server S3 will be moved to server S4 but keys stored on server S4 and S2 are not relocated. But there is one problem, when server S3 is removed then keys from S3 are not equally distributed among remaining servers S4 and S2. They are only assigned to server S4 which increases the load on server S4. To evenly distribute the load among servers when a server is added or removed, it creates a fixed number of replicas ( known as virtual nodes) of each server and distributes it along the circle. So instead of server labels S1, S2 and S3, we will have S10 S11\u2026S19, S20 S21\u2026S29 and S30 S31\u2026S39. The factor for a number of replicas is also known as weight , depending on the situation. All keys which are mapped to replicas Sij are stored on server Si. To find a key we do the same thing, find the position of the key on the circle and then move forward until you find a server replica. If the server replica is Sij then the key is stored in server Si. Suppose server S3 is removed, then all S3 replicas with labels S30 S31 \u2026 S39 must be removed. Now the objects keys adjacent to S3X labels will be automatically re-assigned to S1X, S2X and S4X. All keys originally assigned to S1, S2 & S4 will not be moved. Similar things happen if we add a server. Suppose we want to add a server S5 as a replacement of S3 then we need to add labels S50 S51 \u2026 S59. In the ideal case, one-fourth of keys from S1, S2 and S4 will be reassigned to S5. When applied to persistent storages, further issues arise: if a node has left the scene, data stored on this node becomes unavailable, unless it has been replicated to other nodes before; in the opposite case of a new node joining the others, adjacent nodes are no longer responsible for some pieces of data which they still store but not get asked for anymore as the corresponding objects are no longer hashed to them by requesting clients. In order to address this issue, a replication factor (r) can be introduced. Introducing replicas in a partitioning scheme\u2014besides reliability benefits\u2014also makes it possible to spread workload for read requests that can go to any physical node responsible for a requested piece of data. Scalability doesn\u2019t work if the clients have to decide between multiple versions of the dataset, because they need to read from a quorum of servers which in turn reduces the efficiency of load balancing.","title":"Consistent Hashing"},{"location":"level101/databases_nosql/key_concepts/#quorum","text":"Quorum is the minimum number of nodes in a cluster that must be online and be able to communicate with each other. If any additional node failure occurs beyond this threshold, the cluster will stop running. To attain a quorum, you need a majority of the nodes. Commonly it is (N/2 + 1), where N is the total no of nodes in the system. For ex, In a 3 node cluster, you need 2 nodes for a majority, In a 5 node cluster, you need 3 nodes for a majority, In a 6 node cluster, you need 4 nodes for a majority. Quorum example Network problems can cause communication failures among cluster nodes. One set of nodes might be able to communicate together across a functioning part of a network but not be able to communicate with a different set of nodes in another part of the network. This is known as split brain in cluster or cluster partitioning. Now the partition which has quorum is allowed to continue running the application. The other partitions are removed from the cluster. Eg: In a 5 node cluster, consider what happens if nodes 1, 2, and 3 can communicate with each other but not with nodes 4 and 5. Nodes 1, 2, and 3 constitute a majority, and they continue running as a cluster. Nodes 4 and 5, being a minority, stop running as a cluster. If node 3 loses communication with other nodes, all nodes stop running as a cluster. However, all functioning nodes will continue to listen for communication, so that when the network begins working again, the cluster can form and begin to run. Below diagram demonstrates Quorum selection on a cluster partitioned into two sets. Cluster Quorum example","title":"Quorum"},{"location":"level101/databases_sql/backup_recovery/","text":"Backup and Recovery Backups are a very crucial part of any database setup. They are generally a copy of the data that can be used to reconstruct the data in case of any major or minor crisis with the database. In general terms backups can be of two types:- Physical Backup - the data directory as it is on the disk Logical Backup - the table structure and records in it Both the above kinds of backups are supported by MySQL with different tools. It is the job of the SRE to identify which should be used when. Mysqldump This utility is available with MySQL installation. It helps in getting the logical backup of the database. It outputs a set of SQL statements to reconstruct the data. It is not recommended to use mysqldump for large tables as it might take a lot of time and the file size will be huge. However, for small tables it is the best and the quickest option. mysqldump [options] > dump_output.sql There are certain options that can be used with mysqldump to get an appropriate dump of the database. To dump all the databases mysqldump -u -p --all-databases > all_dbs.sql To dump specific databases mysqldump -u -p --databases db1 db2 db3 > dbs.sql To dump a single database mysqldump -u -p --databases db1 > db1.sql OR mysqldump -u -p db1 > db1.sql The difference between the above two commands is that the latter one does not contain the CREATE DATABASE command in the backup output. To dump specific tables in a database mysqldump -u -p db1 table1 table2 > db1_tables.sql To dump only table structures and no data mysqldump -u -p --no-data db1 > db1_structure.sql To dump only table data and no CREATE statements mysqldump -u -p --no-create-info db1 > db1_data.sql To dump only specific records from a table mysqldump -u -p --no-create-info db1 table1 --where=\u201dsalary>80000\u201d > db1_table1_80000.sql Mysqldump can also provide output in CSV, other delimited text or XML format to support use-cases if any. The backup from mysqldump utility is offline i.e. when the backup finishes it will not have the changes to the database which were made when the backup was going on. For example, if the backup started at 3 PM and finished at 4 PM, it will not have the changes made to the database between 3 and 4 PM. Restoring from mysqldump can be done in the following two ways:- From shell mysql -u -p < all_dbs.sql OR From shell if the database is already created mysql -u -p db1 < db1.sql From within MySQL shell mysql> source all_dbs.sql Percona Xtrabackup This utility is installed separately from the MySQL server and is open source, provided by Percona. It helps in getting the full or partial physical backup of the database. It provides online backup of the database i.e. it will have the changes made to the database when the backup was going on as explained at the end of the previous section. Full Backup - the complete backup of the database. Partial Backup - Incremental Cumulative - After one full backup, the next backups will have changes post the full backup. For example, we took a full backup on Sunday, from Monday onwards every backup will have changes after Sunday; so, Tuesday\u2019s backup will have Monday\u2019s changes as well, Wednesday\u2019s backup will have changes of Monday and Tuesday as well and so on. Differential - After one full backup, the next backups will have changes post the previous incremental backup. For example, we took a full backup on Sunday, Monday will have changes done after Sunday, Tuesday will have changes done after Monday, and so on. Percona xtrabackup allows us to get both full and incremental backups as we desire. However, incremental backups take less space than a full backup (if taken per day) but the restore time of incremental backups is more than that of full backups. Creating a full backup xtrabackup --defaults-file= --user= --password= --backup --target-dir= Example xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/ Some other options --stream - can be used to stream the backup files to standard output in a specified format. xbstream is the only option for now. --tmp-dir - set this to a tmp directory to be used for temporary files while taking backups. --parallel - set this to the number of threads that can be used to parallely copy data files to target directory. --compress - by default - quicklz is used. Set this to have the backup in compressed format. Each file is a .qp compressed file and can be extracted by qpress file archiver. --decompress - decompresses all the files which were compressed with the .qp extension. It will not delete the .qp files after decompression. To do that, use --remove-original along with this. Please note that the decompress option should be run separately from the xtrabackup command that used the compress option. Preparing a backup Once the backup is done with the --backup option, we need to prepare it in order to restore it. This is done to make the datafiles consistent with point-in-time. There might have been some transactions going on while the backup was being executed and those have changed the data files. When we prepare a backup, all those transactions are applied to the data files. xtrabackup --prepare --target-dir= Example xtrabackup --prepare --target-dir=/mnt/data/backup/ It is not recommended to halt a process which is preparing the backup as that might cause data file corruption and backup cannot be used further. The backup will have to be taken again. Restoring a Full Backup To restore the backup which is created and prepared from above commands, just copy everything from the backup target-dir to the data-dir of MySQL server, change the ownership of all files to mysql user (the linux user used by MySQL server) and start mysql. Or the below command can be used as well, xtrabackup --defaults-file=/etc/my.cnf --copy-back --target-dir=/mnt/data/backups/ Note - the backup has to be prepared in order to restore it. Creating Incremental backups Percona Xtrabackup helps create incremental backups, i.e only the changes can be backed up since the last backup. Every InnoDB page contains a log sequence number or LSN that is also mentioned as one of the last lines of backup and prepare commands. xtrabackup: Transaction log of lsn to was copied. OR InnoDB: Shutdown completed; log sequence number completed OK! This indicates that the backup has been taken till the log sequence number mentioned. This is a key information in understanding incremental backups and working towards automating one. Incremental backups do not compare data files for changes, instead, they go through the InnoDB pages and compare their LSN to the last backup\u2019s LSN. So, without one full backup, the incremental backups are useless. The xtrabackup command creates a xtrabackup_checkpoint file which has the information about the LSN of the backup. Below are the key contents of the file:- backup_type = full-backuped | incremental from_lsn = 0 (full backup) | to_lsn of last backup to_lsn = last_lsn = There is a difference between to_lsn and last_lsn . When the last_lsn is more than to_lsn that means there are transactions that ran while we took the backup and are yet to be applied. That is what --prepare is used for. To take incremental backups, first, we require one full backup. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/full/ Let\u2019s assume the contents of the xtrabackup_checkpoint file to be as follows. backup_type = full-backuped from_lsn = 0 to_lsn = 1000 last_lsn = 1000 Now that we have one full backup, we can have an incremental backup that takes the changes. We will go with differential incremental backups. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/incr1/ --incremental-basedir=/mnt/data/backup/full/ There are delta files created in the incr1 directory like, ibdata1.delta , db1/tbl1.ibd.delta with the changes from the full directory. The xtrabackup_checkpoint file will thus have the following contents. backup_type = incremental from_lsn = 1000 to_lsn = 1500 last_lsn = 1500 Hence, the from_lsn here is equal to the to_lsn of the last backup or the basedir provided for the incremental backups. For the next incremental backup we can use this incremental backup as the basedir. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/incr2/ --incremental-basedir=/mnt/data/backup/incr1/ The xtrabackup_checkpoint file will thus have the following contents. backup_type = incremental from_lsn = 1500 to_lsn = 2000 last_lsn = 2200 Preparing Incremental backups Preparing incremental backups is not the same as preparing a full backup. When prepare runs, two operations are performed - committed transactions are applied on the data files and uncommitted transactions are rolled back . While preparing incremental backups, we have to skip rollback of uncommitted transactions as it is likely that they might get committed in the next incremental backup. If we rollback uncommitted transactions the further incremental backups cannot be applied. We use --apply-log-only option along with --prepare to avoid the rollback phase. From the last section, we had the following directories with complete backup /mnt/data/backup/full /mnt/data/backup/incr1 /mnt/data/backup/incr2 First, we prepare the full backup, but only with the --apply-log-only option. xtrabackup --prepare --apply-log-only --target-dir=/mnt/data/backup/full The output of the command will contain the following at the end. InnoDB: Shutdown complete; log sequence number 1000 Completed OK! Note the LSN mentioned at the end is the same as the to_lsn from the xtrabackup_checkpoint created for full backup. Next, we apply the changes from the first incremental backup to the full backup. xtrabackup --prepare --apply-log-only --target-dir=/mnt/data/backup/full --incremental-dir=/mnt/data/backup/incr1 This applies the delta files in the incremental directory to the full backup directory. It rolls the data files in the full backup directory forward to the time of incremental backup and applies the redo logs as usual. Lastly, we apply the last incremental backup same as the previous one with just a small change. xtrabackup --prepare --target-dir=/mnt/data/backup/full --incremental-dir=/mnt/data/backup/incr1 We do not have to use the --apply-log-only option with it. It applies the incr2 delta files to the full backup data files taking them forward, applies redo logs on them and finally rollbacks the uncommitted transactions to produce the final result. The data now present in the full backup directory can now be used to restore. Note - To create cumulative incremental backups, the incremental-basedir should always be the full backup directory for every incremental backup. While preparing, we can start with the full backup with the --apply-log-only option and use just the last incremental backup for the final --prepare as that has all the changes since the full backup. Restoring Incremental backups Once all the above steps are completed, restoring is the same as done for a full backup. Further Reading MySQL Point-In-Time-Recovery Another MySQL backup tool - mysqlpump Another MySQL backup tool - mydumper A comparison between mysqldump, mysqlpump and mydumper Backup Best Practices","title":"Backup and Recovery"},{"location":"level101/databases_sql/backup_recovery/#backup-and-recovery","text":"Backups are a very crucial part of any database setup. They are generally a copy of the data that can be used to reconstruct the data in case of any major or minor crisis with the database. In general terms backups can be of two types:- Physical Backup - the data directory as it is on the disk Logical Backup - the table structure and records in it Both the above kinds of backups are supported by MySQL with different tools. It is the job of the SRE to identify which should be used when.","title":"Backup and Recovery"},{"location":"level101/databases_sql/backup_recovery/#mysqldump","text":"This utility is available with MySQL installation. It helps in getting the logical backup of the database. It outputs a set of SQL statements to reconstruct the data. It is not recommended to use mysqldump for large tables as it might take a lot of time and the file size will be huge. However, for small tables it is the best and the quickest option. mysqldump [options] > dump_output.sql There are certain options that can be used with mysqldump to get an appropriate dump of the database. To dump all the databases mysqldump -u -p --all-databases > all_dbs.sql To dump specific databases mysqldump -u -p --databases db1 db2 db3 > dbs.sql To dump a single database mysqldump -u -p --databases db1 > db1.sql OR mysqldump -u -p db1 > db1.sql The difference between the above two commands is that the latter one does not contain the CREATE DATABASE command in the backup output. To dump specific tables in a database mysqldump -u -p db1 table1 table2 > db1_tables.sql To dump only table structures and no data mysqldump -u -p --no-data db1 > db1_structure.sql To dump only table data and no CREATE statements mysqldump -u -p --no-create-info db1 > db1_data.sql To dump only specific records from a table mysqldump -u -p --no-create-info db1 table1 --where=\u201dsalary>80000\u201d > db1_table1_80000.sql Mysqldump can also provide output in CSV, other delimited text or XML format to support use-cases if any. The backup from mysqldump utility is offline i.e. when the backup finishes it will not have the changes to the database which were made when the backup was going on. For example, if the backup started at 3 PM and finished at 4 PM, it will not have the changes made to the database between 3 and 4 PM. Restoring from mysqldump can be done in the following two ways:- From shell mysql -u -p < all_dbs.sql OR From shell if the database is already created mysql -u -p db1 < db1.sql From within MySQL shell mysql> source all_dbs.sql","title":"Mysqldump"},{"location":"level101/databases_sql/backup_recovery/#percona-xtrabackup","text":"This utility is installed separately from the MySQL server and is open source, provided by Percona. It helps in getting the full or partial physical backup of the database. It provides online backup of the database i.e. it will have the changes made to the database when the backup was going on as explained at the end of the previous section. Full Backup - the complete backup of the database. Partial Backup - Incremental Cumulative - After one full backup, the next backups will have changes post the full backup. For example, we took a full backup on Sunday, from Monday onwards every backup will have changes after Sunday; so, Tuesday\u2019s backup will have Monday\u2019s changes as well, Wednesday\u2019s backup will have changes of Monday and Tuesday as well and so on. Differential - After one full backup, the next backups will have changes post the previous incremental backup. For example, we took a full backup on Sunday, Monday will have changes done after Sunday, Tuesday will have changes done after Monday, and so on. Percona xtrabackup allows us to get both full and incremental backups as we desire. However, incremental backups take less space than a full backup (if taken per day) but the restore time of incremental backups is more than that of full backups. Creating a full backup xtrabackup --defaults-file= --user= --password= --backup --target-dir= Example xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/ Some other options --stream - can be used to stream the backup files to standard output in a specified format. xbstream is the only option for now. --tmp-dir - set this to a tmp directory to be used for temporary files while taking backups. --parallel - set this to the number of threads that can be used to parallely copy data files to target directory. --compress - by default - quicklz is used. Set this to have the backup in compressed format. Each file is a .qp compressed file and can be extracted by qpress file archiver. --decompress - decompresses all the files which were compressed with the .qp extension. It will not delete the .qp files after decompression. To do that, use --remove-original along with this. Please note that the decompress option should be run separately from the xtrabackup command that used the compress option. Preparing a backup Once the backup is done with the --backup option, we need to prepare it in order to restore it. This is done to make the datafiles consistent with point-in-time. There might have been some transactions going on while the backup was being executed and those have changed the data files. When we prepare a backup, all those transactions are applied to the data files. xtrabackup --prepare --target-dir= Example xtrabackup --prepare --target-dir=/mnt/data/backup/ It is not recommended to halt a process which is preparing the backup as that might cause data file corruption and backup cannot be used further. The backup will have to be taken again. Restoring a Full Backup To restore the backup which is created and prepared from above commands, just copy everything from the backup target-dir to the data-dir of MySQL server, change the ownership of all files to mysql user (the linux user used by MySQL server) and start mysql. Or the below command can be used as well, xtrabackup --defaults-file=/etc/my.cnf --copy-back --target-dir=/mnt/data/backups/ Note - the backup has to be prepared in order to restore it. Creating Incremental backups Percona Xtrabackup helps create incremental backups, i.e only the changes can be backed up since the last backup. Every InnoDB page contains a log sequence number or LSN that is also mentioned as one of the last lines of backup and prepare commands. xtrabackup: Transaction log of lsn to was copied. OR InnoDB: Shutdown completed; log sequence number completed OK! This indicates that the backup has been taken till the log sequence number mentioned. This is a key information in understanding incremental backups and working towards automating one. Incremental backups do not compare data files for changes, instead, they go through the InnoDB pages and compare their LSN to the last backup\u2019s LSN. So, without one full backup, the incremental backups are useless. The xtrabackup command creates a xtrabackup_checkpoint file which has the information about the LSN of the backup. Below are the key contents of the file:- backup_type = full-backuped | incremental from_lsn = 0 (full backup) | to_lsn of last backup to_lsn = last_lsn = There is a difference between to_lsn and last_lsn . When the last_lsn is more than to_lsn that means there are transactions that ran while we took the backup and are yet to be applied. That is what --prepare is used for. To take incremental backups, first, we require one full backup. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/full/ Let\u2019s assume the contents of the xtrabackup_checkpoint file to be as follows. backup_type = full-backuped from_lsn = 0 to_lsn = 1000 last_lsn = 1000 Now that we have one full backup, we can have an incremental backup that takes the changes. We will go with differential incremental backups. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/incr1/ --incremental-basedir=/mnt/data/backup/full/ There are delta files created in the incr1 directory like, ibdata1.delta , db1/tbl1.ibd.delta with the changes from the full directory. The xtrabackup_checkpoint file will thus have the following contents. backup_type = incremental from_lsn = 1000 to_lsn = 1500 last_lsn = 1500 Hence, the from_lsn here is equal to the to_lsn of the last backup or the basedir provided for the incremental backups. For the next incremental backup we can use this incremental backup as the basedir. xtrabackup --defaults-file=/etc/my.cnf --user=some_user --password=XXXX --backup --target-dir=/mnt/data/backup/incr2/ --incremental-basedir=/mnt/data/backup/incr1/ The xtrabackup_checkpoint file will thus have the following contents. backup_type = incremental from_lsn = 1500 to_lsn = 2000 last_lsn = 2200 Preparing Incremental backups Preparing incremental backups is not the same as preparing a full backup. When prepare runs, two operations are performed - committed transactions are applied on the data files and uncommitted transactions are rolled back . While preparing incremental backups, we have to skip rollback of uncommitted transactions as it is likely that they might get committed in the next incremental backup. If we rollback uncommitted transactions the further incremental backups cannot be applied. We use --apply-log-only option along with --prepare to avoid the rollback phase. From the last section, we had the following directories with complete backup /mnt/data/backup/full /mnt/data/backup/incr1 /mnt/data/backup/incr2 First, we prepare the full backup, but only with the --apply-log-only option. xtrabackup --prepare --apply-log-only --target-dir=/mnt/data/backup/full The output of the command will contain the following at the end. InnoDB: Shutdown complete; log sequence number 1000 Completed OK! Note the LSN mentioned at the end is the same as the to_lsn from the xtrabackup_checkpoint created for full backup. Next, we apply the changes from the first incremental backup to the full backup. xtrabackup --prepare --apply-log-only --target-dir=/mnt/data/backup/full --incremental-dir=/mnt/data/backup/incr1 This applies the delta files in the incremental directory to the full backup directory. It rolls the data files in the full backup directory forward to the time of incremental backup and applies the redo logs as usual. Lastly, we apply the last incremental backup same as the previous one with just a small change. xtrabackup --prepare --target-dir=/mnt/data/backup/full --incremental-dir=/mnt/data/backup/incr1 We do not have to use the --apply-log-only option with it. It applies the incr2 delta files to the full backup data files taking them forward, applies redo logs on them and finally rollbacks the uncommitted transactions to produce the final result. The data now present in the full backup directory can now be used to restore. Note - To create cumulative incremental backups, the incremental-basedir should always be the full backup directory for every incremental backup. While preparing, we can start with the full backup with the --apply-log-only option and use just the last incremental backup for the final --prepare as that has all the changes since the full backup. Restoring Incremental backups Once all the above steps are completed, restoring is the same as done for a full backup.","title":"Percona Xtrabackup"},{"location":"level101/databases_sql/backup_recovery/#further-reading","text":"MySQL Point-In-Time-Recovery Another MySQL backup tool - mysqlpump Another MySQL backup tool - mydumper A comparison between mysqldump, mysqlpump and mydumper Backup Best Practices","title":"Further Reading"},{"location":"level101/databases_sql/concepts/","text":"Relational DBs are used for data storage. Even a file can be used to store data, but relational DBs are designed with specific goals: Efficiency Ease of access and management Organized Handle relations between data (represented as tables) Transaction: a unit of work that can comprise multiple statements, executed together ACID properties Set of properties that guarantee data integrity of DB transactions Atomicity: Each transaction is atomic (succeeds or fails completely) Consistency: Transactions only result in valid state (which includes rules, constraints, triggers etc.) Isolation: Each transaction is executed independently of others safely within a concurrent system Durability: Completed transactions will not be lost due to any later failures Let\u2019s take some examples to illustrate the above properties. Account A has a balance of \u20b9200 & B has \u20b9400. Account A is transferring \u20b9100 to Account B. This transaction has a deduction from sender and an addition into the recipient\u2019s balance. If the first operation passes successfully while the second fails, A\u2019s balance would be \u20b9100 while B would be having \u20b9400 instead of \u20b9500. Atomicity in a DB ensures this partially failed transaction is rolled back. If the second operation above fails, it leaves the DB inconsistent (sum of balance of accounts before and after the operation is not the same). Consistency ensures that this does not happen. There are three operations, one to calculate interest for A\u2019s account, another to add that to A\u2019s account, then transfer \u20b9100 from B to A. Without isolation guarantees, concurrent execution of these 3 operations may lead to a different outcome every time. What happens if the system crashes before the transactions are written to disk? Durability ensures that the changes are applied correctly during recovery. Relational data Tables represent relations Columns (fields) represent attributes Rows are individual records Schema describes the structure of DB SQL A query language to interact with and manage data. CRUD operations - create, read, update, delete queries Management operations - create DBs/tables/indexes etc, backup, import/export, users, access controls Exercise: Classify the below queries into the four types - DDL (definition), DML(manipulation), DCL(control) and TCL(transactions) and explain in detail. insert, create, drop, delete, update, commit, rollback, truncate, alter, grant, revoke You can practise these in the lab section . Constraints Rules for data that can be stored. Query fails if you violate any of these defined on a table. Primary key: one or more columns that contain UNIQUE values, and cannot contain NULL values. A table can have only ONE primary key. An index on it is created by default. Foreign key: links two tables together. Its value(s) match a primary key in a different table \\ Not null: Does not allow null values \\ Unique: Value of column must be unique across all rows \\ Default: Provides a default value for a column if none is specified during insert Check: Allows only particular values (like Balance >= 0) Indexes Most indexes use B+ tree structure. Why use them: Speeds up queries (in large tables that fetch only a few rows, min/max queries, by eliminating rows from consideration etc) Types of indexes: unique, primary key, fulltext, secondary Write-heavy loads, mostly full table scans or accessing large number of rows etc. do not benefit from indexes Joins Allows you to fetch related data from multiple tables, linking them together with some common field. Powerful but also resource-intensive and makes scaling databases difficult. This is the cause of many slow performing queries when run at scale, and the solution is almost always to find ways to reduce the joins. Access control DBs have privileged accounts for admin tasks, and regular accounts for clients. There are finegrained controls on what actions(DDL, DML etc. discussed earlier )are allowed for these accounts. DB first verifies the user credentials (authentication), and then examines whether this user is permitted to perform the request (authorization) by looking up these information in some internal tables. Other controls include activity auditing that allows examining the history of actions done by a user, and resource limits which define the number of queries, connections etc. allowed. Popular databases Commercial, closed source - Oracle, Microsoft SQL Server, IBM DB2 Open source with optional paid support - MySQL, MariaDB, PostgreSQL Individuals and small companies have always preferred open source DBs because of the huge cost associated with commercial software. In recent times, even large organizations have moved away from commercial software to open source alternatives because of the flexibility and cost savings associated with it. Lack of support is no longer a concern because of the paid support available from the developer and third parties. MySQL is the most widely used open source DB, and it is widely supported by hosting providers, making it easy for anyone to use. It is part of the popular Linux-Apache-MySQL-PHP ( LAMP ) stack that became popular in the 2000s. We have many more choices for a programming language, but the rest of that stack is still widely used.","title":"Key Concepts"},{"location":"level101/databases_sql/concepts/#popular-databases","text":"Commercial, closed source - Oracle, Microsoft SQL Server, IBM DB2 Open source with optional paid support - MySQL, MariaDB, PostgreSQL Individuals and small companies have always preferred open source DBs because of the huge cost associated with commercial software. In recent times, even large organizations have moved away from commercial software to open source alternatives because of the flexibility and cost savings associated with it. Lack of support is no longer a concern because of the paid support available from the developer and third parties. MySQL is the most widely used open source DB, and it is widely supported by hosting providers, making it easy for anyone to use. It is part of the popular Linux-Apache-MySQL-PHP ( LAMP ) stack that became popular in the 2000s. We have many more choices for a programming language, but the rest of that stack is still widely used.","title":"Popular databases"},{"location":"level101/databases_sql/conclusion/","text":"Conclusion We have covered basic concepts of SQL databases. We have also covered some of the tasks that an SRE may be responsible for - there is so much more to learn and do. We hope this course gives you a good start and inspires you to explore further. Further reading More practice with online resources like this one Normalization Routines , triggers Views Transaction isolation levels Sharding Setting up HA , monitoring , backups","title":"Conclusion"},{"location":"level101/databases_sql/conclusion/#conclusion","text":"We have covered basic concepts of SQL databases. We have also covered some of the tasks that an SRE may be responsible for - there is so much more to learn and do. We hope this course gives you a good start and inspires you to explore further.","title":"Conclusion"},{"location":"level101/databases_sql/conclusion/#further-reading","text":"More practice with online resources like this one Normalization Routines , triggers Views Transaction isolation levels Sharding Setting up HA , monitoring , backups","title":"Further reading"},{"location":"level101/databases_sql/innodb/","text":"Why should you use this? General purpose, row level locking, ACID support, transactions, crash recovery and multi-version concurrency control etc. Architecture Key components: Memory: Buffer pool: LRU cache of frequently used data(table and index) to be processed directly from memory, which speeds up processing. Important for tuning performance. Change buffer: Caches changes to secondary index pages when those pages are not in the buffer pool and merges it when they are fetched. Merging may take a long time and impact live queries. It also takes up part of the buffer pool. Avoids the extra I/O to read secondary indexes in. Adaptive hash index: Supplements InnoDB\u2019s B-Tree indexes with fast hash lookup tables like a cache. Slight performance penalty for misses, also adds maintenance overhead of updating it. Hash collisions cause AHI rebuilding for large DBs. Log buffer: Holds log data before flush to disk. Size of each above memory is configurable, and impacts performance a lot. Requires careful analysis of workload, available resources, benchmarking and tuning for optimal performance. Disk: Tables: Stores data within rows and columns. Indexes: Helps find rows with specific column values quickly, avoids full table scans. Redo Logs: all transactions are written to them, and after a crash, the recovery process corrects data written by incomplete transactions and replays any pending ones. Undo Logs: Records associated with a single transaction that contains information about how to undo the latest change by a transaction.","title":"InnoDB"},{"location":"level101/databases_sql/innodb/#why-should-you-use-this","text":"General purpose, row level locking, ACID support, transactions, crash recovery and multi-version concurrency control etc.","title":"Why should you use this?"},{"location":"level101/databases_sql/innodb/#architecture","text":"","title":"Architecture"},{"location":"level101/databases_sql/innodb/#key-components","text":"Memory: Buffer pool: LRU cache of frequently used data(table and index) to be processed directly from memory, which speeds up processing. Important for tuning performance. Change buffer: Caches changes to secondary index pages when those pages are not in the buffer pool and merges it when they are fetched. Merging may take a long time and impact live queries. It also takes up part of the buffer pool. Avoids the extra I/O to read secondary indexes in. Adaptive hash index: Supplements InnoDB\u2019s B-Tree indexes with fast hash lookup tables like a cache. Slight performance penalty for misses, also adds maintenance overhead of updating it. Hash collisions cause AHI rebuilding for large DBs. Log buffer: Holds log data before flush to disk. Size of each above memory is configurable, and impacts performance a lot. Requires careful analysis of workload, available resources, benchmarking and tuning for optimal performance. Disk: Tables: Stores data within rows and columns. Indexes: Helps find rows with specific column values quickly, avoids full table scans. Redo Logs: all transactions are written to them, and after a crash, the recovery process corrects data written by incomplete transactions and replays any pending ones. Undo Logs: Records associated with a single transaction that contains information about how to undo the latest change by a transaction.","title":"Key components:"},{"location":"level101/databases_sql/intro/","text":"Relational Databases Prerequisites Complete Linux course Install Docker (for lab section) What to expect from this course You will have an understanding of what relational databases are, their advantages, and some MySQL specific concepts. What is not covered under this course In depth implementation details Advanced topics like normalization, sharding Specific tools for administration Introduction The main purpose of database systems is to manage data. This includes storage, adding new data, deleting unused data, updating existing data, retrieving data within a reasonable response time, other maintenance tasks to keep the system running etc. Pre-reads RDBMS Concepts Course Contents Key Concepts MySQL Architecture InnoDB Backup and Recovery MySQL Replication Operational Concepts SELECT Query Query Performance Lab Further Reading","title":"Introduction"},{"location":"level101/databases_sql/intro/#relational-databases","text":"","title":"Relational Databases"},{"location":"level101/databases_sql/intro/#prerequisites","text":"Complete Linux course Install Docker (for lab section)","title":"Prerequisites"},{"location":"level101/databases_sql/intro/#what-to-expect-from-this-course","text":"You will have an understanding of what relational databases are, their advantages, and some MySQL specific concepts.","title":"What to expect from this course"},{"location":"level101/databases_sql/intro/#what-is-not-covered-under-this-course","text":"In depth implementation details Advanced topics like normalization, sharding Specific tools for administration","title":"What is not covered under this course"},{"location":"level101/databases_sql/intro/#introduction","text":"The main purpose of database systems is to manage data. This includes storage, adding new data, deleting unused data, updating existing data, retrieving data within a reasonable response time, other maintenance tasks to keep the system running etc.","title":"Introduction"},{"location":"level101/databases_sql/intro/#pre-reads","text":"RDBMS Concepts","title":"Pre-reads"},{"location":"level101/databases_sql/intro/#course-contents","text":"Key Concepts MySQL Architecture InnoDB Backup and Recovery MySQL Replication Operational Concepts SELECT Query Query Performance Lab Further Reading","title":"Course Contents"},{"location":"level101/databases_sql/lab/","text":"Prerequisites Install Docker Setup Create a working directory named sos or something similar, and cd into it. Enter the following into a file named my.cnf under a directory named custom. sos $ cat custom/my.cnf [mysqld] # These settings apply to MySQL server # You can set port, socket path, buffer size etc. # Below, we are configuring slow query settings slow_query_log=1 slow_query_log_file=/var/log/mysqlslow.log long_query_time=1 Start a container and enable slow query log with the following: sos $ docker run --name db -v custom:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=realsecret -d mysql:8 sos $ docker cp custom/my.cnf $(docker ps -qf \"name=db\"):/etc/mysql/conf.d/custom.cnf sos $ docker restart $(docker ps -qf \"name=db\") Import a sample database sos $ git clone git@github.com:datacharmer/test_db.git sos $ docker cp test_db $(docker ps -qf \"name=db\"):/home/test_db/ sos $ docker exec -it $(docker ps -qf \"name=db\") bash root@3ab5b18b0c7d:/# cd /home/test_db/ root@3ab5b18b0c7d:/# mysql -uroot -prealsecret mysql < employees.sql root@3ab5b18b0c7d:/etc# touch /var/log/mysqlslow.log root@3ab5b18b0c7d:/etc# chown mysql:mysql /var/log/mysqlslow.log Workshop 1: Run some sample queries Run the following $ mysql -uroot -prealsecret mysql mysql> # inspect DBs and tables # the last 4 are MySQL internal DBs mysql> show databases; +--------------------+ | Database | +--------------------+ | employees | | information_schema | | mysql | | performance_schema | | sys | +--------------------+ > use employees; mysql> show tables; +----------------------+ | Tables_in_employees | +----------------------+ | current_dept_emp | | departments | | dept_emp | | dept_emp_latest_date | | dept_manager | | employees | | salaries | | titles | +----------------------+ # read a few rows mysql> select * from employees limit 5; # filter data by conditions mysql> select count(*) from employees where gender = 'M' limit 5; # find count of particular data mysql> select count(*) from employees where first_name = 'Sachin'; Workshop 2: Use explain and explain analyze to profile a query, identify and add indexes required for improving performance # View all indexes on table #(\\G is to output horizontally, replace it with a ; to get table output) mysql> show index from employees from employees\\G *************************** 1. row *************************** Table: employees Non_unique: 0 Key_name: PRIMARY Seq_in_index: 1 Column_name: emp_no Collation: A Cardinality: 299113 Sub_part: NULL Packed: NULL Null: Index_type: BTREE Comment: Index_comment: Visible: YES Expression: NULL # This query uses an index, idenitfied by 'key' field # By prefixing explain keyword to the command, # we get query plan (including key used) mysql> explain select * from employees where emp_no < 10005\\G *************************** 1. row *************************** id: 1 select_type: SIMPLE table: employees partitions: NULL type: range possible_keys: PRIMARY key: PRIMARY key_len: 4 ref: NULL rows: 4 filtered: 100.00 Extra: Using where # Compare that to the next query which does not utilize any index mysql> explain select first_name, last_name from employees where first_name = 'Sachin'\\G *************************** 1. row *************************** id: 1 select_type: SIMPLE table: employees partitions: NULL type: ALL possible_keys: NULL key: NULL key_len: NULL ref: NULL rows: 299113 filtered: 10.00 Extra: Using where # Let's see how much time this query takes mysql> explain analyze select first_name, last_name from employees where first_name = 'Sachin'\\G *************************** 1. row *************************** EXPLAIN: -> Filter: (employees.first_name = 'Sachin') (cost=30143.55 rows=29911) (actual time=28.284..3952.428 rows=232 loops=1) -> Table scan on employees (cost=30143.55 rows=299113) (actual time=0.095..1996.092 rows=300024 loops=1) # Cost(estimated by query planner) is 30143.55 # actual time=28.284ms for first row, 3952.428 for all rows # Now lets try adding an index and running the query again mysql> create index idx_firstname on employees(first_name); Query OK, 0 rows affected (1.25 sec) Records: 0 Duplicates: 0 Warnings: 0 mysql> explain analyze select first_name, last_name from employees where first_name = 'Sachin'; +--------------------------------------------------------------------------------------------------------------------------------------------+ | EXPLAIN | +--------------------------------------------------------------------------------------------------------------------------------------------+ | -> Index lookup on employees using idx_firstname (first_name='Sachin') (cost=81.20 rows=232) (actual time=0.551..2.934 rows=232 loops=1) | +--------------------------------------------------------------------------------------------------------------------------------------------+ 1 row in set (0.01 sec) # Actual time=0.551ms for first row # 2.934ms for all rows. A huge improvement! # Also notice that the query involves only an index lookup, # and no table scan (reading all rows of table) # ..which vastly reduces load on the DB. Workshop 3: Identify slow queries on a MySQL server # Run the command below in two terminal tabs to open two shells into the container. docker exec -it $(docker ps -qf \"name=db\") bash # Open a mysql prompt in one of them and execute this command # We have configured to log queries that take longer than 1s, # so this sleep(3) will be logged mysql -uroot -prealsecret mysql mysql> select sleep(3); # Now, in the other terminal, tail the slow log to find details about the query root@62c92c89234d:/etc# tail -f /var/log/mysqlslow.log /usr/sbin/mysqld, Version: 8.0.21 (MySQL Community Server - GPL). started with: Tcp port: 3306 Unix socket: /var/run/mysqld/mysqld.sock Time Id Command Argument # Time: 2020-11-26T14:53:44.822348Z # User@Host: root[root] @ localhost [] Id: 9 # Query_time: 5.404938 Lock_time: 0.000000 Rows_sent: 1 Rows_examined: 1 use employees; # Time: 2020-11-26T14:53:58.015736Z # User@Host: root[root] @ localhost [] Id: 9 # Query_time: 10.000225 Lock_time: 0.000000 Rows_sent: 1 Rows_examined: 1 SET timestamp=1606402428; select sleep(3); These were simulated examples with minimal complexity. In real life, the queries would be much more complex and the explain/analyze and slow query logs would have more details.","title":"Lab"},{"location":"level101/databases_sql/mysql/","text":"MySQL architecture MySQL architecture enables you to select the right storage engine for your needs, and abstracts away all implementation details from the end users (application engineers and DBA ) who only need to know a consistent stable API. Application layer: Connection handling - each client gets its own connection which is cached for the duration of access) Authentication - server checks (username,password,host) info of client and allows/rejects connection Security: server determines whether the client has privileges to execute each query (check with show privileges command) Server layer: Services and utilities - backup/restore, replication, cluster etc SQL interface - clients run queries for data access and manipulation SQL parser - creates a parse tree from the query (lexical/syntactic/semantic analysis and code generation) Optimizer - optimizes queries using various algorithms and data available to it(table level stats), modifies queries, order of scanning, indexes to use etc. (check with explain command) Caches and buffers - cache stores query results, buffer pool(InnoDB) stores table and index data in LRU fashion Storage engine options: InnoDB: most widely used, transaction support, ACID compliant, supports row-level locking, crash recovery and multi-version concurrency control. Default since MySQL 5.5+. MyISAM: fast, does not support transactions, provides table-level locking, great for read-heavy workloads, mostly in web and data warehousing. Default upto MySQL 5.1. Archive: optimised for high speed inserts, compresses data as it is inserted, does not support transactions, ideal for storing and retrieving large amounts of seldom referenced historical, archived data Memory: tables in memory. Fastest engine, supports table-level locking, does not support transactions, ideal for creating temporary tables or quick lookups, data is lost after a shutdown CSV: stores data in CSV files, great for integrating into other applications that use this format \u2026 etc. It is possible to migrate from one storage engine to another. But this migration locks tables for all operations and is not online, as it changes the physical layout of the data. It takes a long time and is generally not recommended. Hence, choosing the right storage engine at the beginning is important. General guideline is to use InnoDB unless you have a specific need for one of the other storage engines. Running mysql> SHOW ENGINES; shows you the supported engines on your MySQL server.","title":"MySQL"},{"location":"level101/databases_sql/mysql/#mysql-architecture","text":"MySQL architecture enables you to select the right storage engine for your needs, and abstracts away all implementation details from the end users (application engineers and DBA ) who only need to know a consistent stable API. Application layer: Connection handling - each client gets its own connection which is cached for the duration of access) Authentication - server checks (username,password,host) info of client and allows/rejects connection Security: server determines whether the client has privileges to execute each query (check with show privileges command) Server layer: Services and utilities - backup/restore, replication, cluster etc SQL interface - clients run queries for data access and manipulation SQL parser - creates a parse tree from the query (lexical/syntactic/semantic analysis and code generation) Optimizer - optimizes queries using various algorithms and data available to it(table level stats), modifies queries, order of scanning, indexes to use etc. (check with explain command) Caches and buffers - cache stores query results, buffer pool(InnoDB) stores table and index data in LRU fashion Storage engine options: InnoDB: most widely used, transaction support, ACID compliant, supports row-level locking, crash recovery and multi-version concurrency control. Default since MySQL 5.5+. MyISAM: fast, does not support transactions, provides table-level locking, great for read-heavy workloads, mostly in web and data warehousing. Default upto MySQL 5.1. Archive: optimised for high speed inserts, compresses data as it is inserted, does not support transactions, ideal for storing and retrieving large amounts of seldom referenced historical, archived data Memory: tables in memory. Fastest engine, supports table-level locking, does not support transactions, ideal for creating temporary tables or quick lookups, data is lost after a shutdown CSV: stores data in CSV files, great for integrating into other applications that use this format \u2026 etc. It is possible to migrate from one storage engine to another. But this migration locks tables for all operations and is not online, as it changes the physical layout of the data. It takes a long time and is generally not recommended. Hence, choosing the right storage engine at the beginning is important. General guideline is to use InnoDB unless you have a specific need for one of the other storage engines. Running mysql> SHOW ENGINES; shows you the supported engines on your MySQL server.","title":"MySQL architecture"},{"location":"level101/databases_sql/operations/","text":"Explain and explain+analyze EXPLAIN analyzes query plans from the optimizer, including how tables are joined, which tables/rows are scanned etc. Explain analyze shows the above and additional info like execution cost, number of rows returned, time taken etc. This knowledge is useful to tweak queries and add indexes. Watch this performance tuning tutorial video . Checkout the lab section for a hands-on about indexes. Slow query logs Used to identify slow queries (configurable threshold), enabled in config or dynamically with a query Checkout the lab section about identifying slow queries. User management This includes creation and changes to users, like managing privileges, changing password etc. Backup and restore strategies, pros and cons Logical backup using mysqldump - slower but can be done online Physical backup (copy data directory or use xtrabackup) - quick backup/recovery. Copying data directory requires locking or shut down. xtrabackup is an improvement because it supports backups without shutting down (hot backup). Others - PITR, snapshots etc. Crash recovery process using redo logs After a crash, when you restart server it reads redo logs and replays modifications to recover Monitoring MySQL Key MySQL metrics: reads, writes, query runtime, errors, slow queries, connections, running threads, InnoDB metrics Key OS metrics: CPU, load, memory, disk I/O, network Replication Copies data from one instance to one or more instances. Helps in horizontal scaling, data protection, analytics and performance. Binlog dump thread on primary, replication I/O and SQL threads on secondary. Strategies include the standard async, semi async or group replication. High Availability Ability to cope with failure at software, hardware and network level. Essential for anyone who needs 99.9%+ uptime. Can be implemented with replication or clustering solutions from MySQL, Percona, Oracle etc. Requires expertise to setup and maintain. Failover can be manual, scripted or using tools like Orchestrator. Data directory Data is stored in a particular directory, with nested directories for the data contained in each database. There are also MySQL log files, InnoDB log files, server process ID file and some other configs. The data directory is configurable. MySQL configuration This can be done by passing parameters during startup , or in a file . There are a few standard paths where MySQL looks for config files, /etc/my.cnf is one of the commonly used paths. These options are organized under headers (mysqld for server and mysql for client), you can explore them more in the lab that follows. Logs MySQL has logs for various purposes - general query log, errors, binary logs (for replication), slow query log. Only error log is enabled by default (to reduce I/O and storage requirement), the others can be enabled when required - by specifying config parameters at startup or running commands at runtime. Log destination can also be tweaked with config parameters.","title":"Operations"},{"location":"level101/databases_sql/query_performance/","text":"Query Performance Improvement Query Performance is a very crucial aspect of relational databases. If not tuned correctly, the select queries can become slow and painful for the application, and for the MySQL server as well. The important task is to identify the slow queries and try to improve their performance by either rewriting them or creating proper indexes on the tables involved in it. The Slow Query Log The slow query log contains SQL statements that take a longer time to execute then set in the config parameter long_query_time. These queries are the candidates for optimization. There are some good utilities to summarize the slow query logs like, mysqldumpslow (provided by MySQL itself), pt-query-digest (provided by Percona), etc. Following are the config parameters that are used to enable and effectively catch slow queries Variable Explanation Example value slow_query_log Enables or disables slow query logs ON slow_query_log_file The location of the slow query log /var/lib/mysql/mysql-slow.log long_query_time Threshold time. The query that takes longer than this time is logged in slow query log 5 log_queries_not_using_indexes When enabled with the slow query log, the queries which do not make use of any index are also logged in the slow query log even though they take less time than long_query_time. ON So, for this section, we will be enabling slow_query_log , long_query_time will be kept to 0.3 (300 ms) , and log_queries_not_using index will be enabled as well. Below are the queries that we will execute on the employees database. select * from employees where last_name = 'Koblick'; select * from salaries where salary >= 100000; select * from titles where title = 'Manager'; select * from employees where year(hire_date) = 1995; select year(e.hire_date), max(s.salary) from employees e join salaries s on e.emp_no=s.emp_no group by year(e.hire_date); Now, queries 1 , 3 and 4 executed under 300 ms but if we check the slow query logs, we will find these queries logged as they are not using any of the index. Queries 2 and 5 are taking longer than 300ms and also not using any index. Use the following command to get the summary of the slow query log mysqldumpslow /var/lib/mysql/mysql-slow.log There are some more queries in the snapshot that were along with the queries mentioned. Mysqldumpslow replaces actual values that were used by N (in case of numbers) and S (in case of strings). That can be overridden by -a option, however that will increase the output lines if different values are used in similar queries. The EXPLAIN Plan The EXPLAIN command is used with any query that we want to analyze. It describes the query execution plan, how MySQL sees and executes the query. EXPLAIN works with Select, Insert, Update and Delete statements. It tells about different aspects of the query like, how tables are joined, indexes used or not, etc. The important thing here is to understand the basic Explain plan output of a query to determine its performance. Let's take the following query as an example, mysql> explain select * from salaries where salary = 100000; +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ | 1 | SIMPLE | salaries | NULL | ALL | NULL | NULL | NULL | NULL | 2838426 | 10.00 | Using where | +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) The key aspects to understand in the above output are:- Partitions - the number of partitions considered while executing the query. It is only valid if the table is partitioned. Possible_keys - the list of indexes that were considered during creation of the execution plan. Key - the index that will be used while executing the query. Rows - the number of rows examined during the execution. Filtered - the percentage of rows that were filtered out of the rows examined. The maximum and most optimized result will have 100 in this field. Extra - this tells some extra information on how MySQL evaluates, whether the query is using only where clause to match target rows, any index or temporary table, etc. So, for the above query, we can determine that there are no partitions, there are no candidate indexes to be used and so no index is used at all, over 2M rows are examined and only 10% of them are included in the result, and lastly, only a where clause is used to match the target rows. Creating an Index Indexes are used to speed up selecting relevant rows for a given column value. Without an index, MySQL starts with the first row and goes through the entire table to find matching rows. If the table has too many rows, the operation becomes costly. With indexes, MySQL determines the position to start looking for the data without reading the full table. A primary key is also an index which is also the fastest and is stored along with the table data. Secondary indexes are stored outside of the table data and are used to further enhance the performance of SQL statements. Indexes are mostly stored as B-Trees, with some exceptions like spatial indexes use R-Trees and memory tables use hash indexes. There are 2 ways to create indexes:- While creating a table - if we know beforehand the columns that will drive the most number of where clauses in select queries, then we can put an index over them while creating a table. Altering a Table - To improve the performance of a troubling query, we create an index on a table which already has data in it using ALTER or CREATE INDEX command. This operation does not block the table but might take some time to complete depending on the size of the table. Let\u2019s look at the query that we discussed in the previous section. It\u2019s clear that scanning over 2M records is not a good idea when only 10% of those records are actually in the resultset. Hence, we create an index on the salary column of the salaries table. create index idx_salary on salaries(salary) OR alter table salaries add index idx_salary(salary) And the same explain plan now looks like this mysql> explain select * from salaries where salary = 100000; +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ | 1 | SIMPLE | salaries | NULL | ref | idx_salary | idx_salary | 4 | const | 13 | 100.00 | NULL | +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) Now the index used is idx_salary, the one we recently created. The index actually helped examine only 13 records and all of them are in the resultset. Also, the query execution time is also reduced from over 700ms to almost negligible. Let\u2019s look at another example. Here we are searching for a specific combination of first_name and last_name. But, we might also search based on last_name only. mysql> explain select * from employees where last_name = 'Dredge' and first_name = 'Yinghua'; +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | 1 | SIMPLE | employees | NULL | ALL | NULL | NULL | NULL | NULL | 299468 | 1.00 | Using where | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) Now only 1% record out of almost 300K is the resultset. Although the query time is particularly quick as we have only 300K records, this will be a pain if the number of records are over millions. In this case, we create an index on last_name and first_name, not separately, but a composite index including both the columns. create index idx_last_first on employees(last_name, first_name) mysql> explain select * from employees where last_name = 'Dredge' and first_name = 'Yinghua'; +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ | 1 | SIMPLE | employees | NULL | ref | idx_last_first | idx_last_first | 124 | const,const | 1 | 100.00 | NULL | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) We chose to put last_name before first_name while creating the index as the optimizer starts from the leftmost prefix of the index while evaluating the query. For example, if we have a 3-column index like idx(c1, c2, c3), then the search capability of the index follows - (c1), (c1, c2) or (c1, c2, c3) i.e. if your where clause has only first_name this index won\u2019t work. mysql> explain select * from employees where first_name = 'Yinghua'; +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | 1 | SIMPLE | employees | NULL | ALL | NULL | NULL | NULL | NULL | 299468 | 10.00 | Using where | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) But, if you have only the last_name in the where clause, it will work as expected. mysql> explain select * from employees where last_name = 'Dredge'; +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ | 1 | SIMPLE | employees | NULL | ref | idx_last_first | idx_last_first | 66 | const | 200 | 100.00 | NULL | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) For another example, use the following queries:- create table employees_2 like employees; create table salaries_2 like salaries; alter table salaries_2 drop primary key; We made copies of employees and salaries tables without the Primary Key of salaries table to understand an example of Select with Join. When you have queries like the below, it becomes tricky to identify the pain point of the query. mysql> select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; 1860 rows in set (4.44 sec) This query is taking about 4.5 seconds to complete with 1860 rows in the resultset. Let\u2019s look at the Explain plan. There will be 2 records in the Explain plan as 2 tables are used in the query. mysql> explain select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ | 1 | SIMPLE | s | NULL | ALL | NULL | NULL | NULL | NULL | 2837194 | 100.00 | NULL | | 1 | SIMPLE | e | NULL | eq_ref | PRIMARY,idx_last_first | PRIMARY | 4 | employees.s.emp_no | 1 | 5.00 | Using where | +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ 2 rows in set, 1 warning (0.00 sec) These are in order of evaluation i.e. salaries_2 will be evaluated first and then employees_2 will be joined to it. As it looks like, it scans almost all the rows of salaries_2 table and tries to match the employees_2 rows as per the join condition. Though where clause is used in fetching the final resultset, but the index corresponding to the where clause is not used for the employees_2 table. If the join is done on two indexes which have the same data-types, it will always be faster. So, let\u2019s create an index on the emp_no column of salaries_2 table and analyze the query again. create index idx_empno on salaries_2(emp_no); mysql> explain select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ | 1 | SIMPLE | e | NULL | ref | PRIMARY,idx_last_first | idx_last_first | 66 | const | 200 | 100.00 | NULL | | 1 | SIMPLE | s | NULL | ref | idx_empno | idx_empno | 4 | employees.e.emp_no | 9 | 100.00 | NULL | +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ 2 rows in set, 1 warning (0.00 sec) Now, not only did the index help the optimizer to examine only a few rows in both tables, it reversed the order of the tables in evaluation. The employees_2 table is evaluated first and rows are selected as per the index respective to the where clause. Then the records are joined to salaries_2 table as per the index used due to the join condition. The execution time of the query came down from 4.5s to 0.02s . mysql> select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'\\G 1860 rows in set (0.02 sec)","title":"Query Performance"},{"location":"level101/databases_sql/query_performance/#query-performance-improvement","text":"Query Performance is a very crucial aspect of relational databases. If not tuned correctly, the select queries can become slow and painful for the application, and for the MySQL server as well. The important task is to identify the slow queries and try to improve their performance by either rewriting them or creating proper indexes on the tables involved in it.","title":"Query Performance Improvement"},{"location":"level101/databases_sql/query_performance/#the-slow-query-log","text":"The slow query log contains SQL statements that take a longer time to execute then set in the config parameter long_query_time. These queries are the candidates for optimization. There are some good utilities to summarize the slow query logs like, mysqldumpslow (provided by MySQL itself), pt-query-digest (provided by Percona), etc. Following are the config parameters that are used to enable and effectively catch slow queries Variable Explanation Example value slow_query_log Enables or disables slow query logs ON slow_query_log_file The location of the slow query log /var/lib/mysql/mysql-slow.log long_query_time Threshold time. The query that takes longer than this time is logged in slow query log 5 log_queries_not_using_indexes When enabled with the slow query log, the queries which do not make use of any index are also logged in the slow query log even though they take less time than long_query_time. ON So, for this section, we will be enabling slow_query_log , long_query_time will be kept to 0.3 (300 ms) , and log_queries_not_using index will be enabled as well. Below are the queries that we will execute on the employees database. select * from employees where last_name = 'Koblick'; select * from salaries where salary >= 100000; select * from titles where title = 'Manager'; select * from employees where year(hire_date) = 1995; select year(e.hire_date), max(s.salary) from employees e join salaries s on e.emp_no=s.emp_no group by year(e.hire_date); Now, queries 1 , 3 and 4 executed under 300 ms but if we check the slow query logs, we will find these queries logged as they are not using any of the index. Queries 2 and 5 are taking longer than 300ms and also not using any index. Use the following command to get the summary of the slow query log mysqldumpslow /var/lib/mysql/mysql-slow.log There are some more queries in the snapshot that were along with the queries mentioned. Mysqldumpslow replaces actual values that were used by N (in case of numbers) and S (in case of strings). That can be overridden by -a option, however that will increase the output lines if different values are used in similar queries.","title":"The Slow Query Log"},{"location":"level101/databases_sql/query_performance/#the-explain-plan","text":"The EXPLAIN command is used with any query that we want to analyze. It describes the query execution plan, how MySQL sees and executes the query. EXPLAIN works with Select, Insert, Update and Delete statements. It tells about different aspects of the query like, how tables are joined, indexes used or not, etc. The important thing here is to understand the basic Explain plan output of a query to determine its performance. Let's take the following query as an example, mysql> explain select * from salaries where salary = 100000; +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ | 1 | SIMPLE | salaries | NULL | ALL | NULL | NULL | NULL | NULL | 2838426 | 10.00 | Using where | +----+-------------+----------+------------+------+---------------+------+---------+------+---------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) The key aspects to understand in the above output are:- Partitions - the number of partitions considered while executing the query. It is only valid if the table is partitioned. Possible_keys - the list of indexes that were considered during creation of the execution plan. Key - the index that will be used while executing the query. Rows - the number of rows examined during the execution. Filtered - the percentage of rows that were filtered out of the rows examined. The maximum and most optimized result will have 100 in this field. Extra - this tells some extra information on how MySQL evaluates, whether the query is using only where clause to match target rows, any index or temporary table, etc. So, for the above query, we can determine that there are no partitions, there are no candidate indexes to be used and so no index is used at all, over 2M rows are examined and only 10% of them are included in the result, and lastly, only a where clause is used to match the target rows.","title":"The EXPLAIN Plan"},{"location":"level101/databases_sql/query_performance/#creating-an-index","text":"Indexes are used to speed up selecting relevant rows for a given column value. Without an index, MySQL starts with the first row and goes through the entire table to find matching rows. If the table has too many rows, the operation becomes costly. With indexes, MySQL determines the position to start looking for the data without reading the full table. A primary key is also an index which is also the fastest and is stored along with the table data. Secondary indexes are stored outside of the table data and are used to further enhance the performance of SQL statements. Indexes are mostly stored as B-Trees, with some exceptions like spatial indexes use R-Trees and memory tables use hash indexes. There are 2 ways to create indexes:- While creating a table - if we know beforehand the columns that will drive the most number of where clauses in select queries, then we can put an index over them while creating a table. Altering a Table - To improve the performance of a troubling query, we create an index on a table which already has data in it using ALTER or CREATE INDEX command. This operation does not block the table but might take some time to complete depending on the size of the table. Let\u2019s look at the query that we discussed in the previous section. It\u2019s clear that scanning over 2M records is not a good idea when only 10% of those records are actually in the resultset. Hence, we create an index on the salary column of the salaries table. create index idx_salary on salaries(salary) OR alter table salaries add index idx_salary(salary) And the same explain plan now looks like this mysql> explain select * from salaries where salary = 100000; +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ | 1 | SIMPLE | salaries | NULL | ref | idx_salary | idx_salary | 4 | const | 13 | 100.00 | NULL | +----+-------------+----------+------------+------+---------------+------------+---------+-------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) Now the index used is idx_salary, the one we recently created. The index actually helped examine only 13 records and all of them are in the resultset. Also, the query execution time is also reduced from over 700ms to almost negligible. Let\u2019s look at another example. Here we are searching for a specific combination of first_name and last_name. But, we might also search based on last_name only. mysql> explain select * from employees where last_name = 'Dredge' and first_name = 'Yinghua'; +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | 1 | SIMPLE | employees | NULL | ALL | NULL | NULL | NULL | NULL | 299468 | 1.00 | Using where | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) Now only 1% record out of almost 300K is the resultset. Although the query time is particularly quick as we have only 300K records, this will be a pain if the number of records are over millions. In this case, we create an index on last_name and first_name, not separately, but a composite index including both the columns. create index idx_last_first on employees(last_name, first_name) mysql> explain select * from employees where last_name = 'Dredge' and first_name = 'Yinghua'; +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ | 1 | SIMPLE | employees | NULL | ref | idx_last_first | idx_last_first | 124 | const,const | 1 | 100.00 | NULL | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) We chose to put last_name before first_name while creating the index as the optimizer starts from the leftmost prefix of the index while evaluating the query. For example, if we have a 3-column index like idx(c1, c2, c3), then the search capability of the index follows - (c1), (c1, c2) or (c1, c2, c3) i.e. if your where clause has only first_name this index won\u2019t work. mysql> explain select * from employees where first_name = 'Yinghua'; +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ | 1 | SIMPLE | employees | NULL | ALL | NULL | NULL | NULL | NULL | 299468 | 10.00 | Using where | +----+-------------+-----------+------------+------+---------------+------+---------+------+--------+----------+-------------+ 1 row in set, 1 warning (0.00 sec) But, if you have only the last_name in the where clause, it will work as expected. mysql> explain select * from employees where last_name = 'Dredge'; +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ | 1 | SIMPLE | employees | NULL | ref | idx_last_first | idx_last_first | 66 | const | 200 | 100.00 | NULL | +----+-------------+-----------+------------+------+----------------+----------------+---------+-------+------+----------+-------+ 1 row in set, 1 warning (0.00 sec) For another example, use the following queries:- create table employees_2 like employees; create table salaries_2 like salaries; alter table salaries_2 drop primary key; We made copies of employees and salaries tables without the Primary Key of salaries table to understand an example of Select with Join. When you have queries like the below, it becomes tricky to identify the pain point of the query. mysql> select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; 1860 rows in set (4.44 sec) This query is taking about 4.5 seconds to complete with 1860 rows in the resultset. Let\u2019s look at the Explain plan. There will be 2 records in the Explain plan as 2 tables are used in the query. mysql> explain select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ | 1 | SIMPLE | s | NULL | ALL | NULL | NULL | NULL | NULL | 2837194 | 100.00 | NULL | | 1 | SIMPLE | e | NULL | eq_ref | PRIMARY,idx_last_first | PRIMARY | 4 | employees.s.emp_no | 1 | 5.00 | Using where | +----+-------------+-------+------------+--------+------------------------+---------+---------+--------------------+---------+----------+-------------+ 2 rows in set, 1 warning (0.00 sec) These are in order of evaluation i.e. salaries_2 will be evaluated first and then employees_2 will be joined to it. As it looks like, it scans almost all the rows of salaries_2 table and tries to match the employees_2 rows as per the join condition. Though where clause is used in fetching the final resultset, but the index corresponding to the where clause is not used for the employees_2 table. If the join is done on two indexes which have the same data-types, it will always be faster. So, let\u2019s create an index on the emp_no column of salaries_2 table and analyze the query again. create index idx_empno on salaries_2(emp_no); mysql> explain select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'; +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ | id | select_type | table | partitions | type | possible_keys | key | key_len | ref | rows | filtered | Extra | +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ | 1 | SIMPLE | e | NULL | ref | PRIMARY,idx_last_first | idx_last_first | 66 | const | 200 | 100.00 | NULL | | 1 | SIMPLE | s | NULL | ref | idx_empno | idx_empno | 4 | employees.e.emp_no | 9 | 100.00 | NULL | +----+-------------+-------+------------+------+------------------------+----------------+---------+--------------------+------+----------+-------+ 2 rows in set, 1 warning (0.00 sec) Now, not only did the index help the optimizer to examine only a few rows in both tables, it reversed the order of the tables in evaluation. The employees_2 table is evaluated first and rows are selected as per the index respective to the where clause. Then the records are joined to salaries_2 table as per the index used due to the join condition. The execution time of the query came down from 4.5s to 0.02s . mysql> select e.first_name, e.last_name, s.salary, e.hire_date from employees_2 e join salaries_2 s on e.emp_no=s.emp_no where e.last_name='Dredge'\\G 1860 rows in set (0.02 sec)","title":"Creating an Index"},{"location":"level101/databases_sql/replication/","text":"MySQL Replication Replication enables data from one MySQL host (termed as Primary) to be copied to another MySQL host (termed as Replica). MySQL Replication is asynchronous in nature by default, but it can be changed to semi-synchronous with some configurations. Some common applications of MySQL replication are:- Read-scaling - as multiple hosts can replicate the data from a single primary host, we can set up as many replicas as we need and scale reads through them, i.e. application writes will go to a single primary host and the reads can balance between all the replicas that are there. Such a setup can improve the write performance as well, as the primary is dedicated to only updates and not reads. Backups using replicas - the backup process can sometimes be a little heavy. But if we have replicas configured, then we can use one of them to get the backup without affecting the primary data at all. Disaster Recovery - a replica in some other geographical region paves a proper path to configure disaster recovery. MySQL supports different types of synchronizations as well:- Asynchronous - this is the default synchronization method. It is one-way, i.e. one host serves as primary and one or more hosts as replica. We will discuss this method throughout the replication topic. Semi-Synchronous - in this type of synchronization, a commit performed on the primary host is blocked until at least one replica acknowledges it. Post the acknowledgement from any one replica, the control is returned to the session that performed the transaction. This ensures strong consistency but the replication is slower than asynchronous. Delayed - we can deliberately lag the replica in a typical MySQL replication by the number of seconds desired by the use case. This type of replication safeguards from severe human errors of dropping or corrupting the data on the primary, for example, in the above diagram for Delayed Replication, if a DROP DATABASE is executed by mistake on the primary, we still have 30 minutes to recover the data from R2 as that command has not been replicated on R2 yet. Pre-Requisites Before we dive into setting up replication, we should know about the binary logs. Binary logs play a very important role in MySQL replication. Binary logs, or commonly known as binlogs contain events about the changes done to the database, like table structure changes, data changes via DML operations, etc. They are not used to log SELECT statements. For replication, the primary sends the information to the replicas using its binlogs about the changes done to the database, and the replicas make the same data changes. With respect to MySQL replication, the binary log format can be of two types that decides the main type of replication:- - Statement-Based Replication or SBR - Row-Based Replication or RBR Statement Based Binlog Format Originally, the replication in MySQL was based on SQL statements getting replicated and executed on the replica from the primary. This is called statement based logging. The binlog contains the exact SQL statement run by the session. So If we run the above statements to insert 3 records and the update 3 in a single update statement, they will be logged exactly the same as when we executed them. Row Based Binlog Format The Row based is the default one in the latest MySQL releases. This is a lot different from the Statement format as here, row events are logged instead of statements. By that we mean, in the above example one update statement affected 3 records, but binlog had only one update statement; if it is a row based format, binlog will have an event for each record updated. Statement Based v/s Row Based binlogs Let\u2019s have a look at the operational differences between statement-based and row-based binlogs. Statement Based Row Based Logs SQL statements as executed Logs row events based on SQL statements executed Takes lesser disk space Takes more disk space Restoring using binlogs is faster Restoring using binlogs is slower When used for replication, if any statement has a predefined function that has its own value, like sysdate(), uuid() etc, the output could be different on the replica which makes it inconsistent. Whatever is executed becomes a row event with values, so there will be no problem if such functions are used in SQL statements. Only statements are logged so no other row events are generated. A lot of events are generated when a table is copied into another using INSERT INTO SELECT. Note - There is another type of binlog format called Mixed . With mixed logging, statement based is used by default but it switches to row based in certain cases. If MySQL cannot guarantee that statement based logging is safe for the statements executed, it issues a warning and switches to row based for those statements. We will be using binary log format as Row for the entire replication topic. Replication in Motion The above figure indicates how a typical MySQL replication works. Replica_IO_Thread is responsible to fetch the binlog events from the primary binary logs to the replica On the Replica host, relay logs are created which are exact copies of the binary logs. If the binary logs on primary are in row format, the relay logs will be the same. Replica_SQL_Thread applies the relay logs on the replica MySQL server. If log-bin is enabled on the replica, then the replica will have its own binary logs as well. If log-slave-updates is enabled, then it will have the updates from the primary logged in the binlogs as well. Setting up Replication In this section, we will set up a simple asynchronous replication. The binlogs will be in row based format. The replication will be set up on two fresh hosts with no prior data present. There are two different ways in which we can set up replication. Binlog based - Each replica keeps a record of the binlog coordinates on the primary - current binlog and position in the binlog till where it has read and processed. So, at a time different replicas might be reading different parts of the same binlog. GTID based - Every transaction gets an identifier called global transaction identifier or GTID. There is no need to keep the record of binlog coordinates, as long as the replica has all the GTIDs executed on the primary, it is consistent with the primary. A typical GTID is the server_uuid:# positive integer. We will set up a GTID based replication in the following section but will also discuss binlog based replication setup as well. Primary Host Configurations The following config parameters should be present in the primary my.cnf file for setting up GTID based replication. server-id - a unique ID for the mysql server log-bin - the binlog location binlog-format - ROW | STATEMENT (we will use ROW) gtid-mode - ON enforce-gtid-consistency - ON (allows execution of only those statements which can be logged using GTIDs) Replica Host Configurations The following config parameters should be present in the replica my.cnf file for setting up replication. server-id - different than the primary host log-bin - (optional, if you want replica to log its own changes as well) binlog-format - depends on the above gtid-mode - ON enforce-gtid-consistency - ON log-slave-updates - ON (if binlog is enabled, then we can enable this. This enables the replica to log the changes coming from the primary along with its own changes. Helps in setting up chain replication) Replication User Every replica connects to the primary using a mysql user for replicating. So there must be a mysql user account for the same on the primary host. Any user can be used for this purpose provided it has REPLICATION SLAVE privilege. If the sole purpose is replication then we can have a user with only the required privilege. On the primary host mysql> create user repl_user@ identified by 'xxxxx'; mysql> grant replication slave on *.* to repl_user@''; Obtaining Starting position from Primary Run the following command on the primary host mysql> show master status\\G *************************** 1. row *************************** File: mysql-bin.000001 Position: 73 Binlog_Do_DB: Binlog_Ignore_DB: Executed_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 1 row in set (0.00 sec) If we are working with binary log based replication, the top two output lines are the most important ones. That tells the current binlog on the primary host and till what position it has written. For fresh hosts we know that no data is written so we can directly set up replication using the very first binlog file and position 4. If we are setting up a replication from a backup, then that changes the way we obtain the starting position. For GTIDs, the executed_gtid_set is the value where primary is right now. Again, for a fresh setup, we don\u2019t have to specify anything about the starting point and it will start from the transaction id 1, but when we set up from a backup, the backup will contain the GTID positions till where backup has been taken. Setting up Replica The replication setup must know about the primary host, the user and password to connect, the binlog coordinates (for binlog based replication) or the GTID auto-position parameter. The following command is used for setting up change master to master_host = '', master_port = , master_user = 'repl_user', master_password = 'xxxxx', master_auto_position = 1; Note - the Change Master To command has been replaced with Change Replication Source To from Mysql 8.0.23 onwards, also all the master and slave keywords are replaced with source and replica . If it is binlog based replication, then instead of master_auto_position, we need to specify the binlog coordinates. master_log_file = 'mysql-bin.000001', master_log_pos = 4 Starting Replication and Check Status Now that everything is configured, we just need to start the replication on the replica via the following command start slave; OR from MySQL 8.0.23 onwards, start replica; Whether or not the replication is running successfully, we can determine by running the following command show slave status\\G OR from MySQL 8.0.23 onwards, show replica status\\G mysql> show replica status\\G *************************** 1. row *************************** Replica_IO_State: Waiting for master to send event Source_Host: Source_User: repl_user Source_Port: Connect_Retry: 60 Source_Log_File: mysql-bin.000001 Read_Source_Log_Pos: 852 Relay_Log_File: mysql-relay-bin.000002 Relay_Log_Pos: 1067 Relay_Source_Log_File: mysql-bin.000001 Replica_IO_Running: Yes Replica_SQL_Running: Yes Replicate_Do_DB: Replicate_Ignore_DB: Replicate_Do_Table: Replicate_Ignore_Table: Replicate_Wild_Do_Table: Replicate_Wild_Ignore_Table: Last_Errno: 0 Last_Error: Skip_Counter: 0 Exec_Source_Log_Pos: 852 Relay_Log_Space: 1283 Until_Condition: None Until_Log_File: Until_Log_Pos: 0 Source_SSL_Allowed: No Source_SSL_CA_File: Source_SSL_CA_Path: Source_SSL_Cert: Source_SSL_Cipher: Source_SSL_Key: Seconds_Behind_Source: 0 Source_SSL_Verify_Server_Cert: No Last_IO_Errno: 0 Last_IO_Error: Last_SQL_Errno: 0 Last_SQL_Error: Replicate_Ignore_Server_Ids: Source_Server_Id: 1 Source_UUID: e17d0920-d00e-11eb-a3e6-000d3aa00f87 Source_Info_File: mysql.slave_master_info SQL_Delay: 0 SQL_Remaining_Delay: NULL Replica_SQL_Running_State: Slave has read all relay log; waiting for more updates Source_Retry_Count: 86400 Source_Bind: Last_IO_Error_Timestamp: Last_SQL_Error_Timestamp: Source_SSL_Crl: Source_SSL_Crlpath: Retrieved_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 Executed_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 Auto_Position: 1 Replicate_Rewrite_DB: Channel_Name: Source_TLS_Version: Source_public_key_path: Get_Source_public_key: 0 Network_Namespace: 1 row in set (0.00 sec) Some of the parameters are explained below:- Relay_Source_Log_File - the primary\u2019s file where replica is currently reading from Execute_Source_Log_Pos - for the above file on which position is the replica reading currently from. These two parameters are of utmost importance when binlog based replication is used. Replica_IO_Running - IO thread of replica is running or not Replica_SQL_Running - SQL thread of replica is running or not Seconds_Behind_Source - the difference of seconds when a statement was executed on Primary and then on Replica. This indicates how much replication lag is there. Source_UUID - the uuid of the primary host Retrieved_Gtid_Set - the GTIDs fetched from the primary host by the replica to be executed. Executed_Gtid_Set - the GTIDs executed on the replica. This set remains the same for the entire cluster if the replicas are in sync. Auto_Position - it directs the replica to fetch the next GTID automatically Create a Replica for the already setup cluster The steps discussed in the previous section talks about the setting up replication on two fresh hosts. When we have to set up a replica for a host which is already serving applications, then the backup of the primary is used, either fresh backup taken for the replica (should only be done if the traffic it is serving is less) or use a recently taken backup. If the size of the databases on the MySQL primary server is small, less than 100G recommended, then mysqldump can be used to take backup along with the following options. mysqldump -uroot -p -hhost_ip -P3306 --all-databases --single-transaction --master-data=1 > primary_host.bkp --single-transaction - this option starts a transaction before taking the backup which ensures it is consistent. As transactions are isolated from each other, so no other writes affect the backup. --master-data - this option is required if binlog based replication is desired to be set up. It includes the binary log file and log file position in the backup file. When GTID mode is enabled and mysqldump is executed, it includes the GTID executed to be used to start the replica after the backup position. The contents of the mysqldump output file will have the following It is recommended to comment these before restoring otherwise they could throw errors. Also, using master-data=2 will automatically comment the master_log_file line. Similarly, when taking backup of the host using xtrabackup , the file xtrabckup_info file contains the information about binlog file and file position, as well as the GTID executed set. server_version = 8.0.25 start_time = 2021-06-22 03:45:17 end_time = 2021-06-22 03:45:20 lock_time = 0 binlog_pos = filename 'mysql-bin.000007', position '196', GTID of the last change 'e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-5' innodb_from_lsn = 0 innodb_to_lsn = 18153149 partial = N incremental = N format = file compressed = N encrypted = N Now, after setting MySQL server on the desired host, restore the backup taken from any one of the above methods. If the intended way is binlog based replication, then use the binlog file and position info in the following command change Replication Source to source_host = \u2018primary_ip\u2019, source_port = 3306, source_user = \u2018repl_user\u2019, source_password = \u2018xxxxx\u2019, source_log_file = \u2018mysql-bin.000007\u2019, source_log_pos = \u2018196\u2019; If the replication needs to be set via GITDs, then run the below command to tell the replica about the GTIDs already executed. On the Replica host, run th following commands reset master; set global gtid_purged = \u2018e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-5\u2019 change replication source to source_host = \u2018primary_ip\u2019, source_port = 3306, source_user = \u2018repl_user\u2019, source_password = \u2018xxxxx\u2019, source_auto_position = 1 The reset master command resets the position of the binary log to initial. It can be skipped if the host is a freshly installed MySQL, but we restored a backup so it is necessary. The gtid_purged global variable lets the replica know the GTIDs that have already been executed, so that the replication can start after that. Then in the change source command, we set the auto-position to 1 which automatically gets the next GTID to proceed. Further Reading More applications of Replication Automtaed Failovers using MySQL Orchestrator","title":"MySQL Replication"},{"location":"level101/databases_sql/replication/#mysql-replication","text":"Replication enables data from one MySQL host (termed as Primary) to be copied to another MySQL host (termed as Replica). MySQL Replication is asynchronous in nature by default, but it can be changed to semi-synchronous with some configurations. Some common applications of MySQL replication are:- Read-scaling - as multiple hosts can replicate the data from a single primary host, we can set up as many replicas as we need and scale reads through them, i.e. application writes will go to a single primary host and the reads can balance between all the replicas that are there. Such a setup can improve the write performance as well, as the primary is dedicated to only updates and not reads. Backups using replicas - the backup process can sometimes be a little heavy. But if we have replicas configured, then we can use one of them to get the backup without affecting the primary data at all. Disaster Recovery - a replica in some other geographical region paves a proper path to configure disaster recovery. MySQL supports different types of synchronizations as well:- Asynchronous - this is the default synchronization method. It is one-way, i.e. one host serves as primary and one or more hosts as replica. We will discuss this method throughout the replication topic. Semi-Synchronous - in this type of synchronization, a commit performed on the primary host is blocked until at least one replica acknowledges it. Post the acknowledgement from any one replica, the control is returned to the session that performed the transaction. This ensures strong consistency but the replication is slower than asynchronous. Delayed - we can deliberately lag the replica in a typical MySQL replication by the number of seconds desired by the use case. This type of replication safeguards from severe human errors of dropping or corrupting the data on the primary, for example, in the above diagram for Delayed Replication, if a DROP DATABASE is executed by mistake on the primary, we still have 30 minutes to recover the data from R2 as that command has not been replicated on R2 yet. Pre-Requisites Before we dive into setting up replication, we should know about the binary logs. Binary logs play a very important role in MySQL replication. Binary logs, or commonly known as binlogs contain events about the changes done to the database, like table structure changes, data changes via DML operations, etc. They are not used to log SELECT statements. For replication, the primary sends the information to the replicas using its binlogs about the changes done to the database, and the replicas make the same data changes. With respect to MySQL replication, the binary log format can be of two types that decides the main type of replication:- - Statement-Based Replication or SBR - Row-Based Replication or RBR Statement Based Binlog Format Originally, the replication in MySQL was based on SQL statements getting replicated and executed on the replica from the primary. This is called statement based logging. The binlog contains the exact SQL statement run by the session. So If we run the above statements to insert 3 records and the update 3 in a single update statement, they will be logged exactly the same as when we executed them. Row Based Binlog Format The Row based is the default one in the latest MySQL releases. This is a lot different from the Statement format as here, row events are logged instead of statements. By that we mean, in the above example one update statement affected 3 records, but binlog had only one update statement; if it is a row based format, binlog will have an event for each record updated. Statement Based v/s Row Based binlogs Let\u2019s have a look at the operational differences between statement-based and row-based binlogs. Statement Based Row Based Logs SQL statements as executed Logs row events based on SQL statements executed Takes lesser disk space Takes more disk space Restoring using binlogs is faster Restoring using binlogs is slower When used for replication, if any statement has a predefined function that has its own value, like sysdate(), uuid() etc, the output could be different on the replica which makes it inconsistent. Whatever is executed becomes a row event with values, so there will be no problem if such functions are used in SQL statements. Only statements are logged so no other row events are generated. A lot of events are generated when a table is copied into another using INSERT INTO SELECT. Note - There is another type of binlog format called Mixed . With mixed logging, statement based is used by default but it switches to row based in certain cases. If MySQL cannot guarantee that statement based logging is safe for the statements executed, it issues a warning and switches to row based for those statements. We will be using binary log format as Row for the entire replication topic. Replication in Motion The above figure indicates how a typical MySQL replication works. Replica_IO_Thread is responsible to fetch the binlog events from the primary binary logs to the replica On the Replica host, relay logs are created which are exact copies of the binary logs. If the binary logs on primary are in row format, the relay logs will be the same. Replica_SQL_Thread applies the relay logs on the replica MySQL server. If log-bin is enabled on the replica, then the replica will have its own binary logs as well. If log-slave-updates is enabled, then it will have the updates from the primary logged in the binlogs as well.","title":"MySQL Replication"},{"location":"level101/databases_sql/replication/#setting-up-replication","text":"In this section, we will set up a simple asynchronous replication. The binlogs will be in row based format. The replication will be set up on two fresh hosts with no prior data present. There are two different ways in which we can set up replication. Binlog based - Each replica keeps a record of the binlog coordinates on the primary - current binlog and position in the binlog till where it has read and processed. So, at a time different replicas might be reading different parts of the same binlog. GTID based - Every transaction gets an identifier called global transaction identifier or GTID. There is no need to keep the record of binlog coordinates, as long as the replica has all the GTIDs executed on the primary, it is consistent with the primary. A typical GTID is the server_uuid:# positive integer. We will set up a GTID based replication in the following section but will also discuss binlog based replication setup as well. Primary Host Configurations The following config parameters should be present in the primary my.cnf file for setting up GTID based replication. server-id - a unique ID for the mysql server log-bin - the binlog location binlog-format - ROW | STATEMENT (we will use ROW) gtid-mode - ON enforce-gtid-consistency - ON (allows execution of only those statements which can be logged using GTIDs) Replica Host Configurations The following config parameters should be present in the replica my.cnf file for setting up replication. server-id - different than the primary host log-bin - (optional, if you want replica to log its own changes as well) binlog-format - depends on the above gtid-mode - ON enforce-gtid-consistency - ON log-slave-updates - ON (if binlog is enabled, then we can enable this. This enables the replica to log the changes coming from the primary along with its own changes. Helps in setting up chain replication) Replication User Every replica connects to the primary using a mysql user for replicating. So there must be a mysql user account for the same on the primary host. Any user can be used for this purpose provided it has REPLICATION SLAVE privilege. If the sole purpose is replication then we can have a user with only the required privilege. On the primary host mysql> create user repl_user@ identified by 'xxxxx'; mysql> grant replication slave on *.* to repl_user@''; Obtaining Starting position from Primary Run the following command on the primary host mysql> show master status\\G *************************** 1. row *************************** File: mysql-bin.000001 Position: 73 Binlog_Do_DB: Binlog_Ignore_DB: Executed_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 1 row in set (0.00 sec) If we are working with binary log based replication, the top two output lines are the most important ones. That tells the current binlog on the primary host and till what position it has written. For fresh hosts we know that no data is written so we can directly set up replication using the very first binlog file and position 4. If we are setting up a replication from a backup, then that changes the way we obtain the starting position. For GTIDs, the executed_gtid_set is the value where primary is right now. Again, for a fresh setup, we don\u2019t have to specify anything about the starting point and it will start from the transaction id 1, but when we set up from a backup, the backup will contain the GTID positions till where backup has been taken. Setting up Replica The replication setup must know about the primary host, the user and password to connect, the binlog coordinates (for binlog based replication) or the GTID auto-position parameter. The following command is used for setting up change master to master_host = '', master_port = , master_user = 'repl_user', master_password = 'xxxxx', master_auto_position = 1; Note - the Change Master To command has been replaced with Change Replication Source To from Mysql 8.0.23 onwards, also all the master and slave keywords are replaced with source and replica . If it is binlog based replication, then instead of master_auto_position, we need to specify the binlog coordinates. master_log_file = 'mysql-bin.000001', master_log_pos = 4 Starting Replication and Check Status Now that everything is configured, we just need to start the replication on the replica via the following command start slave; OR from MySQL 8.0.23 onwards, start replica; Whether or not the replication is running successfully, we can determine by running the following command show slave status\\G OR from MySQL 8.0.23 onwards, show replica status\\G mysql> show replica status\\G *************************** 1. row *************************** Replica_IO_State: Waiting for master to send event Source_Host: Source_User: repl_user Source_Port: Connect_Retry: 60 Source_Log_File: mysql-bin.000001 Read_Source_Log_Pos: 852 Relay_Log_File: mysql-relay-bin.000002 Relay_Log_Pos: 1067 Relay_Source_Log_File: mysql-bin.000001 Replica_IO_Running: Yes Replica_SQL_Running: Yes Replicate_Do_DB: Replicate_Ignore_DB: Replicate_Do_Table: Replicate_Ignore_Table: Replicate_Wild_Do_Table: Replicate_Wild_Ignore_Table: Last_Errno: 0 Last_Error: Skip_Counter: 0 Exec_Source_Log_Pos: 852 Relay_Log_Space: 1283 Until_Condition: None Until_Log_File: Until_Log_Pos: 0 Source_SSL_Allowed: No Source_SSL_CA_File: Source_SSL_CA_Path: Source_SSL_Cert: Source_SSL_Cipher: Source_SSL_Key: Seconds_Behind_Source: 0 Source_SSL_Verify_Server_Cert: No Last_IO_Errno: 0 Last_IO_Error: Last_SQL_Errno: 0 Last_SQL_Error: Replicate_Ignore_Server_Ids: Source_Server_Id: 1 Source_UUID: e17d0920-d00e-11eb-a3e6-000d3aa00f87 Source_Info_File: mysql.slave_master_info SQL_Delay: 0 SQL_Remaining_Delay: NULL Replica_SQL_Running_State: Slave has read all relay log; waiting for more updates Source_Retry_Count: 86400 Source_Bind: Last_IO_Error_Timestamp: Last_SQL_Error_Timestamp: Source_SSL_Crl: Source_SSL_Crlpath: Retrieved_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 Executed_Gtid_Set: e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-3 Auto_Position: 1 Replicate_Rewrite_DB: Channel_Name: Source_TLS_Version: Source_public_key_path: Get_Source_public_key: 0 Network_Namespace: 1 row in set (0.00 sec) Some of the parameters are explained below:- Relay_Source_Log_File - the primary\u2019s file where replica is currently reading from Execute_Source_Log_Pos - for the above file on which position is the replica reading currently from. These two parameters are of utmost importance when binlog based replication is used. Replica_IO_Running - IO thread of replica is running or not Replica_SQL_Running - SQL thread of replica is running or not Seconds_Behind_Source - the difference of seconds when a statement was executed on Primary and then on Replica. This indicates how much replication lag is there. Source_UUID - the uuid of the primary host Retrieved_Gtid_Set - the GTIDs fetched from the primary host by the replica to be executed. Executed_Gtid_Set - the GTIDs executed on the replica. This set remains the same for the entire cluster if the replicas are in sync. Auto_Position - it directs the replica to fetch the next GTID automatically Create a Replica for the already setup cluster The steps discussed in the previous section talks about the setting up replication on two fresh hosts. When we have to set up a replica for a host which is already serving applications, then the backup of the primary is used, either fresh backup taken for the replica (should only be done if the traffic it is serving is less) or use a recently taken backup. If the size of the databases on the MySQL primary server is small, less than 100G recommended, then mysqldump can be used to take backup along with the following options. mysqldump -uroot -p -hhost_ip -P3306 --all-databases --single-transaction --master-data=1 > primary_host.bkp --single-transaction - this option starts a transaction before taking the backup which ensures it is consistent. As transactions are isolated from each other, so no other writes affect the backup. --master-data - this option is required if binlog based replication is desired to be set up. It includes the binary log file and log file position in the backup file. When GTID mode is enabled and mysqldump is executed, it includes the GTID executed to be used to start the replica after the backup position. The contents of the mysqldump output file will have the following It is recommended to comment these before restoring otherwise they could throw errors. Also, using master-data=2 will automatically comment the master_log_file line. Similarly, when taking backup of the host using xtrabackup , the file xtrabckup_info file contains the information about binlog file and file position, as well as the GTID executed set. server_version = 8.0.25 start_time = 2021-06-22 03:45:17 end_time = 2021-06-22 03:45:20 lock_time = 0 binlog_pos = filename 'mysql-bin.000007', position '196', GTID of the last change 'e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-5' innodb_from_lsn = 0 innodb_to_lsn = 18153149 partial = N incremental = N format = file compressed = N encrypted = N Now, after setting MySQL server on the desired host, restore the backup taken from any one of the above methods. If the intended way is binlog based replication, then use the binlog file and position info in the following command change Replication Source to source_host = \u2018primary_ip\u2019, source_port = 3306, source_user = \u2018repl_user\u2019, source_password = \u2018xxxxx\u2019, source_log_file = \u2018mysql-bin.000007\u2019, source_log_pos = \u2018196\u2019; If the replication needs to be set via GITDs, then run the below command to tell the replica about the GTIDs already executed. On the Replica host, run th following commands reset master; set global gtid_purged = \u2018e17d0920-d00e-11eb-a3e6-000d3aa00f87:1-5\u2019 change replication source to source_host = \u2018primary_ip\u2019, source_port = 3306, source_user = \u2018repl_user\u2019, source_password = \u2018xxxxx\u2019, source_auto_position = 1 The reset master command resets the position of the binary log to initial. It can be skipped if the host is a freshly installed MySQL, but we restored a backup so it is necessary. The gtid_purged global variable lets the replica know the GTIDs that have already been executed, so that the replication can start after that. Then in the change source command, we set the auto-position to 1 which automatically gets the next GTID to proceed.","title":"Setting up Replication"},{"location":"level101/databases_sql/replication/#further-reading","text":"More applications of Replication Automtaed Failovers using MySQL Orchestrator","title":"Further Reading"},{"location":"level101/databases_sql/select_query/","text":"SELECT Query The most commonly used command while working with MySQL is SELECT. It is used to fetch the result set from one or more tables. The general form of a typical select query looks like:- SELECT expr FROM table1 [WHERE condition] [GROUP BY column_list HAVING condition] [ORDER BY column_list ASC|DESC] [LIMIT #] The above general form contains some commonly used clauses of a SELECT query:- expr - comma-separated column list or * (for all columns) WHERE - a condition is provided, if true, directs the query to select only those records. GROUP BY - groups the entire result set based on the column list provided. An aggregate function is recommended to be present in the select expression of the query. HAVING supports grouping by putting a condition on the selected or any other aggregate function. ORDER BY - sorts the result set based on the column list in ascending or descending order. LIMIT - commonly used to limit the number of records. Let\u2019s have a look at some examples for a better understanding of the above. The dataset used for the examples below is available here and is free to use. Select all records mysql> select * from employees limit 5; +--------+------------+------------+-----------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-----------+--------+------------+ | 10001 | 1953-09-02 | Georgi | Facello | M | 1986-06-26 | | 10002 | 1964-06-02 | Bezalel | Simmel | F | 1985-11-21 | | 10003 | 1959-12-03 | Parto | Bamford | M | 1986-08-28 | | 10004 | 1954-05-01 | Chirstian | Koblick | M | 1986-12-01 | | 10005 | 1955-01-21 | Kyoichi | Maliniak | M | 1989-09-12 | +--------+------------+------------+-----------+--------+------------+ 5 rows in set (0.00 sec) Select specific fields for all records mysql> select first_name, last_name, gender from employees limit 5; +------------+-----------+--------+ | first_name | last_name | gender | +------------+-----------+--------+ | Georgi | Facello | M | | Bezalel | Simmel | F | | Parto | Bamford | M | | Chirstian | Koblick | M | | Kyoichi | Maliniak | M | +------------+-----------+--------+ 5 rows in set (0.00 sec) Select all records Where hire_date >= January 1, 1990 mysql> select * from employees where hire_date >= '1990-01-01' limit 5; +--------+------------+------------+-------------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-------------+--------+------------+ | 10008 | 1958-02-19 | Saniya | Kalloufi | M | 1994-09-15 | | 10011 | 1953-11-07 | Mary | Sluis | F | 1990-01-22 | | 10012 | 1960-10-04 | Patricio | Bridgland | M | 1992-12-18 | | 10016 | 1961-05-02 | Kazuhito | Cappelletti | M | 1995-01-27 | | 10017 | 1958-07-06 | Cristinel | Bouloucos | F | 1993-08-03 | +--------+------------+------------+-------------+--------+------------+ 5 rows in set (0.01 sec) Select first_name and last_name from all records Where birth_date >= 1960 AND gender = \u2018F\u2019 mysql> select first_name, last_name from employees where year(birth_date) >= 1960 and gender='F' limit 5; +------------+-----------+ | first_name | last_name | +------------+-----------+ | Bezalel | Simmel | | Duangkaew | Piveteau | | Divier | Reistad | | Jeong | Reistad | | Mingsen | Casley | +------------+-----------+ 5 rows in set (0.00 sec) Display the total number of records mysql> select count(*) from employees; +----------+ | count(*) | +----------+ | 300024 | +----------+ 1 row in set (0.05 sec) Display gender-wise count of all records mysql> select gender, count(*) from employees group by gender; +--------+----------+ | gender | count(*) | +--------+----------+ | M | 179973 | | F | 120051 | +--------+----------+ 2 rows in set (0.14 sec) Display the year of hire_date and number of employees hired that year, also only those years where more than 20k employees were hired mysql> select year(hire_date), count(*) from employees group by year(hire_date) having count(*) > 20000; +-----------------+----------+ | year(hire_date) | count(*) | +-----------------+----------+ | 1985 | 35316 | | 1986 | 36150 | | 1987 | 33501 | | 1988 | 31436 | | 1989 | 28394 | | 1990 | 25610 | | 1991 | 22568 | | 1992 | 20402 | +-----------------+----------+ 8 rows in set (0.14 sec) Display all records ordered by their hire_date in descending order. If hire_date is the same then in order of their birth_date ascending order mysql> select * from employees order by hire_date desc, birth_date asc limit 5; +--------+------------+------------+-----------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-----------+--------+------------+ | 463807 | 1964-06-12 | Bikash | Covnot | M | 2000-01-28 | | 428377 | 1957-05-09 | Yucai | Gerlach | M | 2000-01-23 | | 499553 | 1954-05-06 | Hideyuki | Delgrande | F | 2000-01-22 | | 222965 | 1959-08-07 | Volkmar | Perko | F | 2000-01-13 | | 47291 | 1960-09-09 | Ulf | Flexer | M | 2000-01-12 | +--------+------------+------------+-----------+--------+------------+ 5 rows in set (0.12 sec) SELECT - JOINS JOIN statement is used to produce a combined result set from two or more tables based on certain conditions. It can be also used with Update and Delete statements but we will be focussing on the select query. Following is a basic general form for joins SELECT table1.col1, table2.col1, ... (any combination) FROM table1 table2 ON (or USING depends on join_type) table1.column_for_joining = table2.column_for_joining WHERE \u2026 Any number of columns can be selected, but it is recommended to select only those which are relevant to increase the readability of the resultset. All other clauses like where, group by are not mandatory. Let\u2019s discuss the types of JOINs supported by MySQL Syntax. Inner Join This joins table A with table B on a condition. Only the records where the condition is True are selected in the resultset. Display some details of employees along with their salary mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e join salaries s on e.emp_no=s.emp_no limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Similar result can be achieved by mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e join salaries s using (emp_no) limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) And also by mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e natural join salaries s limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Outer Join Majorly of two types:- - LEFT - joining complete table A with table B on a condition. All the records from table A are selected, but from table B, only those records are selected where the condition is True. - RIGHT - Exact opposite of the left join. Let us assume the below tables for understanding left join better. mysql> select * from dummy1; +----------+------------+ | same_col | diff_col_1 | +----------+------------+ | 1 | A | | 2 | B | | 3 | C | +----------+------------+ mysql> select * from dummy2; +----------+------------+ | same_col | diff_col_2 | +----------+------------+ | 1 | X | | 3 | Y | +----------+------------+ A simple select join will look like the one below. mysql> select * from dummy1 d1 left join dummy2 d2 on d1.same_col=d2.same_col; +----------+------------+----------+------------+ | same_col | diff_col_1 | same_col | diff_col_2 | +----------+------------+----------+------------+ | 1 | A | 1 | X | | 3 | C | 3 | Y | | 2 | B | NULL | NULL | +----------+------------+----------+------------+ 3 rows in set (0.00 sec) Which can also be written as mysql> select * from dummy1 d1 left join dummy2 d2 using(same_col); +----------+------------+------------+ | same_col | diff_col_1 | diff_col_2 | +----------+------------+------------+ | 1 | A | X | | 3 | C | Y | | 2 | B | NULL | +----------+------------+------------+ 3 rows in set (0.00 sec) And also as mysql> select * from dummy1 d1 natural left join dummy2 d2; +----------+------------+------------+ | same_col | diff_col_1 | diff_col_2 | +----------+------------+------------+ | 1 | A | X | | 3 | C | Y | | 2 | B | NULL | +----------+------------+------------+ 3 rows in set (0.00 sec) Cross Join This does a cross product of table A and table B without any condition. It doesn\u2019t have a lot of applications in the real world. A Simple Cross Join looks like this mysql> select * from dummy1 cross join dummy2; +----------+------------+----------+------------+ | same_col | diff_col_1 | same_col | diff_col_2 | +----------+------------+----------+------------+ | 1 | A | 3 | Y | | 1 | A | 1 | X | | 2 | B | 3 | Y | | 2 | B | 1 | X | | 3 | C | 3 | Y | | 3 | C | 1 | X | +----------+------------+----------+------------+ 6 rows in set (0.01 sec) One use case that can come in handy is when you have to fill in some missing entries. For example, all the entries from dummy1 must be inserted into a similar table dummy3, with each record must have 3 entries with statuses 1, 5 and 7. mysql> desc dummy3; +----------+----------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +----------+----------+------+-----+---------+-------+ | same_col | int | YES | | NULL | | | value | char(15) | YES | | NULL | | | status | smallint | YES | | NULL | | +----------+----------+------+-----+---------+-------+ 3 rows in set (0.02 sec) Either you create an insert query script with as many entries as in dummy1 or use cross join to produce the required resultset. mysql> select * from dummy1 cross join (select 1 union select 5 union select 7) T2 order by same_col; +----------+------------+---+ | same_col | diff_col_1 | 1 | +----------+------------+---+ | 1 | A | 1 | | 1 | A | 5 | | 1 | A | 7 | | 2 | B | 1 | | 2 | B | 5 | | 2 | B | 7 | | 3 | C | 1 | | 3 | C | 5 | | 3 | C | 7 | +----------+------------+---+ 9 rows in set (0.00 sec) The T2 section in the above query is called a sub-query . We will discuss the same in the next section. Natural Join This implicitly selects the common column from table A and table B and performs an inner join. mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e natural join salaries s limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Notice how natural join and using takes care that the common column is displayed only once if you are not explicitly selecting columns for the query. Some More Examples Display emp_no, salary, title and dept of the employees where salary > 80000 mysql> select e.emp_no, s.salary, t.title, d.dept_no from employees e join salaries s using (emp_no) join titles t using (emp_no) join dept_emp d using (emp_no) where s.salary > 80000 limit 5; +--------+--------+--------------+---------+ | emp_no | salary | title | dept_no | +--------+--------+--------------+---------+ | 10017 | 82163 | Senior Staff | d001 | | 10017 | 86157 | Senior Staff | d001 | | 10017 | 89619 | Senior Staff | d001 | | 10017 | 91985 | Senior Staff | d001 | | 10017 | 96122 | Senior Staff | d001 | +--------+--------+--------------+---------+ 5 rows in set (0.00 sec) Display title-wise count of employees in each department order by dept_no mysql> select d.dept_no, t.title, count(*) from titles t left join dept_emp d using (emp_no) group by d.dept_no, t.title order by d.dept_no limit 10; +---------+--------------------+----------+ | dept_no | title | count(*) | +---------+--------------------+----------+ | d001 | Manager | 2 | | d001 | Senior Staff | 13940 | | d001 | Staff | 16196 | | d002 | Manager | 2 | | d002 | Senior Staff | 12139 | | d002 | Staff | 13929 | | d003 | Manager | 2 | | d003 | Senior Staff | 12274 | | d003 | Staff | 14342 | | d004 | Assistant Engineer | 6445 | +---------+--------------------+----------+ 10 rows in set (1.32 sec) SELECT - Subquery A subquery is generally a smaller resultset that can be used to power a select query in many ways. It can be used in a \u2018where\u2019 condition, can be used in place of join mostly where a join could be an overkill. These subqueries are also termed as derived tables. They must have a table alias in the select query. Let\u2019s look at some examples of subqueries. Here we got the department name from the departments table by a subquery which used dept_no from dept_emp table. mysql> select e.emp_no, (select dept_name from departments where dept_no=d.dept_no) dept_name from employees e join dept_emp d using (emp_no) limit 5; +--------+-----------------+ | emp_no | dept_name | +--------+-----------------+ | 10001 | Development | | 10002 | Sales | | 10003 | Production | | 10004 | Production | | 10005 | Human Resources | +--------+-----------------+ 5 rows in set (0.01 sec) Here, we used the \u2018avg\u2019 query above (which got the avg salary) as a subquery to list the employees whose latest salary is more than the average. mysql> select avg(salary) from salaries; +-------------+ | avg(salary) | +-------------+ | 63810.7448 | +-------------+ 1 row in set (0.80 sec) mysql> select e.emp_no, max(s.salary) from employees e natural join salaries s group by e.emp_no having max(s.salary) > (select avg(salary) from salaries) limit 10; +--------+---------------+ | emp_no | max(s.salary) | +--------+---------------+ | 10001 | 88958 | | 10002 | 72527 | | 10004 | 74057 | | 10005 | 94692 | | 10007 | 88070 | | 10009 | 94443 | | 10010 | 80324 | | 10013 | 68901 | | 10016 | 77935 | | 10017 | 99651 | +--------+---------------+ 10 rows in set (0.56 sec)","title":"Select Query"},{"location":"level101/databases_sql/select_query/#select-query","text":"The most commonly used command while working with MySQL is SELECT. It is used to fetch the result set from one or more tables. The general form of a typical select query looks like:- SELECT expr FROM table1 [WHERE condition] [GROUP BY column_list HAVING condition] [ORDER BY column_list ASC|DESC] [LIMIT #] The above general form contains some commonly used clauses of a SELECT query:- expr - comma-separated column list or * (for all columns) WHERE - a condition is provided, if true, directs the query to select only those records. GROUP BY - groups the entire result set based on the column list provided. An aggregate function is recommended to be present in the select expression of the query. HAVING supports grouping by putting a condition on the selected or any other aggregate function. ORDER BY - sorts the result set based on the column list in ascending or descending order. LIMIT - commonly used to limit the number of records. Let\u2019s have a look at some examples for a better understanding of the above. The dataset used for the examples below is available here and is free to use. Select all records mysql> select * from employees limit 5; +--------+------------+------------+-----------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-----------+--------+------------+ | 10001 | 1953-09-02 | Georgi | Facello | M | 1986-06-26 | | 10002 | 1964-06-02 | Bezalel | Simmel | F | 1985-11-21 | | 10003 | 1959-12-03 | Parto | Bamford | M | 1986-08-28 | | 10004 | 1954-05-01 | Chirstian | Koblick | M | 1986-12-01 | | 10005 | 1955-01-21 | Kyoichi | Maliniak | M | 1989-09-12 | +--------+------------+------------+-----------+--------+------------+ 5 rows in set (0.00 sec) Select specific fields for all records mysql> select first_name, last_name, gender from employees limit 5; +------------+-----------+--------+ | first_name | last_name | gender | +------------+-----------+--------+ | Georgi | Facello | M | | Bezalel | Simmel | F | | Parto | Bamford | M | | Chirstian | Koblick | M | | Kyoichi | Maliniak | M | +------------+-----------+--------+ 5 rows in set (0.00 sec) Select all records Where hire_date >= January 1, 1990 mysql> select * from employees where hire_date >= '1990-01-01' limit 5; +--------+------------+------------+-------------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-------------+--------+------------+ | 10008 | 1958-02-19 | Saniya | Kalloufi | M | 1994-09-15 | | 10011 | 1953-11-07 | Mary | Sluis | F | 1990-01-22 | | 10012 | 1960-10-04 | Patricio | Bridgland | M | 1992-12-18 | | 10016 | 1961-05-02 | Kazuhito | Cappelletti | M | 1995-01-27 | | 10017 | 1958-07-06 | Cristinel | Bouloucos | F | 1993-08-03 | +--------+------------+------------+-------------+--------+------------+ 5 rows in set (0.01 sec) Select first_name and last_name from all records Where birth_date >= 1960 AND gender = \u2018F\u2019 mysql> select first_name, last_name from employees where year(birth_date) >= 1960 and gender='F' limit 5; +------------+-----------+ | first_name | last_name | +------------+-----------+ | Bezalel | Simmel | | Duangkaew | Piveteau | | Divier | Reistad | | Jeong | Reistad | | Mingsen | Casley | +------------+-----------+ 5 rows in set (0.00 sec) Display the total number of records mysql> select count(*) from employees; +----------+ | count(*) | +----------+ | 300024 | +----------+ 1 row in set (0.05 sec) Display gender-wise count of all records mysql> select gender, count(*) from employees group by gender; +--------+----------+ | gender | count(*) | +--------+----------+ | M | 179973 | | F | 120051 | +--------+----------+ 2 rows in set (0.14 sec) Display the year of hire_date and number of employees hired that year, also only those years where more than 20k employees were hired mysql> select year(hire_date), count(*) from employees group by year(hire_date) having count(*) > 20000; +-----------------+----------+ | year(hire_date) | count(*) | +-----------------+----------+ | 1985 | 35316 | | 1986 | 36150 | | 1987 | 33501 | | 1988 | 31436 | | 1989 | 28394 | | 1990 | 25610 | | 1991 | 22568 | | 1992 | 20402 | +-----------------+----------+ 8 rows in set (0.14 sec) Display all records ordered by their hire_date in descending order. If hire_date is the same then in order of their birth_date ascending order mysql> select * from employees order by hire_date desc, birth_date asc limit 5; +--------+------------+------------+-----------+--------+------------+ | emp_no | birth_date | first_name | last_name | gender | hire_date | +--------+------------+------------+-----------+--------+------------+ | 463807 | 1964-06-12 | Bikash | Covnot | M | 2000-01-28 | | 428377 | 1957-05-09 | Yucai | Gerlach | M | 2000-01-23 | | 499553 | 1954-05-06 | Hideyuki | Delgrande | F | 2000-01-22 | | 222965 | 1959-08-07 | Volkmar | Perko | F | 2000-01-13 | | 47291 | 1960-09-09 | Ulf | Flexer | M | 2000-01-12 | +--------+------------+------------+-----------+--------+------------+ 5 rows in set (0.12 sec)","title":"SELECT Query"},{"location":"level101/databases_sql/select_query/#select-joins","text":"JOIN statement is used to produce a combined result set from two or more tables based on certain conditions. It can be also used with Update and Delete statements but we will be focussing on the select query. Following is a basic general form for joins SELECT table1.col1, table2.col1, ... (any combination) FROM table1 table2 ON (or USING depends on join_type) table1.column_for_joining = table2.column_for_joining WHERE \u2026 Any number of columns can be selected, but it is recommended to select only those which are relevant to increase the readability of the resultset. All other clauses like where, group by are not mandatory. Let\u2019s discuss the types of JOINs supported by MySQL Syntax. Inner Join This joins table A with table B on a condition. Only the records where the condition is True are selected in the resultset. Display some details of employees along with their salary mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e join salaries s on e.emp_no=s.emp_no limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Similar result can be achieved by mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e join salaries s using (emp_no) limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) And also by mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e natural join salaries s limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Outer Join Majorly of two types:- - LEFT - joining complete table A with table B on a condition. All the records from table A are selected, but from table B, only those records are selected where the condition is True. - RIGHT - Exact opposite of the left join. Let us assume the below tables for understanding left join better. mysql> select * from dummy1; +----------+------------+ | same_col | diff_col_1 | +----------+------------+ | 1 | A | | 2 | B | | 3 | C | +----------+------------+ mysql> select * from dummy2; +----------+------------+ | same_col | diff_col_2 | +----------+------------+ | 1 | X | | 3 | Y | +----------+------------+ A simple select join will look like the one below. mysql> select * from dummy1 d1 left join dummy2 d2 on d1.same_col=d2.same_col; +----------+------------+----------+------------+ | same_col | diff_col_1 | same_col | diff_col_2 | +----------+------------+----------+------------+ | 1 | A | 1 | X | | 3 | C | 3 | Y | | 2 | B | NULL | NULL | +----------+------------+----------+------------+ 3 rows in set (0.00 sec) Which can also be written as mysql> select * from dummy1 d1 left join dummy2 d2 using(same_col); +----------+------------+------------+ | same_col | diff_col_1 | diff_col_2 | +----------+------------+------------+ | 1 | A | X | | 3 | C | Y | | 2 | B | NULL | +----------+------------+------------+ 3 rows in set (0.00 sec) And also as mysql> select * from dummy1 d1 natural left join dummy2 d2; +----------+------------+------------+ | same_col | diff_col_1 | diff_col_2 | +----------+------------+------------+ | 1 | A | X | | 3 | C | Y | | 2 | B | NULL | +----------+------------+------------+ 3 rows in set (0.00 sec) Cross Join This does a cross product of table A and table B without any condition. It doesn\u2019t have a lot of applications in the real world. A Simple Cross Join looks like this mysql> select * from dummy1 cross join dummy2; +----------+------------+----------+------------+ | same_col | diff_col_1 | same_col | diff_col_2 | +----------+------------+----------+------------+ | 1 | A | 3 | Y | | 1 | A | 1 | X | | 2 | B | 3 | Y | | 2 | B | 1 | X | | 3 | C | 3 | Y | | 3 | C | 1 | X | +----------+------------+----------+------------+ 6 rows in set (0.01 sec) One use case that can come in handy is when you have to fill in some missing entries. For example, all the entries from dummy1 must be inserted into a similar table dummy3, with each record must have 3 entries with statuses 1, 5 and 7. mysql> desc dummy3; +----------+----------+------+-----+---------+-------+ | Field | Type | Null | Key | Default | Extra | +----------+----------+------+-----+---------+-------+ | same_col | int | YES | | NULL | | | value | char(15) | YES | | NULL | | | status | smallint | YES | | NULL | | +----------+----------+------+-----+---------+-------+ 3 rows in set (0.02 sec) Either you create an insert query script with as many entries as in dummy1 or use cross join to produce the required resultset. mysql> select * from dummy1 cross join (select 1 union select 5 union select 7) T2 order by same_col; +----------+------------+---+ | same_col | diff_col_1 | 1 | +----------+------------+---+ | 1 | A | 1 | | 1 | A | 5 | | 1 | A | 7 | | 2 | B | 1 | | 2 | B | 5 | | 2 | B | 7 | | 3 | C | 1 | | 3 | C | 5 | | 3 | C | 7 | +----------+------------+---+ 9 rows in set (0.00 sec) The T2 section in the above query is called a sub-query . We will discuss the same in the next section. Natural Join This implicitly selects the common column from table A and table B and performs an inner join. mysql> select e.emp_no,e.first_name,e.last_name,s.salary from employees e natural join salaries s limit 5; +--------+------------+-----------+--------+ | emp_no | first_name | last_name | salary | +--------+------------+-----------+--------+ | 10001 | Georgi | Facello | 60117 | | 10001 | Georgi | Facello | 62102 | | 10001 | Georgi | Facello | 66074 | | 10001 | Georgi | Facello | 66596 | | 10001 | Georgi | Facello | 66961 | +--------+------------+-----------+--------+ 5 rows in set (0.00 sec) Notice how natural join and using takes care that the common column is displayed only once if you are not explicitly selecting columns for the query. Some More Examples Display emp_no, salary, title and dept of the employees where salary > 80000 mysql> select e.emp_no, s.salary, t.title, d.dept_no from employees e join salaries s using (emp_no) join titles t using (emp_no) join dept_emp d using (emp_no) where s.salary > 80000 limit 5; +--------+--------+--------------+---------+ | emp_no | salary | title | dept_no | +--------+--------+--------------+---------+ | 10017 | 82163 | Senior Staff | d001 | | 10017 | 86157 | Senior Staff | d001 | | 10017 | 89619 | Senior Staff | d001 | | 10017 | 91985 | Senior Staff | d001 | | 10017 | 96122 | Senior Staff | d001 | +--------+--------+--------------+---------+ 5 rows in set (0.00 sec) Display title-wise count of employees in each department order by dept_no mysql> select d.dept_no, t.title, count(*) from titles t left join dept_emp d using (emp_no) group by d.dept_no, t.title order by d.dept_no limit 10; +---------+--------------------+----------+ | dept_no | title | count(*) | +---------+--------------------+----------+ | d001 | Manager | 2 | | d001 | Senior Staff | 13940 | | d001 | Staff | 16196 | | d002 | Manager | 2 | | d002 | Senior Staff | 12139 | | d002 | Staff | 13929 | | d003 | Manager | 2 | | d003 | Senior Staff | 12274 | | d003 | Staff | 14342 | | d004 | Assistant Engineer | 6445 | +---------+--------------------+----------+ 10 rows in set (1.32 sec)","title":"SELECT - JOINS"},{"location":"level101/databases_sql/select_query/#select-subquery","text":"A subquery is generally a smaller resultset that can be used to power a select query in many ways. It can be used in a \u2018where\u2019 condition, can be used in place of join mostly where a join could be an overkill. These subqueries are also termed as derived tables. They must have a table alias in the select query. Let\u2019s look at some examples of subqueries. Here we got the department name from the departments table by a subquery which used dept_no from dept_emp table. mysql> select e.emp_no, (select dept_name from departments where dept_no=d.dept_no) dept_name from employees e join dept_emp d using (emp_no) limit 5; +--------+-----------------+ | emp_no | dept_name | +--------+-----------------+ | 10001 | Development | | 10002 | Sales | | 10003 | Production | | 10004 | Production | | 10005 | Human Resources | +--------+-----------------+ 5 rows in set (0.01 sec) Here, we used the \u2018avg\u2019 query above (which got the avg salary) as a subquery to list the employees whose latest salary is more than the average. mysql> select avg(salary) from salaries; +-------------+ | avg(salary) | +-------------+ | 63810.7448 | +-------------+ 1 row in set (0.80 sec) mysql> select e.emp_no, max(s.salary) from employees e natural join salaries s group by e.emp_no having max(s.salary) > (select avg(salary) from salaries) limit 10; +--------+---------------+ | emp_no | max(s.salary) | +--------+---------------+ | 10001 | 88958 | | 10002 | 72527 | | 10004 | 74057 | | 10005 | 94692 | | 10007 | 88070 | | 10009 | 94443 | | 10010 | 80324 | | 10013 | 68901 | | 10016 | 77935 | | 10017 | 99651 | +--------+---------------+ 10 rows in set (0.56 sec)","title":"SELECT - Subquery"},{"location":"level101/git/branches/","text":"Working With Branches Coming back to our local repo which has two commits. So far, what we have is a single line of history. Commits are chained in a single line. But sometimes you may have a need to work on two different features in parallel in the same repo. Now one option here could be making a new folder/repo with the same code and use that for another feature development. But there's a better way. Use branches. Since git follows tree like structure for commits, we can use branches to work on different sets of features. From a commit, two or more branches can be created and branches can also be merged. Using branches, there can exist multiple lines of histories and we can checkout to any of them and work on it. Checking out, as we discussed earlier, would simply mean replacing contents of the directory (repo) with the snapshot at the checked out version. Let's create a branch and see how it looks like: $ git branch b1 $ git log --oneline --graph * 7f3b00e (HEAD -> master, b1) adding file 2 * df2fb7a adding file 1 We create a branch called b1 . Git log tells us that b1 also points to the last commit (7f3b00e) but the HEAD is still pointing to master. If you remember, HEAD points to the commit/reference wherever you are checkout to. So if we checkout to b1 , HEAD should point to that. Let's confirm: $ git checkout b1 Switched to branch 'b1' $ git log --oneline --graph * 7f3b00e (HEAD -> b1, master) adding file 2 * df2fb7a adding file 1 b1 still points to the same commit but HEAD now points to b1 . Since we create a branch at commit 7f3b00e , there will be two lines of histories starting this commit. Depending on which branch you are checked out on, the line of history will progress. At this moment, we are checked out on branch b1 , so making a new commit will advance branch reference b1 to that commit and current b1 commit will become its parent. Let's do that. # Creating a file and making a commit $ echo \"I am a file in b1 branch\" > b1.txt $ git add b1.txt $ git commit -m \"adding b1 file\" [b1 872a38f] adding b1 file 1 file changed, 1 insertion(+) create mode 100644 b1.txt # The new line of history $ git log --oneline --graph * 872a38f (HEAD -> b1) adding b1 file * 7f3b00e (master) adding file 2 * df2fb7a adding file 1 $ Do note that master is still pointing to the old commit it was pointing to. We can now checkout to master branch and make commits there. This will result in another line of history starting from commit 7f3b00e. # checkout to master branch $ git checkout master Switched to branch 'master' # Creating a new commit on master branch $ echo \"new file in master branch\" > master.txt $ git add master.txt $ git commit -m \"adding master.txt file\" [master 60dc441] adding master.txt file 1 file changed, 1 insertion(+) create mode 100644 master.txt # The history line $ git log --oneline --graph * 60dc441 (HEAD -> master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 Notice how branch b1 is not visible here since we are on the master. Let's try to visualize both to get the whole picture: $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Above tree structure should make things clear. Notice a clear branch/fork on commit 7f3b00e. This is how we create branches. Now they both are two separate lines of history on which feature development can be done independently. To reiterate, internally, git is just a tree of commits. Branch names (human readable) are pointers to those commits in the tree. We use various git commands to work with the tree structure and references. Git accordingly modifies contents of our repo. Merges Now say the feature you were working on branch b1 is complete and you need to merge it on master branch, where all the final version of code goes. So first you will checkout to branch master and then you pull the latest code from upstream (eg: GitHub). Then you need to merge your code from b1 into master. There could be two ways this can be done. Here is the current history: $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Option 1: Directly merge the branch. Merging the branch b1 into master will result in a new merge commit. This will merge changes from two different lines of history and create a new commit of the result. $ git merge b1 Merge made by the 'recursive' strategy. b1.txt | 1 + 1 file changed, 1 insertion(+) create mode 100644 b1.txt $ git log --oneline --graph --all * 8fc28f9 (HEAD -> master) Merge branch 'b1' |\\ | * 872a38f (b1) adding b1 file * | 60dc441 adding master.txt file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 You can see a new merge commit created (8fc28f9). You will be prompted for the commit message. If there are a lot of branches in the repo, this result will end-up with a lot of merge commits. Which looks ugly compared to a single line of history of development. So let's look at an alternative approach First let's reset our last merge and go to the previous state. $ git reset --hard 60dc441 HEAD is now at 60dc441 adding master.txt file $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Option 2: Rebase. Now, instead of merging two branches which has a similar base (commit: 7f3b00e), let us rebase branch b1 on to current master. What this means is take branch b1 (from commit 7f3b00e to commit 872a38f) and rebase (put them on top of) master (60dc441). # Switch to b1 $ git checkout b1 Switched to branch 'b1' # Rebase (b1 which is current branch) on master $ git rebase master First, rewinding head to replay your work on top of it... Applying: adding b1 file # The result $ git log --oneline --graph --all * 5372c8f (HEAD -> b1) adding b1 file * 60dc441 (master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 You can see b1 which had 1 commit. That commit's parent was 7f3b00e . But since we rebase it on master ( 60dc441 ). That becomes the parent now. As a side effect, you also see it has become a single line of history. Now if we were to merge b1 into master , it would simply mean change master to point to 5372c8f which is b1 . Let's try it: # checkout to master since we want to merge code into master $ git checkout master Switched to branch 'master' # the current history, where b1 is based on master $ git log --oneline --graph --all * 5372c8f (b1) adding b1 file * 60dc441 (HEAD -> master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 # Performing the merge, notice the \"fast-forward\" message $ git merge b1 Updating 60dc441..5372c8f Fast-forward b1.txt | 1 + 1 file changed, 1 insertion(+) create mode 100644 b1.txt # The Result $ git log --oneline --graph --all * 5372c8f (HEAD -> master, b1) adding b1 file * 60dc441 adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 Now you see both b1 and master are pointing to the same commit. Your code has been merged to the master branch and it can be pushed. Also we have clean line of history! :D","title":"Working With Branches"},{"location":"level101/git/branches/#working-with-branches","text":"Coming back to our local repo which has two commits. So far, what we have is a single line of history. Commits are chained in a single line. But sometimes you may have a need to work on two different features in parallel in the same repo. Now one option here could be making a new folder/repo with the same code and use that for another feature development. But there's a better way. Use branches. Since git follows tree like structure for commits, we can use branches to work on different sets of features. From a commit, two or more branches can be created and branches can also be merged. Using branches, there can exist multiple lines of histories and we can checkout to any of them and work on it. Checking out, as we discussed earlier, would simply mean replacing contents of the directory (repo) with the snapshot at the checked out version. Let's create a branch and see how it looks like: $ git branch b1 $ git log --oneline --graph * 7f3b00e (HEAD -> master, b1) adding file 2 * df2fb7a adding file 1 We create a branch called b1 . Git log tells us that b1 also points to the last commit (7f3b00e) but the HEAD is still pointing to master. If you remember, HEAD points to the commit/reference wherever you are checkout to. So if we checkout to b1 , HEAD should point to that. Let's confirm: $ git checkout b1 Switched to branch 'b1' $ git log --oneline --graph * 7f3b00e (HEAD -> b1, master) adding file 2 * df2fb7a adding file 1 b1 still points to the same commit but HEAD now points to b1 . Since we create a branch at commit 7f3b00e , there will be two lines of histories starting this commit. Depending on which branch you are checked out on, the line of history will progress. At this moment, we are checked out on branch b1 , so making a new commit will advance branch reference b1 to that commit and current b1 commit will become its parent. Let's do that. # Creating a file and making a commit $ echo \"I am a file in b1 branch\" > b1.txt $ git add b1.txt $ git commit -m \"adding b1 file\" [b1 872a38f] adding b1 file 1 file changed, 1 insertion(+) create mode 100644 b1.txt # The new line of history $ git log --oneline --graph * 872a38f (HEAD -> b1) adding b1 file * 7f3b00e (master) adding file 2 * df2fb7a adding file 1 $ Do note that master is still pointing to the old commit it was pointing to. We can now checkout to master branch and make commits there. This will result in another line of history starting from commit 7f3b00e. # checkout to master branch $ git checkout master Switched to branch 'master' # Creating a new commit on master branch $ echo \"new file in master branch\" > master.txt $ git add master.txt $ git commit -m \"adding master.txt file\" [master 60dc441] adding master.txt file 1 file changed, 1 insertion(+) create mode 100644 master.txt # The history line $ git log --oneline --graph * 60dc441 (HEAD -> master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 Notice how branch b1 is not visible here since we are on the master. Let's try to visualize both to get the whole picture: $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Above tree structure should make things clear. Notice a clear branch/fork on commit 7f3b00e. This is how we create branches. Now they both are two separate lines of history on which feature development can be done independently. To reiterate, internally, git is just a tree of commits. Branch names (human readable) are pointers to those commits in the tree. We use various git commands to work with the tree structure and references. Git accordingly modifies contents of our repo.","title":"Working With Branches"},{"location":"level101/git/branches/#merges","text":"Now say the feature you were working on branch b1 is complete and you need to merge it on master branch, where all the final version of code goes. So first you will checkout to branch master and then you pull the latest code from upstream (eg: GitHub). Then you need to merge your code from b1 into master. There could be two ways this can be done. Here is the current history: $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Option 1: Directly merge the branch. Merging the branch b1 into master will result in a new merge commit. This will merge changes from two different lines of history and create a new commit of the result. $ git merge b1 Merge made by the 'recursive' strategy. b1.txt | 1 + 1 file changed, 1 insertion(+) create mode 100644 b1.txt $ git log --oneline --graph --all * 8fc28f9 (HEAD -> master) Merge branch 'b1' |\\ | * 872a38f (b1) adding b1 file * | 60dc441 adding master.txt file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 You can see a new merge commit created (8fc28f9). You will be prompted for the commit message. If there are a lot of branches in the repo, this result will end-up with a lot of merge commits. Which looks ugly compared to a single line of history of development. So let's look at an alternative approach First let's reset our last merge and go to the previous state. $ git reset --hard 60dc441 HEAD is now at 60dc441 adding master.txt file $ git log --oneline --graph --all * 60dc441 (HEAD -> master) adding master.txt file | * 872a38f (b1) adding b1 file |/ * 7f3b00e adding file 2 * df2fb7a adding file 1 Option 2: Rebase. Now, instead of merging two branches which has a similar base (commit: 7f3b00e), let us rebase branch b1 on to current master. What this means is take branch b1 (from commit 7f3b00e to commit 872a38f) and rebase (put them on top of) master (60dc441). # Switch to b1 $ git checkout b1 Switched to branch 'b1' # Rebase (b1 which is current branch) on master $ git rebase master First, rewinding head to replay your work on top of it... Applying: adding b1 file # The result $ git log --oneline --graph --all * 5372c8f (HEAD -> b1) adding b1 file * 60dc441 (master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 You can see b1 which had 1 commit. That commit's parent was 7f3b00e . But since we rebase it on master ( 60dc441 ). That becomes the parent now. As a side effect, you also see it has become a single line of history. Now if we were to merge b1 into master , it would simply mean change master to point to 5372c8f which is b1 . Let's try it: # checkout to master since we want to merge code into master $ git checkout master Switched to branch 'master' # the current history, where b1 is based on master $ git log --oneline --graph --all * 5372c8f (b1) adding b1 file * 60dc441 (HEAD -> master) adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 # Performing the merge, notice the \"fast-forward\" message $ git merge b1 Updating 60dc441..5372c8f Fast-forward b1.txt | 1 + 1 file changed, 1 insertion(+) create mode 100644 b1.txt # The Result $ git log --oneline --graph --all * 5372c8f (HEAD -> master, b1) adding b1 file * 60dc441 adding master.txt file * 7f3b00e adding file 2 * df2fb7a adding file 1 Now you see both b1 and master are pointing to the same commit. Your code has been merged to the master branch and it can be pushed. Also we have clean line of history! :D","title":"Merges"},{"location":"level101/git/conclusion/","text":"What next from here? There are a lot of git commands and features which we have not explored here. But with the base built-up, be sure to explore concepts like Cherrypick Squash Amend Stash Reset","title":"Conclusion"},{"location":"level101/git/conclusion/#what-next-from-here","text":"There are a lot of git commands and features which we have not explored here. But with the base built-up, be sure to explore concepts like Cherrypick Squash Amend Stash Reset","title":"What next from here?"},{"location":"level101/git/git-basics/","text":"Git Prerequisites Have Git installed https://git-scm.com/downloads Have taken any git high level tutorial or following LinkedIn learning courses https://www.linkedin.com/learning/git-essential-training-the-basics/ https://www.linkedin.com/learning/git-branches-merges-and-remotes/ The Official Git Docs What to expect from this course As an engineer in the field of computer science, having knowledge of version control tools becomes almost a requirement. While there are a lot of version control tools that exist today like SVN, Mercurial, etc, Git perhaps is the most used one and this course we will be working with Git. While this course does not start with Git 101 and expects basic knowledge of git as a prerequisite, it will reintroduce the git concepts known by you with details covering what is happening under the hood as you execute various git commands. So that next time you run a git command, you will be able to press enter more confidently! What is not covered under this course Advanced usage and specifics of internal implementation details of Git. Course Contents Git Basics Working with Branches Git with Github Hooks Git Basics Though you might be aware already, let's revisit why we need a version control system. As the project grows and multiple developers start working on it, an efficient method for collaboration is warranted. Git helps the team collaborate easily and also maintains the history of the changes happening with the codebase. Creating a Git Repo Any folder can be converted into a git repository. After executing the following command, we will see a .git folder within the folder, which makes our folder a git repository. All the magic that git does, .git folder is the enabler for the same. # creating an empty folder and changing current dir to it $ cd /tmp $ mkdir school-of-sre $ cd school-of-sre/ # initialize a git repo $ git init Initialized empty Git repository in /private/tmp/school-of-sre/.git/ As the output says, an empty git repo has been initialized in our folder. Let's take a look at what is there. $ ls .git/ HEAD config description hooks info objects refs There are a bunch of folders and files in the .git folder. As I said, all these enables git to do its magic. We will look into some of these folders and files. But for now, what we have is an empty git repository. Tracking a File Now as you might already know, let us create a new file in our repo (we will refer to the folder as repo now.) And see git status $ echo \"I am file 1\" > file1.txt $ git status On branch master No commits yet Untracked files: (use \"git add ...\" to include in what will be committed) file1.txt nothing added to commit but untracked files present (use \"git add\" to track) The current git status says No commits yet and there is one untracked file. Since we just created the file, git is not tracking that file. We explicitly need to ask git to track files and folders. (also checkout gitignore ) And how we do that is via git add command as suggested in the above output. Then we go ahead and create a commit. $ git add file1.txt $ git status On branch master No commits yet Changes to be committed: (use \"git rm --cached ...\" to unstage) new file: file1.txt $ git commit -m \"adding file 1\" [master (root-commit) df2fb7a] adding file 1 1 file changed, 1 insertion(+) create mode 100644 file1.txt Notice how after adding the file, git status says Changes to be committed: . What it means is whatever is listed there, will be included in the next commit. Then we go ahead and create a commit, with an attached messaged via -m . More About a Commit Commit is a snapshot of the repo. Whenever a commit is made, a snapshot of the current state of repo (the folder) is taken and saved. Each commit has a unique ID. ( df2fb7a for the commit we made in the previous step). As we keep adding/changing more and more contents and keep making commits, all those snapshots are stored by git. Again, all this magic happens inside the .git folder. This is where all this snapshot or versions are stored in an efficient manner. Adding More Changes Let us create one more file and commit the change. It would look the same as the previous commit we made. $ echo \"I am file 2\" > file2.txt $ git add file2.txt $ git commit -m \"adding file 2\" [master 7f3b00e] adding file 2 1 file changed, 1 insertion(+) create mode 100644 file2.txt A new commit with ID 7f3b00e has been created. You can issue git status at any time to see the state of the repository. **IMPORTANT: Note that commit IDs are long string (SHA) but we can refer to a commit by its initial few (8 or more) characters too. We will interchangeably using shorter and longer commit IDs.** Now that we have two commits, let's visualize them: $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 git log , as the name suggests, prints the log of all the git commits. Here you see two additional arguments, --oneline prints the shorter version of the log, ie: the commit message only and not the person who made the commit and when. --graph prints it in graph format. Now at this moment the commits might look like just one in each line but all commits are stored as a tree like data structure internally by git. That means there can be two or more children commits of a given commit. And not just a single line of commits. We will look more into this part when we get to the Branches section. For now this is our commit history: df2fb7a ===> 7f3b00e Are commits really linked? As I just said, the two commits we just made are linked via tree like data structure and we saw how they are linked. But let's actually verify it. Everything in git is an object. Newly created files are stored as an object. Changes to file are stored as an objects and even commits are objects. To view contents of an object we can use the following command with the object's ID. We will take a look at the contents of the second commit $ git cat-file -p 7f3b00e tree ebf3af44d253e5328340026e45a9fa9ae3ea1982 parent df2fb7a61f5d40c1191e0fdeb0fc5d6e7969685a author Sanket Patel 1603273316 -0700 committer Sanket Patel 1603273316 -0700 adding file 2 Take a note of parent attribute in the above output. It points to the commit id of the first commit we made. So this proves that they are linked! Additionally you can see the second commit's message in this object. As I said all this magic is enabled by .git folder and the object to which we are looking at also is in that folder. $ ls .git/objects/7f/3b00eaa957815884198e2fdfec29361108d6a9 .git/objects/7f/3b00eaa957815884198e2fdfec29361108d6a9 It is stored in .git/objects/ folder. All the files and changes to them as well are stored in this folder. The Version Control part of Git We already can see two commits (versions) in our git log. One thing a version control tool gives you is ability to browse back and forth in history. For example: some of your users are running an old version of code and they are reporting an issue. In order to debug the issue, you need access to the old code. The one in your current repo is the latest code. In this example, you are working on the second commit (7f3b00e) and someone reported an issue with the code snapshot at commit (df2fb7a). This is how you would get access to the code at any older commit # Current contents, two files present $ ls file1.txt file2.txt # checking out to (an older) commit $ git checkout df2fb7a Note: checking out 'df2fb7a'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by performing another checkout. If you want to create a new branch to retain commits you create, you may do so (now or later) by using -b with the checkout command again. Example: git checkout -b HEAD is now at df2fb7a adding file 1 # checking contents, can verify it has old contents $ ls file1.txt So this is how we would get access to old versions/snapshots. All we need is a reference to that snapshot. Upon executing git checkout ... , what git does for you is use the .git folder, see what was the state of things (files and folders) at that version/reference and replace the contents of current directory with those contents. The then-existing content will no longer be present in the local dir (repo) but we can and will still get access to them because they are tracked via git commit and .git folder has them stored/tracked. Reference I mention in the previous section that we need a reference to the version. By default, git repo is made of tree of commits. And each commit has a unique IDs. But the unique ID is not the only thing we can reference commits via. There are multiple ways to reference commits. For example: HEAD is a reference to current commit. Whatever commit your repo is checked out at, HEAD will point to that. HEAD~1 is reference to previous commit. So while checking out previous version in section above, we could have done git checkout HEAD~1 . Similarly, master is also a reference (to a branch). Since git uses tree like structure to store commits, there of course will be branches. And the default branch is called master . Master (or any branch reference) will point to the latest commit in the branch. Even though we have checked out to the previous commit in out repo, master still points to the latest commit. And we can get back to the latest version by checkout at master reference $ git checkout master Previous HEAD position was df2fb7a adding file 1 Switched to branch 'master' # now we will see latest code, with two files $ ls file1.txt file2.txt Note, instead of master in above command, we could have used commit's ID as well. References and The Magic Let's look at the state of things. Two commits, master and HEAD references are pointing to the latest commit $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 The magic? Let's examine these files: $ cat .git/refs/heads/master 7f3b00eaa957815884198e2fdfec29361108d6a9 Viola! Where master is pointing to is stored in a file. Whenever git needs to know where master reference is pointing to, or if git needs to update where master points, it just needs to update the file above. So when you create a new commit, a new commit is created on top of the current commit and the master file is updated with the new commit's ID. Similary, for HEAD reference: $ cat .git/HEAD ref: refs/heads/master We can see HEAD is pointing to a reference called refs/heads/master . So HEAD will point where ever the master points. Little Adventure We discussed how git will update the files as we execute commands. But let's try to do it ourselves, by hand, and see what happens. $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 Now let's change master to point to the previous/first commit. $ echo df2fb7a61f5d40c1191e0fdeb0fc5d6e7969685a > .git/refs/heads/master $ git log --oneline --graph * df2fb7a (HEAD -> master) adding file 1 # RESETTING TO ORIGINAL $ echo 7f3b00eaa957815884198e2fdfec29361108d6a9 > .git/refs/heads/master $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 We just edited the master reference file and now we can see only the first commit in git log. Undoing the change to the file brings the state back to original. Not so much of magic, is it?","title":"Git Basics"},{"location":"level101/git/git-basics/#git","text":"","title":"Git"},{"location":"level101/git/git-basics/#prerequisites","text":"Have Git installed https://git-scm.com/downloads Have taken any git high level tutorial or following LinkedIn learning courses https://www.linkedin.com/learning/git-essential-training-the-basics/ https://www.linkedin.com/learning/git-branches-merges-and-remotes/ The Official Git Docs","title":"Prerequisites"},{"location":"level101/git/git-basics/#what-to-expect-from-this-course","text":"As an engineer in the field of computer science, having knowledge of version control tools becomes almost a requirement. While there are a lot of version control tools that exist today like SVN, Mercurial, etc, Git perhaps is the most used one and this course we will be working with Git. While this course does not start with Git 101 and expects basic knowledge of git as a prerequisite, it will reintroduce the git concepts known by you with details covering what is happening under the hood as you execute various git commands. So that next time you run a git command, you will be able to press enter more confidently!","title":"What to expect from this course"},{"location":"level101/git/git-basics/#what-is-not-covered-under-this-course","text":"Advanced usage and specifics of internal implementation details of Git.","title":"What is not covered under this course"},{"location":"level101/git/git-basics/#course-contents","text":"Git Basics Working with Branches Git with Github Hooks","title":"Course Contents"},{"location":"level101/git/git-basics/#git-basics","text":"Though you might be aware already, let's revisit why we need a version control system. As the project grows and multiple developers start working on it, an efficient method for collaboration is warranted. Git helps the team collaborate easily and also maintains the history of the changes happening with the codebase.","title":"Git Basics"},{"location":"level101/git/git-basics/#creating-a-git-repo","text":"Any folder can be converted into a git repository. After executing the following command, we will see a .git folder within the folder, which makes our folder a git repository. All the magic that git does, .git folder is the enabler for the same. # creating an empty folder and changing current dir to it $ cd /tmp $ mkdir school-of-sre $ cd school-of-sre/ # initialize a git repo $ git init Initialized empty Git repository in /private/tmp/school-of-sre/.git/ As the output says, an empty git repo has been initialized in our folder. Let's take a look at what is there. $ ls .git/ HEAD config description hooks info objects refs There are a bunch of folders and files in the .git folder. As I said, all these enables git to do its magic. We will look into some of these folders and files. But for now, what we have is an empty git repository.","title":"Creating a Git Repo"},{"location":"level101/git/git-basics/#tracking-a-file","text":"Now as you might already know, let us create a new file in our repo (we will refer to the folder as repo now.) And see git status $ echo \"I am file 1\" > file1.txt $ git status On branch master No commits yet Untracked files: (use \"git add ...\" to include in what will be committed) file1.txt nothing added to commit but untracked files present (use \"git add\" to track) The current git status says No commits yet and there is one untracked file. Since we just created the file, git is not tracking that file. We explicitly need to ask git to track files and folders. (also checkout gitignore ) And how we do that is via git add command as suggested in the above output. Then we go ahead and create a commit. $ git add file1.txt $ git status On branch master No commits yet Changes to be committed: (use \"git rm --cached ...\" to unstage) new file: file1.txt $ git commit -m \"adding file 1\" [master (root-commit) df2fb7a] adding file 1 1 file changed, 1 insertion(+) create mode 100644 file1.txt Notice how after adding the file, git status says Changes to be committed: . What it means is whatever is listed there, will be included in the next commit. Then we go ahead and create a commit, with an attached messaged via -m .","title":"Tracking a File"},{"location":"level101/git/git-basics/#more-about-a-commit","text":"Commit is a snapshot of the repo. Whenever a commit is made, a snapshot of the current state of repo (the folder) is taken and saved. Each commit has a unique ID. ( df2fb7a for the commit we made in the previous step). As we keep adding/changing more and more contents and keep making commits, all those snapshots are stored by git. Again, all this magic happens inside the .git folder. This is where all this snapshot or versions are stored in an efficient manner.","title":"More About a Commit"},{"location":"level101/git/git-basics/#adding-more-changes","text":"Let us create one more file and commit the change. It would look the same as the previous commit we made. $ echo \"I am file 2\" > file2.txt $ git add file2.txt $ git commit -m \"adding file 2\" [master 7f3b00e] adding file 2 1 file changed, 1 insertion(+) create mode 100644 file2.txt A new commit with ID 7f3b00e has been created. You can issue git status at any time to see the state of the repository. **IMPORTANT: Note that commit IDs are long string (SHA) but we can refer to a commit by its initial few (8 or more) characters too. We will interchangeably using shorter and longer commit IDs.** Now that we have two commits, let's visualize them: $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 git log , as the name suggests, prints the log of all the git commits. Here you see two additional arguments, --oneline prints the shorter version of the log, ie: the commit message only and not the person who made the commit and when. --graph prints it in graph format. Now at this moment the commits might look like just one in each line but all commits are stored as a tree like data structure internally by git. That means there can be two or more children commits of a given commit. And not just a single line of commits. We will look more into this part when we get to the Branches section. For now this is our commit history: df2fb7a ===> 7f3b00e","title":"Adding More Changes"},{"location":"level101/git/git-basics/#are-commits-really-linked","text":"As I just said, the two commits we just made are linked via tree like data structure and we saw how they are linked. But let's actually verify it. Everything in git is an object. Newly created files are stored as an object. Changes to file are stored as an objects and even commits are objects. To view contents of an object we can use the following command with the object's ID. We will take a look at the contents of the second commit $ git cat-file -p 7f3b00e tree ebf3af44d253e5328340026e45a9fa9ae3ea1982 parent df2fb7a61f5d40c1191e0fdeb0fc5d6e7969685a author Sanket Patel 1603273316 -0700 committer Sanket Patel 1603273316 -0700 adding file 2 Take a note of parent attribute in the above output. It points to the commit id of the first commit we made. So this proves that they are linked! Additionally you can see the second commit's message in this object. As I said all this magic is enabled by .git folder and the object to which we are looking at also is in that folder. $ ls .git/objects/7f/3b00eaa957815884198e2fdfec29361108d6a9 .git/objects/7f/3b00eaa957815884198e2fdfec29361108d6a9 It is stored in .git/objects/ folder. All the files and changes to them as well are stored in this folder.","title":"Are commits really linked?"},{"location":"level101/git/git-basics/#the-version-control-part-of-git","text":"We already can see two commits (versions) in our git log. One thing a version control tool gives you is ability to browse back and forth in history. For example: some of your users are running an old version of code and they are reporting an issue. In order to debug the issue, you need access to the old code. The one in your current repo is the latest code. In this example, you are working on the second commit (7f3b00e) and someone reported an issue with the code snapshot at commit (df2fb7a). This is how you would get access to the code at any older commit # Current contents, two files present $ ls file1.txt file2.txt # checking out to (an older) commit $ git checkout df2fb7a Note: checking out 'df2fb7a'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by performing another checkout. If you want to create a new branch to retain commits you create, you may do so (now or later) by using -b with the checkout command again. Example: git checkout -b HEAD is now at df2fb7a adding file 1 # checking contents, can verify it has old contents $ ls file1.txt So this is how we would get access to old versions/snapshots. All we need is a reference to that snapshot. Upon executing git checkout ... , what git does for you is use the .git folder, see what was the state of things (files and folders) at that version/reference and replace the contents of current directory with those contents. The then-existing content will no longer be present in the local dir (repo) but we can and will still get access to them because they are tracked via git commit and .git folder has them stored/tracked.","title":"The Version Control part of Git"},{"location":"level101/git/git-basics/#reference","text":"I mention in the previous section that we need a reference to the version. By default, git repo is made of tree of commits. And each commit has a unique IDs. But the unique ID is not the only thing we can reference commits via. There are multiple ways to reference commits. For example: HEAD is a reference to current commit. Whatever commit your repo is checked out at, HEAD will point to that. HEAD~1 is reference to previous commit. So while checking out previous version in section above, we could have done git checkout HEAD~1 . Similarly, master is also a reference (to a branch). Since git uses tree like structure to store commits, there of course will be branches. And the default branch is called master . Master (or any branch reference) will point to the latest commit in the branch. Even though we have checked out to the previous commit in out repo, master still points to the latest commit. And we can get back to the latest version by checkout at master reference $ git checkout master Previous HEAD position was df2fb7a adding file 1 Switched to branch 'master' # now we will see latest code, with two files $ ls file1.txt file2.txt Note, instead of master in above command, we could have used commit's ID as well.","title":"Reference"},{"location":"level101/git/git-basics/#references-and-the-magic","text":"Let's look at the state of things. Two commits, master and HEAD references are pointing to the latest commit $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 The magic? Let's examine these files: $ cat .git/refs/heads/master 7f3b00eaa957815884198e2fdfec29361108d6a9 Viola! Where master is pointing to is stored in a file. Whenever git needs to know where master reference is pointing to, or if git needs to update where master points, it just needs to update the file above. So when you create a new commit, a new commit is created on top of the current commit and the master file is updated with the new commit's ID. Similary, for HEAD reference: $ cat .git/HEAD ref: refs/heads/master We can see HEAD is pointing to a reference called refs/heads/master . So HEAD will point where ever the master points.","title":"References and The Magic"},{"location":"level101/git/git-basics/#little-adventure","text":"We discussed how git will update the files as we execute commands. But let's try to do it ourselves, by hand, and see what happens. $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 Now let's change master to point to the previous/first commit. $ echo df2fb7a61f5d40c1191e0fdeb0fc5d6e7969685a > .git/refs/heads/master $ git log --oneline --graph * df2fb7a (HEAD -> master) adding file 1 # RESETTING TO ORIGINAL $ echo 7f3b00eaa957815884198e2fdfec29361108d6a9 > .git/refs/heads/master $ git log --oneline --graph * 7f3b00e (HEAD -> master) adding file 2 * df2fb7a adding file 1 We just edited the master reference file and now we can see only the first commit in git log. Undoing the change to the file brings the state back to original. Not so much of magic, is it?","title":"Little Adventure"},{"location":"level101/git/github-hooks/","text":"Git with Github Till now all the operations we did were in our local repo while git also helps us in a collaborative environment. GitHub is one place on the internet where you can centrally host your git repos and collaborate with other developers. Most of the workflow will remain the same as we discussed, with addition of couple of things: Pull: to pull latest changes from github (the central) repo Push: to push your changes to github repo so that it's available to all people GitHub has written nice guides and tutorials about this and you can refer them here: GitHub Hello World Git Handbook Hooks Git has another nice feature called hooks. Hooks are basically scripts which will be called when a certain event happens. Here is where hooks are located: $ ls .git/hooks/ applypatch-msg.sample fsmonitor-watchman.sample pre-applypatch.sample pre-push.sample pre-receive.sample update.sample commit-msg.sample post-update.sample pre-commit.sample pre-rebase.sample prepare-commit-msg.sample Names are self explanatory. These hooks are useful when you want to do certain things when a certain event happens. If you want to run tests before pushing code, you would want to setup pre-push hooks. Let's try to create a pre commit hook. $ echo \"echo this is from pre commit hook\" > .git/hooks/pre-commit $ chmod +x .git/hooks/pre-commit We basically create a file called pre-commit in hooks folder and make it executable. Now if we make a commit, we should see the message getting printed. $ echo \"sample file\" > sample.txt $ git add sample.txt $ git commit -m \"adding sample file\" this is from pre commit hook # <===== THE MESSAGE FROM HOOK EXECUTION [master 9894e05] adding sample file 1 file changed, 1 insertion(+) create mode 100644 sample.txt","title":"Github and Hooks"},{"location":"level101/git/github-hooks/#git-with-github","text":"Till now all the operations we did were in our local repo while git also helps us in a collaborative environment. GitHub is one place on the internet where you can centrally host your git repos and collaborate with other developers. Most of the workflow will remain the same as we discussed, with addition of couple of things: Pull: to pull latest changes from github (the central) repo Push: to push your changes to github repo so that it's available to all people GitHub has written nice guides and tutorials about this and you can refer them here: GitHub Hello World Git Handbook","title":"Git with Github"},{"location":"level101/git/github-hooks/#hooks","text":"Git has another nice feature called hooks. Hooks are basically scripts which will be called when a certain event happens. Here is where hooks are located: $ ls .git/hooks/ applypatch-msg.sample fsmonitor-watchman.sample pre-applypatch.sample pre-push.sample pre-receive.sample update.sample commit-msg.sample post-update.sample pre-commit.sample pre-rebase.sample prepare-commit-msg.sample Names are self explanatory. These hooks are useful when you want to do certain things when a certain event happens. If you want to run tests before pushing code, you would want to setup pre-push hooks. Let's try to create a pre commit hook. $ echo \"echo this is from pre commit hook\" > .git/hooks/pre-commit $ chmod +x .git/hooks/pre-commit We basically create a file called pre-commit in hooks folder and make it executable. Now if we make a commit, we should see the message getting printed. $ echo \"sample file\" > sample.txt $ git add sample.txt $ git commit -m \"adding sample file\" this is from pre commit hook # <===== THE MESSAGE FROM HOOK EXECUTION [master 9894e05] adding sample file 1 file changed, 1 insertion(+) create mode 100644 sample.txt","title":"Hooks"},{"location":"level101/linux_basics/command_line_basics/","text":"Command Line Basics Lab Environment Setup One can use an online bash interpreter to run all the commands that are provided as examples in this course. This will also help you in getting a hands-on experience of various linux commands. REPL is one of the popular online bash interpreters for running linux commands. We will be using it for running all the commands mentioned in this course. What is a Command A command is a program that tells the operating system to perform specific work. Programs are stored as files in linux. Therefore, a command is also a file which is stored somewhere on the disk. Commands may also take additional arguments as input from the user. These arguments are called command line arguments. Knowing how to use the commands is important and there are many ways to get help in Linux, especially for commands. Almost every command will have some form of documentation, most commands will have a command-line argument -h or --help that will display a reasonable amount of documentation. But the most popular documentation system in Linux is called man pages - short for manual pages. Using --help to show the documentation for ls command. File System Organization The linux file system has a hierarchical (or tree-like) structure with its highest level directory called root ( denoted by / ). Directories present inside the root directory stores file related to the system. These directories in turn can either store system files or application files or user related files. bin | The executable program of most commonly used commands reside in bin directory sbin | This directory contains programs used for system administration. home | This directory contains user related files and directories. lib | This directory contains all the library files etc | This directory contains all the system configuration files proc | This directory contains files related to the running processes on the system dev | This directory contains files related to devices on the system mnt | This directory contains files related to mounted devices on the system tmp | This directory is used to store temporary files on the system usr | This directory is used to store application programs on the system Commands for Navigating the File System There are three basic commands which are used frequently to navigate the file system: ls pwd cd We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. pwd (print working directory) At any given moment of time, we will be standing in a certain directory. To get the name of the directory in which we are standing, we can use the pwd command in linux. We will now use the cd command to move to a different directory and then print the working directory. cd (change directory) The cd command can be used to change the working directory. Using the command, you can move from one directory to another. In the below example, we are initially in the root directory. we have then used the cd command to change the directory. ls (list files and directories)** The ls command is used to list the contents of a directory. It will list down all the files and folders present in the given directory. If we just type ls in the shell, it will list all the files and directories present in the current directory. We can also provide the directory name as argument to ls command. It will then list all the files and directories inside the given directory. Commands for Manipulating Files There are five basic commands which are used frequently to manipulate files: touch mkdir cp mv rm We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. touch (create new file) The touch command can be used to create an empty new file. This command is very useful for many other purposes but we will discuss the simplest use case of creating a new file. General syntax of using touch command touch mkdir (create new directories) The mkdir command is used to create directories.You can use ls command to verify that the new directory is created. General syntax of using mkdir command mkdir rm (delete files and directories) The rm command can be used to delete files and directories. It is very important to note that this command permanently deletes the files and directories. It's almost impossible to recover these files and directories once you have executed rm command on them successfully. Do run this command with care. General syntax of using rm command: rm Let's try to understand the rm command with an example. We will try to delete the file and directory we created using touch and mkdir command respectively. cp (copy files and directories) The cp command is used to copy files and directories from one location to another. Do note that the cp command doesn't do any change to the original files or directories. The original files or directories and their copy both co-exist after running cp command successfully. General syntax of using cp command: cp We are currently in the '/home/runner' directory. We will use the mkdir command to create a new directory named \"test_directory\". We will now try to copy the \"_test_runner.py\" file to the directory we created just now. Do note that nothing happened to the original \"_test_runner.py\" file. It's still there in the current directory. A new copy of it got created inside the \"test_directory\". We can also use the cp command to copy the whole directory from one location to another. Let's try to understand this with an example. We again used the mkdir command to create a new directory called \"another_directory\". We then used the cp command along with an additional argument '-r' to copy the \"test_directory\". mv (move files and directories) The mv command can either be used to move files or directories from one location to another or it can be used to rename files or directories. Do note that moving files and copying them are very different. When you move the files or directories, the original copy is lost. General syntax of using mv command: mv In this example, we will use the mv command to move the \"_test_runner.py\" file to \"test_directory\". In this case, this file already exists in \"test_directory\". The mv command will just replace it. Do note that the original file doesn't exist in the current directory after mv command ran successfully. We can also use the mv command to move a directory from one location to another. In this case, we do not need to use the '-r' flag that we did while using the cp command. Do note that the original directory will not exist if we use mv command. One of the important uses of the mv command is to rename files and directories. Let's see how we can use this command for renaming. We have first changed our location to \"test_directory\". We then use the mv command to rename the \"\"_test_runner.py\" file to \"test.py\". Commands for Viewing Files There are five basic commands which are used frequently to view the files: cat head tail more less We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. We will create a new file called \"numbers.txt\" and insert numbers from 1 to 100 in this file. Each number will be in a separate line. Do not worry about the above command now. It's an advanced command which is used to generate numbers. We have then used a redirection operator to push these numbers to the file. We will be discussing I/O redirection in the later sections. cat The most simplest use of cat command is to print the contents of the file on your output screen. This command is very useful and can be used for many other purposes. We will study about other use cases later. You can try to run the above command and you will see numbers being printed from 1 to 100 on your screen. You will need to scroll up to view all the numbers. head The head command displays the first 10 lines of the file by default. We can include additional arguments to display as many lines as we want from the top. In this example, we are only able to see the first 10 lines from the file when we use the head command. By default, head command will only display the first 10 lines. If we want to specify the number of lines we want to see from start, use the '-n' argument to provide the input. tail The tail command displays the last 10 lines of the file by default. We can include additional arguments to display as many lines as we want from the end of the file. By default, the tail command will only display the last 10 lines. If we want to specify the number of lines we want to see from the end, use '-n' argument to provide the input. In this example, we are only able to see the last 5 lines from the file when we use the tail command with explicit -n option. more More command displays the contents of a file or a command output, displaying one screen at a time in case the file is large (Eg: log files). It also allows forward navigation and limited backward navigation in the file. More command displays as much as can fit on the current screen and waits for user input to advance. Forward navigation can be done by pressing Enter, which advances the output by one line and Space, which advances the output by one screen. less Less command is an improved version of more. It displays the contents of a file or a command output, one page at a time. It allows backward navigation as well as forward navigation in the file and also has search options. We can use arrow keys for advancing backward or forward by one line. For moving forward by one page, press Space and for moving backward by one page, press b on your keyboard. You can go to the beginning and the end of a file instantly. Echo Command in Linux The echo command is one of the simplest commands that is used in the shell. This command is equivalent to what we have in other programming languages. The echo command prints the given input string on the screen. Text Processing Commands In the previous section, we learned how to view the content of a file. In many cases, we will be interested in performing the below operations: Print only the lines which contain a particular word(s) Replace a particular word with another word in a file Sort the lines in a particular order There are three basic commands which are used frequently to process texts: grep sed sort We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. We will create a new file called \"numbers.txt\" and insert numbers from 1 to 10 in this file. Each number will be in a separate line. grep The grep command in its simplest form can be used to search particular words in a text file. It will display all the lines in a file that contains a particular input. The word we want to search is provided as an input to the grep command. General syntax of using grep command: grep In this example, we are trying to search for a string \"1\" in this file. The grep command outputs the lines where it found this string. sed The sed command in its simplest form can be used to replace a text in a file. General syntax of using the sed command for replacement: sed 's///' Let's try to replace each occurrence of \"1\" in the file with \"3\" using sed command. The content of the file will not change in the above example. To do so, we have to use an extra argument '-i' so that the changes are reflected back in the file. sort The sort command can be used to sort the input provided to it as an argument. By default, it will sort in increasing order. Let's first see the content of the file before trying to sort it. Now, we will try to sort the file using the sort command. The sort command sorts the content in lexicographical order. The content of the file will not change in the above example. I/O Redirection Each open file gets assigned a file descriptor. A file descriptor is an unique identifier for open files in the system. There are always three default files open, stdin (the keyboard), stdout (the screen), and stderr (error messages output to the screen). These files can be redirected. Everything is a file in linux - https://unix.stackexchange.com/questions/225537/everything-is-a-file Till now, we have displayed all the output on the screen which is the standard output. We can use some special operators to redirect the output of the command to files or even to the input of other commands. I/O redirection is a very powerful feature. In the below example, we have used the '>' operator to redirect the output of ls command to output.txt file. In the below example, we have redirected the output from echo command to a file. We can also redirect the output of a command as an input to another command. This is possible with the help of pipes. In the below example, we have passed the output of cat command as an input to grep command using pipe(|) operator. In the below example, we have passed the output of sort command as an input to uniq command using pipe(|) operator. The uniq command only prints the unique numbers from the input. I/O redirection - https://tldp.org/LDP/abs/html/io-redirection.html","title":"Command Line Basics"},{"location":"level101/linux_basics/command_line_basics/#command-line-basics","text":"","title":"Command Line Basics"},{"location":"level101/linux_basics/command_line_basics/#lab-environment-setup","text":"One can use an online bash interpreter to run all the commands that are provided as examples in this course. This will also help you in getting a hands-on experience of various linux commands. REPL is one of the popular online bash interpreters for running linux commands. We will be using it for running all the commands mentioned in this course.","title":"Lab Environment Setup"},{"location":"level101/linux_basics/command_line_basics/#what-is-a-command","text":"A command is a program that tells the operating system to perform specific work. Programs are stored as files in linux. Therefore, a command is also a file which is stored somewhere on the disk. Commands may also take additional arguments as input from the user. These arguments are called command line arguments. Knowing how to use the commands is important and there are many ways to get help in Linux, especially for commands. Almost every command will have some form of documentation, most commands will have a command-line argument -h or --help that will display a reasonable amount of documentation. But the most popular documentation system in Linux is called man pages - short for manual pages. Using --help to show the documentation for ls command.","title":"What is a Command"},{"location":"level101/linux_basics/command_line_basics/#file-system-organization","text":"The linux file system has a hierarchical (or tree-like) structure with its highest level directory called root ( denoted by / ). Directories present inside the root directory stores file related to the system. These directories in turn can either store system files or application files or user related files. bin | The executable program of most commonly used commands reside in bin directory sbin | This directory contains programs used for system administration. home | This directory contains user related files and directories. lib | This directory contains all the library files etc | This directory contains all the system configuration files proc | This directory contains files related to the running processes on the system dev | This directory contains files related to devices on the system mnt | This directory contains files related to mounted devices on the system tmp | This directory is used to store temporary files on the system usr | This directory is used to store application programs on the system","title":"File System Organization"},{"location":"level101/linux_basics/command_line_basics/#commands-for-navigating-the-file-system","text":"There are three basic commands which are used frequently to navigate the file system: ls pwd cd We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell.","title":"Commands for Navigating the File System"},{"location":"level101/linux_basics/command_line_basics/#pwd-print-working-directory","text":"At any given moment of time, we will be standing in a certain directory. To get the name of the directory in which we are standing, we can use the pwd command in linux. We will now use the cd command to move to a different directory and then print the working directory.","title":"pwd (print working directory)"},{"location":"level101/linux_basics/command_line_basics/#cd-change-directory","text":"The cd command can be used to change the working directory. Using the command, you can move from one directory to another. In the below example, we are initially in the root directory. we have then used the cd command to change the directory.","title":"cd (change directory)"},{"location":"level101/linux_basics/command_line_basics/#ls-list-files-and-directories","text":"The ls command is used to list the contents of a directory. It will list down all the files and folders present in the given directory. If we just type ls in the shell, it will list all the files and directories present in the current directory. We can also provide the directory name as argument to ls command. It will then list all the files and directories inside the given directory.","title":"ls (list files and directories)**"},{"location":"level101/linux_basics/command_line_basics/#commands-for-manipulating-files","text":"There are five basic commands which are used frequently to manipulate files: touch mkdir cp mv rm We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell.","title":"Commands for Manipulating Files"},{"location":"level101/linux_basics/command_line_basics/#touch-create-new-file","text":"The touch command can be used to create an empty new file. This command is very useful for many other purposes but we will discuss the simplest use case of creating a new file. General syntax of using touch command touch ","title":"touch (create new file)"},{"location":"level101/linux_basics/command_line_basics/#mkdir-create-new-directories","text":"The mkdir command is used to create directories.You can use ls command to verify that the new directory is created. General syntax of using mkdir command mkdir ","title":"mkdir (create new directories)"},{"location":"level101/linux_basics/command_line_basics/#rm-delete-files-and-directories","text":"The rm command can be used to delete files and directories. It is very important to note that this command permanently deletes the files and directories. It's almost impossible to recover these files and directories once you have executed rm command on them successfully. Do run this command with care. General syntax of using rm command: rm Let's try to understand the rm command with an example. We will try to delete the file and directory we created using touch and mkdir command respectively.","title":"rm (delete files and directories)"},{"location":"level101/linux_basics/command_line_basics/#cp-copy-files-and-directories","text":"The cp command is used to copy files and directories from one location to another. Do note that the cp command doesn't do any change to the original files or directories. The original files or directories and their copy both co-exist after running cp command successfully. General syntax of using cp command: cp We are currently in the '/home/runner' directory. We will use the mkdir command to create a new directory named \"test_directory\". We will now try to copy the \"_test_runner.py\" file to the directory we created just now. Do note that nothing happened to the original \"_test_runner.py\" file. It's still there in the current directory. A new copy of it got created inside the \"test_directory\". We can also use the cp command to copy the whole directory from one location to another. Let's try to understand this with an example. We again used the mkdir command to create a new directory called \"another_directory\". We then used the cp command along with an additional argument '-r' to copy the \"test_directory\". mv (move files and directories) The mv command can either be used to move files or directories from one location to another or it can be used to rename files or directories. Do note that moving files and copying them are very different. When you move the files or directories, the original copy is lost. General syntax of using mv command: mv In this example, we will use the mv command to move the \"_test_runner.py\" file to \"test_directory\". In this case, this file already exists in \"test_directory\". The mv command will just replace it. Do note that the original file doesn't exist in the current directory after mv command ran successfully. We can also use the mv command to move a directory from one location to another. In this case, we do not need to use the '-r' flag that we did while using the cp command. Do note that the original directory will not exist if we use mv command. One of the important uses of the mv command is to rename files and directories. Let's see how we can use this command for renaming. We have first changed our location to \"test_directory\". We then use the mv command to rename the \"\"_test_runner.py\" file to \"test.py\".","title":"cp (copy files and directories)"},{"location":"level101/linux_basics/command_line_basics/#commands-for-viewing-files","text":"There are five basic commands which are used frequently to view the files: cat head tail more less We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. We will create a new file called \"numbers.txt\" and insert numbers from 1 to 100 in this file. Each number will be in a separate line. Do not worry about the above command now. It's an advanced command which is used to generate numbers. We have then used a redirection operator to push these numbers to the file. We will be discussing I/O redirection in the later sections.","title":"Commands for Viewing Files"},{"location":"level101/linux_basics/command_line_basics/#cat","text":"The most simplest use of cat command is to print the contents of the file on your output screen. This command is very useful and can be used for many other purposes. We will study about other use cases later. You can try to run the above command and you will see numbers being printed from 1 to 100 on your screen. You will need to scroll up to view all the numbers.","title":"cat"},{"location":"level101/linux_basics/command_line_basics/#head","text":"The head command displays the first 10 lines of the file by default. We can include additional arguments to display as many lines as we want from the top. In this example, we are only able to see the first 10 lines from the file when we use the head command. By default, head command will only display the first 10 lines. If we want to specify the number of lines we want to see from start, use the '-n' argument to provide the input.","title":"head"},{"location":"level101/linux_basics/command_line_basics/#tail","text":"The tail command displays the last 10 lines of the file by default. We can include additional arguments to display as many lines as we want from the end of the file. By default, the tail command will only display the last 10 lines. If we want to specify the number of lines we want to see from the end, use '-n' argument to provide the input. In this example, we are only able to see the last 5 lines from the file when we use the tail command with explicit -n option.","title":"tail"},{"location":"level101/linux_basics/command_line_basics/#more","text":"More command displays the contents of a file or a command output, displaying one screen at a time in case the file is large (Eg: log files). It also allows forward navigation and limited backward navigation in the file. More command displays as much as can fit on the current screen and waits for user input to advance. Forward navigation can be done by pressing Enter, which advances the output by one line and Space, which advances the output by one screen.","title":"more"},{"location":"level101/linux_basics/command_line_basics/#less","text":"Less command is an improved version of more. It displays the contents of a file or a command output, one page at a time. It allows backward navigation as well as forward navigation in the file and also has search options. We can use arrow keys for advancing backward or forward by one line. For moving forward by one page, press Space and for moving backward by one page, press b on your keyboard. You can go to the beginning and the end of a file instantly.","title":"less"},{"location":"level101/linux_basics/command_line_basics/#echo-command-in-linux","text":"The echo command is one of the simplest commands that is used in the shell. This command is equivalent to what we have in other programming languages. The echo command prints the given input string on the screen.","title":"Echo Command in Linux"},{"location":"level101/linux_basics/command_line_basics/#text-processing-commands","text":"In the previous section, we learned how to view the content of a file. In many cases, we will be interested in performing the below operations: Print only the lines which contain a particular word(s) Replace a particular word with another word in a file Sort the lines in a particular order There are three basic commands which are used frequently to process texts: grep sed sort We will now try to understand what each command does and how to use these commands. You should also practice the given examples on the online bash shell. We will create a new file called \"numbers.txt\" and insert numbers from 1 to 10 in this file. Each number will be in a separate line.","title":"Text Processing Commands"},{"location":"level101/linux_basics/command_line_basics/#grep","text":"The grep command in its simplest form can be used to search particular words in a text file. It will display all the lines in a file that contains a particular input. The word we want to search is provided as an input to the grep command. General syntax of using grep command: grep In this example, we are trying to search for a string \"1\" in this file. The grep command outputs the lines where it found this string.","title":"grep"},{"location":"level101/linux_basics/command_line_basics/#sed","text":"The sed command in its simplest form can be used to replace a text in a file. General syntax of using the sed command for replacement: sed 's///' Let's try to replace each occurrence of \"1\" in the file with \"3\" using sed command. The content of the file will not change in the above example. To do so, we have to use an extra argument '-i' so that the changes are reflected back in the file.","title":"sed"},{"location":"level101/linux_basics/command_line_basics/#sort","text":"The sort command can be used to sort the input provided to it as an argument. By default, it will sort in increasing order. Let's first see the content of the file before trying to sort it. Now, we will try to sort the file using the sort command. The sort command sorts the content in lexicographical order. The content of the file will not change in the above example.","title":"sort"},{"location":"level101/linux_basics/command_line_basics/#io-redirection","text":"Each open file gets assigned a file descriptor. A file descriptor is an unique identifier for open files in the system. There are always three default files open, stdin (the keyboard), stdout (the screen), and stderr (error messages output to the screen). These files can be redirected. Everything is a file in linux - https://unix.stackexchange.com/questions/225537/everything-is-a-file Till now, we have displayed all the output on the screen which is the standard output. We can use some special operators to redirect the output of the command to files or even to the input of other commands. I/O redirection is a very powerful feature. In the below example, we have used the '>' operator to redirect the output of ls command to output.txt file. In the below example, we have redirected the output from echo command to a file. We can also redirect the output of a command as an input to another command. This is possible with the help of pipes. In the below example, we have passed the output of cat command as an input to grep command using pipe(|) operator. In the below example, we have passed the output of sort command as an input to uniq command using pipe(|) operator. The uniq command only prints the unique numbers from the input. I/O redirection - https://tldp.org/LDP/abs/html/io-redirection.html","title":"I/O Redirection"},{"location":"level101/linux_basics/conclusion/","text":"Conclusion We have covered the basics of Linux operating systems and basic commands used in linux. We have also covered the Linux server administration commands. We hope that this course will make it easier for you to operate on the command line. Applications in SRE Role As a SRE, you will be required to perform some general tasks on these Linux servers. You will also be using the command line when you are troubleshooting issues. Moving from one location to another in the filesystem will require the help of ls , pwd and cd commands. You may need to search some specific information in the log files. grep command would be very useful here. I/O redirection will become handy if you want to store the output in a file or pass it as an input to another command. tail command is very useful to view the latest data in the log file. Different users will have different permissions depending on their roles. We will also not want everyone in the company to access our servers for security reasons. Users permissions can be restricted with chown , chmod and chgrp commands. ssh is one of the most frequently used commands for a SRE. Logging into servers and troubleshooting along with performing basic administration tasks will only be possible if we are able to login into the server. What if we want to run an apache server or nginx on a server? We will first install it using the package manager. Package management commands become important here. Managing services on servers is another critical responsibility of a SRE. Systemd related commands can help in troubleshooting issues. If a service goes down, we can start it using systemctl start command. We can also stop a service in case it is not needed. Monitoring is another core responsibility of a SRE. Memory and CPU are two important system level metrics which should be monitored. Commands like top and free are quite helpful here. If a service is throwing an error, how do we find out the root cause of the error ? We will certainly need to check logs to find out the whole stack trace of the error. The log file will also tell us the number of times the error has occurred along with time when it started. Useful Courses and tutorials Edx basic linux commands course Edx Red Hat Enterprise Linux Course https://linuxcommand.org/lc3_learning_the_shell.php","title":"Conclusion"},{"location":"level101/linux_basics/conclusion/#conclusion","text":"We have covered the basics of Linux operating systems and basic commands used in linux. We have also covered the Linux server administration commands. We hope that this course will make it easier for you to operate on the command line.","title":"Conclusion"},{"location":"level101/linux_basics/conclusion/#applications-in-sre-role","text":"As a SRE, you will be required to perform some general tasks on these Linux servers. You will also be using the command line when you are troubleshooting issues. Moving from one location to another in the filesystem will require the help of ls , pwd and cd commands. You may need to search some specific information in the log files. grep command would be very useful here. I/O redirection will become handy if you want to store the output in a file or pass it as an input to another command. tail command is very useful to view the latest data in the log file. Different users will have different permissions depending on their roles. We will also not want everyone in the company to access our servers for security reasons. Users permissions can be restricted with chown , chmod and chgrp commands. ssh is one of the most frequently used commands for a SRE. Logging into servers and troubleshooting along with performing basic administration tasks will only be possible if we are able to login into the server. What if we want to run an apache server or nginx on a server? We will first install it using the package manager. Package management commands become important here. Managing services on servers is another critical responsibility of a SRE. Systemd related commands can help in troubleshooting issues. If a service goes down, we can start it using systemctl start command. We can also stop a service in case it is not needed. Monitoring is another core responsibility of a SRE. Memory and CPU are two important system level metrics which should be monitored. Commands like top and free are quite helpful here. If a service is throwing an error, how do we find out the root cause of the error ? We will certainly need to check logs to find out the whole stack trace of the error. The log file will also tell us the number of times the error has occurred along with time when it started.","title":"Applications in SRE Role"},{"location":"level101/linux_basics/conclusion/#useful-courses-and-tutorials","text":"Edx basic linux commands course Edx Red Hat Enterprise Linux Course https://linuxcommand.org/lc3_learning_the_shell.php","title":"Useful Courses and tutorials"},{"location":"level101/linux_basics/intro/","text":"Linux Basics Introduction Prerequisites Should be comfortable in using any operating systems like Windows, Linux or Mac Expected to have fundamental knowledge of operating systems What to expect from this course This course is divided into three parts. In the first part, we cover the fundamentals of Linux operating systems. We will talk about Linux architecture, Linux distributions and uses of Linux operating systems. We will also talk about the difference between GUI and CLI. In the second part, we cover some basic commands used in Linux. We will focus on commands used for navigating the file system, viewing and manipulating files, I/O redirection etc. In the third part, we cover Linux system administration. This includes day to day tasks performed by Linux admins, like managing users/groups, managing file permissions, monitoring system performance, log files etc. In the second and third part, we will be taking examples to understand the concepts. What is not covered under this course We are not covering advanced Linux commands and bash scripting in this course. We will also not be covering Linux internals. Course Contents The following topics has been covered in this course: Introduction to Linux What are Linux Operating Systems What are popular Linux distributions Uses of Linux Operating Systems Linux Architecture Graphical user interface (GUI) vs Command line interface (CLI) Command Line Basics Lab Environment Setup What is a Command File System Organization Navigating File System Manipulating Files Viewing Files Echo Command Text Processing Commands I/O Redirection Linux system administration Lab Environment Setup User/Groups management Becoming a Superuser File Permissions SSH Command Package Management Process Management Memory Management Daemons and Systemd Logs Conclusion Applications in SRE Role Useful Courses and tutorials What are Linux operating systems Most of us are familiar with the Windows operating system used in more than 75% of the personal computers. The Windows operating systems are based on Windows NT kernel. A kernel is the most important part of an operating system - it performs important functions like process management, memory management, filesystem management etc. Linux operating systems are based on the Linux kernel. A Linux based operating system will consist of Linux kernel, GUI/CLI, system libraries and system utilities. The Linux kernel was independently developed and released by Linus Torvalds. The Linux kernel is free and open-source - https://github.com/torvalds/linux Linux is a kernel and and not a complete operating system. Linux kernel is combined with GNU system to make a complete operating system. Therefore, linux based operating systems are also called as GNU/Linux systems. GNU is an extensive collection of free softwares like compiler, debugger, C library etc. Linux and the GNU System History of Linux - https://en.wikipedia.org/wiki/History_of_Linux What are popular Linux distributions A Linux distribution(distro) is an operating system based on the Linux kernel and a package management system. A package management system consists of tools that help in installing, upgrading, configuring and removing softwares on the operating system. Software are usually adopted to a distribution and are packaged in a distro specific format. These packages are available through a distro specific repository. Packages are installed and managed in the operating system by a package manager. List of popular Linux distributions: Fedora Ubuntu Debian Centos Red Hat Enterprise Linux Suse Arch Linux Packaging systems Distributions Package manager Debian style (.deb) Debian, Ubuntu APT Red Hat style (.rpm) Fedora, CentOS, Red Hat Enterprise Linux YUM Linux Architecture The Linux kernel is monolithic in nature. System calls are used to interact with the Linux kernel space. Kernel code can only be executed in the kernel mode. Non-kernel code is executed in the user mode. Device drivers are used to communicate with the hardware devices. Uses of Linux Operating Systems Operating system based on Linux kernel are widely used in: Personal computers Servers Mobile phones - Android is based on Linux operating system Embedded devices - watches, televisions, traffic lights etc Satellites Network devices - routers, switches etc. Graphical user interface (GUI) vs Command line interface (CLI) A user interacts with a computer with the help of user interfaces. The user interface can be either GUI or CLI. Graphical user interface allows a user to interact with the computer using graphics such as icons and images. When a user clicks on an icon to open an application on a computer, he or she is actually using the GUI. It's easy to perform tasks using GUI. Command line interface allows a user to interact with the computer using commands. A user types the command in a terminal and the system helps in executing these commands. A new user with experience on GUI may find it difficult to interact with CLI as he/she needs to be aware of the commands to perform a particular operation. Shell vs Terminal Shell is a program that takes commands from the users and gives them to the operating system for processing. Shell is an example of a CLI (command line interface). Bash is one of the most popular shell programs available on Linux servers. Other popular shell programs are zsh, ksh and tcsh. Terminal is a program that opens a window and lets you interact with the shell. Some popular examples of terminals are gnome-terminal, xterm, konsole etc. Linux users do use the terms shell, terminal, prompt, console etc. interchangeably. In simple terms, these all refer to a way of taking commands from the user.","title":"Introduction"},{"location":"level101/linux_basics/intro/#linux-basics","text":"","title":"Linux Basics"},{"location":"level101/linux_basics/intro/#introduction","text":"","title":"Introduction"},{"location":"level101/linux_basics/intro/#prerequisites","text":"Should be comfortable in using any operating systems like Windows, Linux or Mac Expected to have fundamental knowledge of operating systems","title":"Prerequisites"},{"location":"level101/linux_basics/intro/#what-to-expect-from-this-course","text":"This course is divided into three parts. In the first part, we cover the fundamentals of Linux operating systems. We will talk about Linux architecture, Linux distributions and uses of Linux operating systems. We will also talk about the difference between GUI and CLI. In the second part, we cover some basic commands used in Linux. We will focus on commands used for navigating the file system, viewing and manipulating files, I/O redirection etc. In the third part, we cover Linux system administration. This includes day to day tasks performed by Linux admins, like managing users/groups, managing file permissions, monitoring system performance, log files etc. In the second and third part, we will be taking examples to understand the concepts.","title":"What to expect from this course"},{"location":"level101/linux_basics/intro/#what-is-not-covered-under-this-course","text":"We are not covering advanced Linux commands and bash scripting in this course. We will also not be covering Linux internals.","title":"What is not covered under this course"},{"location":"level101/linux_basics/intro/#course-contents","text":"The following topics has been covered in this course: Introduction to Linux What are Linux Operating Systems What are popular Linux distributions Uses of Linux Operating Systems Linux Architecture Graphical user interface (GUI) vs Command line interface (CLI) Command Line Basics Lab Environment Setup What is a Command File System Organization Navigating File System Manipulating Files Viewing Files Echo Command Text Processing Commands I/O Redirection Linux system administration Lab Environment Setup User/Groups management Becoming a Superuser File Permissions SSH Command Package Management Process Management Memory Management Daemons and Systemd Logs Conclusion Applications in SRE Role Useful Courses and tutorials","title":"Course Contents"},{"location":"level101/linux_basics/intro/#what-are-linux-operating-systems","text":"Most of us are familiar with the Windows operating system used in more than 75% of the personal computers. The Windows operating systems are based on Windows NT kernel. A kernel is the most important part of an operating system - it performs important functions like process management, memory management, filesystem management etc. Linux operating systems are based on the Linux kernel. A Linux based operating system will consist of Linux kernel, GUI/CLI, system libraries and system utilities. The Linux kernel was independently developed and released by Linus Torvalds. The Linux kernel is free and open-source - https://github.com/torvalds/linux Linux is a kernel and and not a complete operating system. Linux kernel is combined with GNU system to make a complete operating system. Therefore, linux based operating systems are also called as GNU/Linux systems. GNU is an extensive collection of free softwares like compiler, debugger, C library etc. Linux and the GNU System History of Linux - https://en.wikipedia.org/wiki/History_of_Linux","title":"What are Linux operating systems"},{"location":"level101/linux_basics/intro/#what-are-popular-linux-distributions","text":"A Linux distribution(distro) is an operating system based on the Linux kernel and a package management system. A package management system consists of tools that help in installing, upgrading, configuring and removing softwares on the operating system. Software are usually adopted to a distribution and are packaged in a distro specific format. These packages are available through a distro specific repository. Packages are installed and managed in the operating system by a package manager. List of popular Linux distributions: Fedora Ubuntu Debian Centos Red Hat Enterprise Linux Suse Arch Linux Packaging systems Distributions Package manager Debian style (.deb) Debian, Ubuntu APT Red Hat style (.rpm) Fedora, CentOS, Red Hat Enterprise Linux YUM","title":"What are popular Linux distributions"},{"location":"level101/linux_basics/intro/#linux-architecture","text":"The Linux kernel is monolithic in nature. System calls are used to interact with the Linux kernel space. Kernel code can only be executed in the kernel mode. Non-kernel code is executed in the user mode. Device drivers are used to communicate with the hardware devices.","title":"Linux Architecture"},{"location":"level101/linux_basics/intro/#uses-of-linux-operating-systems","text":"Operating system based on Linux kernel are widely used in: Personal computers Servers Mobile phones - Android is based on Linux operating system Embedded devices - watches, televisions, traffic lights etc Satellites Network devices - routers, switches etc.","title":"Uses of Linux Operating Systems"},{"location":"level101/linux_basics/intro/#graphical-user-interface-gui-vs-command-line-interface-cli","text":"A user interacts with a computer with the help of user interfaces. The user interface can be either GUI or CLI. Graphical user interface allows a user to interact with the computer using graphics such as icons and images. When a user clicks on an icon to open an application on a computer, he or she is actually using the GUI. It's easy to perform tasks using GUI. Command line interface allows a user to interact with the computer using commands. A user types the command in a terminal and the system helps in executing these commands. A new user with experience on GUI may find it difficult to interact with CLI as he/she needs to be aware of the commands to perform a particular operation.","title":"Graphical user interface (GUI) vs Command line interface (CLI)"},{"location":"level101/linux_basics/intro/#shell-vs-terminal","text":"Shell is a program that takes commands from the users and gives them to the operating system for processing. Shell is an example of a CLI (command line interface). Bash is one of the most popular shell programs available on Linux servers. Other popular shell programs are zsh, ksh and tcsh. Terminal is a program that opens a window and lets you interact with the shell. Some popular examples of terminals are gnome-terminal, xterm, konsole etc. Linux users do use the terms shell, terminal, prompt, console etc. interchangeably. In simple terms, these all refer to a way of taking commands from the user.","title":"Shell vs Terminal"},{"location":"level101/linux_basics/linux_server_administration/","text":"Linux Server Administration In this course will try to cover some of the common tasks that a linux server administrator performs. We will first try to understand what a particular command does and then try to understand the commands using examples. Do keep in mind that it's very important to practice the Linux commands on your own. Lab Environment Setup Install docker on your system - https://docs.docker.com/engine/install/ We will be running all the commands on Red Hat Enterprise Linux (RHEL) 8 system. We will run most of the commands used in this module in the above Docker container. Multi-User Operating Systems An operating system is considered as multi-user if it allows multiple people/users to use a computer and not affect each other's files and preferences. Linux based operating systems are multi-user in nature as it allows multiple users to access the system at the same time. A typical computer will only have one keyboard and monitor but multiple users can log in via SSH if the computer is connected to the network. We will cover more about SSH later. As a server administrator, we are mostly concerned with the Linux servers which are physically present at a very large distance from us. We can connect to these servers with the help of remote login methods like SSH. Since Linux supports multiple users, we need to have a method which can protect the users from each other. One user should not be able to access and modify files of other users User/Group Management Users in Linux has an associated user ID called UID attached to them. Users also has a home directory and a login shell associated with them. A group is a collection of one or more users. A group makes it easier to share permissions among a group of users. Each group has a group ID called GID associated with it. id command id command can be used to find the uid and gid associated with an user. It also lists down the groups to which the user belongs to. The uid and gid associated with the root user is 0. A good way to find out the current user in Linux is to use the whoami command. \"root\" user or superuser is the most privileged user with unrestricted access to all the resources on the system. It has UID 0 Important files associated with users/groups /etc/passwd Stores the user name, the uid, the gid, the home directory, the login shell etc /etc/shadow Stores the password associated with the users /etc/group Stores information about different groups on the system If you want to understand each filed discussed in the above outputs, you can go through below links: https://tldp.org/LDP/lame/LAME/linux-admin-made-easy/shadow-file-formats.html https://tldp.org/HOWTO/User-Authentication-HOWTO/x71.html Important commands for managing users Some of the commands which are used frequently to manage users/groups on Linux are following: useradd - Creates a new user passwd - Adds or modifies passwords for a user usermod - Modifies attributes of an user userdel - Deletes an user useradd The useradd command adds a new user in Linux. We will create a new user 'shivam'. We will also verify that the user has been created by tailing the /etc/passwd file. The uid and gid are 1000 for the newly created user. The home directory assigned to the user is /home/shivam and the login shell assigned is /bin/bash. Do note that the user home directory and login shell can be modified later on. If we do not specify any value for attributes like home directory or login shell, default values will be assigned to the user. We can also override these default values when creating a new user. passwd The passwd command is used to create or modify passwords for a user. In the above examples, we have not assigned any password for users 'shivam' or 'amit' while creating them. \"!!\" in an account entry in shadow means the account of an user has been created, but not yet given a password. Let's now try to create a password for user \"shivam\". Do remember the password as we will be later using examples where it will be useful. Also, let's change the password for the root user now. When we switch from a normal user to root user, it will request you for a password. Also, when you login using root user, the password will be asked. usermod The usermod command is used to modify the attributes of an user like the home directory or the shell. Let's try to modify the login shell of user \"amit\" to \"/bin/bash\". In a similar way, you can also modify many other attributes for a user. Try 'usermod -h' for a list of attributes you can modify. userdel The userdel command is used to remove a user on Linux. Once we remove a user, all the information related to that user will be removed. Let's try to delete the user \"amit\". After deleting the user, you will not find the entry for that user in \"/etc/passwd\" or \"/etc/shadow\" file. Important commands for managing groups Commands for managing groups are quite similar to the commands used for managing users. Each command is not explained in detail here as they are quite similar. You can try running these commands on your system. groupadd \\ Creates a new group groupmod \\ Modifies attributes of a group groupdel \\ Deletes a group gpasswd \\ Modifies password for group We will now try to add user \"shivam\" to the group we have created above. Becoming a Superuser Before running the below commands, do make sure that you have set up a password for user \"shivam\" and user \"root\" using the passwd command described in the above section. The su command can be used to switch users in Linux. Let's now try to switch to user \"shivam\". Let's now try to open the \"/etc/shadow\" file. The operating system didn't allow the user \"shivam\" to read the content of the \"/etc/shadow\" file. This is an important file in Linux which stores the passwords of users. This file can only be accessed by root or users who have the superuser privileges. The sudo command allows a user to run commands with the security privileges of the root user. Do remember that the root user has all the privileges on a system. We can also use su command to switch to the root user and open the above file but doing that will require the password of the root user. An alternative way which is preferred on most modern operating systems is to use sudo command for becoming a superuser. Using this way, a user has to enter his/her password and they need to be a part of the sudo group. How to provide superpriveleges to other users ? Let's first switch to the root user using su command. Do note that using the below command will need you to enter the password for the root user. In case, you forgot to set a password for the root user, type \"exit\" and you will be back as the root user. Now, set up a password using the passwd command. The file /etc/sudoers holds the names of users permitted to invoke sudo . In redhat operating systems, this file is not present by default. We will need to install sudo. We will discuss the yum command in detail in later sections. Try to open the \"/etc/sudoers\" file on the system. The file has a lot of information. This file stores the rules that users must follow when running the sudo command. For example, root is allowed to run any commands from anywhere. One easy way of providing root access to users is to add them to a group which has permissions to run all the commands. \"wheel\" is a group in redhat Linux with such privileges. Let's add the user \"shivam\" to this group so that it also has sudo privileges. Let's now switch back to user \"shivam\" and try to access the \"/etc/shadow\" file. We need to use sudo before running the command since it can only be accessed with the sudo privileges. We have already given sudo privileges to user \u201cshivam\u201d by adding him to the group \u201cwheel\u201d. File Permissions On a Linux operating system, each file and directory is assigned access permissions for the owner of the file, the members of a group of related users and everybody else. This is to make sure that one user is not allowed to access the files and resources of another user. To see the permissions of a file, we can use the ls command. Let's look at the permissions of /etc/passwd file. Let's go over some of the important fields in the output that are related to file permissions. Chmod command The chmod command is used to modify files and directories permissions in Linux. The chmod command accepts permissions in as a numerical argument. We can think of permission as a series of bits with 1 representing True or allowed and 0 representing False or not allowed. Permission rwx Binary Decimal Read, write and execute rwx 111 7 Read and write rw- 110 6 Read and execute r-x 101 5 Read only r-- 100 4 Write and execute -wx 011 3 Write only -w- 010 2 Execute only --x 001 1 None --- 000 0 We will now create a new file and check the permission of the file. The group owner doesn't have the permission to write to this file. Let's give the group owner or root the permission to write to it using chmod command. Chmod command can be also used to change the permissions of a directory in the similar way. Chown command The chown command is used to change the owner of files or directories in Linux. Command syntax: chown \\ \\ In case, we do not have sudo privileges, we need to use sudo command . Let's switch to user 'shivam' and try changing the owner. We have also changed the owner of the file to root before running the below command. Chown command can also be used to change the owner of a directory in the similar way. Chgrp command The chgrp command can be used to change the group ownership of files or directories in Linux. The syntax is very similar to that of chown command. Chgrp command can also be used to change the owner of a directory in the similar way. SSH Command The ssh command is used for logging into the remote systems, transfer files between systems and for executing commands on a remote machine. SSH stands for secure shell and is used to provide an encrypted secured connection between two hosts over an insecure network like the internet. Reference: https://www.ssh.com/ssh/command/ We will now discuss passwordless authentication which is secure and most commonly used for ssh authentication. Passwordless Authentication Using SSH Using this method, we can ssh into hosts without entering the password. This method is also useful when we want some scripts to perform ssh-related tasks. Passwordless authentication requires the use of a public and private key pair. As the name implies, the public key can be shared with anyone but the private key should be kept private. Lets not get into the details of how this authentication works. You can read more about it here Steps for setting up a passwordless authentication with a remote host: Generating public-private key pair If we already have a key pair stored in \\~/.ssh directory, we will not need to generate keys again. Install openssh package which contains all the commands related to ssh. Generate a key pair using the ssh-keygen command. One can choose the default values for all prompts. After running the ssh-keygen command successfully, we should see two keys present in the \\~/.ssh directory. Id_rsa is the private key and id_rsa.pub is the public key. Do note that the private key can only be read and modified by you. Transferring the public key to the remote host There are multiple ways to transfer the public key to the remote server. We will look at one of the most common ways of doing it using the ssh-copy-id command. Install the openssh-clients package to use ssh-copy-id command. Use the ssh-copy-id command to copy your public key to the remote host. Now, ssh into the remote host using the password authentication. Our public key should be there in \\~/.ssh/authorized_keys now. \\~/.ssh/authorized_key contains a list of public keys. The users associated with these public keys have the ssh access into the remote host. How to run commands on a remote host ? General syntax: ssh \\@\\ \\ How to transfer files from one host to another host ? General syntax: scp \\ \\ Package Management Package management is the process of installing and managing software on the system. We can install the packages which we require from the Linux package distributor. Different distributors use different packaging systems. Packaging systems Distributions Debian style (.deb) Debian, Ubuntu Red Hat style (.rpm) Fedora, CentOS, Red Hat Enterprise Linux Popular Packaging Systems in Linux Command Description yum install \\ Installs a package on your system yum update \\ Updates a package to it's latest available version yum remove \\ Removes a package from your system yum search \\ Searches for a particular keyword DNF is the successor to YUM which is now used in Fedora for installing and managing packages. DNF may replace YUM in the future on all RPM based Linux distributions. We did find an exact match for the keyword httpd when we searched using yum search command. Let's now install the httpd package. After httpd is installed, we will use the yum remove command to remove httpd package. Process Management In this section, we will study about some useful commands that can be used to monitor the processes on Linux systems. ps (process status) The ps command is used to know the information of a process or list of processes. If you get an error \"ps command not found\" while running ps command, do install procps package. ps without any arguments is not very useful. Let's try to list all the processes on the system by using the below command. Reference: https://unix.stackexchange.com/questions/106847/what-does-aux-mean-in-ps-aux We can use an additional argument with ps command to list the information about the process with a specific process ID. We can use grep in combination with ps command to list only specific processes. top The top command is used to show information about Linux processes running on the system in real time. It also shows a summary of the system information. For each process, top lists down the process ID, owner, priority, state, cpu utilization, memory utilization and much more information. It also lists down the memory utilization and cpu utilization of the system as a whole along with system uptime and cpu load average. Memory Management In this section, we will study about some useful commands that can be used to view information about the system memory. free The free command is used to display the memory usage of the system. The command displays the total free and used space available in the RAM along with space occupied by the caches/buffers. free command by default shows the memory usage in kilobytes. We can use an additional argument to get the data in human-readable format. vmstat The vmstat command can be used to display the memory usage along with additional information about io and cpu usage. Checking Disk Space In this section, we will study about some useful commands that can be used to view disk space on Linux. df (disk free) The df command is used to display the free and available space for each mounted file system. du (disk usage) The du command is used to display disk usage of files and directories on the system. The below command can be used to display the top 5 largest directories in the root directory. Daemons A computer program that runs as a background process is called a daemon. Traditionally, the name of daemon processes ended with d - sshd, httpd etc. We cannot interact with a daemon process as they run in the background. Services and daemons are used interchangeably most of the time. Systemd Systemd is a system and service manager for Linux operating systems. Systemd units are the building blocks of systemd. These units are represented by unit configuration files. The below examples shows the unit configuration files available at /usr/lib/systemd/system which are distributed by installed RPM packages. We are more interested in the configuration file that ends with service as these are service units. Managing System Services Service units end with .service file extension. Systemctl command can be used to start/stop/restart the services managed by systemd. Command Description systemctl start name.service Starts a service systemctl stop name.service Stops a service systemctl restart name.service Restarts a service systemctl status name.service Check the status of a service systemctl reload name.service Reload the configuration of a service Logs In this section, we will talk about some important files and directories which can be very useful for viewing system logs and applications logs in Linux. These logs can be very useful when you are troubleshooting on the system.","title":"Server Administration"},{"location":"level101/linux_basics/linux_server_administration/#linux-server-administration","text":"In this course will try to cover some of the common tasks that a linux server administrator performs. We will first try to understand what a particular command does and then try to understand the commands using examples. Do keep in mind that it's very important to practice the Linux commands on your own.","title":"Linux Server Administration"},{"location":"level101/linux_basics/linux_server_administration/#lab-environment-setup","text":"Install docker on your system - https://docs.docker.com/engine/install/ We will be running all the commands on Red Hat Enterprise Linux (RHEL) 8 system. We will run most of the commands used in this module in the above Docker container.","title":"Lab Environment Setup"},{"location":"level101/linux_basics/linux_server_administration/#multi-user-operating-systems","text":"An operating system is considered as multi-user if it allows multiple people/users to use a computer and not affect each other's files and preferences. Linux based operating systems are multi-user in nature as it allows multiple users to access the system at the same time. A typical computer will only have one keyboard and monitor but multiple users can log in via SSH if the computer is connected to the network. We will cover more about SSH later. As a server administrator, we are mostly concerned with the Linux servers which are physically present at a very large distance from us. We can connect to these servers with the help of remote login methods like SSH. Since Linux supports multiple users, we need to have a method which can protect the users from each other. One user should not be able to access and modify files of other users","title":"Multi-User Operating Systems"},{"location":"level101/linux_basics/linux_server_administration/#usergroup-management","text":"Users in Linux has an associated user ID called UID attached to them. Users also has a home directory and a login shell associated with them. A group is a collection of one or more users. A group makes it easier to share permissions among a group of users. Each group has a group ID called GID associated with it.","title":"User/Group Management"},{"location":"level101/linux_basics/linux_server_administration/#id-command","text":"id command can be used to find the uid and gid associated with an user. It also lists down the groups to which the user belongs to. The uid and gid associated with the root user is 0. A good way to find out the current user in Linux is to use the whoami command. \"root\" user or superuser is the most privileged user with unrestricted access to all the resources on the system. It has UID 0","title":"id command"},{"location":"level101/linux_basics/linux_server_administration/#important-files-associated-with-usersgroups","text":"/etc/passwd Stores the user name, the uid, the gid, the home directory, the login shell etc /etc/shadow Stores the password associated with the users /etc/group Stores information about different groups on the system If you want to understand each filed discussed in the above outputs, you can go through below links: https://tldp.org/LDP/lame/LAME/linux-admin-made-easy/shadow-file-formats.html https://tldp.org/HOWTO/User-Authentication-HOWTO/x71.html","title":"Important files associated with users/groups"},{"location":"level101/linux_basics/linux_server_administration/#important-commands-for-managing-users","text":"Some of the commands which are used frequently to manage users/groups on Linux are following: useradd - Creates a new user passwd - Adds or modifies passwords for a user usermod - Modifies attributes of an user userdel - Deletes an user","title":"Important commands for managing users"},{"location":"level101/linux_basics/linux_server_administration/#useradd","text":"The useradd command adds a new user in Linux. We will create a new user 'shivam'. We will also verify that the user has been created by tailing the /etc/passwd file. The uid and gid are 1000 for the newly created user. The home directory assigned to the user is /home/shivam and the login shell assigned is /bin/bash. Do note that the user home directory and login shell can be modified later on. If we do not specify any value for attributes like home directory or login shell, default values will be assigned to the user. We can also override these default values when creating a new user.","title":"useradd"},{"location":"level101/linux_basics/linux_server_administration/#passwd","text":"The passwd command is used to create or modify passwords for a user. In the above examples, we have not assigned any password for users 'shivam' or 'amit' while creating them. \"!!\" in an account entry in shadow means the account of an user has been created, but not yet given a password. Let's now try to create a password for user \"shivam\". Do remember the password as we will be later using examples where it will be useful. Also, let's change the password for the root user now. When we switch from a normal user to root user, it will request you for a password. Also, when you login using root user, the password will be asked.","title":"passwd"},{"location":"level101/linux_basics/linux_server_administration/#usermod","text":"The usermod command is used to modify the attributes of an user like the home directory or the shell. Let's try to modify the login shell of user \"amit\" to \"/bin/bash\". In a similar way, you can also modify many other attributes for a user. Try 'usermod -h' for a list of attributes you can modify.","title":"usermod"},{"location":"level101/linux_basics/linux_server_administration/#userdel","text":"The userdel command is used to remove a user on Linux. Once we remove a user, all the information related to that user will be removed. Let's try to delete the user \"amit\". After deleting the user, you will not find the entry for that user in \"/etc/passwd\" or \"/etc/shadow\" file.","title":"userdel"},{"location":"level101/linux_basics/linux_server_administration/#important-commands-for-managing-groups","text":"Commands for managing groups are quite similar to the commands used for managing users. Each command is not explained in detail here as they are quite similar. You can try running these commands on your system. groupadd \\ Creates a new group groupmod \\ Modifies attributes of a group groupdel \\ Deletes a group gpasswd \\ Modifies password for group We will now try to add user \"shivam\" to the group we have created above.","title":"Important commands for managing groups"},{"location":"level101/linux_basics/linux_server_administration/#becoming-a-superuser","text":"Before running the below commands, do make sure that you have set up a password for user \"shivam\" and user \"root\" using the passwd command described in the above section. The su command can be used to switch users in Linux. Let's now try to switch to user \"shivam\". Let's now try to open the \"/etc/shadow\" file. The operating system didn't allow the user \"shivam\" to read the content of the \"/etc/shadow\" file. This is an important file in Linux which stores the passwords of users. This file can only be accessed by root or users who have the superuser privileges. The sudo command allows a user to run commands with the security privileges of the root user. Do remember that the root user has all the privileges on a system. We can also use su command to switch to the root user and open the above file but doing that will require the password of the root user. An alternative way which is preferred on most modern operating systems is to use sudo command for becoming a superuser. Using this way, a user has to enter his/her password and they need to be a part of the sudo group. How to provide superpriveleges to other users ? Let's first switch to the root user using su command. Do note that using the below command will need you to enter the password for the root user. In case, you forgot to set a password for the root user, type \"exit\" and you will be back as the root user. Now, set up a password using the passwd command. The file /etc/sudoers holds the names of users permitted to invoke sudo . In redhat operating systems, this file is not present by default. We will need to install sudo. We will discuss the yum command in detail in later sections. Try to open the \"/etc/sudoers\" file on the system. The file has a lot of information. This file stores the rules that users must follow when running the sudo command. For example, root is allowed to run any commands from anywhere. One easy way of providing root access to users is to add them to a group which has permissions to run all the commands. \"wheel\" is a group in redhat Linux with such privileges. Let's add the user \"shivam\" to this group so that it also has sudo privileges. Let's now switch back to user \"shivam\" and try to access the \"/etc/shadow\" file. We need to use sudo before running the command since it can only be accessed with the sudo privileges. We have already given sudo privileges to user \u201cshivam\u201d by adding him to the group \u201cwheel\u201d.","title":"Becoming a Superuser"},{"location":"level101/linux_basics/linux_server_administration/#file-permissions","text":"On a Linux operating system, each file and directory is assigned access permissions for the owner of the file, the members of a group of related users and everybody else. This is to make sure that one user is not allowed to access the files and resources of another user. To see the permissions of a file, we can use the ls command. Let's look at the permissions of /etc/passwd file. Let's go over some of the important fields in the output that are related to file permissions.","title":"File Permissions"},{"location":"level101/linux_basics/linux_server_administration/#chmod-command","text":"The chmod command is used to modify files and directories permissions in Linux. The chmod command accepts permissions in as a numerical argument. We can think of permission as a series of bits with 1 representing True or allowed and 0 representing False or not allowed. Permission rwx Binary Decimal Read, write and execute rwx 111 7 Read and write rw- 110 6 Read and execute r-x 101 5 Read only r-- 100 4 Write and execute -wx 011 3 Write only -w- 010 2 Execute only --x 001 1 None --- 000 0 We will now create a new file and check the permission of the file. The group owner doesn't have the permission to write to this file. Let's give the group owner or root the permission to write to it using chmod command. Chmod command can be also used to change the permissions of a directory in the similar way.","title":"Chmod command"},{"location":"level101/linux_basics/linux_server_administration/#chown-command","text":"The chown command is used to change the owner of files or directories in Linux. Command syntax: chown \\ \\ In case, we do not have sudo privileges, we need to use sudo command . Let's switch to user 'shivam' and try changing the owner. We have also changed the owner of the file to root before running the below command. Chown command can also be used to change the owner of a directory in the similar way.","title":"Chown command"},{"location":"level101/linux_basics/linux_server_administration/#chgrp-command","text":"The chgrp command can be used to change the group ownership of files or directories in Linux. The syntax is very similar to that of chown command. Chgrp command can also be used to change the owner of a directory in the similar way.","title":"Chgrp command"},{"location":"level101/linux_basics/linux_server_administration/#ssh-command","text":"The ssh command is used for logging into the remote systems, transfer files between systems and for executing commands on a remote machine. SSH stands for secure shell and is used to provide an encrypted secured connection between two hosts over an insecure network like the internet. Reference: https://www.ssh.com/ssh/command/ We will now discuss passwordless authentication which is secure and most commonly used for ssh authentication.","title":"SSH Command"},{"location":"level101/linux_basics/linux_server_administration/#passwordless-authentication-using-ssh","text":"Using this method, we can ssh into hosts without entering the password. This method is also useful when we want some scripts to perform ssh-related tasks. Passwordless authentication requires the use of a public and private key pair. As the name implies, the public key can be shared with anyone but the private key should be kept private. Lets not get into the details of how this authentication works. You can read more about it here Steps for setting up a passwordless authentication with a remote host: Generating public-private key pair If we already have a key pair stored in \\~/.ssh directory, we will not need to generate keys again. Install openssh package which contains all the commands related to ssh. Generate a key pair using the ssh-keygen command. One can choose the default values for all prompts. After running the ssh-keygen command successfully, we should see two keys present in the \\~/.ssh directory. Id_rsa is the private key and id_rsa.pub is the public key. Do note that the private key can only be read and modified by you. Transferring the public key to the remote host There are multiple ways to transfer the public key to the remote server. We will look at one of the most common ways of doing it using the ssh-copy-id command. Install the openssh-clients package to use ssh-copy-id command. Use the ssh-copy-id command to copy your public key to the remote host. Now, ssh into the remote host using the password authentication. Our public key should be there in \\~/.ssh/authorized_keys now. \\~/.ssh/authorized_key contains a list of public keys. The users associated with these public keys have the ssh access into the remote host.","title":"Passwordless Authentication Using SSH"},{"location":"level101/linux_basics/linux_server_administration/#how-to-run-commands-on-a-remote-host","text":"General syntax: ssh \\@\\ \\","title":"How to run commands on a remote host ?"},{"location":"level101/linux_basics/linux_server_administration/#how-to-transfer-files-from-one-host-to-another-host","text":"General syntax: scp \\ \\","title":"How to transfer files from one host to another host ?"},{"location":"level101/linux_basics/linux_server_administration/#package-management","text":"Package management is the process of installing and managing software on the system. We can install the packages which we require from the Linux package distributor. Different distributors use different packaging systems. Packaging systems Distributions Debian style (.deb) Debian, Ubuntu Red Hat style (.rpm) Fedora, CentOS, Red Hat Enterprise Linux Popular Packaging Systems in Linux Command Description yum install \\ Installs a package on your system yum update \\ Updates a package to it's latest available version yum remove \\ Removes a package from your system yum search \\ Searches for a particular keyword DNF is the successor to YUM which is now used in Fedora for installing and managing packages. DNF may replace YUM in the future on all RPM based Linux distributions. We did find an exact match for the keyword httpd when we searched using yum search command. Let's now install the httpd package. After httpd is installed, we will use the yum remove command to remove httpd package.","title":"Package Management"},{"location":"level101/linux_basics/linux_server_administration/#process-management","text":"In this section, we will study about some useful commands that can be used to monitor the processes on Linux systems.","title":"Process Management"},{"location":"level101/linux_basics/linux_server_administration/#ps-process-status","text":"The ps command is used to know the information of a process or list of processes. If you get an error \"ps command not found\" while running ps command, do install procps package. ps without any arguments is not very useful. Let's try to list all the processes on the system by using the below command. Reference: https://unix.stackexchange.com/questions/106847/what-does-aux-mean-in-ps-aux We can use an additional argument with ps command to list the information about the process with a specific process ID. We can use grep in combination with ps command to list only specific processes.","title":"ps (process status)"},{"location":"level101/linux_basics/linux_server_administration/#top","text":"The top command is used to show information about Linux processes running on the system in real time. It also shows a summary of the system information. For each process, top lists down the process ID, owner, priority, state, cpu utilization, memory utilization and much more information. It also lists down the memory utilization and cpu utilization of the system as a whole along with system uptime and cpu load average.","title":"top"},{"location":"level101/linux_basics/linux_server_administration/#memory-management","text":"In this section, we will study about some useful commands that can be used to view information about the system memory.","title":"Memory Management"},{"location":"level101/linux_basics/linux_server_administration/#free","text":"The free command is used to display the memory usage of the system. The command displays the total free and used space available in the RAM along with space occupied by the caches/buffers. free command by default shows the memory usage in kilobytes. We can use an additional argument to get the data in human-readable format.","title":"free"},{"location":"level101/linux_basics/linux_server_administration/#vmstat","text":"The vmstat command can be used to display the memory usage along with additional information about io and cpu usage.","title":"vmstat"},{"location":"level101/linux_basics/linux_server_administration/#checking-disk-space","text":"In this section, we will study about some useful commands that can be used to view disk space on Linux.","title":"Checking Disk Space"},{"location":"level101/linux_basics/linux_server_administration/#df-disk-free","text":"The df command is used to display the free and available space for each mounted file system.","title":"df (disk free)"},{"location":"level101/linux_basics/linux_server_administration/#du-disk-usage","text":"The du command is used to display disk usage of files and directories on the system. The below command can be used to display the top 5 largest directories in the root directory.","title":"du (disk usage)"},{"location":"level101/linux_basics/linux_server_administration/#daemons","text":"A computer program that runs as a background process is called a daemon. Traditionally, the name of daemon processes ended with d - sshd, httpd etc. We cannot interact with a daemon process as they run in the background. Services and daemons are used interchangeably most of the time.","title":"Daemons"},{"location":"level101/linux_basics/linux_server_administration/#systemd","text":"Systemd is a system and service manager for Linux operating systems. Systemd units are the building blocks of systemd. These units are represented by unit configuration files. The below examples shows the unit configuration files available at /usr/lib/systemd/system which are distributed by installed RPM packages. We are more interested in the configuration file that ends with service as these are service units.","title":"Systemd"},{"location":"level101/linux_basics/linux_server_administration/#managing-system-services","text":"Service units end with .service file extension. Systemctl command can be used to start/stop/restart the services managed by systemd. Command Description systemctl start name.service Starts a service systemctl stop name.service Stops a service systemctl restart name.service Restarts a service systemctl status name.service Check the status of a service systemctl reload name.service Reload the configuration of a service","title":"Managing System Services"},{"location":"level101/linux_basics/linux_server_administration/#logs","text":"In this section, we will talk about some important files and directories which can be very useful for viewing system logs and applications logs in Linux. These logs can be very useful when you are troubleshooting on the system.","title":"Logs"},{"location":"level101/linux_networking/conclusion/","text":"Conclusion With this we have traversed through the TCP/IP stack completely. We hope there will be a different perspective when one opens any website in the browser post the course. During the course we have also dissected what are common tasks in this pipeline which falls under the ambit of SRE. Post Training Exercises Setup own DNS resolver in the dev environment which acts as an authoritative DNS server for example.com and forwarder for other domains. Update resolv.conf to use the new DNS resolver running in localhost Set up a site dummy.example.com in localhost and run a webserver with a self signed certificate. Update the trusted CAs or pass self signed CA\u2019s public key as a parameter so that curl https://dummy.example.com -v works properly without self signed cert warning Update the routing table to use another host(container/VM) in the same network as a gateway for 8.8.8.8/32 and run ping 8.8.8.8. Do the packet capture on the new gateway to see L3 hop is working as expected(might need to disable icmp_redirect)","title":"Conclusion"},{"location":"level101/linux_networking/conclusion/#conclusion","text":"With this we have traversed through the TCP/IP stack completely. We hope there will be a different perspective when one opens any website in the browser post the course. During the course we have also dissected what are common tasks in this pipeline which falls under the ambit of SRE.","title":"Conclusion"},{"location":"level101/linux_networking/conclusion/#post-training-exercises","text":"Setup own DNS resolver in the dev environment which acts as an authoritative DNS server for example.com and forwarder for other domains. Update resolv.conf to use the new DNS resolver running in localhost Set up a site dummy.example.com in localhost and run a webserver with a self signed certificate. Update the trusted CAs or pass self signed CA\u2019s public key as a parameter so that curl https://dummy.example.com -v works properly without self signed cert warning Update the routing table to use another host(container/VM) in the same network as a gateway for 8.8.8.8/32 and run ping 8.8.8.8. Do the packet capture on the new gateway to see L3 hop is working as expected(might need to disable icmp_redirect)","title":"Post Training Exercises"},{"location":"level101/linux_networking/dns/","text":"DNS Domain Names are the simple human-readable names for websites. The Internet understands only IP addresses, but since memorizing incoherent numbers is not practical, domain names are used instead. These domain names are translated into IP addresses by the DNS infrastructure. When somebody tries to open www.linkedin.com in the browser, the browser tries to convert www.linkedin.com to an IP Address. This process is called DNS resolution. A simple pseudocode depicting this process looks this ip, err = getIPAddress(domainName) if err: print(\u201cunknown Host Exception while trying to resolve:%s\u201d.format(domainName)) Now let\u2019s try to understand what happens inside the getIPAddress function. The browser would have a DNS cache of its own where it checks if there is a mapping for the domainName to an IP Address already available, in which case the browser uses that IP address. If no such mapping exists, the browser calls gethostbyname syscall to ask the operating system to find the IP address for the given domainName def getIPAddress(domainName): resp, fail = lookupCache(domainName) If not fail: return resp else: resp, err = gethostbyname(domainName) if err: return null, err else: return resp Now lets understand what operating system kernel does when the gethostbyname function is called. The Linux operating system looks at the file /etc/nsswitch.conf file which usually has a line hosts: files dns This line means the OS has to look up first in file (/etc/hosts) and then use DNS protocol to do the resolution if there is no match in /etc/hosts. The file /etc/hosts is of format IPAddress FQDN [FQDN].* 127.0.0.1 localhost.localdomain localhost ::1 localhost.localdomain localhost If a match exists for a domain in this file then that IP address is returned by the OS. Lets add a line to this file 127.0.0.1 test.linkedin.com And then do ping test.linkedin.com ping test.linkedin.com -n PING test.linkedin.com (127.0.0.1) 56(84) bytes of data. 64 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.047 ms 64 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.036 ms 64 bytes from 127.0.0.1: icmp_seq=3 ttl=64 time=0.037 ms As mentioned earlier, if no match exists in /etc/hosts, the OS tries to do a DNS resolution using the DNS protocol. The linux system makes a DNS request to the first IP in /etc/resolv.conf. If there is no response, requests are sent to subsequent servers in resolv.conf. These servers in resolv.conf are called DNS resolvers. The DNS resolvers are populated by DHCP or statically configured by an administrator. Dig is a userspace DNS system which creates and sends request to DNS resolvers and prints the response it receives to the console. #run this command in one shell to capture all DNS requests sudo tcpdump -s 0 -A -i any port 53 #make a dig request from another shell dig linkedin.com 13:19:54.432507 IP 172.19.209.122.56497 > 172.23.195.101.53: 527+ [1au] A? linkedin.com. (41) ....E..E....@.n....z...e...5.1.:... .........linkedin.com.......)........ 13:19:54.485131 IP 172.23.195.101.53 > 172.19.209.122.56497: 527 1/0/1 A 108.174.10.10 (57) ....E..U..@.|. ....e...z.5...A...............linkedin.com..............3..l. ..)........ The packet capture shows a request is made to 172.23.195.101:53 (this is the resolver in /etc/resolv.conf) for linkedin.com and a response is received from 172.23.195.101 with the IP address of linkedin.com 108.174.10.10 Now let's try to understand how DNS resolver tries to find the IP address of linkedin.com. DNS resolver first looks at its cache. Since many devices in the network can query for the domain name linkedin.com, the name resolution result may already exist in the cache. If there is a cache miss, it starts the DNS resolution process. The DNS server breaks \u201clinkedin.com\u201d to \u201c.\u201d, \u201ccom.\u201d and \u201clinkedin.com.\u201d and starts DNS resolution from \u201c.\u201d. The \u201c.\u201d is called root domain and those IPs are known to the DNS resolver software. DNS resolver queries the root domain Nameservers to find the right nameservers which could respond regarding details for \"com.\". The address of the authoritative nameserver of \u201ccom.\u201d is returned. Now the DNS resolution service contacts the authoritative nameserver for \u201ccom.\u201d to fetch the authoritative nameserver for \u201clinkedin.com\u201d. Once an authoritative nameserver of \u201clinkedin.com\u201d is known, the resolver contacts Linkedin\u2019s nameserver to provide the IP address of \u201clinkedin.com\u201d. This whole process can be visualized by running dig +trace linkedin.com linkedin.com. 3600 IN A 108.174.10.10 This DNS response has 5 fields where the first field is the request and the last field is the response. The second field is the Time to Live which says how long the DNS response is valid in seconds. In this case this mapping of linkedin.com is valid for 1 hour. This is how the resolvers and application(browser) maintain their cache. Any request for linkedin.com beyond 1 hour will be treated as a cache miss as the mapping has expired its TTL and the whole process has to be redone. The 4th field says the type of DNS response/request. Some of the various DNS query types are A, AAAA, NS, TXT, PTR, MX and CNAME. - A record returns IPV4 address of the domain name - AAAA record returns the IPV6 address of the domain Name - NS record returns the authoritative nameserver for the domain name - CNAME records are aliases to the domain names. Some domains point to other domain names and resolving the latter domain name gives an IP which is used as an IP for the former domain name as well. Example www.linkedin.com\u2019s IP address is the same as 2-01-2c3e-005a.cdx.cedexis.net. - For the brevity we are not discussing other DNS record types, the RFC of each of these records are available here . dig A linkedin.com +short 108.174.10.10 dig AAAA linkedin.com +short 2620:109:c002::6cae:a0a dig NS linkedin.com +short dns3.p09.nsone.net. dns4.p09.nsone.net. dns2.p09.nsone.net. ns4.p43.dynect.net. ns1.p43.dynect.net. ns2.p43.dynect.net. ns3.p43.dynect.net. dns1.p09.nsone.net. dig www.linkedin.com CNAME +short 2-01-2c3e-005a.cdx.cedexis.net. Armed with these fundamentals of DNS lets see usecases where DNS is used by SREs. Applications in SRE role This section covers some of the common solutions SRE can derive from DNS Every company has to have its internal DNS infrastructure for intranet sites and internal services like databases and other internal applications like wiki. So there has to be a DNS infrastructure maintained for those domain names by the infrastructure team. This DNS infrastructure has to be optimized and scaled so that it doesn\u2019t become a single point of failure. Failure of the internal DNS infrastructure can cause API calls of microservices to fail and other cascading effects. DNS can also be used for discovering services. For example the hostname serviceb.internal.example.com could list instances which run service b internally in example.com company. Cloud providers provide options to enable DNS discovery( example ) DNS is used by cloud providers and CDN providers to scale their services. In Azure/AWS, Load Balancers are given a CNAME instead of IPAddress. They update the IPAddress of the Loadbalancers as they scale by changing the IP Address of alias domain names. This is one of the reasons why A records of such alias domains are short lived like 1 minute. DNS can also be used to make clients get IP addresses closer to their location so that their HTTP calls can be responded faster if the company has a presence geographically distributed. SRE also has to understand since there is no verification in DNS infrastructure, these responses can be spoofed. This is safeguarded by other protocols like HTTPS(dealt later). DNSSEC protects from forged or manipulated DNS responses. Stale DNS cache can be a problem. Some apps might still be using expired DNS records for their api calls. This is something SRE has to be wary of when doing maintenance. DNS Loadbalancing and service discovery also has to understand TTL and the servers can be removed from the pool only after waiting till TTL post the changes are made to DNS records. If this is not done, a certain portion of the traffic will fail as the server is removed before the TTL.","title":"DNS"},{"location":"level101/linux_networking/dns/#dns","text":"Domain Names are the simple human-readable names for websites. The Internet understands only IP addresses, but since memorizing incoherent numbers is not practical, domain names are used instead. These domain names are translated into IP addresses by the DNS infrastructure. When somebody tries to open www.linkedin.com in the browser, the browser tries to convert www.linkedin.com to an IP Address. This process is called DNS resolution. A simple pseudocode depicting this process looks this ip, err = getIPAddress(domainName) if err: print(\u201cunknown Host Exception while trying to resolve:%s\u201d.format(domainName)) Now let\u2019s try to understand what happens inside the getIPAddress function. The browser would have a DNS cache of its own where it checks if there is a mapping for the domainName to an IP Address already available, in which case the browser uses that IP address. If no such mapping exists, the browser calls gethostbyname syscall to ask the operating system to find the IP address for the given domainName def getIPAddress(domainName): resp, fail = lookupCache(domainName) If not fail: return resp else: resp, err = gethostbyname(domainName) if err: return null, err else: return resp Now lets understand what operating system kernel does when the gethostbyname function is called. The Linux operating system looks at the file /etc/nsswitch.conf file which usually has a line hosts: files dns This line means the OS has to look up first in file (/etc/hosts) and then use DNS protocol to do the resolution if there is no match in /etc/hosts. The file /etc/hosts is of format IPAddress FQDN [FQDN].* 127.0.0.1 localhost.localdomain localhost ::1 localhost.localdomain localhost If a match exists for a domain in this file then that IP address is returned by the OS. Lets add a line to this file 127.0.0.1 test.linkedin.com And then do ping test.linkedin.com ping test.linkedin.com -n PING test.linkedin.com (127.0.0.1) 56(84) bytes of data. 64 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.047 ms 64 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.036 ms 64 bytes from 127.0.0.1: icmp_seq=3 ttl=64 time=0.037 ms As mentioned earlier, if no match exists in /etc/hosts, the OS tries to do a DNS resolution using the DNS protocol. The linux system makes a DNS request to the first IP in /etc/resolv.conf. If there is no response, requests are sent to subsequent servers in resolv.conf. These servers in resolv.conf are called DNS resolvers. The DNS resolvers are populated by DHCP or statically configured by an administrator. Dig is a userspace DNS system which creates and sends request to DNS resolvers and prints the response it receives to the console. #run this command in one shell to capture all DNS requests sudo tcpdump -s 0 -A -i any port 53 #make a dig request from another shell dig linkedin.com 13:19:54.432507 IP 172.19.209.122.56497 > 172.23.195.101.53: 527+ [1au] A? linkedin.com. (41) ....E..E....@.n....z...e...5.1.:... .........linkedin.com.......)........ 13:19:54.485131 IP 172.23.195.101.53 > 172.19.209.122.56497: 527 1/0/1 A 108.174.10.10 (57) ....E..U..@.|. ....e...z.5...A...............linkedin.com..............3..l. ..)........ The packet capture shows a request is made to 172.23.195.101:53 (this is the resolver in /etc/resolv.conf) for linkedin.com and a response is received from 172.23.195.101 with the IP address of linkedin.com 108.174.10.10 Now let's try to understand how DNS resolver tries to find the IP address of linkedin.com. DNS resolver first looks at its cache. Since many devices in the network can query for the domain name linkedin.com, the name resolution result may already exist in the cache. If there is a cache miss, it starts the DNS resolution process. The DNS server breaks \u201clinkedin.com\u201d to \u201c.\u201d, \u201ccom.\u201d and \u201clinkedin.com.\u201d and starts DNS resolution from \u201c.\u201d. The \u201c.\u201d is called root domain and those IPs are known to the DNS resolver software. DNS resolver queries the root domain Nameservers to find the right nameservers which could respond regarding details for \"com.\". The address of the authoritative nameserver of \u201ccom.\u201d is returned. Now the DNS resolution service contacts the authoritative nameserver for \u201ccom.\u201d to fetch the authoritative nameserver for \u201clinkedin.com\u201d. Once an authoritative nameserver of \u201clinkedin.com\u201d is known, the resolver contacts Linkedin\u2019s nameserver to provide the IP address of \u201clinkedin.com\u201d. This whole process can be visualized by running dig +trace linkedin.com linkedin.com. 3600 IN A 108.174.10.10 This DNS response has 5 fields where the first field is the request and the last field is the response. The second field is the Time to Live which says how long the DNS response is valid in seconds. In this case this mapping of linkedin.com is valid for 1 hour. This is how the resolvers and application(browser) maintain their cache. Any request for linkedin.com beyond 1 hour will be treated as a cache miss as the mapping has expired its TTL and the whole process has to be redone. The 4th field says the type of DNS response/request. Some of the various DNS query types are A, AAAA, NS, TXT, PTR, MX and CNAME. - A record returns IPV4 address of the domain name - AAAA record returns the IPV6 address of the domain Name - NS record returns the authoritative nameserver for the domain name - CNAME records are aliases to the domain names. Some domains point to other domain names and resolving the latter domain name gives an IP which is used as an IP for the former domain name as well. Example www.linkedin.com\u2019s IP address is the same as 2-01-2c3e-005a.cdx.cedexis.net. - For the brevity we are not discussing other DNS record types, the RFC of each of these records are available here . dig A linkedin.com +short 108.174.10.10 dig AAAA linkedin.com +short 2620:109:c002::6cae:a0a dig NS linkedin.com +short dns3.p09.nsone.net. dns4.p09.nsone.net. dns2.p09.nsone.net. ns4.p43.dynect.net. ns1.p43.dynect.net. ns2.p43.dynect.net. ns3.p43.dynect.net. dns1.p09.nsone.net. dig www.linkedin.com CNAME +short 2-01-2c3e-005a.cdx.cedexis.net. Armed with these fundamentals of DNS lets see usecases where DNS is used by SREs.","title":"DNS"},{"location":"level101/linux_networking/dns/#applications-in-sre-role","text":"This section covers some of the common solutions SRE can derive from DNS Every company has to have its internal DNS infrastructure for intranet sites and internal services like databases and other internal applications like wiki. So there has to be a DNS infrastructure maintained for those domain names by the infrastructure team. This DNS infrastructure has to be optimized and scaled so that it doesn\u2019t become a single point of failure. Failure of the internal DNS infrastructure can cause API calls of microservices to fail and other cascading effects. DNS can also be used for discovering services. For example the hostname serviceb.internal.example.com could list instances which run service b internally in example.com company. Cloud providers provide options to enable DNS discovery( example ) DNS is used by cloud providers and CDN providers to scale their services. In Azure/AWS, Load Balancers are given a CNAME instead of IPAddress. They update the IPAddress of the Loadbalancers as they scale by changing the IP Address of alias domain names. This is one of the reasons why A records of such alias domains are short lived like 1 minute. DNS can also be used to make clients get IP addresses closer to their location so that their HTTP calls can be responded faster if the company has a presence geographically distributed. SRE also has to understand since there is no verification in DNS infrastructure, these responses can be spoofed. This is safeguarded by other protocols like HTTPS(dealt later). DNSSEC protects from forged or manipulated DNS responses. Stale DNS cache can be a problem. Some apps might still be using expired DNS records for their api calls. This is something SRE has to be wary of when doing maintenance. DNS Loadbalancing and service discovery also has to understand TTL and the servers can be removed from the pool only after waiting till TTL post the changes are made to DNS records. If this is not done, a certain portion of the traffic will fail as the server is removed before the TTL.","title":"Applications in SRE role"},{"location":"level101/linux_networking/http/","text":"HTTP Till this point we have only got the IP address of linkedin.com. The HTML page of linkedin.com is served by HTTP protocol which the browser renders. Browser sends a HTTP request to the IP of the server determined above. Request has a verb GET, PUT, POST followed by a path and query parameters and lines of key value pair which gives information about the client and capabilities of the client like contents it can accept and a body (usually in POST or PUT) # Eg run the following in your container and have a look at the headers curl linkedin.com -v * Connected to linkedin.com (108.174.10.10) port 80 (#0) > GET / HTTP/1.1 > Host: linkedin.com > User-Agent: curl/7.64.1 > Accept: */* > < HTTP/1.1 301 Moved Permanently < Date: Mon, 09 Nov 2020 10:39:43 GMT < X-Li-Pop: prod-esv5 < X-LI-Proto: http/1.1 < Location: https://www.linkedin.com/ < Content-Length: 0 < * Connection #0 to host linkedin.com left intact * Closing connection 0 Here, in the first line GET is the verb, / is the path and 1.1 is the HTTP protocol version. Then there are key value pairs which give client capabilities and some details to the server. The server responds back with HTTP version, Status Code and Status message . Status codes 2xx means success, 3xx denotes redirection, 4xx denotes client side errors and 5xx server side errors. We will now jump in to see the difference between HTTP/1.0 and HTTP/1.1. #On the terminal type telnet www.linkedin.com 80 #Copy and paste the following with an empty new line at last in the telnet STDIN GET / HTTP/1.1 HOST:linkedin.com USER-AGENT: curl This would get server response and waits for next input as the underlying connection to www.linkedin.com can be reused for further queries. While going through TCP, we can understand the benefits of this. But in HTTP/1.0 this connection will be immediately closed after the response meaning new connection has to be opened for each query. HTTP/1.1 can have only one inflight request in an open connection but connection can be reused for multiple requests one after another. One of the benefits of HTTP/2.0 over HTTP/1.1 is we can have multiple inflight requests on the same connection. We are restricting our scope to generic HTTP and not jumping to the intricacies of each protocol version but they should be straight forward to understand post the course. HTTP is called stateless protocol . This section we will try to understand what stateless means. Say we logged in to linkedin.com, each request to linkedin.com from the client will have no context of the user and it makes no sense to prompt user to login for each page/resource. This problem of HTTP is solved by COOKIE . A user is created a session when a user logs in. This session identifier is sent to the browser via SET-COOKIE header. The browser stores the COOKIE till the expiry set by the server and sends the cookie for each request from hereon for linkedin.com. More details on cookies are available here . Cookies are a critical piece of information like password and since HTTP is a plain text protocol, any man in the middle can capture either password or cookies and can breach the privacy of the user. Similarly as discussed during DNS a spoofed IP of linkedin.com can cause a phishing attack on users where an user can give linkedin\u2019s password to login on the malicious site. To solve both problems HTTPs came in place and HTTPs has to be mandated. HTTPS has to provide server identification and encryption of data between client and server. The server administrator has to generate a private public key pair and certificate request. This certificate request has to be signed by a certificate authority which converts the certificate request to a certificate. The server administrator has to update the certificate and private key to the webserver. The certificate has details about the server (like domain name for which it serves, expiry date), public key of the server. The private key is a secret to the server and losing the private key loses the trust the server provides. When clients connect, the client sends a HELLO. The server sends its certificate to the client. The client checks the validity of the cert by seeing if it is within its expiry time, if it is signed by a trusted authority and the hostname in the cert is the same as the server. This validation makes sure the server is the right server and there is no phishing. Once that is validated, the client negotiates a symmetrical key and cipher with the server by encrypting the negotiation with the public key of the server. Nobody else other than the server who has the private key can understand this data. Once negotiation is complete, that symmetric key and algorithm is used for further encryption which can be decrypted only by client and server from thereon as they only know the symmetric key and algorithm. The switch to symmetric algorithm from asymmetric encryption algorithm is to not strain the resources of client devices as symmetric encryption is generally less resource intensive than asymmetric. #Try the following on your terminal to see the cert details like Subject Name(domain name), Issuer details, Expiry date curl https://www.linkedin.com -v * Connected to www.linkedin.com (13.107.42.14) port 443 (#0) * ALPN, offering h2 * ALPN, offering http/1.1 * successfully set certificate verify locations: * CAfile: /etc/ssl/cert.pem CApath: none * TLSv1.2 (OUT), TLS handshake, Client hello (1): } [230 bytes data] * TLSv1.2 (IN), TLS handshake, Server hello (2): { [90 bytes data] * TLSv1.2 (IN), TLS handshake, Certificate (11): { [3171 bytes data] * TLSv1.2 (IN), TLS handshake, Server key exchange (12): { [365 bytes data] * TLSv1.2 (IN), TLS handshake, Server finished (14): { [4 bytes data] * TLSv1.2 (OUT), TLS handshake, Client key exchange (16): } [102 bytes data] * TLSv1.2 (OUT), TLS change cipher, Change cipher spec (1): } [1 bytes data] * TLSv1.2 (OUT), TLS handshake, Finished (20): } [16 bytes data] * TLSv1.2 (IN), TLS change cipher, Change cipher spec (1): { [1 bytes data] * TLSv1.2 (IN), TLS handshake, Finished (20): { [16 bytes data] * SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384 * ALPN, server accepted to use h2 * Server certificate: * subject: C=US; ST=California; L=Sunnyvale; O=LinkedIn Corporation; CN=www.linkedin.com * start date: Oct 2 00:00:00 2020 GMT * expire date: Apr 2 12:00:00 2021 GMT * subjectAltName: host \"www.linkedin.com\" matched cert's \"www.linkedin.com\" * issuer: C=US; O=DigiCert Inc; CN=DigiCert SHA2 Secure Server CA * SSL certificate verify ok. * Using HTTP2, server supports multi-use * Connection state changed (HTTP/2 confirmed) * Copying HTTP/2 data in stream buffer to connection buffer after upgrade: len=0 * Using Stream ID: 1 (easy handle 0x7fb055808200) * Connection state changed (MAX_CONCURRENT_STREAMS == 100)! 0 82117 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0 * Connection #0 to host www.linkedin.com left intact HTTP/2 200 cache-control: no-cache, no-store pragma: no-cache content-length: 82117 content-type: text/html; charset=utf-8 expires: Thu, 01 Jan 1970 00:00:00 GMT set-cookie: JSESSIONID=ajax:2747059799136291014; SameSite=None; Path=/; Domain=.www.linkedin.com; Secure set-cookie: lang=v=2&lang=en-us; SameSite=None; Path=/; Domain=linkedin.com; Secure set-cookie: bcookie=\"v=2&70bd59e3-5a51-406c-8e0d-dd70befa8890\"; domain=.linkedin.com; Path=/; Secure; Expires=Wed, 09-Nov-2022 22:27:42 GMT; SameSite=None set-cookie: bscookie=\"v=1&202011091050107ae9b7ac-fe97-40fc-830d-d7a9ccf80659AQGib5iXwarbY8CCBP94Q39THkgUlx6J\"; domain=.www.linkedin.com; Path=/; Secure; Expires=Wed, 09-Nov-2022 22:27:42 GMT; HttpOnly; SameSite=None set-cookie: lissc=1; domain=.linkedin.com; Path=/; Secure; Expires=Tue, 09-Nov-2021 10:50:10 GMT; SameSite=None set-cookie: lidc=\"b=VGST04:s=V:r=V:g=2201:u=1:i=1604919010:t=1605005410:v=1:sig=AQHe-KzU8i_5Iy6MwnFEsgRct3c9Lh5R\"; Expires=Tue, 10 Nov 2020 10:50:10 GMT; domain=.linkedin.com; Path=/; SameSite=None; Secure x-fs-txn-id: 2b8d5409ba70 x-fs-uuid: 61bbf94956d14516302567fc882b0000 expect-ct: max-age=86400, report-uri=\"https://www.linkedin.com/platform-telemetry/ct\" x-xss-protection: 1; mode=block content-security-policy-report-only: default-src 'none'; connect-src 'self' www.linkedin.com www.google-analytics.com https://dpm.demdex.net/id lnkd.demdex.net blob: https://linkedin.sc.omtrdc.net/b/ss/ static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; script-src 'sha256-THuVhwbXPeTR0HszASqMOnIyxqEgvGyBwSPBKBF/iMc=' 'sha256-PyCXNcEkzRWqbiNr087fizmiBBrq9O6GGD8eV3P09Ik=' 'sha256-2SQ55Erm3CPCb+k03EpNxU9bdV3XL9TnVTriDs7INZ4=' 'sha256-S/KSPe186K/1B0JEjbIXcCdpB97krdzX05S+dHnQjUs=' platform.linkedin.com platform-akam.linkedin.com platform-ecst.linkedin.com platform-azur.linkedin.com static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; img-src data: blob: *; font-src data: *; style-src 'self' 'unsafe-inline' static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; media-src dms.licdn.com; child-src blob: *; frame-src 'self' lnkd.demdex.net linkedin.cdn.qualaroo.com; manifest-src 'self'; report-uri https://www.linkedin.com/platform-telemetry/csp?f=g content-security-policy: default-src *; connect-src 'self' https://media-src.linkedin.com/media/ www.linkedin.com s.c.lnkd.licdn.com m.c.lnkd.licdn.com s.c.exp1.licdn.com s.c.exp2.licdn.com m.c.exp1.licdn.com m.c.exp2.licdn.com wss://*.linkedin.com dms.licdn.com https://dpm.demdex.net/id lnkd.demdex.net blob: https://accounts.google.com/gsi/status https://linkedin.sc.omtrdc.net/b/ss/ www.google-analytics.com static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com media.licdn.com media-exp1.licdn.com media-exp2.licdn.com media-exp3.licdn.com; img-src data: blob: *; font-src data: *; style-src 'unsafe-inline' 'self' static-src.linkedin.com *.licdn.com; script-src 'report-sample' 'unsafe-inline' 'unsafe-eval' 'self' spdy.linkedin.com static-src.linkedin.com *.ads.linkedin.com *.licdn.com static.chartbeat.com www.google-analytics.com ssl.google-analytics.com bcvipva02.rightnowtech.com www.bizographics.com sjs.bizographics.com js.bizographics.com d.la4-c1-was.salesforceliveagent.com slideshare.www.linkedin.com https://snap.licdn.com/li.lms-analytics/ platform.linkedin.com platform-akam.linkedin.com platform-ecst.linkedin.com platform-azur.linkedin.com; object-src 'none'; media-src blob: *; child-src blob: lnkd-communities: voyager: *; frame-ancestors 'self'; report-uri https://www.linkedin.com/platform-telemetry/csp?f=l x-frame-options: sameorigin x-content-type-options: nosniff strict-transport-security: max-age=2592000 x-li-fabric: prod-lva1 x-li-pop: afd-prod-lva1 x-li-proto: http/2 x-li-uuid: Ybv5SVbRRRYwJWf8iCsAAA== x-msedge-ref: Ref A: CFB9AC1D2B0645DDB161CEE4A4909AEF Ref B: BOM02EDGE0712 Ref C: 2020-11-09T10:50:10Z date: Mon, 09 Nov 2020 10:50:10 GMT * Closing connection 0 Here my system has a list of certificate authorities it trusts in this file /etc/ssl/cert.pem. Curl validates the certificate is for www.linkedin.com by seeing the CN section of the subject part of the certificate. It also makes sure the certificate is not expired by seeing the expire date. It also validates the signature on the certificate by using the public key of issuer Digicert in /etc/ssl/cert.pem. Once this is done, using the public key of www.linkedin.com it negotiates cipher TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 with a symmetric key. Subsequent data transfer including first HTTP request uses the same cipher and symmetric key.","title":"HTTP"},{"location":"level101/linux_networking/http/#http","text":"Till this point we have only got the IP address of linkedin.com. The HTML page of linkedin.com is served by HTTP protocol which the browser renders. Browser sends a HTTP request to the IP of the server determined above. Request has a verb GET, PUT, POST followed by a path and query parameters and lines of key value pair which gives information about the client and capabilities of the client like contents it can accept and a body (usually in POST or PUT) # Eg run the following in your container and have a look at the headers curl linkedin.com -v * Connected to linkedin.com (108.174.10.10) port 80 (#0) > GET / HTTP/1.1 > Host: linkedin.com > User-Agent: curl/7.64.1 > Accept: */* > < HTTP/1.1 301 Moved Permanently < Date: Mon, 09 Nov 2020 10:39:43 GMT < X-Li-Pop: prod-esv5 < X-LI-Proto: http/1.1 < Location: https://www.linkedin.com/ < Content-Length: 0 < * Connection #0 to host linkedin.com left intact * Closing connection 0 Here, in the first line GET is the verb, / is the path and 1.1 is the HTTP protocol version. Then there are key value pairs which give client capabilities and some details to the server. The server responds back with HTTP version, Status Code and Status message . Status codes 2xx means success, 3xx denotes redirection, 4xx denotes client side errors and 5xx server side errors. We will now jump in to see the difference between HTTP/1.0 and HTTP/1.1. #On the terminal type telnet www.linkedin.com 80 #Copy and paste the following with an empty new line at last in the telnet STDIN GET / HTTP/1.1 HOST:linkedin.com USER-AGENT: curl This would get server response and waits for next input as the underlying connection to www.linkedin.com can be reused for further queries. While going through TCP, we can understand the benefits of this. But in HTTP/1.0 this connection will be immediately closed after the response meaning new connection has to be opened for each query. HTTP/1.1 can have only one inflight request in an open connection but connection can be reused for multiple requests one after another. One of the benefits of HTTP/2.0 over HTTP/1.1 is we can have multiple inflight requests on the same connection. We are restricting our scope to generic HTTP and not jumping to the intricacies of each protocol version but they should be straight forward to understand post the course. HTTP is called stateless protocol . This section we will try to understand what stateless means. Say we logged in to linkedin.com, each request to linkedin.com from the client will have no context of the user and it makes no sense to prompt user to login for each page/resource. This problem of HTTP is solved by COOKIE . A user is created a session when a user logs in. This session identifier is sent to the browser via SET-COOKIE header. The browser stores the COOKIE till the expiry set by the server and sends the cookie for each request from hereon for linkedin.com. More details on cookies are available here . Cookies are a critical piece of information like password and since HTTP is a plain text protocol, any man in the middle can capture either password or cookies and can breach the privacy of the user. Similarly as discussed during DNS a spoofed IP of linkedin.com can cause a phishing attack on users where an user can give linkedin\u2019s password to login on the malicious site. To solve both problems HTTPs came in place and HTTPs has to be mandated. HTTPS has to provide server identification and encryption of data between client and server. The server administrator has to generate a private public key pair and certificate request. This certificate request has to be signed by a certificate authority which converts the certificate request to a certificate. The server administrator has to update the certificate and private key to the webserver. The certificate has details about the server (like domain name for which it serves, expiry date), public key of the server. The private key is a secret to the server and losing the private key loses the trust the server provides. When clients connect, the client sends a HELLO. The server sends its certificate to the client. The client checks the validity of the cert by seeing if it is within its expiry time, if it is signed by a trusted authority and the hostname in the cert is the same as the server. This validation makes sure the server is the right server and there is no phishing. Once that is validated, the client negotiates a symmetrical key and cipher with the server by encrypting the negotiation with the public key of the server. Nobody else other than the server who has the private key can understand this data. Once negotiation is complete, that symmetric key and algorithm is used for further encryption which can be decrypted only by client and server from thereon as they only know the symmetric key and algorithm. The switch to symmetric algorithm from asymmetric encryption algorithm is to not strain the resources of client devices as symmetric encryption is generally less resource intensive than asymmetric. #Try the following on your terminal to see the cert details like Subject Name(domain name), Issuer details, Expiry date curl https://www.linkedin.com -v * Connected to www.linkedin.com (13.107.42.14) port 443 (#0) * ALPN, offering h2 * ALPN, offering http/1.1 * successfully set certificate verify locations: * CAfile: /etc/ssl/cert.pem CApath: none * TLSv1.2 (OUT), TLS handshake, Client hello (1): } [230 bytes data] * TLSv1.2 (IN), TLS handshake, Server hello (2): { [90 bytes data] * TLSv1.2 (IN), TLS handshake, Certificate (11): { [3171 bytes data] * TLSv1.2 (IN), TLS handshake, Server key exchange (12): { [365 bytes data] * TLSv1.2 (IN), TLS handshake, Server finished (14): { [4 bytes data] * TLSv1.2 (OUT), TLS handshake, Client key exchange (16): } [102 bytes data] * TLSv1.2 (OUT), TLS change cipher, Change cipher spec (1): } [1 bytes data] * TLSv1.2 (OUT), TLS handshake, Finished (20): } [16 bytes data] * TLSv1.2 (IN), TLS change cipher, Change cipher spec (1): { [1 bytes data] * TLSv1.2 (IN), TLS handshake, Finished (20): { [16 bytes data] * SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384 * ALPN, server accepted to use h2 * Server certificate: * subject: C=US; ST=California; L=Sunnyvale; O=LinkedIn Corporation; CN=www.linkedin.com * start date: Oct 2 00:00:00 2020 GMT * expire date: Apr 2 12:00:00 2021 GMT * subjectAltName: host \"www.linkedin.com\" matched cert's \"www.linkedin.com\" * issuer: C=US; O=DigiCert Inc; CN=DigiCert SHA2 Secure Server CA * SSL certificate verify ok. * Using HTTP2, server supports multi-use * Connection state changed (HTTP/2 confirmed) * Copying HTTP/2 data in stream buffer to connection buffer after upgrade: len=0 * Using Stream ID: 1 (easy handle 0x7fb055808200) * Connection state changed (MAX_CONCURRENT_STREAMS == 100)! 0 82117 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0 * Connection #0 to host www.linkedin.com left intact HTTP/2 200 cache-control: no-cache, no-store pragma: no-cache content-length: 82117 content-type: text/html; charset=utf-8 expires: Thu, 01 Jan 1970 00:00:00 GMT set-cookie: JSESSIONID=ajax:2747059799136291014; SameSite=None; Path=/; Domain=.www.linkedin.com; Secure set-cookie: lang=v=2&lang=en-us; SameSite=None; Path=/; Domain=linkedin.com; Secure set-cookie: bcookie=\"v=2&70bd59e3-5a51-406c-8e0d-dd70befa8890\"; domain=.linkedin.com; Path=/; Secure; Expires=Wed, 09-Nov-2022 22:27:42 GMT; SameSite=None set-cookie: bscookie=\"v=1&202011091050107ae9b7ac-fe97-40fc-830d-d7a9ccf80659AQGib5iXwarbY8CCBP94Q39THkgUlx6J\"; domain=.www.linkedin.com; Path=/; Secure; Expires=Wed, 09-Nov-2022 22:27:42 GMT; HttpOnly; SameSite=None set-cookie: lissc=1; domain=.linkedin.com; Path=/; Secure; Expires=Tue, 09-Nov-2021 10:50:10 GMT; SameSite=None set-cookie: lidc=\"b=VGST04:s=V:r=V:g=2201:u=1:i=1604919010:t=1605005410:v=1:sig=AQHe-KzU8i_5Iy6MwnFEsgRct3c9Lh5R\"; Expires=Tue, 10 Nov 2020 10:50:10 GMT; domain=.linkedin.com; Path=/; SameSite=None; Secure x-fs-txn-id: 2b8d5409ba70 x-fs-uuid: 61bbf94956d14516302567fc882b0000 expect-ct: max-age=86400, report-uri=\"https://www.linkedin.com/platform-telemetry/ct\" x-xss-protection: 1; mode=block content-security-policy-report-only: default-src 'none'; connect-src 'self' www.linkedin.com www.google-analytics.com https://dpm.demdex.net/id lnkd.demdex.net blob: https://linkedin.sc.omtrdc.net/b/ss/ static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; script-src 'sha256-THuVhwbXPeTR0HszASqMOnIyxqEgvGyBwSPBKBF/iMc=' 'sha256-PyCXNcEkzRWqbiNr087fizmiBBrq9O6GGD8eV3P09Ik=' 'sha256-2SQ55Erm3CPCb+k03EpNxU9bdV3XL9TnVTriDs7INZ4=' 'sha256-S/KSPe186K/1B0JEjbIXcCdpB97krdzX05S+dHnQjUs=' platform.linkedin.com platform-akam.linkedin.com platform-ecst.linkedin.com platform-azur.linkedin.com static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; img-src data: blob: *; font-src data: *; style-src 'self' 'unsafe-inline' static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com; media-src dms.licdn.com; child-src blob: *; frame-src 'self' lnkd.demdex.net linkedin.cdn.qualaroo.com; manifest-src 'self'; report-uri https://www.linkedin.com/platform-telemetry/csp?f=g content-security-policy: default-src *; connect-src 'self' https://media-src.linkedin.com/media/ www.linkedin.com s.c.lnkd.licdn.com m.c.lnkd.licdn.com s.c.exp1.licdn.com s.c.exp2.licdn.com m.c.exp1.licdn.com m.c.exp2.licdn.com wss://*.linkedin.com dms.licdn.com https://dpm.demdex.net/id lnkd.demdex.net blob: https://accounts.google.com/gsi/status https://linkedin.sc.omtrdc.net/b/ss/ www.google-analytics.com static.licdn.com static-exp1.licdn.com static-exp2.licdn.com static-exp3.licdn.com media.licdn.com media-exp1.licdn.com media-exp2.licdn.com media-exp3.licdn.com; img-src data: blob: *; font-src data: *; style-src 'unsafe-inline' 'self' static-src.linkedin.com *.licdn.com; script-src 'report-sample' 'unsafe-inline' 'unsafe-eval' 'self' spdy.linkedin.com static-src.linkedin.com *.ads.linkedin.com *.licdn.com static.chartbeat.com www.google-analytics.com ssl.google-analytics.com bcvipva02.rightnowtech.com www.bizographics.com sjs.bizographics.com js.bizographics.com d.la4-c1-was.salesforceliveagent.com slideshare.www.linkedin.com https://snap.licdn.com/li.lms-analytics/ platform.linkedin.com platform-akam.linkedin.com platform-ecst.linkedin.com platform-azur.linkedin.com; object-src 'none'; media-src blob: *; child-src blob: lnkd-communities: voyager: *; frame-ancestors 'self'; report-uri https://www.linkedin.com/platform-telemetry/csp?f=l x-frame-options: sameorigin x-content-type-options: nosniff strict-transport-security: max-age=2592000 x-li-fabric: prod-lva1 x-li-pop: afd-prod-lva1 x-li-proto: http/2 x-li-uuid: Ybv5SVbRRRYwJWf8iCsAAA== x-msedge-ref: Ref A: CFB9AC1D2B0645DDB161CEE4A4909AEF Ref B: BOM02EDGE0712 Ref C: 2020-11-09T10:50:10Z date: Mon, 09 Nov 2020 10:50:10 GMT * Closing connection 0 Here my system has a list of certificate authorities it trusts in this file /etc/ssl/cert.pem. Curl validates the certificate is for www.linkedin.com by seeing the CN section of the subject part of the certificate. It also makes sure the certificate is not expired by seeing the expire date. It also validates the signature on the certificate by using the public key of issuer Digicert in /etc/ssl/cert.pem. Once this is done, using the public key of www.linkedin.com it negotiates cipher TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 with a symmetric key. Subsequent data transfer including first HTTP request uses the same cipher and symmetric key.","title":"HTTP"},{"location":"level101/linux_networking/intro/","text":"Linux Networking Fundamentals Prerequisites High-level knowledge of commonly used jargon in TCP/IP stack like DNS, TCP, UDP and HTTP Linux Commandline Basics What to expect from this course Throughout the course, we cover how an SRE can optimize the system to improve their web stack performance and troubleshoot if there is an issue in any of the layers of the networking stack. This course tries to dig through each layer of traditional TCP/IP stack and expects an SRE to have a picture beyond the bird\u2019s eye view of the functioning of the Internet. What is not covered under this course This course spends time on the fundamentals. We are not covering concepts like HTTP/2.0 , QUIC , TCP congestion control protocols , Anycast , BGP , CDN , Tunnels and Multicast . We expect that this course will provide the relevant basics to understand such concepts Birds eye view of the course The course covers the question \u201cWhat happens when you open linkedin.com in your browser?\u201d The course follows the flow of TCP/IP stack.More specifically, the course covers topics of Application layer protocols DNS and HTTP, transport layer protocols UDP and TCP, networking layer protocol IP and Data Link Layer protocol Course Contents DNS UDP HTTP TCP IP Routing","title":"Introduction"},{"location":"level101/linux_networking/intro/#linux-networking-fundamentals","text":"","title":"Linux Networking Fundamentals"},{"location":"level101/linux_networking/intro/#prerequisites","text":"High-level knowledge of commonly used jargon in TCP/IP stack like DNS, TCP, UDP and HTTP Linux Commandline Basics","title":"Prerequisites"},{"location":"level101/linux_networking/intro/#what-to-expect-from-this-course","text":"Throughout the course, we cover how an SRE can optimize the system to improve their web stack performance and troubleshoot if there is an issue in any of the layers of the networking stack. This course tries to dig through each layer of traditional TCP/IP stack and expects an SRE to have a picture beyond the bird\u2019s eye view of the functioning of the Internet.","title":"What to expect from this course"},{"location":"level101/linux_networking/intro/#what-is-not-covered-under-this-course","text":"This course spends time on the fundamentals. We are not covering concepts like HTTP/2.0 , QUIC , TCP congestion control protocols , Anycast , BGP , CDN , Tunnels and Multicast . We expect that this course will provide the relevant basics to understand such concepts","title":"What is not covered under this course"},{"location":"level101/linux_networking/intro/#birds-eye-view-of-the-course","text":"The course covers the question \u201cWhat happens when you open linkedin.com in your browser?\u201d The course follows the flow of TCP/IP stack.More specifically, the course covers topics of Application layer protocols DNS and HTTP, transport layer protocols UDP and TCP, networking layer protocol IP and Data Link Layer protocol","title":"Birds eye view of the course"},{"location":"level101/linux_networking/intro/#course-contents","text":"DNS UDP HTTP TCP IP Routing","title":"Course Contents"},{"location":"level101/linux_networking/ipr/","text":"IP Routing and Data Link Layer We will dig how packets that leave the client reach the server and vice versa. When the packet reaches the IP layer, the transport layer populates source port, destination port. IP/Network layer populates destination IP(discovered from DNS) and then looks up the route to the destination IP on the routing table. #Linux route -n command gives the default routing table route -n Kernel IP routing table Destination Gateway Genmask Flags Metric Ref Use Iface 0.0.0.0 172.17.0.1 0.0.0.0 UG 0 0 0 eth0 172.17.0.0 0.0.0.0 255.255.0.0 U 0 0 0 eth0 Here the destination IP is bitwise AND\u2019d with the Genmask and if the answer is the destination part of the table then that gateway and interface is picked for routing. Here linkedin.com\u2019s IP 108.174.10.10 is AND\u2019d with 255.255.255.0 and the answer we get is 108.174.10.0 which doesn\u2019t match with any destination in the routing table. Then Linux does an AND of destination IP with 0.0.0.0 and we get 0.0.0.0. This answer matches the default row Routing table is processed in the order of more octets of 1 set in genmask and genmask 0.0.0.0 is the default route if nothing matches. At the end of this operation Linux figured out that the packet has to be sent to next hop 172.17.0.1 via eth0. The source IP of the packet will be set as the IP of interface eth0. Now to send the packet to 172.17.0.1 linux has to figure out the MAC address of 172.17.0.1. MAC address is figured by looking at the internal arp cache which stores translation between IP address and MAC address. If there is a cache miss, Linux broadcasts ARP request within the internal network asking who has 172.17.0.1. The owner of the IP sends an ARP response which is cached by the kernel and the kernel sends the packet to the gateway by setting Source mac address as mac address of eth0 and destination mac address of 172.17.0.1 which we got just now. Similar routing lookup process is followed in each hop till the packet reaches the actual server. Transport layer and layers above it come to play only at end servers. During intermediate hops only till the IP/Network layer is involved. One weird gateway we saw in the routing table is 0.0.0.0. This gateway means no Layer3(Network layer) hop is needed to send the packet. Both source and destination are in the same network. Kernel has to figure out the mac of the destination and populate source and destination mac appropriately and send the packet out so that it reaches the destination without any Layer3 hop in the middle As we followed in other modules, lets complete this session with SRE usecases Applications in SRE role Generally the routing table is populated by DHCP and playing around is not a good practice. There can be reasons where one has to play around the routing table but take that path only when it's absolutely necessary Understanding error messages better like, \u201cNo route to host\u201d error can mean mac address of the destination host is not found and it can mean the destination host is down On rare cases looking at the ARP table can help us understand if there is a IP conflict where same IP is assigned to two hosts by mistake and this is causing unexpected behavior","title":"Routing"},{"location":"level101/linux_networking/ipr/#ip-routing-and-data-link-layer","text":"We will dig how packets that leave the client reach the server and vice versa. When the packet reaches the IP layer, the transport layer populates source port, destination port. IP/Network layer populates destination IP(discovered from DNS) and then looks up the route to the destination IP on the routing table. #Linux route -n command gives the default routing table route -n Kernel IP routing table Destination Gateway Genmask Flags Metric Ref Use Iface 0.0.0.0 172.17.0.1 0.0.0.0 UG 0 0 0 eth0 172.17.0.0 0.0.0.0 255.255.0.0 U 0 0 0 eth0 Here the destination IP is bitwise AND\u2019d with the Genmask and if the answer is the destination part of the table then that gateway and interface is picked for routing. Here linkedin.com\u2019s IP 108.174.10.10 is AND\u2019d with 255.255.255.0 and the answer we get is 108.174.10.0 which doesn\u2019t match with any destination in the routing table. Then Linux does an AND of destination IP with 0.0.0.0 and we get 0.0.0.0. This answer matches the default row Routing table is processed in the order of more octets of 1 set in genmask and genmask 0.0.0.0 is the default route if nothing matches. At the end of this operation Linux figured out that the packet has to be sent to next hop 172.17.0.1 via eth0. The source IP of the packet will be set as the IP of interface eth0. Now to send the packet to 172.17.0.1 linux has to figure out the MAC address of 172.17.0.1. MAC address is figured by looking at the internal arp cache which stores translation between IP address and MAC address. If there is a cache miss, Linux broadcasts ARP request within the internal network asking who has 172.17.0.1. The owner of the IP sends an ARP response which is cached by the kernel and the kernel sends the packet to the gateway by setting Source mac address as mac address of eth0 and destination mac address of 172.17.0.1 which we got just now. Similar routing lookup process is followed in each hop till the packet reaches the actual server. Transport layer and layers above it come to play only at end servers. During intermediate hops only till the IP/Network layer is involved. One weird gateway we saw in the routing table is 0.0.0.0. This gateway means no Layer3(Network layer) hop is needed to send the packet. Both source and destination are in the same network. Kernel has to figure out the mac of the destination and populate source and destination mac appropriately and send the packet out so that it reaches the destination without any Layer3 hop in the middle As we followed in other modules, lets complete this session with SRE usecases","title":"IP Routing and Data Link Layer"},{"location":"level101/linux_networking/ipr/#applications-in-sre-role","text":"Generally the routing table is populated by DHCP and playing around is not a good practice. There can be reasons where one has to play around the routing table but take that path only when it's absolutely necessary Understanding error messages better like, \u201cNo route to host\u201d error can mean mac address of the destination host is not found and it can mean the destination host is down On rare cases looking at the ARP table can help us understand if there is a IP conflict where same IP is assigned to two hosts by mistake and this is causing unexpected behavior","title":"Applications in SRE role"},{"location":"level101/linux_networking/tcp/","text":"TCP TCP is a transport layer protocol like UDP but it guarantees reliability, flow control and congestion control. TCP guarantees reliable delivery by using sequence numbers. A TCP connection is established by a three way handshake. In our case, the client sends a SYN packet along with the starting sequence number it plans to use, the server acknowledges the SYN packet and sends a SYN with its sequence number. Once the client acknowledges the syn packet, the connection is established. Each data transferred from here on is considered delivered reliably once acknowledgement for that sequence is received by the concerned party #To understand handshake run packet capture on one bash session tcpdump -S -i any port 80 #Run curl on one bash session curl www.linkedin.com Here client sends a syn flag shown by [S] flag with a sequence number 1522264672. The server acknowledges receipt of SYN with an ack [.] flag and a Syn flag for its sequence number[S]. The server uses the sequence number 1063230400 and acknowledges the client it\u2019s expecting sequence number 1522264673 (client sequence+1). Client sends a zero length acknowledgement packet to the server(server sequence+1) and connection stands established. This is called three way handshake. The client sends a 76 bytes length packet after this and increments its sequence number by 76. Server sends a 170 byte response and closes the connection. This was the difference we were talking about between HTTP/1.1 and HTTP/1.0. In HTTP/1.1 this same connection can be reused which reduces overhead of 3 way handshake for each HTTP request. If a packet is missed between client and server, server won\u2019t send an ack to the client and client would retry sending the packet till the ACK is received. This guarantees reliability. The flow control is established by the win size field in each segment. The win size says available TCP buffer length in the kernel which can be used to buffer received segments. A size 0 means the receiver has a lot of lag to catch from its socket buffer and the sender has to pause sending packets so that receiver can cope up. This flow control protects from slow receiver and fast sender problem TCP also does congestion control which determines how many segments can be in transit without an ack. Linux provides us the ability to configure algorithms for congestion control which we are not covering here. While closing a connection, client/server calls a close syscall. Let's assume client do that. Client\u2019s kernel will send a FIN packet to the server. Server\u2019s kernel can\u2019t close the connection till the close syscall is called by the server application. Once server app calls close, server also sends a FIN packet and client enters into time wait state for 2*MSS(120s) so that this socket can\u2019t be reused for that time period to prevent any TCP state corruptions due to stray stale packets. Armed with our TCP and HTTP knowledge lets see how this is used by SREs in their role Applications in SRE role Scaling HTTP performance using load balancers need consistent knowledge about both TCP and HTTP. There are different kinds of load balancing like L4, L7 load balancing, Direct Server Return etc. HTTPs offloading can be done on Load balancer or directly on servers based on the performance and compliance needs. Tweaking sysctl variables for rmem and wmem like we did for UDP can improve throughput of sender and receiver. Sysctl variable tcp_max_syn_backlog and socket variable somax_conn determines how many connections for which the kernel can complete 3 way handshake before app calling accept syscall. This is much useful in single threaded applications. Once the backlog is full, new connections stay in SYN_RCVD state (when you run netstat) till the application calls accept syscall Apps can run out of file descriptors if there are too many short lived connections. Digging through tcp_reuse and tcp_recycle can help reduce time spent in the time wait state(it has its own risk). Making apps reuse a pool of connections instead of creating ad hoc connection can also help Understanding performance bottlenecks by seeing metrics and classifying whether its a problem in App or network side. Example too many sockets in Close_wait state is a problem on application whereas retransmissions can be a problem more on network or on OS stack than the application itself. Understanding the fundamentals can help us narrow down where the bottleneck is","title":"TCP"},{"location":"level101/linux_networking/tcp/#tcp","text":"TCP is a transport layer protocol like UDP but it guarantees reliability, flow control and congestion control. TCP guarantees reliable delivery by using sequence numbers. A TCP connection is established by a three way handshake. In our case, the client sends a SYN packet along with the starting sequence number it plans to use, the server acknowledges the SYN packet and sends a SYN with its sequence number. Once the client acknowledges the syn packet, the connection is established. Each data transferred from here on is considered delivered reliably once acknowledgement for that sequence is received by the concerned party #To understand handshake run packet capture on one bash session tcpdump -S -i any port 80 #Run curl on one bash session curl www.linkedin.com Here client sends a syn flag shown by [S] flag with a sequence number 1522264672. The server acknowledges receipt of SYN with an ack [.] flag and a Syn flag for its sequence number[S]. The server uses the sequence number 1063230400 and acknowledges the client it\u2019s expecting sequence number 1522264673 (client sequence+1). Client sends a zero length acknowledgement packet to the server(server sequence+1) and connection stands established. This is called three way handshake. The client sends a 76 bytes length packet after this and increments its sequence number by 76. Server sends a 170 byte response and closes the connection. This was the difference we were talking about between HTTP/1.1 and HTTP/1.0. In HTTP/1.1 this same connection can be reused which reduces overhead of 3 way handshake for each HTTP request. If a packet is missed between client and server, server won\u2019t send an ack to the client and client would retry sending the packet till the ACK is received. This guarantees reliability. The flow control is established by the win size field in each segment. The win size says available TCP buffer length in the kernel which can be used to buffer received segments. A size 0 means the receiver has a lot of lag to catch from its socket buffer and the sender has to pause sending packets so that receiver can cope up. This flow control protects from slow receiver and fast sender problem TCP also does congestion control which determines how many segments can be in transit without an ack. Linux provides us the ability to configure algorithms for congestion control which we are not covering here. While closing a connection, client/server calls a close syscall. Let's assume client do that. Client\u2019s kernel will send a FIN packet to the server. Server\u2019s kernel can\u2019t close the connection till the close syscall is called by the server application. Once server app calls close, server also sends a FIN packet and client enters into time wait state for 2*MSS(120s) so that this socket can\u2019t be reused for that time period to prevent any TCP state corruptions due to stray stale packets. Armed with our TCP and HTTP knowledge lets see how this is used by SREs in their role","title":"TCP"},{"location":"level101/linux_networking/tcp/#applications-in-sre-role","text":"Scaling HTTP performance using load balancers need consistent knowledge about both TCP and HTTP. There are different kinds of load balancing like L4, L7 load balancing, Direct Server Return etc. HTTPs offloading can be done on Load balancer or directly on servers based on the performance and compliance needs. Tweaking sysctl variables for rmem and wmem like we did for UDP can improve throughput of sender and receiver. Sysctl variable tcp_max_syn_backlog and socket variable somax_conn determines how many connections for which the kernel can complete 3 way handshake before app calling accept syscall. This is much useful in single threaded applications. Once the backlog is full, new connections stay in SYN_RCVD state (when you run netstat) till the application calls accept syscall Apps can run out of file descriptors if there are too many short lived connections. Digging through tcp_reuse and tcp_recycle can help reduce time spent in the time wait state(it has its own risk). Making apps reuse a pool of connections instead of creating ad hoc connection can also help Understanding performance bottlenecks by seeing metrics and classifying whether its a problem in App or network side. Example too many sockets in Close_wait state is a problem on application whereas retransmissions can be a problem more on network or on OS stack than the application itself. Understanding the fundamentals can help us narrow down where the bottleneck is","title":"Applications in SRE role"},{"location":"level101/linux_networking/udp/","text":"UDP UDP is a transport layer protocol. DNS is an application layer protocol that runs on top of UDP(most of the times). Before jumping into UDP, let's try to understand what an application and transport layer is. DNS protocol is used by a DNS client(eg dig) and DNS server(eg named). The transport layer makes sure the DNS request reaches the DNS server process and similarly the response reaches the DNS client process. Multiple processes can run on a system and they can listen on any ports . DNS servers usually listen on port number 53. When a client makes a DNS request, after filling the necessary application payload, it passes the payload to the kernel via sendto system call. The kernel picks a random port number( >1024 ) as source port number and puts 53 as destination port number and sends the packet to lower layers. When the kernel on server side receives the packet, it checks the port number and queues the packet to the application buffer of the DNS server process which makes a recvfrom system call and reads the packet. This process by the kernel is called multiplexing(combining packets from multiple applications to same lower layers) and demultiplexing(segregating packets from single lower layer to multiple applications). Multiplexing and Demultiplexing is done by the Transport layer. UDP is one of the simplest transport layer protocol and it does only multiplexing and demultiplexing. Another common transport layer protocol TCP does a bunch of other things like reliable communication, flow control and congestion control. UDP is designed to be lightweight and handle communications with little overhead. So it doesn\u2019t do anything beyond multiplexing and demultiplexing. If applications running on top of UDP need any of the features of TCP, they have to implement that in their application This example from python wiki covers a sample UDP client and server where \u201cHello World\u201d is an application payload sent to server listening on port number 5005. The server receives the packet and prints the \u201cHello World\u201d string from the client Applications in SRE role If the underlying network is slow and the UDP layer is unable to queue packets down to the networking layer, sendto syscall from the application will hang till the kernel finds some of its buffer is freed. This can affect the throughput of the system. Increasing write memory buffer values using sysctl variables net.core.wmem_max and net.core.wmem_default provides some cushion to the application from the slow network Similarly if the receiver process is slow in consuming from its buffer, the kernel has to drop packets which it can\u2019t queue due to the buffer being full. Since UDP doesn\u2019t guarantee reliability these dropped packets can cause data loss unless tracked by the application layer. Increasing sysctl variables rmem_default and rmem_max can provide some cushion to slow applications from fast senders.","title":"UDP"},{"location":"level101/linux_networking/udp/#udp","text":"UDP is a transport layer protocol. DNS is an application layer protocol that runs on top of UDP(most of the times). Before jumping into UDP, let's try to understand what an application and transport layer is. DNS protocol is used by a DNS client(eg dig) and DNS server(eg named). The transport layer makes sure the DNS request reaches the DNS server process and similarly the response reaches the DNS client process. Multiple processes can run on a system and they can listen on any ports . DNS servers usually listen on port number 53. When a client makes a DNS request, after filling the necessary application payload, it passes the payload to the kernel via sendto system call. The kernel picks a random port number( >1024 ) as source port number and puts 53 as destination port number and sends the packet to lower layers. When the kernel on server side receives the packet, it checks the port number and queues the packet to the application buffer of the DNS server process which makes a recvfrom system call and reads the packet. This process by the kernel is called multiplexing(combining packets from multiple applications to same lower layers) and demultiplexing(segregating packets from single lower layer to multiple applications). Multiplexing and Demultiplexing is done by the Transport layer. UDP is one of the simplest transport layer protocol and it does only multiplexing and demultiplexing. Another common transport layer protocol TCP does a bunch of other things like reliable communication, flow control and congestion control. UDP is designed to be lightweight and handle communications with little overhead. So it doesn\u2019t do anything beyond multiplexing and demultiplexing. If applications running on top of UDP need any of the features of TCP, they have to implement that in their application This example from python wiki covers a sample UDP client and server where \u201cHello World\u201d is an application payload sent to server listening on port number 5005. The server receives the packet and prints the \u201cHello World\u201d string from the client","title":"UDP"},{"location":"level101/linux_networking/udp/#applications-in-sre-role","text":"If the underlying network is slow and the UDP layer is unable to queue packets down to the networking layer, sendto syscall from the application will hang till the kernel finds some of its buffer is freed. This can affect the throughput of the system. Increasing write memory buffer values using sysctl variables net.core.wmem_max and net.core.wmem_default provides some cushion to the application from the slow network Similarly if the receiver process is slow in consuming from its buffer, the kernel has to drop packets which it can\u2019t queue due to the buffer being full. Since UDP doesn\u2019t guarantee reliability these dropped packets can cause data loss unless tracked by the application layer. Increasing sysctl variables rmem_default and rmem_max can provide some cushion to slow applications from fast senders.","title":"Applications in SRE role"},{"location":"level101/metrics_and_monitoring/alerts/","text":"Proactive monitoring using alerts Earlier we discussed different ways to collect key metric data points from a service and its underlying infrastructure. This data gives us a better understanding of how the service is performing. One of the main objectives of monitoring is to detect any service degradations early (reduce Mean Time To Detect) and notify stakeholders so that the issues are either avoided or can be fixed early, thus reducing Mean Time To Recover (MTTR). For example, if you are notified when resource usage by a service exceeds 90 percent, you can take preventive measures to avoid any service breakdown due to a shortage of resources. On the other hand, when a service goes down due to an issue, early detection and notification of such incidents can help you quickly fix the issue. Figure 8: An alert notification received on Slack Today most of the monitoring services available provide a mechanism to set up alerts on one or a combination of metrics to actively monitor the service health. These alerts have a set of defined rules or conditions, and when the rule is broken, you are notified. These rules can be as simple as notifying when the metric value exceeds n to as complex as a week over week (WoW) comparison of standard deviation over a period of time. Monitoring tools notify you about an active alert, and most of these tools support instant messaging (IM) platforms, SMS, email, or phone calls. Figure 8 shows a sample alert notification received on Slack for memory usage exceeding 90 percent of total RAM space on the host.","title":"Proactive Monitoring with Alerts"},{"location":"level101/metrics_and_monitoring/alerts/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/alerts/#proactive-monitoring-using-alerts","text":"Earlier we discussed different ways to collect key metric data points from a service and its underlying infrastructure. This data gives us a better understanding of how the service is performing. One of the main objectives of monitoring is to detect any service degradations early (reduce Mean Time To Detect) and notify stakeholders so that the issues are either avoided or can be fixed early, thus reducing Mean Time To Recover (MTTR). For example, if you are notified when resource usage by a service exceeds 90 percent, you can take preventive measures to avoid any service breakdown due to a shortage of resources. On the other hand, when a service goes down due to an issue, early detection and notification of such incidents can help you quickly fix the issue. Figure 8: An alert notification received on Slack Today most of the monitoring services available provide a mechanism to set up alerts on one or a combination of metrics to actively monitor the service health. These alerts have a set of defined rules or conditions, and when the rule is broken, you are notified. These rules can be as simple as notifying when the metric value exceeds n to as complex as a week over week (WoW) comparison of standard deviation over a period of time. Monitoring tools notify you about an active alert, and most of these tools support instant messaging (IM) platforms, SMS, email, or phone calls. Figure 8 shows a sample alert notification received on Slack for memory usage exceeding 90 percent of total RAM space on the host.","title":"Proactive monitoring using alerts"},{"location":"level101/metrics_and_monitoring/best_practices/","text":"Best practices for monitoring When setting up monitoring for a service, keep the following best practices in mind. Use the right metric type -- Most of the libraries available today offer various metric types. Choose the appropriate metric type for monitoring your system. Following are the types of metrics and their purposes. Gauge -- Gauge is a constant type of metric. After the metric is initialized, the metric value does not change unless you intentionally update it. Timer -- Timer measures the time taken to complete a task. Counter -- Counter counts the number of occurrences of a particular event. For more information about these metric types, see Data Types . Avoid over-monitoring -- Monitoring can be a significant engineering endeavor . Therefore, be sure not to spend too much time and resources on monitoring services, yet make sure all important metrics are captured. Prevent alert fatigue -- Set alerts for metrics that are important and actionable. If you receive too many non-critical alerts, you might start ignoring alert notifications over time. As a result, critical alerts might get overlooked. Have a runbook for alerts -- For every alert, make sure you have a document explaining what actions and checks need to be performed when the alert fires. This enables any engineer on the team to handle the alert and take necessary actions, without any help from others.","title":"Best Practices for Monitoring"},{"location":"level101/metrics_and_monitoring/best_practices/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/best_practices/#best-practices-for-monitoring","text":"When setting up monitoring for a service, keep the following best practices in mind. Use the right metric type -- Most of the libraries available today offer various metric types. Choose the appropriate metric type for monitoring your system. Following are the types of metrics and their purposes. Gauge -- Gauge is a constant type of metric. After the metric is initialized, the metric value does not change unless you intentionally update it. Timer -- Timer measures the time taken to complete a task. Counter -- Counter counts the number of occurrences of a particular event. For more information about these metric types, see Data Types . Avoid over-monitoring -- Monitoring can be a significant engineering endeavor . Therefore, be sure not to spend too much time and resources on monitoring services, yet make sure all important metrics are captured. Prevent alert fatigue -- Set alerts for metrics that are important and actionable. If you receive too many non-critical alerts, you might start ignoring alert notifications over time. As a result, critical alerts might get overlooked. Have a runbook for alerts -- For every alert, make sure you have a document explaining what actions and checks need to be performed when the alert fires. This enables any engineer on the team to handle the alert and take necessary actions, without any help from others.","title":"Best practices for monitoring"},{"location":"level101/metrics_and_monitoring/command-line_tools/","text":"Command-line tools Most of the Linux distributions today come with a set of tools that monitor the system's performance. These tools help you measure and understand various subsystem statistics (CPU, memory, network, and so on). Let's look at some of the tools that are predominantly used. ps/top -- The process status command (ps) displays information about all the currently running processes in a Linux system. The top command is similar to the ps command, but it periodically updates the information displayed until the program is terminated. An advanced version of top, called htop, has a more user-friendly interface and some additional features. These command-line utilities come with options to modify the operation and output of the command. Following are some important options supported by the ps command. -p -- Displays information about processes that match the specified process IDs. Similarly, you can use -u and -g to display information about processes belonging to a specific user or group. -a -- Displays information about other users' processes, as well as one's own. -x -- When displaying processes matched by other options, includes processes that do not have a controlling terminal. Figure 2: Results of top command ss -- The socket statistics command (ss) displays information about network sockets on the system. This tool is the successor of netstat , which is deprecated. Following are some command-line options supported by the ss command: -t -- Displays the TCP socket. Similarly, -u displays UDP sockets, -x is for UNIX domain sockets, and so on. -l -- Displays only listening sockets. -n -- Instructs the command to not resolve service names. Instead displays the port numbers. Figure 3: List of listening sockets on a system free -- The free command displays memory usage statistics on the host like available memory, used memory, and free memory. Most often, this command is used with the -h command-line option, which displays the statistics in a human-readable format. Figure 4: Memory statistics on a host in human-readable form df -- The df command displays disk space usage statistics. The -i command-line option is also often used to display inode usage statistics. The -h command-line option is used for displaying statistics in a human-readable format. Figure 5: Disk usage statistics on a system in human-readable form sar -- The sar utility monitors various subsystems, such as CPU and memory, in real time. This data can be stored in a file specified with the -o option. This tool helps to identify anomalies. iftop -- The interface top command ( iftop ) displays bandwidth utilization by a host on an interface. This command is often used to identify bandwidth usage by active connections. The -i option specifies which network interface to watch. Figure 6: Network bandwidth usage by active connection on the host tcpdump -- The tcpdump command is a network monitoring tool that captures network packets flowing over the network and displays a description of the captured packets. The following options are available: -i -- Interface to listen on host -- Filters traffic going to or from the specified host src/dst -- Displays one-way traffic from the source (src) or to the destination (dst) port -- Filters traffic to or from a particular port Figure 7: *tcpdump* of packets on *docker0* interface on a host","title":"Command-line Tools"},{"location":"level101/metrics_and_monitoring/command-line_tools/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/command-line_tools/#command-line-tools","text":"Most of the Linux distributions today come with a set of tools that monitor the system's performance. These tools help you measure and understand various subsystem statistics (CPU, memory, network, and so on). Let's look at some of the tools that are predominantly used. ps/top -- The process status command (ps) displays information about all the currently running processes in a Linux system. The top command is similar to the ps command, but it periodically updates the information displayed until the program is terminated. An advanced version of top, called htop, has a more user-friendly interface and some additional features. These command-line utilities come with options to modify the operation and output of the command. Following are some important options supported by the ps command. -p -- Displays information about processes that match the specified process IDs. Similarly, you can use -u and -g to display information about processes belonging to a specific user or group. -a -- Displays information about other users' processes, as well as one's own. -x -- When displaying processes matched by other options, includes processes that do not have a controlling terminal. Figure 2: Results of top command ss -- The socket statistics command (ss) displays information about network sockets on the system. This tool is the successor of netstat , which is deprecated. Following are some command-line options supported by the ss command: -t -- Displays the TCP socket. Similarly, -u displays UDP sockets, -x is for UNIX domain sockets, and so on. -l -- Displays only listening sockets. -n -- Instructs the command to not resolve service names. Instead displays the port numbers. Figure 3: List of listening sockets on a system free -- The free command displays memory usage statistics on the host like available memory, used memory, and free memory. Most often, this command is used with the -h command-line option, which displays the statistics in a human-readable format. Figure 4: Memory statistics on a host in human-readable form df -- The df command displays disk space usage statistics. The -i command-line option is also often used to display inode usage statistics. The -h command-line option is used for displaying statistics in a human-readable format. Figure 5: Disk usage statistics on a system in human-readable form sar -- The sar utility monitors various subsystems, such as CPU and memory, in real time. This data can be stored in a file specified with the -o option. This tool helps to identify anomalies. iftop -- The interface top command ( iftop ) displays bandwidth utilization by a host on an interface. This command is often used to identify bandwidth usage by active connections. The -i option specifies which network interface to watch. Figure 6: Network bandwidth usage by active connection on the host tcpdump -- The tcpdump command is a network monitoring tool that captures network packets flowing over the network and displays a description of the captured packets. The following options are available: -i -- Interface to listen on host -- Filters traffic going to or from the specified host src/dst -- Displays one-way traffic from the source (src) or to the destination (dst) port -- Filters traffic to or from a particular port Figure 7: *tcpdump* of packets on *docker0* interface on a host","title":"Command-line tools"},{"location":"level101/metrics_and_monitoring/conclusion/","text":"Conclusion A robust monitoring and alerting system is necessary for maintaining and troubleshooting a system. A dashboard with key metrics can give you an overview of service performance, all in one place. Well-defined alerts (with realistic thresholds and notifications) further enable you to quickly identify any anomalies in the service infrastructure and in resource saturation. By taking necessary actions, you can avoid any service degradations and decrease MTTD for service breakdowns. In addition to in-house monitoring, monitoring real user experience can help you to understand service performance as perceived by the users. Many modules are involved in serving the user, and most of them are out of your control. Therefore, you need to have real-user monitoring in place. Metrics give very abstract details on service performance. To get a better understanding of the system and for faster recovery during incidents, you might want to implement the other two pillars of observability: logs and tracing. Logs and trace data can help you understand what led to service failure or degradation. Following are some resources to learn more about monitoring and observability: Google SRE book: Monitoring Distributed Systems Mastering Distributed Tracing by Yuri Shkuro References Google SRE book: Monitoring Distributed Systems Mastering Distributed Tracing, by Yuri Shkuro Monitoring and Observability Three PIllars with Zero Answers Engineering blogs on LinkedIn , Grafana , Elastic.co , OpenTelemetry","title":"Conclusion"},{"location":"level101/metrics_and_monitoring/conclusion/#conclusion","text":"A robust monitoring and alerting system is necessary for maintaining and troubleshooting a system. A dashboard with key metrics can give you an overview of service performance, all in one place. Well-defined alerts (with realistic thresholds and notifications) further enable you to quickly identify any anomalies in the service infrastructure and in resource saturation. By taking necessary actions, you can avoid any service degradations and decrease MTTD for service breakdowns. In addition to in-house monitoring, monitoring real user experience can help you to understand service performance as perceived by the users. Many modules are involved in serving the user, and most of them are out of your control. Therefore, you need to have real-user monitoring in place. Metrics give very abstract details on service performance. To get a better understanding of the system and for faster recovery during incidents, you might want to implement the other two pillars of observability: logs and tracing. Logs and trace data can help you understand what led to service failure or degradation. Following are some resources to learn more about monitoring and observability: Google SRE book: Monitoring Distributed Systems Mastering Distributed Tracing by Yuri Shkuro","title":"Conclusion"},{"location":"level101/metrics_and_monitoring/conclusion/#references","text":"Google SRE book: Monitoring Distributed Systems Mastering Distributed Tracing, by Yuri Shkuro Monitoring and Observability Three PIllars with Zero Answers Engineering blogs on LinkedIn , Grafana , Elastic.co , OpenTelemetry","title":"References"},{"location":"level101/metrics_and_monitoring/introduction/","text":"Prerequisites Linux Basics Python and the Web Systems Design Linux Networking Fundamentals What to expect from this course Monitoring is an integral part of any system. As an SRE, you need to have a basic understanding of monitoring a service infrastructure. By the end of this course, you will gain a better understanding of the following topics: What is monitoring? What needs to be measured How the metrics gathered can be used to improve business decisions and overall reliability Proactive monitoring with alerts Log processing and its importance What is observability? Distributed tracing Logs Metrics What is not covered in this course Guide to setting up a monitoring infrastructure Deep dive into different monitoring technologies and benchmarking or comparison of any tools Course content Introduction Four golden signals of monitoring Why is monitoring important? Command-line tools Third-party monitoring Proactive monitoring using alerts Best practices for monitoring Observability Logs Tracing Conclusion Introduction Monitoring is a process of collecting real-time performance metrics from a system, analyzing the data to derive meaningful information, and displaying the data to the users. In simple terms, you measure various metrics regularly to understand the state of the system, including but not limited to, user requests, latency, and error rate. What gets measured, gets fixed ---if you can measure something, you can reason about it, understand it, discuss it, and act upon it with confidence. Four golden signals of monitoring When setting up monitoring for a system, you need to decide what to measure. The four golden signals of monitoring provide a good understanding of service performance and lay a foundation for monitoring a system. These four golden signals are Traffic Latency Error Saturation These metrics help you to understand the system performance and bottlenecks, and to create a better end-user experience. As discussed in the Google SRE book , if you can measure only four metrics of your service, focus on these four. Let's look at each of the four golden signals. Traffic -- Traffic gives a better understanding of the service demand. Often referred to as service QPS (queries per second), traffic is a measure of requests served by the service. This signal helps you to decide when a service needs to be scaled up to handle increasing customer demand and scaled down to be cost-effective. Latency -- Latency is the measure of time taken by the service to process the incoming request and send the response. Measuring service latency helps in the early detection of slow degradation of the service. Distinguishing between the latency of successful requests and the latency of failed requests is important. For example, an HTTP 5XX error triggered due to loss of connection to a database or other critical backend might be served very quickly. However, because an HTTP 500 error indicates a failed request, factoring 500s into overall latency might result in misleading calculations. Error (rate) -- Error is the measure of failed client requests. These failures can be easily identified based on the response codes ( HTTP 5XX error ). There might be cases where the response is considered erroneous due to wrong result data or due to policy violations. For example, you might get an HTTP 200 response, but the body has incomplete data, or response time is breaching the agreed-upon SLA s. Therefore, you need to have other mechanisms (code logic or instrumentation ) in place to capture errors in addition to the response codes. Saturation -- Saturation is a measure of the resource utilization by a service. This signal tells you the state of service resources and how full they are. These resources include memory, compute, network I/O, and so on. Service performance slowly degrades even before resource utilization is at 100 percent. Therefore, having a utilization target is important. An increase in latency is a good indicator of saturation; measuring the 99th percentile of latency can help in the early detection of saturation. Depending on the type of service, you can measure these signals in different ways. For example, you might measure queries per second served for a web server. In contrast, for a database server, transactions performed and database sessions created give you an idea about the traffic handled by the database server. With the help of additional code logic (monitoring libraries and instrumentation), you can measure these signals periodically and store them for future analysis. Although these metrics give you an idea about the performance at the service end, you need to also ensure that the same user experience is delivered at the client end. Therefore, you might need to monitor the service from outside the service infrastructure, which is discussed under third-party monitoring. Why is monitoring important? Monitoring plays a key role in the success of a service. As discussed earlier, monitoring provides performance insights for understanding service health. With access to historical data collected over time, you can build intelligent applications to address specific needs. Some of the key use cases follow: Reduction in time to resolve issues -- With a good monitoring infrastructure in place, you can identify issues quickly and resolve them, which reduces the impact caused by the issues. Business decisions -- Data collected over a period of time can help you make business decisions such as determining the product release cycle, which features to invest in, and geographical areas to focus on. Decisions based on long-term data can improve the overall product experience. Resource planning -- By analyzing historical data, you can forecast service compute-resource demands, and you can properly allocate resources. This allows financially effective decisions, with no compromise in end-user experience. Before we dive deeper into monitoring, let's understand some basic terminologies. Metric -- A metric is a quantitative measure of a particular system attribute---for example, memory or CPU Node or host -- A physical server, virtual machine, or container where an application is running QPS -- Queries Per Second , a measure of traffic served by the service per second Latency -- The time interval between user action and the response from the server---for example, time spent after sending a query to a database before the first response bit is received Error rate -- Number of errors observed over a particular time period (usually a second) Graph -- In monitoring, a graph is a representation of one or more values of metrics collected over time Dashboard -- A dashboard is a collection of graphs that provide an overview of system health Incident -- An incident is an event that disrupts the normal operations of a system MTTD -- Mean Time To Detect is the time interval between the beginning of a service failure and the detection of such failure MTTR -- Mean Time To Resolve is the time spent to fix a service failure and bring the service back to its normal state Before we discuss monitoring an application, let us look at the monitoring infrastructure. Following is an illustration of a basic monitoring system. Figure 1: Illustration of a monitoring infrastructure Figure 1 shows a monitoring infrastructure mechanism for aggregating metrics on the system, and collecting and storing the data for display. In addition, a monitoring infrastructure includes alert subsystems for notifying concerned parties during any abnormal behavior. Let's look at each of these infrastructure components: Host metrics agent -- A host metrics agent is a process running on the host that collects performance statistics for host subsystems such as memory, CPU, and network. These metrics are regularly relayed to a metrics collector for storage and visualization. Some examples are collectd , telegraf , and metricbeat . Metric aggregator -- A metric aggregator is a process running on the host. Applications running on the host collect service metrics using instrumentation . Collected metrics are sent either to the aggregator process or directly to the metrics collector over API, if available. Received metrics are aggregated periodically and relayed to the metrics collector in batches. An example is StatsD . Metrics collector -- A metrics collector process collects all the metrics from the metric aggregators running on multiple hosts. The collector takes care of decoding and stores this data on the database. Metric collection and storage might be taken care of by one single service such as InfluxDB , which we discuss next. An example is carbon daemons . Storage -- A time-series database stores all of these metrics. Examples are OpenTSDB , Whisper , and InfluxDB . Metrics server -- A metrics server can be as basic as a web server that graphically renders metric data. In addition, the metrics server provides aggregation functionalities and APIs for fetching metric data programmatically. Some examples are Grafana and Graphite-Web . Alert manager -- The alert manager regularly polls metric data available and, if there are any anomalies detected, notifies you. Each alert has a set of rules for identifying such anomalies. Today many metrics servers such as Grafana support alert management. We discuss alerting in detail later . Examples are Grafana and Icinga .","title":"Introduction"},{"location":"level101/metrics_and_monitoring/introduction/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/introduction/#prerequisites","text":"Linux Basics Python and the Web Systems Design Linux Networking Fundamentals","title":"Prerequisites"},{"location":"level101/metrics_and_monitoring/introduction/#what-to-expect-from-this-course","text":"Monitoring is an integral part of any system. As an SRE, you need to have a basic understanding of monitoring a service infrastructure. By the end of this course, you will gain a better understanding of the following topics: What is monitoring? What needs to be measured How the metrics gathered can be used to improve business decisions and overall reliability Proactive monitoring with alerts Log processing and its importance What is observability? Distributed tracing Logs Metrics","title":"What to expect from this course"},{"location":"level101/metrics_and_monitoring/introduction/#what-is-not-covered-in-this-course","text":"Guide to setting up a monitoring infrastructure Deep dive into different monitoring technologies and benchmarking or comparison of any tools","title":"What is not covered in this course"},{"location":"level101/metrics_and_monitoring/introduction/#course-content","text":"Introduction Four golden signals of monitoring Why is monitoring important? Command-line tools Third-party monitoring Proactive monitoring using alerts Best practices for monitoring Observability Logs Tracing Conclusion","title":"Course content"},{"location":"level101/metrics_and_monitoring/introduction/#_2","text":"","title":""},{"location":"level101/metrics_and_monitoring/introduction/#introduction","text":"Monitoring is a process of collecting real-time performance metrics from a system, analyzing the data to derive meaningful information, and displaying the data to the users. In simple terms, you measure various metrics regularly to understand the state of the system, including but not limited to, user requests, latency, and error rate. What gets measured, gets fixed ---if you can measure something, you can reason about it, understand it, discuss it, and act upon it with confidence.","title":"Introduction"},{"location":"level101/metrics_and_monitoring/introduction/#four-golden-signals-of-monitoring","text":"When setting up monitoring for a system, you need to decide what to measure. The four golden signals of monitoring provide a good understanding of service performance and lay a foundation for monitoring a system. These four golden signals are Traffic Latency Error Saturation These metrics help you to understand the system performance and bottlenecks, and to create a better end-user experience. As discussed in the Google SRE book , if you can measure only four metrics of your service, focus on these four. Let's look at each of the four golden signals. Traffic -- Traffic gives a better understanding of the service demand. Often referred to as service QPS (queries per second), traffic is a measure of requests served by the service. This signal helps you to decide when a service needs to be scaled up to handle increasing customer demand and scaled down to be cost-effective. Latency -- Latency is the measure of time taken by the service to process the incoming request and send the response. Measuring service latency helps in the early detection of slow degradation of the service. Distinguishing between the latency of successful requests and the latency of failed requests is important. For example, an HTTP 5XX error triggered due to loss of connection to a database or other critical backend might be served very quickly. However, because an HTTP 500 error indicates a failed request, factoring 500s into overall latency might result in misleading calculations. Error (rate) -- Error is the measure of failed client requests. These failures can be easily identified based on the response codes ( HTTP 5XX error ). There might be cases where the response is considered erroneous due to wrong result data or due to policy violations. For example, you might get an HTTP 200 response, but the body has incomplete data, or response time is breaching the agreed-upon SLA s. Therefore, you need to have other mechanisms (code logic or instrumentation ) in place to capture errors in addition to the response codes. Saturation -- Saturation is a measure of the resource utilization by a service. This signal tells you the state of service resources and how full they are. These resources include memory, compute, network I/O, and so on. Service performance slowly degrades even before resource utilization is at 100 percent. Therefore, having a utilization target is important. An increase in latency is a good indicator of saturation; measuring the 99th percentile of latency can help in the early detection of saturation. Depending on the type of service, you can measure these signals in different ways. For example, you might measure queries per second served for a web server. In contrast, for a database server, transactions performed and database sessions created give you an idea about the traffic handled by the database server. With the help of additional code logic (monitoring libraries and instrumentation), you can measure these signals periodically and store them for future analysis. Although these metrics give you an idea about the performance at the service end, you need to also ensure that the same user experience is delivered at the client end. Therefore, you might need to monitor the service from outside the service infrastructure, which is discussed under third-party monitoring.","title":"Four golden signals of monitoring"},{"location":"level101/metrics_and_monitoring/introduction/#why-is-monitoring-important","text":"Monitoring plays a key role in the success of a service. As discussed earlier, monitoring provides performance insights for understanding service health. With access to historical data collected over time, you can build intelligent applications to address specific needs. Some of the key use cases follow: Reduction in time to resolve issues -- With a good monitoring infrastructure in place, you can identify issues quickly and resolve them, which reduces the impact caused by the issues. Business decisions -- Data collected over a period of time can help you make business decisions such as determining the product release cycle, which features to invest in, and geographical areas to focus on. Decisions based on long-term data can improve the overall product experience. Resource planning -- By analyzing historical data, you can forecast service compute-resource demands, and you can properly allocate resources. This allows financially effective decisions, with no compromise in end-user experience. Before we dive deeper into monitoring, let's understand some basic terminologies. Metric -- A metric is a quantitative measure of a particular system attribute---for example, memory or CPU Node or host -- A physical server, virtual machine, or container where an application is running QPS -- Queries Per Second , a measure of traffic served by the service per second Latency -- The time interval between user action and the response from the server---for example, time spent after sending a query to a database before the first response bit is received Error rate -- Number of errors observed over a particular time period (usually a second) Graph -- In monitoring, a graph is a representation of one or more values of metrics collected over time Dashboard -- A dashboard is a collection of graphs that provide an overview of system health Incident -- An incident is an event that disrupts the normal operations of a system MTTD -- Mean Time To Detect is the time interval between the beginning of a service failure and the detection of such failure MTTR -- Mean Time To Resolve is the time spent to fix a service failure and bring the service back to its normal state Before we discuss monitoring an application, let us look at the monitoring infrastructure. Following is an illustration of a basic monitoring system. Figure 1: Illustration of a monitoring infrastructure Figure 1 shows a monitoring infrastructure mechanism for aggregating metrics on the system, and collecting and storing the data for display. In addition, a monitoring infrastructure includes alert subsystems for notifying concerned parties during any abnormal behavior. Let's look at each of these infrastructure components: Host metrics agent -- A host metrics agent is a process running on the host that collects performance statistics for host subsystems such as memory, CPU, and network. These metrics are regularly relayed to a metrics collector for storage and visualization. Some examples are collectd , telegraf , and metricbeat . Metric aggregator -- A metric aggregator is a process running on the host. Applications running on the host collect service metrics using instrumentation . Collected metrics are sent either to the aggregator process or directly to the metrics collector over API, if available. Received metrics are aggregated periodically and relayed to the metrics collector in batches. An example is StatsD . Metrics collector -- A metrics collector process collects all the metrics from the metric aggregators running on multiple hosts. The collector takes care of decoding and stores this data on the database. Metric collection and storage might be taken care of by one single service such as InfluxDB , which we discuss next. An example is carbon daemons . Storage -- A time-series database stores all of these metrics. Examples are OpenTSDB , Whisper , and InfluxDB . Metrics server -- A metrics server can be as basic as a web server that graphically renders metric data. In addition, the metrics server provides aggregation functionalities and APIs for fetching metric data programmatically. Some examples are Grafana and Graphite-Web . Alert manager -- The alert manager regularly polls metric data available and, if there are any anomalies detected, notifies you. Each alert has a set of rules for identifying such anomalies. Today many metrics servers such as Grafana support alert management. We discuss alerting in detail later . Examples are Grafana and Icinga .","title":"Why is monitoring important?"},{"location":"level101/metrics_and_monitoring/observability/","text":"Observability Engineers often use observability when referring to building reliable systems. Observability is a term derived from control theory, It is a measure of how well internal states of a system can be inferred from knowledge of its external outputs. Service infrastructures used on a daily basis are becoming more and more complex; proactive monitoring alone is not sufficient to quickly resolve issues causing application failures. With monitoring, you can keep known past failures from recurring, but with a complex service architecture, many unknown factors can cause potential problems. To address such cases, you can make the service observable. An observable system provides highly granular insights into the implicit failure modes. In addition, an observable system furnishes ample context about its inner workings, which unlocks the ability to uncover deeper systemic issues. Monitoring enables failure detection; observability helps in gaining a better understanding of the system. Among engineers, there is a common misconception that monitoring and observability are two different things. Actually, observability is the superset to monitoring; that is, monitoring improves service observability. The goal of observability is not only to detect problems, but also to understand where the issue is and what is causing it. In addition to metrics, observability has two more pillars: logs and traces, as shown in Figure 9. Although these three components do not make a system 100 percent observable, these are the most important and powerful components that give a better understanding of the system. Each of these pillars has its flaws, which are described in Three Pillars with Zero Answers . Figure 9: Three pillars of observability Because we have covered metrics already, let's look at the other two pillars (logs and traces). Logs Logs (often referred to as events ) are a record of activities performed by a service during its run time, with a corresponding timestamp. Metrics give abstract information about degradations in a system, and logs give a detailed view of what is causing these degradations. Logs created by the applications and infrastructure components help in effectively understanding the behavior of the system by providing details on application errors, exceptions, and event timelines. Logs help you to go back in time to understand the events that led to a failure. Therefore, examining logs is essential to troubleshooting system failures. Log processing involves the aggregation of different logs from individual applications and their subsequent shipment to central storage. Moving logs to central storage helps to preserve the logs, in case the application instances are inaccessible, or the application crashes due to a failure. After the logs are available in a central place, you can analyze the logs to derive sensible information from them. For audit and compliance purposes, you archive these logs on the central storage for a certain period of time. Log analyzers fetch useful information from log lines, such as request user information, request URL (feature), and response headers (such as content length) and response time. This information is grouped based on these attributes and made available to you through a visualization tool for quick understanding. You might be wondering how this log information helps. This information gives a holistic view of activities performed on all the involved entities. For example, let's say someone is performing a DoS (denial of service) attack on a web application. With the help of log processing, you can quickly look at top client IPs derived from access logs and identify where the attack is coming from. Similarly, if a feature in an application is causing a high error rate when accessed with a particular request parameter value, the results of log analysis can help you to quickly identify the misbehaving parameter value and take further action. Figure 10: Log processing and analysis using ELK stack Figure 10 shows a log processing platform using ELK (Elasticsearch, Logstash, Kibana), which provides centralized log processing. Beats is a collection of lightweight data shippers that can ship logs, audit data, network data, and so on over the network. In this use case specifically, we are using filebeat as a log shipper. Filebeat watches service log files and ships the log data to Logstash. Logstash parses these logs and transforms the data, preparing it to store on Elasticsearch. Transformed log data is stored on Elasticsearch and indexed for fast retrieval. Kibana searches and displays log data stored on Elasticsearch. Kibana also provides a set of visualizations for graphically displaying summaries derived from log data. Storing logs is expensive. And extensive logging of every event on the server is costly and takes up more storage space. With an increasing number of services, this cost can increase proportionally to the number of services. Tracing So far, we covered the importance of metrics and logging. Metrics give an abstract overview of the system, and logging gives a record of events that occurred. Imagine a complex distributed system with multiple microservices, where a user request is processed by multiple microservices in the system. Metrics and logging give you some information about how these requests are being handled by the system, but they fail to provide detailed information across all the microservices and how they affect a particular client request. If a slow downstream microservice is leading to increased response times, you need to have detailed visibility across all involved microservices to identify such microservice. The answer to this need is a request tracing mechanism. A trace is a series of spans, where each span is a record of events performed by different microservices to serve the client's request. In simple terms, a trace is a log of client-request serving derived from various microservices across different physical machines. Each span includes span metadata such as trace ID and span ID, and context, which includes information about transactions performed. Figure 11: Trace and spans for a URL shortener request Figure 11 is a graphical representation of a trace captured on the URL shortener example we covered earlier while learning Python. Similar to monitoring, the tracing infrastructure comprises a few modules for collecting traces, storing them, and accessing them. Each microservice runs a tracing library that collects traces in the background, creates in-memory batches, and submits the tracing backend. The tracing backend normalizes received trace data and stores it on persistent storage. Tracing data comes from multiple different microservices; therefore, trace storage is often organized to store data incrementally and is indexed by trace identifier. This organization helps in the reconstruction of trace data and in visualization. Figure 12 illustrates the anatomy of the distributed system. Figure 12: Anatomy of distributed tracing Today a set of tools and frameworks are available for building distributed tracing solutions. Following are some of the popular tools: OpenTelemetry : Observability framework for cloud-native software Jaeger : Open-source distributed tracing solution Zipkin : Open-source distributed tracing solution","title":"Observability"},{"location":"level101/metrics_and_monitoring/observability/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/observability/#observability","text":"Engineers often use observability when referring to building reliable systems. Observability is a term derived from control theory, It is a measure of how well internal states of a system can be inferred from knowledge of its external outputs. Service infrastructures used on a daily basis are becoming more and more complex; proactive monitoring alone is not sufficient to quickly resolve issues causing application failures. With monitoring, you can keep known past failures from recurring, but with a complex service architecture, many unknown factors can cause potential problems. To address such cases, you can make the service observable. An observable system provides highly granular insights into the implicit failure modes. In addition, an observable system furnishes ample context about its inner workings, which unlocks the ability to uncover deeper systemic issues. Monitoring enables failure detection; observability helps in gaining a better understanding of the system. Among engineers, there is a common misconception that monitoring and observability are two different things. Actually, observability is the superset to monitoring; that is, monitoring improves service observability. The goal of observability is not only to detect problems, but also to understand where the issue is and what is causing it. In addition to metrics, observability has two more pillars: logs and traces, as shown in Figure 9. Although these three components do not make a system 100 percent observable, these are the most important and powerful components that give a better understanding of the system. Each of these pillars has its flaws, which are described in Three Pillars with Zero Answers . Figure 9: Three pillars of observability Because we have covered metrics already, let's look at the other two pillars (logs and traces).","title":"Observability"},{"location":"level101/metrics_and_monitoring/observability/#logs","text":"Logs (often referred to as events ) are a record of activities performed by a service during its run time, with a corresponding timestamp. Metrics give abstract information about degradations in a system, and logs give a detailed view of what is causing these degradations. Logs created by the applications and infrastructure components help in effectively understanding the behavior of the system by providing details on application errors, exceptions, and event timelines. Logs help you to go back in time to understand the events that led to a failure. Therefore, examining logs is essential to troubleshooting system failures. Log processing involves the aggregation of different logs from individual applications and their subsequent shipment to central storage. Moving logs to central storage helps to preserve the logs, in case the application instances are inaccessible, or the application crashes due to a failure. After the logs are available in a central place, you can analyze the logs to derive sensible information from them. For audit and compliance purposes, you archive these logs on the central storage for a certain period of time. Log analyzers fetch useful information from log lines, such as request user information, request URL (feature), and response headers (such as content length) and response time. This information is grouped based on these attributes and made available to you through a visualization tool for quick understanding. You might be wondering how this log information helps. This information gives a holistic view of activities performed on all the involved entities. For example, let's say someone is performing a DoS (denial of service) attack on a web application. With the help of log processing, you can quickly look at top client IPs derived from access logs and identify where the attack is coming from. Similarly, if a feature in an application is causing a high error rate when accessed with a particular request parameter value, the results of log analysis can help you to quickly identify the misbehaving parameter value and take further action. Figure 10: Log processing and analysis using ELK stack Figure 10 shows a log processing platform using ELK (Elasticsearch, Logstash, Kibana), which provides centralized log processing. Beats is a collection of lightweight data shippers that can ship logs, audit data, network data, and so on over the network. In this use case specifically, we are using filebeat as a log shipper. Filebeat watches service log files and ships the log data to Logstash. Logstash parses these logs and transforms the data, preparing it to store on Elasticsearch. Transformed log data is stored on Elasticsearch and indexed for fast retrieval. Kibana searches and displays log data stored on Elasticsearch. Kibana also provides a set of visualizations for graphically displaying summaries derived from log data. Storing logs is expensive. And extensive logging of every event on the server is costly and takes up more storage space. With an increasing number of services, this cost can increase proportionally to the number of services.","title":"Logs"},{"location":"level101/metrics_and_monitoring/observability/#tracing","text":"So far, we covered the importance of metrics and logging. Metrics give an abstract overview of the system, and logging gives a record of events that occurred. Imagine a complex distributed system with multiple microservices, where a user request is processed by multiple microservices in the system. Metrics and logging give you some information about how these requests are being handled by the system, but they fail to provide detailed information across all the microservices and how they affect a particular client request. If a slow downstream microservice is leading to increased response times, you need to have detailed visibility across all involved microservices to identify such microservice. The answer to this need is a request tracing mechanism. A trace is a series of spans, where each span is a record of events performed by different microservices to serve the client's request. In simple terms, a trace is a log of client-request serving derived from various microservices across different physical machines. Each span includes span metadata such as trace ID and span ID, and context, which includes information about transactions performed. Figure 11: Trace and spans for a URL shortener request Figure 11 is a graphical representation of a trace captured on the URL shortener example we covered earlier while learning Python. Similar to monitoring, the tracing infrastructure comprises a few modules for collecting traces, storing them, and accessing them. Each microservice runs a tracing library that collects traces in the background, creates in-memory batches, and submits the tracing backend. The tracing backend normalizes received trace data and stores it on persistent storage. Tracing data comes from multiple different microservices; therefore, trace storage is often organized to store data incrementally and is indexed by trace identifier. This organization helps in the reconstruction of trace data and in visualization. Figure 12 illustrates the anatomy of the distributed system. Figure 12: Anatomy of distributed tracing Today a set of tools and frameworks are available for building distributed tracing solutions. Following are some of the popular tools: OpenTelemetry : Observability framework for cloud-native software Jaeger : Open-source distributed tracing solution Zipkin : Open-source distributed tracing solution","title":"Tracing"},{"location":"level101/metrics_and_monitoring/third-party_monitoring/","text":"Third-party monitoring Today most cloud providers offer a variety of monitoring solutions. In addition, a number of companies such as Datadog offer monitoring-as-a-service. In this section, we are not covering monitoring-as-a-service in depth. In recent years, more and more people have access to the internet. Many services are offered online to cater to the increasing user base. As a result, web pages are becoming larger, with increased client-side scripts. Users want these services to be fast and error-free. From the service point of view, when the response body is composed, an HTTP 200 OK response is sent, and everything looks okay. But there might be errors during transmission or on the client side. As previously mentioned, monitoring services from within the service infrastructure give good visibility into service health, but this is not enough. You need to monitor user experience, specifically the availability of services for clients. A number of third-party services such asf Catchpoint , Pingdom , and so on are available for achieving this goal. Third-party monitoring services can generate synthetic traffic simulating user requests from various parts of the world, to ensure the service is globally accessible. Other third-party monitoring solutions for real user monitoring (RUM) provide performance statistics such as service uptime and response time, from different geographical locations. This allows you to monitor the user experience from these locations, which might have different internet backbones, different operating systems, and different browsers and browser versions. Catchpoint Global Monitoring Network is a comprehensive 3-minute video that explains the importance of monitoring the client experience.","title":"Third-party Monitoring"},{"location":"level101/metrics_and_monitoring/third-party_monitoring/#_1","text":"","title":""},{"location":"level101/metrics_and_monitoring/third-party_monitoring/#third-party-monitoring","text":"Today most cloud providers offer a variety of monitoring solutions. In addition, a number of companies such as Datadog offer monitoring-as-a-service. In this section, we are not covering monitoring-as-a-service in depth. In recent years, more and more people have access to the internet. Many services are offered online to cater to the increasing user base. As a result, web pages are becoming larger, with increased client-side scripts. Users want these services to be fast and error-free. From the service point of view, when the response body is composed, an HTTP 200 OK response is sent, and everything looks okay. But there might be errors during transmission or on the client side. As previously mentioned, monitoring services from within the service infrastructure give good visibility into service health, but this is not enough. You need to monitor user experience, specifically the availability of services for clients. A number of third-party services such asf Catchpoint , Pingdom , and so on are available for achieving this goal. Third-party monitoring services can generate synthetic traffic simulating user requests from various parts of the world, to ensure the service is globally accessible. Other third-party monitoring solutions for real user monitoring (RUM) provide performance statistics such as service uptime and response time, from different geographical locations. This allows you to monitor the user experience from these locations, which might have different internet backbones, different operating systems, and different browsers and browser versions. Catchpoint Global Monitoring Network is a comprehensive 3-minute video that explains the importance of monitoring the client experience.","title":"Third-party monitoring"},{"location":"level101/python_web/intro/","text":"Python and The Web Prerequisites Basic understanding of python language. Basic familiarity with flask framework. What to expect from this course This course is divided into two high level parts. In the first part, assuming familiarity with python language\u2019s basic operations and syntax usage, we will dive a little deeper into understanding python as a language. We will compare python with other programming languages that you might already know like Java and C. We will also explore concepts of Python objects and with help of that, explore python features like decorators. In the second part which will revolve around the web, and also assume familiarity with the Flask framework, we will start from the socket module and work with HTTP requests. This will demystify how frameworks like flask work internally. And to introduce SRE flavour to the course, we will design, develop and deploy (in theory) a URL shortening application. We will emphasize parts of the whole process that are more important as an SRE of the said app/service. What is not covered under this course Extensive knowledge of python internals and advanced python. Lab Environment Setup Have latest version of python installed Course Contents The Python Language Some Python Concepts Python Gotchas Python and Web Sockets Flask The URL Shortening App Design Scaling The App Monitoring The App The Python Language Assuming you know a little bit of C/C++ and Java, let's try to discuss the following questions in context of those two languages and python. You might have heard that C/C++ is a compiled language while python is an interpreted language. Generally, with compiled language we first compile the program and then run the executable while in case of python we run the source code directly like python hello_world.py . While Java, being an interpreted language, still has a separate compilation step and then its run. So what's really the difference? Compiled vs. Interpreted This might sound a little weird to you: python, in a way is a compiled language! Python has a compiler built-in! It is obvious in the case of java since we compile it using a separate command ie: javac helloWorld.java and it will produce a .class file which we know as a bytecode . Well, python is very similar to that. One difference here is that there is no separate compile command/binary needed to run a python program. What is the difference then, between java and python? Well, Java's compiler is more strict and sophisticated. As you might know Java is a statically typed language. So the compiler is written in a way that it can verify types related errors during compile time. While python being a dynamic language, types are not known until a program is run. So in a way, python compiler is dumb (or, less strict). But there indeed is a compile step involved when a python program is run. You might have seen python bytecode files with .pyc extension. Here is how you can see bytecode for a given python program. # Create a Hello World $ echo \"print('hello world')\" > hello_world.py # Making sure it runs $ python3 hello_world.py hello world # The bytecode of the given program $ python -m dis hello_world.py 1 0 LOAD_NAME 0 (print) 2 LOAD_CONST 0 ('hello world') 4 CALL_FUNCTION 1 6 POP_TOP 8 LOAD_CONST 1 (None) 10 RETURN_VALUE Read more about dis module here Now coming to C/C++, there of course is a compiler. But the output is different than what java/python compiler would produce. Compiling a C program would produce what we also know as machine code . As opposed to bytecode. Running The Programs We know compilation is involved in all 3 languages we are discussing. Just that the compilers are different in nature and they output different types of content. In case of C/C++, the output is machine code which can be directly read by your operating system. When you execute that program, your OS will know how exactly to run it. But this is not the case with bytecode. Those bytecodes are language specific. Python has its own set of bytecode defined (more in dis module) and so does java. So naturally, your operating system will not know how to run it. To run this bytecode, we have something called Virtual Machines. Ie: The JVM or the Python VM (CPython, Jython). These so called Virtual Machines are the programs which can read the bytecode and run it on a given operating system. Python has multiple VMs available. Cpython is a python VM implemented in C language, similarly Jython is a Java implementation of python VM. At the end of the day, what they should be capable of is to understand python language syntax, be able to compile it to bytecode and be able to run that bytecode. You can implement a python VM in any language! (And people do so, just because it can be done) The Operating System +------------------------------------+ | | | | | | hello_world.py Python bytecode | Python VM Process | | | +----------------+ +----------------+ | +----------------+ | |print(... | COMPILE |LOAD_CONST... | | |Reads bytecode | | | +--------------->+ +------------------->+line by line | | | | | | | |and executes. | | | | | | | | | | +----------------+ +----------------+ | +----------------+ | | | | | | | hello_world.c OS Specific machinecode | A New Process | | | +----------------+ +----------------+ | +----------------+ | |void main() { | COMPILE | binary contents| | | binary contents| | | +--------------->+ +------------------->+ | | | | | | | | | | | | | | | | | | +----------------+ +----------------+ | +----------------+ | | (binary contents | | runs as is) | | | | | +------------------------------------+ Two things to note for above diagram: Generally, when we run a python program, a python VM process is started which reads the python source code, compiles it to byte code and run it in a single step. Compiling is not a separate step. Shown only for illustration purpose. Binaries generated for C like languages are not exactly run as is. Since there are multiple types of binaries (eg: ELF), there are more complicated steps involved in order to run a binary but we will not go into that since all that is done at OS level.","title":"Introduction"},{"location":"level101/python_web/intro/#python-and-the-web","text":"","title":"Python and The Web"},{"location":"level101/python_web/intro/#prerequisites","text":"Basic understanding of python language. Basic familiarity with flask framework.","title":"Prerequisites"},{"location":"level101/python_web/intro/#what-to-expect-from-this-course","text":"This course is divided into two high level parts. In the first part, assuming familiarity with python language\u2019s basic operations and syntax usage, we will dive a little deeper into understanding python as a language. We will compare python with other programming languages that you might already know like Java and C. We will also explore concepts of Python objects and with help of that, explore python features like decorators. In the second part which will revolve around the web, and also assume familiarity with the Flask framework, we will start from the socket module and work with HTTP requests. This will demystify how frameworks like flask work internally. And to introduce SRE flavour to the course, we will design, develop and deploy (in theory) a URL shortening application. We will emphasize parts of the whole process that are more important as an SRE of the said app/service.","title":"What to expect from this course"},{"location":"level101/python_web/intro/#what-is-not-covered-under-this-course","text":"Extensive knowledge of python internals and advanced python.","title":"What is not covered under this course"},{"location":"level101/python_web/intro/#lab-environment-setup","text":"Have latest version of python installed","title":"Lab Environment Setup"},{"location":"level101/python_web/intro/#course-contents","text":"The Python Language Some Python Concepts Python Gotchas Python and Web Sockets Flask The URL Shortening App Design Scaling The App Monitoring The App","title":"Course Contents"},{"location":"level101/python_web/intro/#the-python-language","text":"Assuming you know a little bit of C/C++ and Java, let's try to discuss the following questions in context of those two languages and python. You might have heard that C/C++ is a compiled language while python is an interpreted language. Generally, with compiled language we first compile the program and then run the executable while in case of python we run the source code directly like python hello_world.py . While Java, being an interpreted language, still has a separate compilation step and then its run. So what's really the difference?","title":"The Python Language"},{"location":"level101/python_web/intro/#compiled-vs-interpreted","text":"This might sound a little weird to you: python, in a way is a compiled language! Python has a compiler built-in! It is obvious in the case of java since we compile it using a separate command ie: javac helloWorld.java and it will produce a .class file which we know as a bytecode . Well, python is very similar to that. One difference here is that there is no separate compile command/binary needed to run a python program. What is the difference then, between java and python? Well, Java's compiler is more strict and sophisticated. As you might know Java is a statically typed language. So the compiler is written in a way that it can verify types related errors during compile time. While python being a dynamic language, types are not known until a program is run. So in a way, python compiler is dumb (or, less strict). But there indeed is a compile step involved when a python program is run. You might have seen python bytecode files with .pyc extension. Here is how you can see bytecode for a given python program. # Create a Hello World $ echo \"print('hello world')\" > hello_world.py # Making sure it runs $ python3 hello_world.py hello world # The bytecode of the given program $ python -m dis hello_world.py 1 0 LOAD_NAME 0 (print) 2 LOAD_CONST 0 ('hello world') 4 CALL_FUNCTION 1 6 POP_TOP 8 LOAD_CONST 1 (None) 10 RETURN_VALUE Read more about dis module here Now coming to C/C++, there of course is a compiler. But the output is different than what java/python compiler would produce. Compiling a C program would produce what we also know as machine code . As opposed to bytecode.","title":"Compiled vs. Interpreted"},{"location":"level101/python_web/intro/#running-the-programs","text":"We know compilation is involved in all 3 languages we are discussing. Just that the compilers are different in nature and they output different types of content. In case of C/C++, the output is machine code which can be directly read by your operating system. When you execute that program, your OS will know how exactly to run it. But this is not the case with bytecode. Those bytecodes are language specific. Python has its own set of bytecode defined (more in dis module) and so does java. So naturally, your operating system will not know how to run it. To run this bytecode, we have something called Virtual Machines. Ie: The JVM or the Python VM (CPython, Jython). These so called Virtual Machines are the programs which can read the bytecode and run it on a given operating system. Python has multiple VMs available. Cpython is a python VM implemented in C language, similarly Jython is a Java implementation of python VM. At the end of the day, what they should be capable of is to understand python language syntax, be able to compile it to bytecode and be able to run that bytecode. You can implement a python VM in any language! (And people do so, just because it can be done) The Operating System +------------------------------------+ | | | | | | hello_world.py Python bytecode | Python VM Process | | | +----------------+ +----------------+ | +----------------+ | |print(... | COMPILE |LOAD_CONST... | | |Reads bytecode | | | +--------------->+ +------------------->+line by line | | | | | | | |and executes. | | | | | | | | | | +----------------+ +----------------+ | +----------------+ | | | | | | | hello_world.c OS Specific machinecode | A New Process | | | +----------------+ +----------------+ | +----------------+ | |void main() { | COMPILE | binary contents| | | binary contents| | | +--------------->+ +------------------->+ | | | | | | | | | | | | | | | | | | +----------------+ +----------------+ | +----------------+ | | (binary contents | | runs as is) | | | | | +------------------------------------+ Two things to note for above diagram: Generally, when we run a python program, a python VM process is started which reads the python source code, compiles it to byte code and run it in a single step. Compiling is not a separate step. Shown only for illustration purpose. Binaries generated for C like languages are not exactly run as is. Since there are multiple types of binaries (eg: ELF), there are more complicated steps involved in order to run a binary but we will not go into that since all that is done at OS level.","title":"Running The Programs"},{"location":"level101/python_web/python-concepts/","text":"Some Python Concepts Though you are expected to know python and its syntax at basic level, let us discuss some fundamental concepts that will help you understand the python language better. Everything in Python is an object. That includes the functions, lists, dicts, classes, modules, a running function (instance of function definition), everything. In the CPython, it would mean there is an underlying struct variable for each object. In python's current execution context, all the variables are stored in a dict. It'd be a string to object mapping. If you have a function and a float variable defined in the current context, here is how it is handled internally. >>> float_number=42.0 >>> def foo_func(): ... pass ... # NOTICE HOW VARIABLE NAMES ARE STRINGS, stored in a dict >>> locals() {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'float_number': 42.0, 'foo_func': } Python Functions Since functions too are objects, we can see what all attributes a function contains as following >>> def hello(name): ... print(f\"Hello, {name}!\") ... >>> dir(hello) ['__annotations__', '__call__', '__class__', '__closure__', '__code__', '__defaults__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__get__', '__getattribute__', '__globals__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__kwdefaults__', '__le__', '__lt__', '__module__', '__name__', '__ne__', '__new__', '__qualname__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__'] While there are a lot of them, let's look at some interesting ones globals This attribute, as the name suggests, has references of global variables. If you ever need to know what all global variables are in the scope of this function, this will tell you. See how the function start seeing the new variable in globals >>> hello.__globals__ {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'hello': } # adding new global variable >>> GLOBAL=\"g_val\" >>> hello.__globals__ {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'hello': , 'GLOBAL': 'g_val'} code This is an interesting one! As everything in python is an object, this includes the bytecode too. The compiled python bytecode is a python code object. Which is accessible via __code__ attribute here. A function has an associated code object which carries some interesting information. # the file in which function is defined # stdin here since this is run in an interpreter >>> hello.__code__.co_filename '' # number of arguments the function takes >>> hello.__code__.co_argcount 1 # local variable names >>> hello.__code__.co_varnames ('name',) # the function code's compiled bytecode >>> hello.__code__.co_code b't\\x00d\\x01|\\x00\\x9b\\x00d\\x02\\x9d\\x03\\x83\\x01\\x01\\x00d\\x00S\\x00' There are more code attributes which you can enlist by >>> dir(hello.__code__) Decorators Related to functions, python has another feature called decorators. Let's see how that works, keeping everything is an object in mind. Here is a sample decorator: >>> def deco(func): ... def inner(): ... print(\"before\") ... func() ... print(\"after\") ... return inner ... >>> @deco ... def hello_world(): ... print(\"hello world\") ... >>> >>> hello_world() before hello world after Here @deco syntax is used to decorate the hello_world function. It is essentially same as doing >>> def hello_world(): ... print(\"hello world\") ... >>> hello_world = deco(hello_world) What goes inside the deco function might seem complex. Let's try to uncover it. Function hello_world is created It is passed to deco function deco create a new function This new function is calls hello_world function And does a couple other things deco returns the newly created function hello_world is replaced with above function Let's visualize it for better understanding BEFORE function_object (ID: 100) \"hello_world\" +--------------------+ + |print(\"hello_world\")| | | | +--------------> | | | | +--------------------+ WHAT DECORATOR DOES creates a new function (ID: 101) +---------------------------------+ |input arg: function with id: 100 | | | |print(\"before\") | |call function object with id 100 | |print(\"after\") | | | +---------------------------------+ ^ | AFTER | | | \"hello_world\" +-------------+ Note how the hello_world name points to a new function object but that new function object knows the reference (ID) of the original function. Some Gotchas While it is very quick to build prototypes in python and there are tons of libraries available, as the codebase complexity increases, type errors become more common and will get hard to deal with. (There are solutions to that problem like type annotations in python. Checkout mypy .) Because python is dynamically typed language, that means all types are determined at runtime. And that makes python run very slow compared to other statically typed languages. Python has something called GIL (global interpreter lock) which is a limiting factor for utilizing multiple CPU cores for parallel computation. Some weird things that python does: https://github.com/satwikkansal/wtfpython","title":"Some Python Concepts"},{"location":"level101/python_web/python-concepts/#some-python-concepts","text":"Though you are expected to know python and its syntax at basic level, let us discuss some fundamental concepts that will help you understand the python language better. Everything in Python is an object. That includes the functions, lists, dicts, classes, modules, a running function (instance of function definition), everything. In the CPython, it would mean there is an underlying struct variable for each object. In python's current execution context, all the variables are stored in a dict. It'd be a string to object mapping. If you have a function and a float variable defined in the current context, here is how it is handled internally. >>> float_number=42.0 >>> def foo_func(): ... pass ... # NOTICE HOW VARIABLE NAMES ARE STRINGS, stored in a dict >>> locals() {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'float_number': 42.0, 'foo_func': }","title":"Some Python Concepts"},{"location":"level101/python_web/python-concepts/#python-functions","text":"Since functions too are objects, we can see what all attributes a function contains as following >>> def hello(name): ... print(f\"Hello, {name}!\") ... >>> dir(hello) ['__annotations__', '__call__', '__class__', '__closure__', '__code__', '__defaults__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__get__', '__getattribute__', '__globals__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__kwdefaults__', '__le__', '__lt__', '__module__', '__name__', '__ne__', '__new__', '__qualname__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__'] While there are a lot of them, let's look at some interesting ones","title":"Python Functions"},{"location":"level101/python_web/python-concepts/#globals","text":"This attribute, as the name suggests, has references of global variables. If you ever need to know what all global variables are in the scope of this function, this will tell you. See how the function start seeing the new variable in globals >>> hello.__globals__ {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'hello': } # adding new global variable >>> GLOBAL=\"g_val\" >>> hello.__globals__ {'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': , '__spec__': None, '__annotations__': {}, '__builtins__': , 'hello': , 'GLOBAL': 'g_val'}","title":"globals"},{"location":"level101/python_web/python-concepts/#code","text":"This is an interesting one! As everything in python is an object, this includes the bytecode too. The compiled python bytecode is a python code object. Which is accessible via __code__ attribute here. A function has an associated code object which carries some interesting information. # the file in which function is defined # stdin here since this is run in an interpreter >>> hello.__code__.co_filename '' # number of arguments the function takes >>> hello.__code__.co_argcount 1 # local variable names >>> hello.__code__.co_varnames ('name',) # the function code's compiled bytecode >>> hello.__code__.co_code b't\\x00d\\x01|\\x00\\x9b\\x00d\\x02\\x9d\\x03\\x83\\x01\\x01\\x00d\\x00S\\x00' There are more code attributes which you can enlist by >>> dir(hello.__code__)","title":"code"},{"location":"level101/python_web/python-concepts/#decorators","text":"Related to functions, python has another feature called decorators. Let's see how that works, keeping everything is an object in mind. Here is a sample decorator: >>> def deco(func): ... def inner(): ... print(\"before\") ... func() ... print(\"after\") ... return inner ... >>> @deco ... def hello_world(): ... print(\"hello world\") ... >>> >>> hello_world() before hello world after Here @deco syntax is used to decorate the hello_world function. It is essentially same as doing >>> def hello_world(): ... print(\"hello world\") ... >>> hello_world = deco(hello_world) What goes inside the deco function might seem complex. Let's try to uncover it. Function hello_world is created It is passed to deco function deco create a new function This new function is calls hello_world function And does a couple other things deco returns the newly created function hello_world is replaced with above function Let's visualize it for better understanding BEFORE function_object (ID: 100) \"hello_world\" +--------------------+ + |print(\"hello_world\")| | | | +--------------> | | | | +--------------------+ WHAT DECORATOR DOES creates a new function (ID: 101) +---------------------------------+ |input arg: function with id: 100 | | | |print(\"before\") | |call function object with id 100 | |print(\"after\") | | | +---------------------------------+ ^ | AFTER | | | \"hello_world\" +-------------+ Note how the hello_world name points to a new function object but that new function object knows the reference (ID) of the original function.","title":"Decorators"},{"location":"level101/python_web/python-concepts/#some-gotchas","text":"While it is very quick to build prototypes in python and there are tons of libraries available, as the codebase complexity increases, type errors become more common and will get hard to deal with. (There are solutions to that problem like type annotations in python. Checkout mypy .) Because python is dynamically typed language, that means all types are determined at runtime. And that makes python run very slow compared to other statically typed languages. Python has something called GIL (global interpreter lock) which is a limiting factor for utilizing multiple CPU cores for parallel computation. Some weird things that python does: https://github.com/satwikkansal/wtfpython","title":"Some Gotchas"},{"location":"level101/python_web/python-web-flask/","text":"Python, Web and Flask Back in the old days, websites were simple. They were simple static html contents. A webserver would be listening on a defined port and according to the HTTP request received, it would read files from disk and return them in response. But since then, complexity has evolved and websites are now dynamic. Depending on the request, multiple operations need to be performed like reading from database or calling other API and finally returning some response (HTML data, JSON content etc.) Since serving web requests is no longer a simple task like reading files from disk and return contents, we need to process each http request, perform some operations programmatically and construct a response. Sockets Though we have frameworks like flask, HTTP is still a protocol that works over TCP protocol. So let us setup a TCP server and send an HTTP request and inspect the request's payload. Note that this is not a tutorial on socket programming but what we are doing here is inspecting HTTP protocol at its ground level and look at what its contents look like. (Ref: Socket Programming in Python (Guide) on RealPython ) import socket HOST = '127.0.0.1' # Standard loopback interface address (localhost) PORT = 65432 # Port to listen on (non-privileged ports are > 1023) with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s: s.bind((HOST, PORT)) s.listen() conn, addr = s.accept() with conn: print('Connected by', addr) while True: data = conn.recv(1024) if not data: break print(data) Then we open localhost:65432 in our web browser and following would be the output: Connected by ('127.0.0.1', 54719) b'GET / HTTP/1.1\\r\\nHost: localhost:65432\\r\\nConnection: keep-alive\\r\\nDNT: 1\\r\\nUpgrade-Insecure-Requests: 1\\r\\nUser-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36 Edg/85.0.564.44\\r\\nAccept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9\\r\\nSec-Fetch-Site: none\\r\\nSec-Fetch-Mode: navigate\\r\\nSec-Fetch-User: ?1\\r\\nSec-Fetch-Dest: document\\r\\nAccept-Encoding: gzip, deflate, br\\r\\nAccept-Language: en-US,en;q=0.9\\r\\n\\r\\n' Examine closely and the content will look like the HTTP protocol's format. ie: HTTP_METHOD URI_PATH HTTP_VERSION HEADERS_SEPARATED_BY_SEPARATOR So though it's a blob of bytes, knowing http protocol specification , you can parse that string (ie: split by \\r\\n ) and get meaningful information out of it. Flask Flask, and other such frameworks does pretty much what we just discussed in the last section (with added more sophistication). They listen on a port on a TCP socket, receive an HTTP request, parse the data according to protocol format and make it available to you in a convenient manner. ie: you can access headers in flask by request.headers which is made available to you by splitting above payload by /r/n , as defined in http protocol. Another example: we register routes in flask by @app.route(\"/hello\") . What flask will do is maintain a registry internally which will map /hello with the function you decorated with. Now whenever a request comes with the /hello route (second component in the first line, split by space), flask calls the registered function and returns whatever the function returned. Same with all other web frameworks in other languages too. They all work on similar principles. What they basically do is understand the HTTP protocol, parses the HTTP request data and gives us programmers a nice interface to work with HTTP requests. Not so much of magic, innit?","title":"Python, Web and Flask"},{"location":"level101/python_web/python-web-flask/#python-web-and-flask","text":"Back in the old days, websites were simple. They were simple static html contents. A webserver would be listening on a defined port and according to the HTTP request received, it would read files from disk and return them in response. But since then, complexity has evolved and websites are now dynamic. Depending on the request, multiple operations need to be performed like reading from database or calling other API and finally returning some response (HTML data, JSON content etc.) Since serving web requests is no longer a simple task like reading files from disk and return contents, we need to process each http request, perform some operations programmatically and construct a response.","title":"Python, Web and Flask"},{"location":"level101/python_web/python-web-flask/#sockets","text":"Though we have frameworks like flask, HTTP is still a protocol that works over TCP protocol. So let us setup a TCP server and send an HTTP request and inspect the request's payload. Note that this is not a tutorial on socket programming but what we are doing here is inspecting HTTP protocol at its ground level and look at what its contents look like. (Ref: Socket Programming in Python (Guide) on RealPython ) import socket HOST = '127.0.0.1' # Standard loopback interface address (localhost) PORT = 65432 # Port to listen on (non-privileged ports are > 1023) with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s: s.bind((HOST, PORT)) s.listen() conn, addr = s.accept() with conn: print('Connected by', addr) while True: data = conn.recv(1024) if not data: break print(data) Then we open localhost:65432 in our web browser and following would be the output: Connected by ('127.0.0.1', 54719) b'GET / HTTP/1.1\\r\\nHost: localhost:65432\\r\\nConnection: keep-alive\\r\\nDNT: 1\\r\\nUpgrade-Insecure-Requests: 1\\r\\nUser-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36 Edg/85.0.564.44\\r\\nAccept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9\\r\\nSec-Fetch-Site: none\\r\\nSec-Fetch-Mode: navigate\\r\\nSec-Fetch-User: ?1\\r\\nSec-Fetch-Dest: document\\r\\nAccept-Encoding: gzip, deflate, br\\r\\nAccept-Language: en-US,en;q=0.9\\r\\n\\r\\n' Examine closely and the content will look like the HTTP protocol's format. ie: HTTP_METHOD URI_PATH HTTP_VERSION HEADERS_SEPARATED_BY_SEPARATOR So though it's a blob of bytes, knowing http protocol specification , you can parse that string (ie: split by \\r\\n ) and get meaningful information out of it.","title":"Sockets"},{"location":"level101/python_web/python-web-flask/#flask","text":"Flask, and other such frameworks does pretty much what we just discussed in the last section (with added more sophistication). They listen on a port on a TCP socket, receive an HTTP request, parse the data according to protocol format and make it available to you in a convenient manner. ie: you can access headers in flask by request.headers which is made available to you by splitting above payload by /r/n , as defined in http protocol. Another example: we register routes in flask by @app.route(\"/hello\") . What flask will do is maintain a registry internally which will map /hello with the function you decorated with. Now whenever a request comes with the /hello route (second component in the first line, split by space), flask calls the registered function and returns whatever the function returned. Same with all other web frameworks in other languages too. They all work on similar principles. What they basically do is understand the HTTP protocol, parses the HTTP request data and gives us programmers a nice interface to work with HTTP requests. Not so much of magic, innit?","title":"Flask"},{"location":"level101/python_web/sre-conclusion/","text":"Conclusion Scaling The App The design and development is just a part of the journey. We will need to setup continuous integration and continuous delivery pipelines sooner or later. And we have to deploy this app somewhere. Initially we can start with deploying this app on one virtual machine on any cloud provider. But this is a Single point of failure which is something we never allow as an SRE (or even as an engineer). So an improvement here can be having multiple instances of applications deployed behind a load balancer. This certainly prevents problems of one machine going down. Scaling here would mean adding more instances behind the load balancer. But this is scalable upto only a certain point. After that, other bottlenecks in the system will start appearing. ie: DB will become the bottleneck, or perhaps the load balancer itself. How do you know what is the bottleneck? You need to have observability into each aspects of the application architecture. Only after you have metrics, you will be able to know what is going wrong where. What gets measured, gets fixed! Get deeper insights into scaling from School Of SRE's Scalability module and post going through it, apply your learnings and takeaways to this app. Think how will we make this app geographically distributed and highly available and scalable. Monitoring Strategy Once we have our application deployed. It will be working ok. But not forever. Reliability is in the title of our job and we make systems reliable by making the design in a certain way. But things still will go down. Machines will fail. Disks will behave weirdly. Buggy code will get pushed to production. And all these possible scenarios will make the system less reliable. So what do we do? We monitor! We keep an eye on the system's health and if anything is not going as expected, we want ourselves to get alerted. Now let's think in terms of the given url shortening app. We need to monitor it. And we would want to get notified in case something goes wrong. But we first need to decide what is that something that we want to keep an eye on. Since it's a web app serving HTTP requests, we want to keep an eye on HTTP Status codes and latencies Request volume again is a good candidate, if the app is receiving an unusual amount of traffic, something might be off. We also want to keep an eye on the database so depending on the database solution chosen. Query times, volumes, disk usage etc. Finally, there also needs to be some external monitoring which runs periodic tests from devices outside of your data centers. This emulates customers and ensures that from customer point of view, the system is working as expected. Applications in SRE role In the world of SRE, python is a widely used language. For small scripts and tooling developed for various purposes. Since tooling developed by SRE works with critical pieces of infrastructure and has great power (to bring things down), it is important to know what you are doing while using a programming language and its features. Also it is equally important to know the language and its characteristics while debugging the issues. As an SRE having a deeper understanding of python language, it has helped me a lot to debug very sneaky bugs and be generally more aware and informed while making certain design decisions. While developing tools may or may not be part of SRE job, supporting tools or services is more likely to be a daily duty. Building an application or tool is just a small part of productionization. While there is certainly that goes in the design of the application itself to make it more robust, as an SRE you are responsible for its reliability and stability once it is deployed and running. And to ensure that, you\u2019d need to understand the application first and then come up with a strategy to monitor it properly and be prepared for various failure scenarios. Optional Exercises Make a decorator that will cache function return values depending on input parameters. Host the URL shortening app on any cloud provider. Setup monitoring using many of the tools available like catchpoint, datadog etc. Create a minimal flask-like framework on top of TCP sockets. Conclusion This module, in the first part, aims to make you more aware of the things that will happen when you choose python as your programming language and what happens when you run a python program. With the knowledge of how python handles things internally as objects, lot of seemingly magic things in python will start to make more sense. The second part will first explain how a framework like flask works using the existing knowledge of protocols like TCP and HTTP. It then touches the whole lifecycle of an application development lifecycle including the SRE parts of it. While the design and areas in architecture considered will not be exhaustive, it will give a good overview of things that are also important being an SRE and why they are important.","title":"Conclusion"},{"location":"level101/python_web/sre-conclusion/#conclusion","text":"","title":"Conclusion"},{"location":"level101/python_web/sre-conclusion/#scaling-the-app","text":"The design and development is just a part of the journey. We will need to setup continuous integration and continuous delivery pipelines sooner or later. And we have to deploy this app somewhere. Initially we can start with deploying this app on one virtual machine on any cloud provider. But this is a Single point of failure which is something we never allow as an SRE (or even as an engineer). So an improvement here can be having multiple instances of applications deployed behind a load balancer. This certainly prevents problems of one machine going down. Scaling here would mean adding more instances behind the load balancer. But this is scalable upto only a certain point. After that, other bottlenecks in the system will start appearing. ie: DB will become the bottleneck, or perhaps the load balancer itself. How do you know what is the bottleneck? You need to have observability into each aspects of the application architecture. Only after you have metrics, you will be able to know what is going wrong where. What gets measured, gets fixed! Get deeper insights into scaling from School Of SRE's Scalability module and post going through it, apply your learnings and takeaways to this app. Think how will we make this app geographically distributed and highly available and scalable.","title":"Scaling The App"},{"location":"level101/python_web/sre-conclusion/#monitoring-strategy","text":"Once we have our application deployed. It will be working ok. But not forever. Reliability is in the title of our job and we make systems reliable by making the design in a certain way. But things still will go down. Machines will fail. Disks will behave weirdly. Buggy code will get pushed to production. And all these possible scenarios will make the system less reliable. So what do we do? We monitor! We keep an eye on the system's health and if anything is not going as expected, we want ourselves to get alerted. Now let's think in terms of the given url shortening app. We need to monitor it. And we would want to get notified in case something goes wrong. But we first need to decide what is that something that we want to keep an eye on. Since it's a web app serving HTTP requests, we want to keep an eye on HTTP Status codes and latencies Request volume again is a good candidate, if the app is receiving an unusual amount of traffic, something might be off. We also want to keep an eye on the database so depending on the database solution chosen. Query times, volumes, disk usage etc. Finally, there also needs to be some external monitoring which runs periodic tests from devices outside of your data centers. This emulates customers and ensures that from customer point of view, the system is working as expected.","title":"Monitoring Strategy"},{"location":"level101/python_web/sre-conclusion/#applications-in-sre-role","text":"In the world of SRE, python is a widely used language. For small scripts and tooling developed for various purposes. Since tooling developed by SRE works with critical pieces of infrastructure and has great power (to bring things down), it is important to know what you are doing while using a programming language and its features. Also it is equally important to know the language and its characteristics while debugging the issues. As an SRE having a deeper understanding of python language, it has helped me a lot to debug very sneaky bugs and be generally more aware and informed while making certain design decisions. While developing tools may or may not be part of SRE job, supporting tools or services is more likely to be a daily duty. Building an application or tool is just a small part of productionization. While there is certainly that goes in the design of the application itself to make it more robust, as an SRE you are responsible for its reliability and stability once it is deployed and running. And to ensure that, you\u2019d need to understand the application first and then come up with a strategy to monitor it properly and be prepared for various failure scenarios.","title":"Applications in SRE role"},{"location":"level101/python_web/sre-conclusion/#optional-exercises","text":"Make a decorator that will cache function return values depending on input parameters. Host the URL shortening app on any cloud provider. Setup monitoring using many of the tools available like catchpoint, datadog etc. Create a minimal flask-like framework on top of TCP sockets.","title":"Optional Exercises"},{"location":"level101/python_web/sre-conclusion/#conclusion_1","text":"This module, in the first part, aims to make you more aware of the things that will happen when you choose python as your programming language and what happens when you run a python program. With the knowledge of how python handles things internally as objects, lot of seemingly magic things in python will start to make more sense. The second part will first explain how a framework like flask works using the existing knowledge of protocols like TCP and HTTP. It then touches the whole lifecycle of an application development lifecycle including the SRE parts of it. While the design and areas in architecture considered will not be exhaustive, it will give a good overview of things that are also important being an SRE and why they are important.","title":"Conclusion"},{"location":"level101/python_web/url-shorten-app/","text":"The URL Shortening App Let's build a very simple URL shortening app using flask and try to incorporate all aspects of the development process including the reliability aspects. We will not be building the UI and we will come up with a minimal set of API that will be enough for the app to function well. Design We don't jump directly to coding. First thing we do is gather requirements. Come up with an approach. Have the approach/design reviewed by peers. Evolve, iterate, document the decisions and tradeoffs. And then finally implement. While we will not do the full blown design document here, we will raise certain questions here that are important to the design. 1. High Level Operations and API Endpoints Since it's a URL shortening app, we will need an API for generating the shorten link given an original link. And an API/Endpoint which will accept the shorten link and redirect to original URL. We are not including the user aspect of the app to keep things minimal. These two API should make app functional and usable by anyone. 2. How to shorten? Given a url, we will need to generate a shortened version of it. One approach could be using random characters for each link. Another thing that can be done is to use some sort of hashing algorithm. The benefit here is we will reuse the same hash for the same link. ie: if lot of people are shortening https://www.linkedin.com they all will have the same value, compared to multiple entries in DB if chosen random characters. What about hash collisions? Even in random characters approach, though there is a less probability, hash collisions can happen. And we need to be mindful of them. In that case we might want to prepend/append the string with some random value to avoid conflict. Also, choice of hash algorithm matters. We will need to analyze algorithms. Their CPU requirements and their characteristics. Choose one that suits the most. 3. Is URL Valid? Given a URL to shorten, how do we verify if the URL is valid? Do we even verify or validate? One basic check that can be done is see if the URL matches a regex of a URL. To go even further we can try opening/visiting the URL. But there are certain gotchas here. We need to define success criteria. ie: HTTP 200 means it is valid. What is the URL is in private network? What if URL is temporarily down? 4. Storage Finally, storage. Where will we store the data that we will generate over time? There are multiple database solutions available and we will need to choose the one that suits this app the most. Relational database like MySQL would be a fair choice but be sure to checkout School of SRE's SQL database section and NoSQL databases section for deeper insights into making a more informed decision. 5. Other We are not accounting for users into our app and other possible features like rate limiting, customized links etc but it will eventually come up with time. Depending on the requirements, they too might need to get incorporated. The minimal working code is given below for reference but I'd encourage you to come up with your own. from flask import Flask, redirect, request from hashlib import md5 app = Flask(\"url_shortener\") mapping = {} @app.route(\"/shorten\", methods=[\"POST\"]) def shorten(): global mapping payload = request.json if \"url\" not in payload: return \"Missing URL Parameter\", 400 # TODO: check if URL is valid hash_ = md5() hash_.update(payload[\"url\"].encode()) digest = hash_.hexdigest()[:5] # limiting to 5 chars. Less the limit more the chances of collission if digest not in mapping: mapping[digest] = payload[\"url\"] return f\"Shortened: r/{digest}\\n\" else: # TODO: check for hash collission return f\"Already exists: r/{digest}\\n\" @app.route(\"/r/\") def redirect_(hash_): if hash_ not in mapping: return \"URL Not Found\", 404 return redirect(mapping[hash_]) if __name__ == \"__main__\": app.run(debug=True) \"\"\" OUTPUT: ===> SHORTENING $ curl localhost:5000/shorten -H \"content-type: application/json\" --data '{\"url\":\"https://linkedin.com\"}' Shortened: r/a62a4 ===> REDIRECTING, notice the response code 302 and the location header $ curl localhost:5000/r/a62a4 -v * Uses proxy env variable NO_PROXY == '127.0.0.1' * Trying ::1... * TCP_NODELAY set * Connection failed * connect to ::1 port 5000 failed: Connection refused * Trying 127.0.0.1... * TCP_NODELAY set * Connected to localhost (127.0.0.1) port 5000 (#0) > GET /r/a62a4 HTTP/1.1 > Host: localhost:5000 > User-Agent: curl/7.64.1 > Accept: */* > * HTTP 1.0, assume close after body < HTTP/1.0 302 FOUND < Content-Type: text/html; charset=utf-8 < Content-Length: 247 < Location: https://linkedin.com < Server: Werkzeug/0.15.4 Python/3.7.7 < Date: Tue, 27 Oct 2020 09:37:12 GMT < Redirecting...

    Redirecting...

    * Closing connection 0

    You should be redirected automatically to target URL: https://linkedin.com. If not click the link. \"\"\"","title":"The URL Shortening App"},{"location":"level101/python_web/url-shorten-app/#the-url-shortening-app","text":"Let's build a very simple URL shortening app using flask and try to incorporate all aspects of the development process including the reliability aspects. We will not be building the UI and we will come up with a minimal set of API that will be enough for the app to function well.","title":"The URL Shortening App"},{"location":"level101/python_web/url-shorten-app/#design","text":"We don't jump directly to coding. First thing we do is gather requirements. Come up with an approach. Have the approach/design reviewed by peers. Evolve, iterate, document the decisions and tradeoffs. And then finally implement. While we will not do the full blown design document here, we will raise certain questions here that are important to the design.","title":"Design"},{"location":"level101/python_web/url-shorten-app/#1-high-level-operations-and-api-endpoints","text":"Since it's a URL shortening app, we will need an API for generating the shorten link given an original link. And an API/Endpoint which will accept the shorten link and redirect to original URL. We are not including the user aspect of the app to keep things minimal. These two API should make app functional and usable by anyone.","title":"1. High Level Operations and API Endpoints"},{"location":"level101/python_web/url-shorten-app/#2-how-to-shorten","text":"Given a url, we will need to generate a shortened version of it. One approach could be using random characters for each link. Another thing that can be done is to use some sort of hashing algorithm. The benefit here is we will reuse the same hash for the same link. ie: if lot of people are shortening https://www.linkedin.com they all will have the same value, compared to multiple entries in DB if chosen random characters. What about hash collisions? Even in random characters approach, though there is a less probability, hash collisions can happen. And we need to be mindful of them. In that case we might want to prepend/append the string with some random value to avoid conflict. Also, choice of hash algorithm matters. We will need to analyze algorithms. Their CPU requirements and their characteristics. Choose one that suits the most.","title":"2. How to shorten?"},{"location":"level101/python_web/url-shorten-app/#3-is-url-valid","text":"Given a URL to shorten, how do we verify if the URL is valid? Do we even verify or validate? One basic check that can be done is see if the URL matches a regex of a URL. To go even further we can try opening/visiting the URL. But there are certain gotchas here. We need to define success criteria. ie: HTTP 200 means it is valid. What is the URL is in private network? What if URL is temporarily down?","title":"3. Is URL Valid?"},{"location":"level101/python_web/url-shorten-app/#4-storage","text":"Finally, storage. Where will we store the data that we will generate over time? There are multiple database solutions available and we will need to choose the one that suits this app the most. Relational database like MySQL would be a fair choice but be sure to checkout School of SRE's SQL database section and NoSQL databases section for deeper insights into making a more informed decision.","title":"4. Storage"},{"location":"level101/python_web/url-shorten-app/#5-other","text":"We are not accounting for users into our app and other possible features like rate limiting, customized links etc but it will eventually come up with time. Depending on the requirements, they too might need to get incorporated. The minimal working code is given below for reference but I'd encourage you to come up with your own. from flask import Flask, redirect, request from hashlib import md5 app = Flask(\"url_shortener\") mapping = {} @app.route(\"/shorten\", methods=[\"POST\"]) def shorten(): global mapping payload = request.json if \"url\" not in payload: return \"Missing URL Parameter\", 400 # TODO: check if URL is valid hash_ = md5() hash_.update(payload[\"url\"].encode()) digest = hash_.hexdigest()[:5] # limiting to 5 chars. Less the limit more the chances of collission if digest not in mapping: mapping[digest] = payload[\"url\"] return f\"Shortened: r/{digest}\\n\" else: # TODO: check for hash collission return f\"Already exists: r/{digest}\\n\" @app.route(\"/r/\") def redirect_(hash_): if hash_ not in mapping: return \"URL Not Found\", 404 return redirect(mapping[hash_]) if __name__ == \"__main__\": app.run(debug=True) \"\"\" OUTPUT: ===> SHORTENING $ curl localhost:5000/shorten -H \"content-type: application/json\" --data '{\"url\":\"https://linkedin.com\"}' Shortened: r/a62a4 ===> REDIRECTING, notice the response code 302 and the location header $ curl localhost:5000/r/a62a4 -v * Uses proxy env variable NO_PROXY == '127.0.0.1' * Trying ::1... * TCP_NODELAY set * Connection failed * connect to ::1 port 5000 failed: Connection refused * Trying 127.0.0.1... * TCP_NODELAY set * Connected to localhost (127.0.0.1) port 5000 (#0) > GET /r/a62a4 HTTP/1.1 > Host: localhost:5000 > User-Agent: curl/7.64.1 > Accept: */* > * HTTP 1.0, assume close after body < HTTP/1.0 302 FOUND < Content-Type: text/html; charset=utf-8 < Content-Length: 247 < Location: https://linkedin.com < Server: Werkzeug/0.15.4 Python/3.7.7 < Date: Tue, 27 Oct 2020 09:37:12 GMT < Redirecting...

    Redirecting...

    * Closing connection 0

    You should be redirected automatically to target URL: https://linkedin.com. If not click the link. \"\"\"","title":"5. Other"},{"location":"level101/security/conclusion/","text":"Conclusion Now that you have completed this course on Security you are now aware of the possible security threats to computer systems & networks. Not only that, but you are now better able to protect your systems as well as recommend security measures to others. This course provides fundamental everyday knowledge on security domain which will also help you keep security at the top of your priority. Other Resources Some books that would be a great resource Holistic Info-Sec for Web Developers https://holisticinfosecforwebdevelopers.com/ - Free and downloadable book series with very broad and deep coverage of what Web Developers and DevOps Engineers need to know in order to create robust, reliable, maintainable and secure software, networks and other, that are delivered continuously, on time, with no nasty surprises Docker Security - Quick Reference: For DevOps Engineers https://leanpub.com/dockersecurity-quickreference - A book on understanding the Docker security defaults, how to improve them (theory and practical), along with many tools and techniques. How to Hack Like a Legend https://amzn.to/2uWh1Up - A hacker\u2019s tale breaking into a secretive offshore company, Sparc Flow, 2018 How to Investigate Like a Rockstar https://books2read.com/u/4jDWoZ - Live a real crisis to master the secrets of forensic analysis, Sparc Flow, 2017 Real World Cryptography https://www.manning.com/books/real-world-cryptography - This early-access book teaches you applied cryptographic techniques to understand and apply security at every level of your systems and applications. AWS Security https://www.manning.com/books/aws-security?utm_source=github&utm_medium=organic&utm_campaign=book_shields_aws_1_31_20 - This early-access book covers commong AWS security issues and best practices for access policies, data protection, auditing, continuous monitoring, and incident response. Post Training asks/ Further Reading CTF Events like : https://github.com/apsdehal/awesome-ctf Penetration Testing : https://github.com/enaqx/awesome-pentest Threat Intelligence : https://github.com/hslatman/awesome-threat-intelligence Threat Detection & Hunting : https://github.com/0x4D31/awesome-threat-detection Web Security: https://github.com/qazbnm456/awesome-web-security Building Secure and Reliable Systems : https://landing.google.com/sre/resources/foundationsandprinciples/srs-book/","title":"Conclusion"},{"location":"level101/security/conclusion/#conclusion","text":"Now that you have completed this course on Security you are now aware of the possible security threats to computer systems & networks. Not only that, but you are now better able to protect your systems as well as recommend security measures to others. This course provides fundamental everyday knowledge on security domain which will also help you keep security at the top of your priority.","title":"Conclusion"},{"location":"level101/security/conclusion/#other-resources","text":"Some books that would be a great resource Holistic Info-Sec for Web Developers https://holisticinfosecforwebdevelopers.com/ - Free and downloadable book series with very broad and deep coverage of what Web Developers and DevOps Engineers need to know in order to create robust, reliable, maintainable and secure software, networks and other, that are delivered continuously, on time, with no nasty surprises Docker Security - Quick Reference: For DevOps Engineers https://leanpub.com/dockersecurity-quickreference - A book on understanding the Docker security defaults, how to improve them (theory and practical), along with many tools and techniques. How to Hack Like a Legend https://amzn.to/2uWh1Up - A hacker\u2019s tale breaking into a secretive offshore company, Sparc Flow, 2018 How to Investigate Like a Rockstar https://books2read.com/u/4jDWoZ - Live a real crisis to master the secrets of forensic analysis, Sparc Flow, 2017 Real World Cryptography https://www.manning.com/books/real-world-cryptography - This early-access book teaches you applied cryptographic techniques to understand and apply security at every level of your systems and applications. AWS Security https://www.manning.com/books/aws-security?utm_source=github&utm_medium=organic&utm_campaign=book_shields_aws_1_31_20 - This early-access book covers commong AWS security issues and best practices for access policies, data protection, auditing, continuous monitoring, and incident response.","title":"Other Resources"},{"location":"level101/security/conclusion/#post-training-asks-further-reading","text":"CTF Events like : https://github.com/apsdehal/awesome-ctf Penetration Testing : https://github.com/enaqx/awesome-pentest Threat Intelligence : https://github.com/hslatman/awesome-threat-intelligence Threat Detection & Hunting : https://github.com/0x4D31/awesome-threat-detection Web Security: https://github.com/qazbnm456/awesome-web-security Building Secure and Reliable Systems : https://landing.google.com/sre/resources/foundationsandprinciples/srs-book/","title":"Post Training asks/ Further Reading"},{"location":"level101/security/fundamentals/","text":"Part I: Fundamentals Introduction to Security Overview for SRE If you look closely, both Site Reliability Engineering and Security Engineering are concerned with keeping a system usable. Issues like broken releases, capacity shortages, and misconfigurations can make a system unusable (at least temporarily). Security or privacy incidents that break the trust of users also undermine the usefulness of a system. Consequently, system security should be top of mind for SREs. SREs should be involved in both significant design discussions and actual system changes. They have quite a big role in System design & hence are quite sometimes the first line of defence. SRE\u2019s help in preventing bad design & implementations which can affect the overall security of the infrastructure. Successfully designing, implementing, and maintaining systems requires a commitment to the full system lifecycle . This commitment is possible only when security and reliability are central elements in the architecture of systems. Core Pillars of Information Security : Confidentiality \u2013 only allow access to data for which the user is permitted Integrity \u2013 ensure data is not tampered or altered by unauthorized users Availability \u2013 ensure systems and data are available to authorized users when they need it Thinking like a Security Engineer When starting a new application or re-factoring an existing application, you should consider each functional feature, and consider: Is the process surrounding this feature as safe as possible? In other words, is this a flawed process? If I were evil, how would I abuse this feature? Or more specifically failing to address how a feature can be abused can cause design flaws. Is the feature required to be on by default? If so, are there limits or options that could help reduce the risk from this feature? Security Principles By OWASP (Open Web Application Security Project) Minimize attack surface area : Every feature that is added to an application adds a certain amount of risk to the overall application. The aim of secure development is to reduce the overall risk by reducing the attack surface area. For example, a web application implements online help with a search function. The search function may be vulnerable to SQL injection attacks. If the help feature was limited to authorized users, the attack likelihood is reduced. If the help feature\u2019s search function was gated through centralized data validation routines, the ability to perform SQL injection is dramatically reduced. However, if the help feature was re-written to eliminate the search function (through a better user interface, for example), this almost eliminates the attack surface area, even if the help feature was available to the Internet at large. Establish secure defaults: There are many ways to deliver an \u201cout of the box\u201d experience for users. However, by default, the experience should be secure, and it should be up to the user to reduce their security \u2013 if they are allowed. For example, by default, password ageing and complexity should be enabled. Users might be allowed to turn these two features off to simplify their use of the application and increase their risk. Default Passwords of routers, IoT devices should be changed Principle of Least privilege The principle of least privilege recommends that accounts have the least amount of privilege required to perform their business processes. This encompasses user rights, resource permissions such as CPU limits, memory, network, and file system permissions. For example, if a middleware server only requires access to the network, read access to a database table, and the ability to write to a log, this describes all the permissions that should be granted. Under no circumstances should the middleware be granted administrative privileges. Principle of Defense in depth The principle of defence in depth suggests that where one control would be reasonable, more controls that approach risks in different fashions are better. Controls, when used in depth, can make severe vulnerabilities extraordinarily difficult to exploit and thus unlikely to occur. With secure coding, this may take the form of tier-based validation, centralized auditing controls, and requiring users to be logged on all pages. For example, a flawed administrative interface is unlikely to be vulnerable to an anonymous attack if it correctly gates access to production management networks, checks for administrative user authorization, and logs all access. Fail securely Applications regularly fail to process transactions for many reasons. How they fail can determine if an application is secure or not. ``` is_admin = true; try { code_which_may_faile(); is_admin = is_user_assigned_role(\"Adminstrator\"); } catch (Exception err) { log.error(err.toString()); } ``` - If either codeWhichMayFail() or isUserInRole fails or throws an exception, the user is an admin by default. This is obviously a security risk. Don\u2019t trust services Many organizations utilize the processing capabilities of third-party partners, who more than likely have different security policies and posture than you. It is unlikely that you can influence or control any external third party, whether they are home users or major suppliers or partners. Therefore, the implicit trust of externally run systems is not warranted. All external systems should be treated similarly. For example, a loyalty program provider provides data that is used by Internet Banking, providing the number of reward points and a small list of potential redemption items. However, the data should be checked to ensure that it is safe to display to end-users and that the reward points are a positive number, and not improbably large. Separation of duties The key to fraud control is the separation of duties. For example, someone who requests a computer cannot also sign for it, nor should they directly receive the computer. This prevents the user from requesting many computers and claiming they never arrived. Certain roles have different levels of trust than normal users. In particular, administrators are different from normal users. In general, administrators should not be users of the application. For example, an administrator should be able to turn the system on or off, set password policy but shouldn\u2019t be able to log on to the storefront as a super privileged user, such as being able to \u201cbuy\u201d goods on behalf of other users. Avoid security by obscurity Security through obscurity is a weak security control, and nearly always fails when it is the only control. This is not to say that keeping secrets is a bad idea, it simply means that the security of systems should not be reliant upon keeping details hidden. For example, the security of an application should not rely upon knowledge of the source code being kept secret. The security should rely upon many other factors, including reasonable password policies, defence in depth, business transaction limits, solid network architecture, and fraud, and audit controls. A practical example is Linux. Linux\u2019s source code is widely available, and yet when properly secured, Linux is a secure and robust operating system. Keep security simple Attack surface area and simplicity go hand in hand. Certain software engineering practices prefer overly complex approaches to what would otherwise be a relatively straightforward and simple design. Developers should avoid the use of double negatives and complex architectures when a simpler approach would be faster and simpler. For example, although it might be fashionable to have a slew of singleton entity beans running on a separate middleware server, it is more secure and faster to simply use global variables with an appropriate mutex mechanism to protect against race conditions. Fix security issues correctly Once a security issue has been identified, it is important to develop a test for it and to understand the root cause of the issue. When design patterns are used, the security issue is likely widespread amongst all codebases, so developing the right fix without introducing regressions is essential. For example, a user has found that they can see another user\u2019s balance by adjusting their cookie. The fix seems to be relatively straightforward, but as the cookie handling code is shared among all applications, a change to just one application will trickle through to all other applications. The fix must, therefore, be tested on all affected applications. Reliability & Security Reliability and security are both crucial components of a truly trustworthy system, but building systems that are both reliable and secure is difficult. While the requirements for reliability and security share many common properties, they also require different design considerations. It is easy to miss the subtle interplay between reliability and security that can cause unexpected outcomes Ex: A password management application failure was triggered by a reliability problem i.e poor load-balancing and load-shedding strategies and its recovery were later complicated by multiple measures (HSM mechanism which needs to be plugged into server racks, which works as an authentication & the HSM token supposedly locked inside a case.. & the problem can be further elongated ) designed to increase the security of the system. Authentication vs Authorization Authentication is the act of validating that users are who they claim to be. Passwords are the most common authentication factor\u2014if a user enters the correct password, the system assumes the identity is valid and grants access. Other technologies such as One-Time Pins, authentication apps, and even biometrics can also be used to authenticate identity. In some instances, systems require the successful verification of more than one factor before granting access. This multi-factor authentication (MFA) requirement is often deployed to increase security beyond what passwords alone can provide. Authorization in system security is the process of giving the user permission to access a specific resource or function. This term is often used interchangeably with access control or client privilege. Giving someone permission to download a particular file on a server or providing individual users with administrative access to an application are good examples. In secure environments, authorization must always follow authentication, users should first prove that their identities are genuine before an organization\u2019s administrators grant them access to the requested resources. Common authentication flow (local authentication) The user registers using an identifier like username/email/mobile The application stores user credentials in the database The application sends a verification email/message to validate the registration Post successful registration, the user enters credentials for logging in On successful authentication, the user is allowed access to specific resources OpenID/OAuth OpenID is an authentication protocol that allows us to authenticate users without using a local auth system. In such a scenario, a user has to be registered with an OpenID Provider and the same provider should be integrated with the authentication flow of your application. To verify the details, we have to forward the authentication requests to the provider. On successful authentication, we receive a success message and/or profile details with which we can execute the necessary flow. OAuth is an authorization mechanism that allows your application user access to a provider(Gmail/Facebook/Instagram/etc). On successful response, we (your application) receive a token with which the application can access certain APIs on behalf of a user. OAuth is convenient in case your business use case requires some certain user-facing APIs like access to Google Drive or sending tweets on your behalf. Most OAuth 2.0 providers can be used for pseudo authentication. Having said that, it can get pretty complicated if you are using multiple OAuth providers to authenticate users on top of the local authentication system. Cryptography It is the science and study of hiding any text in such a way that only the intended recipients or authorized persons can read it and that any text can even use things such as invisible ink or the mechanical cryptography machines of the past. Cryptography is necessary for securing critical or proprietary information and is used to encode private data messages by converting some plain text into ciphertext. At its core, there are two ways of doing this, more advanced methods are all built upon. Ciphers Ciphers are the cornerstone of cryptography. A cipher is a set of algorithms that performs encryption or decryption on a message. An encryption algorithm (E) takes a secret key (k) and a message (m) and produces a ciphertext (c). Similarly, a Decryption algorithm (D) takes a secret key (K) and the previous resulting Ciphertext (C). They are represented as follows: E(k,m) = c D(k,c) = m This also means that for it to be a cipher, it must satisfy the consistency equation as follows, making it possible to decrypt. D(k,E(k,m)) = m Stream Ciphers: The message is broken into characters or bits and enciphered with a key or keystream(should be random and generated independently of the message stream) that is as long as the plaintext bitstream. If the keystream is random, this scheme would be unbreakable unless the keystream was acquired, making it unconditionally secure. The keystream must be provided to both parties in a secure way to prevent its release. Block Ciphers: Block ciphers \u2014 process messages in blocks, each of which is then encrypted or decrypted. A block cipher is a symmetric cipher in which blocks of plaintext are treated as a whole and used to produce ciphertext blocks. The block cipher takes blocks that are b bits long and encrypts them to blocks that are also b bits long. Block sizes are typically 64 or 128 bits long. Encryption Secret Key (Symmetric Key) : the same key is used for encryption and decryption Public Key (Asymmetric Key) in an asymmetric, the encryption and decryption keys are different but related. The encryption key is known as the public key and the decryption key is known as the private key. The public and private keys are known as a key pair. Symmetric Key Encryption DES The Data Encryption Standard (DES) has been the worldwide encryption standard for a long time. IBM developed DES in 1975, and it has held up remarkably well against years of cryptanalysis. DES is a symmetric encryption algorithm with a fixed key length of 56 bits. The algorithm is still good, but because of the short key length, it is susceptible to brute-force attacks that have sufficient resources. DES usually operates in block mode, whereby it encrypts data in 64-bit blocks. The same algorithm and key are used for both encryption and decryption. Because DES is based on simple mathematical functions, it can be easily implemented and accelerated in hardware. Triple DES With advances in computer processing power, the original 56-bit DES key became too short to withstand an attacker with even a limited budget. One way of increasing the effective key length of DES without changing the well-analyzed algorithm itself is to use the same algorithm with different keys several times in a row. The technique of applying DES three times in a row to a plain text block is called Triple DES (3DES). The 3DES technique is shown in Figure. Brute-force attacks on 3DES are considered unfeasible today. Because the basic algorithm has been tested in the field for more than 25 years, it is considered to be more trustworthy than its predecessor. AES On October 2, 2000, The U.S. National Institute of Standards and Technology (NIST) announced the selection of the Rijndael cipher as the AES algorithm. This cipher, developed by Joan Daemen and Vincent Rijmen, has a variable block length and key length. The algorithm currently specifies how to use keys with a length of 128, 192, or 256 bits to encrypt blocks with a length of 128, 192, or 256 bits (all nine combinations of key length and block length are possible). Both block and key lengths can be extended easily to multiples of 32 bits. AES was chosen to replace DES and 3DES because they are either too weak (DES, in terms of key length) or too slow (3DES) to run on modern, efficient hardware. AES is more efficient and much faster, usually by a factor of 5 compared to DES on the same hardware. AES is also more suitable for high throughput, especially if pure software encryption is used. However, AES is a relatively young algorithm, and as the golden rule of cryptography states, \u201cA more mature algorithm is always more trusted.\u201d Asymmetric Key Algorithm In a symmetric key system, Alice first puts the secret message in a box and then padlocks the box using a lock to which she has a key. She then sends the box to Bob through regular mail. When Bob receives the box, he uses an identical copy of Alice's key (which he has obtained previously) to open the box and read the message. In an asymmetric key system, instead of opening the box when he receives it, Bob simply adds his own personal lock to the box and returns the box through public mail to Alice. Alice uses her key to remove her lock and returns the box to Bob, with Bob's lock still in place. Finally, Bob uses his key to remove his lock and reads the message from Alice. The critical advantage in an asymmetric system is that Alice never needs to send a copy of her key to Bob. This reduces the possibility that a third party (for example, an unscrupulous postmaster) can copy the key while it is in transit to Bob, allowing that third party to spy on all future messages sent by Alice. In addition, if Bob is careless and allows someone else to copy his key, Alice's messages to Bob are compromised, but Alice's messages to other people remain secret NOTE : In terms of TLS key exchange, this is the common approach. Diffie-Hellman The protocol has two system parameters, p and g. They are both public and may be used by everybody. Parameter p is a prime number, and parameter g (usually called a generator) is an integer that is smaller than p, but with the following property: For every number n between 1 and p \u2013 1 inclusive, there is a power k of g such that n = gk mod p. Diffie Hellman algorithm is an asymmetric algorithm used to establish a shared secret for a symmetric key algorithm. Nowadays most of the people use hybrid cryptosystem i.e, a combination of symmetric and asymmetric encryption. Asymmetric Encryption is used as a technique in key exchange mechanism to share a secret key and after the key is shared between sender and receiver, the communication will take place using symmetric encryption. The shared secret key will be used to encrypt the communication. Refer: https://medium.com/@akhigbemmanuel/what-is-the-diffie-hellman-key-exchange-algorithm-84d60025a30d RSA The RSA algorithm is very flexible and has a variable key length where, if necessary, speed can be traded for the level of security of the algorithm. The RSA keys are usually 512 to 2048 bits long. RSA has withstood years of extensive cryptanalysis. Although those years neither proved nor disproved RSA's security, they attest to a confidence level in the algorithm. RSA security is based on the difficulty of factoring very large numbers. If an easy method of factoring these large numbers were discovered, the effectiveness of RSA would be destroyed. Refer: https://medium.com/curiositypapers/a-complete-explanation-of-rsa-asymmetric-encryption-742c5971e0f NOTE : RSA Keys can be used for key exchange just like Diffie Hellman Hashing Algorithms Hashing is one of the mechanisms used for data integrity assurance. Hashing is based on a one-way mathematical function, which is relatively easy to compute but significantly harder to reverse. A hash function, which is a one-way function to input data to produce a fixed-length digest (fingerprint) of output data. The digest is cryptographically strong; that is, it is impossible to recover input data from its digest. If the input data changes just a little, the digest (fingerprint) changes substantially in what is called an avalanche effect. More: https://medium.com/@rauljordan/the-state-of-hashing-algorithms-the-why-the-how-and-the-future-b21d5c0440de https://medium.com/@StevieCEllis/the-beautiful-hash-algorithm-f18d9d2b84fb MD5 MD5 is a one-way function with which it is easy to compute the hash from the given input data, but it is unfeasible to compute input data given only a hash. SHA-1 MD5 is considered less secure than SHA-1 because MD5 has some weaknesses. HA-1 also uses a stronger, 160-bit digest, which makes MD5 the second choice as hash methods are concerned. The algorithm takes a message of less than 264 bits in length and produces a 160-bit message digest. This algorithm is slightly slower than MD5. NOTE : SHA-1 is also recently demonstrated to be broken, Minimum current recommendation is SHA-256 Digital Certificates Digital signatures, provide a means to digitally authenticate devices and individual users. In public-key cryptography, such as the RSA encryption system, each user has a key-pair containing both a public key and a private key. The keys act as complements, and anything encrypted with one of the keys can be decrypted with the other. In simple terms, a signature is formed when data is encrypted with a user's private key. The receiver verifies the signature by decrypting the message with the sender's public key. Key management is often considered the most difficult task in designing and implementing cryptographic systems. Businesses can simplify some of the deployment and management issues that are encountered with secured data communications by employing a Public Key Infrastructure (PKI). Because corporations often move security-sensitive communications across the Internet, an effective mechanism must be implemented to protect sensitive information from the threats presented on the Internet. PKI provides a hierarchical framework for managing digital security attributes. Each PKI participant holds a digital certificate that has been issued by a CA (either public or private). The certificate contains several attributes that are used when parties negotiate a secure connection. These attributes must include the certificate validity period, end-host identity information, encryption keys that will be used for secure communications, and the signature of the issuing CA. Optional attributes may be included, depending on the requirements and capability of the PKI. A CA can be a trusted third party, such as VeriSign or Entrust, or a private (in-house) CA that you establish within your organization. The fact that the message could be decrypted using the sender's public key means that the holder of the private key created the message. This process relies on the receiver having a copy of the sender's public key and knowing with a high degree of certainty that it really does belong to the sender and not to someone pretending to be the sender. To validate the CA's signature, the receiver must know the CA's public key. Normally, this is handled out-of-band or through an operation performed during the installation of the certificate. For instance, most web browsers are configured with the root certificates of several CAs by default. CA Enrollment process The end host generates a private-public key pair. The end host generates a certificate request, which it forwards to the CA. Manual human intervention is required to approve the enrollment request, which is received by the CA. After the CA operator approves the request, the CA signs the certificate request with its private key and returns the completed certificate to the end host. The end host writes the certificate into a nonvolatile storage area (PC hard disk or NVRAM on Cisco routers). Refer : https://www.ssh.com/manuals/server-zos-product/55/ch06s03s01.html Login Security SSH SSH, the Secure Shell, is a popular, powerful, software-based approach to network security. Whenever data is sent by a computer to the network, SSH automatically encrypts (scrambles) it. Then, when the data reaches its intended recipient, SSH automatically decrypts (unscrambles) it. The result is transparent encryption: users can work normally, unaware that their communications are safely encrypted on the network. In addition, SSH can use modern, secure encryption algorithms based on how it's being configured and is effective enough to be found within mission-critical applications at major corporations. SSH has a client/server architecture An SSH server program, typically installed and run by a system administrator, accepts or rejects incoming connections to its host computer. Users then run SSH client programs, typically on other computers, to make requests of the SSH server, such as \u201cPlease log me in,\u201d \u201cPlease send me a file,\u201d or \u201cPlease execute this command.\u201d All communications between clients and servers are securely encrypted and protected from modification. What SSH is not: Although SSH stands for Secure Shell, it is not a true shell in the sense of the Unix Bourne shell and C shell. It is not a command interpreter, nor does it provide wildcard expansion, command history, and so forth. Rather, SSH creates a channel for running a shell on a remote computer, with end-to-end encryption between the two systems. The major features and guarantees of the SSH protocol are: Privacy of your data, via strong encryption Integrity of communications, guaranteeing they haven\u2019t been altered Authentication, i.e., proof of identity of senders and receivers Authorization, i.e., access control to accounts Forwarding or tunnelling to encrypt other TCP/IP-based sessions Kerberos According to Greek mythology Kerberos (Cerberus) was the gigantic, three-headed dog that guards the gates of the underworld to prevent the dead from leaving. So when it comes to Computer Science, Kerberos is a network authentication protocol and is currently the default authentication technology used by Microsoft Active Directory to authenticate users to services within a local area network. Kerberos uses symmetric-key cryptography and requires a trusted third-party authentication service to verify user identities. So they used the name of Kerberos for their computer network authentication protocol as the three heads of the Kerberos represent: a client: A user/ a service a server: Kerberos protected hosts reside - a Key Distribution Center (KDC), which acts as the trusted third-party authentication service. The KDC includes the following two servers: Authentication Server (AS) that performs the initial authentication and issues ticket-granting tickets (TGT) for users. Ticket-Granting Server (TGS) that issues service tickets that are based on the initial ticket-granting tickets (TGT). Certificate Chain The first part of the output of the OpenSSL command shows three certificates numbered 0, 1, and 2(not 2 anymore). Each certificate has a subject, s, and an issuer, i. The first certificate, number 0, is called the end-entity certificate. The subject line tells us it\u2019s valid for any subdomain of google.com because its subject is set to *.google.com. $ openssl s_client -connect www.google.com:443 -CApath /etc/ssl/certs CONNECTED(00000005) depth=2 OU = GlobalSign Root CA - R2, O = GlobalSign, CN = GlobalSign verify return:1 depth=1 C = US, O = Google Trust Services, CN = GTS CA 1O1 verify return:1 depth=0 C = US, ST = California, L = Mountain View, O = Google LLC, CN = www.google.com verify return:1 --- Certificate chain 0 s:/C=US/ST=California/L=Mountain View/O=Google LLC/CN=www.google.com i:/C=US/O=Google Trust Services/CN=GTS CA 1O1 1 s:/C=US/O=Google Trust Services/CN=GTS CA 1O1 i:/OU=GlobalSign Root CA - R2/O=GlobalSign/CN=GlobalSign --- Server certificate The issuer line indicates it\u2019s issued by Google Internet Authority G2, which also happens to be the subject of the second certificate, number 1 What the OpenSSL command line doesn\u2019t show here is the trust store that contains the list of CA certificates trusted by the system OpenSSL runs on. The public certificate of GlobalSign Authority must be present in the system\u2019s trust store to close the verification chain. This is called a chain of trust, and the figure below summarizes its behaviour at a high level. High-level view of the concept of chain of trust applied to verifying the authenticity of a website. The Root CA in the Firefox trust store provides the initial trust to verify the entire chain and trust the end-entity certificate. TLS Handshake The client sends a HELLO message to the server with a list of protocols and algorithms it supports. The server says HELLO back and sends its chain of certificates. Based on the capabilities of the client, the server picks a cipher suite. If the cipher suite supports ephemeral key exchange, like ECDHE does(ECDHE is an algorithm known as the Elliptic Curve Diffie-Hellman Exchange), the server and the client negotiate a pre-master key with the Diffie-Hellman algorithm. The pre-master key is never sent over the wire. The client and server create a session key that will be used to encrypt the data transiting through the connection. At the end of the handshake, both parties possess a secret session key used to encrypt data for the rest of the connection. This is what OpenSSL refers to as Master-Key NOTE There are 3 versions of TLS , TLS 1.0, 1.1 & 1.2 TLS 1.0 was released in 1999, making it a nearly two-decade-old protocol. It has been known to be vulnerable to attacks\u2014such as BEAST and POODLE\u2014for years, in addition to supporting weak cryptography, which doesn\u2019t keep modern-day connections sufficiently secure. TLS 1.1 is the forgotten \u201cmiddle child.\u201d It also has bad cryptography like its younger sibling. In most software, it was leapfrogged by TLS 1.2 and it\u2019s rare to see TLS 1.1 used. \u201cPerfect\u201d Forward Secrecy The term \u201cephemeral\u201d in the key exchange provides an important security feature mis-named perfect forward secrecy (PFS) or just \u201cForward Secrecy\u201d. In a non-ephemeral key exchange, the client sends the pre-master key to the server by encrypting it with the server\u2019s public key. The server then decrypts the pre-master key with its private key. If at a later point in time, the private key of the server is compromised, an attacker can go back to this handshake, decrypt the pre-master key, obtain the session key, and decrypt the entire traffic. Non-ephemeral key exchanges are vulnerable to attacks that may happen in the future on recorded traffic. And because people seldom change their password, decrypting data from the past may still be valuable for an attacker. An ephemeral key exchange like DHE, or its variant on elliptic curve, ECDHE, solves this problem by not transmitting the pre-master key over the wire. Instead, the pre-master key is computed by both the client and the server in isolation, using nonsensitive information exchanged publicly. Because the pre-master key can\u2019t be decrypted later by an attacker, the session key is safe from future attacks: hence, the term perfect forward secrecy. Keys are changed every X blocks along the stream. That prevents an attacker from simply sniffing the stream and applying brute force to crack the whole thing. \"Forward secrecy\" means that just because I can decrypt block M, does not mean that I can decrypt block Q Downside: The downside to PFS is that all those extra computational steps induce latency on the handshake and slow the user down. To avoid repeating this expensive work at every connection, both sides cache the session key for future use via a technique called session resumption. This is what the session-ID and TLS ticket are for: they allow a client and server that share a session ID to skip over the negotiation of a session key, because they already agreed on one previously, and go directly to exchanging data securely.","title":"Fundamentals of Security"},{"location":"level101/security/fundamentals/#part-i-fundamentals","text":"","title":"Part I: Fundamentals"},{"location":"level101/security/fundamentals/#introduction-to-security-overview-for-sre","text":"If you look closely, both Site Reliability Engineering and Security Engineering are concerned with keeping a system usable. Issues like broken releases, capacity shortages, and misconfigurations can make a system unusable (at least temporarily). Security or privacy incidents that break the trust of users also undermine the usefulness of a system. Consequently, system security should be top of mind for SREs. SREs should be involved in both significant design discussions and actual system changes. They have quite a big role in System design & hence are quite sometimes the first line of defence. SRE\u2019s help in preventing bad design & implementations which can affect the overall security of the infrastructure. Successfully designing, implementing, and maintaining systems requires a commitment to the full system lifecycle . This commitment is possible only when security and reliability are central elements in the architecture of systems. Core Pillars of Information Security : Confidentiality \u2013 only allow access to data for which the user is permitted Integrity \u2013 ensure data is not tampered or altered by unauthorized users Availability \u2013 ensure systems and data are available to authorized users when they need it Thinking like a Security Engineer When starting a new application or re-factoring an existing application, you should consider each functional feature, and consider: Is the process surrounding this feature as safe as possible? In other words, is this a flawed process? If I were evil, how would I abuse this feature? Or more specifically failing to address how a feature can be abused can cause design flaws. Is the feature required to be on by default? If so, are there limits or options that could help reduce the risk from this feature? Security Principles By OWASP (Open Web Application Security Project) Minimize attack surface area : Every feature that is added to an application adds a certain amount of risk to the overall application. The aim of secure development is to reduce the overall risk by reducing the attack surface area. For example, a web application implements online help with a search function. The search function may be vulnerable to SQL injection attacks. If the help feature was limited to authorized users, the attack likelihood is reduced. If the help feature\u2019s search function was gated through centralized data validation routines, the ability to perform SQL injection is dramatically reduced. However, if the help feature was re-written to eliminate the search function (through a better user interface, for example), this almost eliminates the attack surface area, even if the help feature was available to the Internet at large. Establish secure defaults: There are many ways to deliver an \u201cout of the box\u201d experience for users. However, by default, the experience should be secure, and it should be up to the user to reduce their security \u2013 if they are allowed. For example, by default, password ageing and complexity should be enabled. Users might be allowed to turn these two features off to simplify their use of the application and increase their risk. Default Passwords of routers, IoT devices should be changed Principle of Least privilege The principle of least privilege recommends that accounts have the least amount of privilege required to perform their business processes. This encompasses user rights, resource permissions such as CPU limits, memory, network, and file system permissions. For example, if a middleware server only requires access to the network, read access to a database table, and the ability to write to a log, this describes all the permissions that should be granted. Under no circumstances should the middleware be granted administrative privileges. Principle of Defense in depth The principle of defence in depth suggests that where one control would be reasonable, more controls that approach risks in different fashions are better. Controls, when used in depth, can make severe vulnerabilities extraordinarily difficult to exploit and thus unlikely to occur. With secure coding, this may take the form of tier-based validation, centralized auditing controls, and requiring users to be logged on all pages. For example, a flawed administrative interface is unlikely to be vulnerable to an anonymous attack if it correctly gates access to production management networks, checks for administrative user authorization, and logs all access. Fail securely Applications regularly fail to process transactions for many reasons. How they fail can determine if an application is secure or not. ``` is_admin = true; try { code_which_may_faile(); is_admin = is_user_assigned_role(\"Adminstrator\"); } catch (Exception err) { log.error(err.toString()); } ``` - If either codeWhichMayFail() or isUserInRole fails or throws an exception, the user is an admin by default. This is obviously a security risk. Don\u2019t trust services Many organizations utilize the processing capabilities of third-party partners, who more than likely have different security policies and posture than you. It is unlikely that you can influence or control any external third party, whether they are home users or major suppliers or partners. Therefore, the implicit trust of externally run systems is not warranted. All external systems should be treated similarly. For example, a loyalty program provider provides data that is used by Internet Banking, providing the number of reward points and a small list of potential redemption items. However, the data should be checked to ensure that it is safe to display to end-users and that the reward points are a positive number, and not improbably large. Separation of duties The key to fraud control is the separation of duties. For example, someone who requests a computer cannot also sign for it, nor should they directly receive the computer. This prevents the user from requesting many computers and claiming they never arrived. Certain roles have different levels of trust than normal users. In particular, administrators are different from normal users. In general, administrators should not be users of the application. For example, an administrator should be able to turn the system on or off, set password policy but shouldn\u2019t be able to log on to the storefront as a super privileged user, such as being able to \u201cbuy\u201d goods on behalf of other users. Avoid security by obscurity Security through obscurity is a weak security control, and nearly always fails when it is the only control. This is not to say that keeping secrets is a bad idea, it simply means that the security of systems should not be reliant upon keeping details hidden. For example, the security of an application should not rely upon knowledge of the source code being kept secret. The security should rely upon many other factors, including reasonable password policies, defence in depth, business transaction limits, solid network architecture, and fraud, and audit controls. A practical example is Linux. Linux\u2019s source code is widely available, and yet when properly secured, Linux is a secure and robust operating system. Keep security simple Attack surface area and simplicity go hand in hand. Certain software engineering practices prefer overly complex approaches to what would otherwise be a relatively straightforward and simple design. Developers should avoid the use of double negatives and complex architectures when a simpler approach would be faster and simpler. For example, although it might be fashionable to have a slew of singleton entity beans running on a separate middleware server, it is more secure and faster to simply use global variables with an appropriate mutex mechanism to protect against race conditions. Fix security issues correctly Once a security issue has been identified, it is important to develop a test for it and to understand the root cause of the issue. When design patterns are used, the security issue is likely widespread amongst all codebases, so developing the right fix without introducing regressions is essential. For example, a user has found that they can see another user\u2019s balance by adjusting their cookie. The fix seems to be relatively straightforward, but as the cookie handling code is shared among all applications, a change to just one application will trickle through to all other applications. The fix must, therefore, be tested on all affected applications. Reliability & Security Reliability and security are both crucial components of a truly trustworthy system, but building systems that are both reliable and secure is difficult. While the requirements for reliability and security share many common properties, they also require different design considerations. It is easy to miss the subtle interplay between reliability and security that can cause unexpected outcomes Ex: A password management application failure was triggered by a reliability problem i.e poor load-balancing and load-shedding strategies and its recovery were later complicated by multiple measures (HSM mechanism which needs to be plugged into server racks, which works as an authentication & the HSM token supposedly locked inside a case.. & the problem can be further elongated ) designed to increase the security of the system.","title":"Introduction to Security Overview for SRE"},{"location":"level101/security/fundamentals/#authentication-vs-authorization","text":"Authentication is the act of validating that users are who they claim to be. Passwords are the most common authentication factor\u2014if a user enters the correct password, the system assumes the identity is valid and grants access. Other technologies such as One-Time Pins, authentication apps, and even biometrics can also be used to authenticate identity. In some instances, systems require the successful verification of more than one factor before granting access. This multi-factor authentication (MFA) requirement is often deployed to increase security beyond what passwords alone can provide. Authorization in system security is the process of giving the user permission to access a specific resource or function. This term is often used interchangeably with access control or client privilege. Giving someone permission to download a particular file on a server or providing individual users with administrative access to an application are good examples. In secure environments, authorization must always follow authentication, users should first prove that their identities are genuine before an organization\u2019s administrators grant them access to the requested resources.","title":"Authentication vs Authorization"},{"location":"level101/security/fundamentals/#common-authentication-flow-local-authentication","text":"The user registers using an identifier like username/email/mobile The application stores user credentials in the database The application sends a verification email/message to validate the registration Post successful registration, the user enters credentials for logging in On successful authentication, the user is allowed access to specific resources","title":"Common authentication flow (local authentication)"},{"location":"level101/security/fundamentals/#openidoauth","text":"OpenID is an authentication protocol that allows us to authenticate users without using a local auth system. In such a scenario, a user has to be registered with an OpenID Provider and the same provider should be integrated with the authentication flow of your application. To verify the details, we have to forward the authentication requests to the provider. On successful authentication, we receive a success message and/or profile details with which we can execute the necessary flow. OAuth is an authorization mechanism that allows your application user access to a provider(Gmail/Facebook/Instagram/etc). On successful response, we (your application) receive a token with which the application can access certain APIs on behalf of a user. OAuth is convenient in case your business use case requires some certain user-facing APIs like access to Google Drive or sending tweets on your behalf. Most OAuth 2.0 providers can be used for pseudo authentication. Having said that, it can get pretty complicated if you are using multiple OAuth providers to authenticate users on top of the local authentication system.","title":"OpenID/OAuth"},{"location":"level101/security/fundamentals/#cryptography","text":"It is the science and study of hiding any text in such a way that only the intended recipients or authorized persons can read it and that any text can even use things such as invisible ink or the mechanical cryptography machines of the past. Cryptography is necessary for securing critical or proprietary information and is used to encode private data messages by converting some plain text into ciphertext. At its core, there are two ways of doing this, more advanced methods are all built upon.","title":"Cryptography"},{"location":"level101/security/fundamentals/#ciphers","text":"Ciphers are the cornerstone of cryptography. A cipher is a set of algorithms that performs encryption or decryption on a message. An encryption algorithm (E) takes a secret key (k) and a message (m) and produces a ciphertext (c). Similarly, a Decryption algorithm (D) takes a secret key (K) and the previous resulting Ciphertext (C). They are represented as follows: E(k,m) = c D(k,c) = m This also means that for it to be a cipher, it must satisfy the consistency equation as follows, making it possible to decrypt. D(k,E(k,m)) = m Stream Ciphers: The message is broken into characters or bits and enciphered with a key or keystream(should be random and generated independently of the message stream) that is as long as the plaintext bitstream. If the keystream is random, this scheme would be unbreakable unless the keystream was acquired, making it unconditionally secure. The keystream must be provided to both parties in a secure way to prevent its release. Block Ciphers: Block ciphers \u2014 process messages in blocks, each of which is then encrypted or decrypted. A block cipher is a symmetric cipher in which blocks of plaintext are treated as a whole and used to produce ciphertext blocks. The block cipher takes blocks that are b bits long and encrypts them to blocks that are also b bits long. Block sizes are typically 64 or 128 bits long. Encryption Secret Key (Symmetric Key) : the same key is used for encryption and decryption Public Key (Asymmetric Key) in an asymmetric, the encryption and decryption keys are different but related. The encryption key is known as the public key and the decryption key is known as the private key. The public and private keys are known as a key pair. Symmetric Key Encryption DES The Data Encryption Standard (DES) has been the worldwide encryption standard for a long time. IBM developed DES in 1975, and it has held up remarkably well against years of cryptanalysis. DES is a symmetric encryption algorithm with a fixed key length of 56 bits. The algorithm is still good, but because of the short key length, it is susceptible to brute-force attacks that have sufficient resources. DES usually operates in block mode, whereby it encrypts data in 64-bit blocks. The same algorithm and key are used for both encryption and decryption. Because DES is based on simple mathematical functions, it can be easily implemented and accelerated in hardware. Triple DES With advances in computer processing power, the original 56-bit DES key became too short to withstand an attacker with even a limited budget. One way of increasing the effective key length of DES without changing the well-analyzed algorithm itself is to use the same algorithm with different keys several times in a row. The technique of applying DES three times in a row to a plain text block is called Triple DES (3DES). The 3DES technique is shown in Figure. Brute-force attacks on 3DES are considered unfeasible today. Because the basic algorithm has been tested in the field for more than 25 years, it is considered to be more trustworthy than its predecessor. AES On October 2, 2000, The U.S. National Institute of Standards and Technology (NIST) announced the selection of the Rijndael cipher as the AES algorithm. This cipher, developed by Joan Daemen and Vincent Rijmen, has a variable block length and key length. The algorithm currently specifies how to use keys with a length of 128, 192, or 256 bits to encrypt blocks with a length of 128, 192, or 256 bits (all nine combinations of key length and block length are possible). Both block and key lengths can be extended easily to multiples of 32 bits. AES was chosen to replace DES and 3DES because they are either too weak (DES, in terms of key length) or too slow (3DES) to run on modern, efficient hardware. AES is more efficient and much faster, usually by a factor of 5 compared to DES on the same hardware. AES is also more suitable for high throughput, especially if pure software encryption is used. However, AES is a relatively young algorithm, and as the golden rule of cryptography states, \u201cA more mature algorithm is always more trusted.\u201d Asymmetric Key Algorithm In a symmetric key system, Alice first puts the secret message in a box and then padlocks the box using a lock to which she has a key. She then sends the box to Bob through regular mail. When Bob receives the box, he uses an identical copy of Alice's key (which he has obtained previously) to open the box and read the message. In an asymmetric key system, instead of opening the box when he receives it, Bob simply adds his own personal lock to the box and returns the box through public mail to Alice. Alice uses her key to remove her lock and returns the box to Bob, with Bob's lock still in place. Finally, Bob uses his key to remove his lock and reads the message from Alice. The critical advantage in an asymmetric system is that Alice never needs to send a copy of her key to Bob. This reduces the possibility that a third party (for example, an unscrupulous postmaster) can copy the key while it is in transit to Bob, allowing that third party to spy on all future messages sent by Alice. In addition, if Bob is careless and allows someone else to copy his key, Alice's messages to Bob are compromised, but Alice's messages to other people remain secret NOTE : In terms of TLS key exchange, this is the common approach. Diffie-Hellman The protocol has two system parameters, p and g. They are both public and may be used by everybody. Parameter p is a prime number, and parameter g (usually called a generator) is an integer that is smaller than p, but with the following property: For every number n between 1 and p \u2013 1 inclusive, there is a power k of g such that n = gk mod p. Diffie Hellman algorithm is an asymmetric algorithm used to establish a shared secret for a symmetric key algorithm. Nowadays most of the people use hybrid cryptosystem i.e, a combination of symmetric and asymmetric encryption. Asymmetric Encryption is used as a technique in key exchange mechanism to share a secret key and after the key is shared between sender and receiver, the communication will take place using symmetric encryption. The shared secret key will be used to encrypt the communication. Refer: https://medium.com/@akhigbemmanuel/what-is-the-diffie-hellman-key-exchange-algorithm-84d60025a30d RSA The RSA algorithm is very flexible and has a variable key length where, if necessary, speed can be traded for the level of security of the algorithm. The RSA keys are usually 512 to 2048 bits long. RSA has withstood years of extensive cryptanalysis. Although those years neither proved nor disproved RSA's security, they attest to a confidence level in the algorithm. RSA security is based on the difficulty of factoring very large numbers. If an easy method of factoring these large numbers were discovered, the effectiveness of RSA would be destroyed. Refer: https://medium.com/curiositypapers/a-complete-explanation-of-rsa-asymmetric-encryption-742c5971e0f NOTE : RSA Keys can be used for key exchange just like Diffie Hellman Hashing Algorithms Hashing is one of the mechanisms used for data integrity assurance. Hashing is based on a one-way mathematical function, which is relatively easy to compute but significantly harder to reverse. A hash function, which is a one-way function to input data to produce a fixed-length digest (fingerprint) of output data. The digest is cryptographically strong; that is, it is impossible to recover input data from its digest. If the input data changes just a little, the digest (fingerprint) changes substantially in what is called an avalanche effect. More: https://medium.com/@rauljordan/the-state-of-hashing-algorithms-the-why-the-how-and-the-future-b21d5c0440de https://medium.com/@StevieCEllis/the-beautiful-hash-algorithm-f18d9d2b84fb MD5 MD5 is a one-way function with which it is easy to compute the hash from the given input data, but it is unfeasible to compute input data given only a hash. SHA-1 MD5 is considered less secure than SHA-1 because MD5 has some weaknesses. HA-1 also uses a stronger, 160-bit digest, which makes MD5 the second choice as hash methods are concerned. The algorithm takes a message of less than 264 bits in length and produces a 160-bit message digest. This algorithm is slightly slower than MD5. NOTE : SHA-1 is also recently demonstrated to be broken, Minimum current recommendation is SHA-256 Digital Certificates Digital signatures, provide a means to digitally authenticate devices and individual users. In public-key cryptography, such as the RSA encryption system, each user has a key-pair containing both a public key and a private key. The keys act as complements, and anything encrypted with one of the keys can be decrypted with the other. In simple terms, a signature is formed when data is encrypted with a user's private key. The receiver verifies the signature by decrypting the message with the sender's public key. Key management is often considered the most difficult task in designing and implementing cryptographic systems. Businesses can simplify some of the deployment and management issues that are encountered with secured data communications by employing a Public Key Infrastructure (PKI). Because corporations often move security-sensitive communications across the Internet, an effective mechanism must be implemented to protect sensitive information from the threats presented on the Internet. PKI provides a hierarchical framework for managing digital security attributes. Each PKI participant holds a digital certificate that has been issued by a CA (either public or private). The certificate contains several attributes that are used when parties negotiate a secure connection. These attributes must include the certificate validity period, end-host identity information, encryption keys that will be used for secure communications, and the signature of the issuing CA. Optional attributes may be included, depending on the requirements and capability of the PKI. A CA can be a trusted third party, such as VeriSign or Entrust, or a private (in-house) CA that you establish within your organization. The fact that the message could be decrypted using the sender's public key means that the holder of the private key created the message. This process relies on the receiver having a copy of the sender's public key and knowing with a high degree of certainty that it really does belong to the sender and not to someone pretending to be the sender. To validate the CA's signature, the receiver must know the CA's public key. Normally, this is handled out-of-band or through an operation performed during the installation of the certificate. For instance, most web browsers are configured with the root certificates of several CAs by default. CA Enrollment process The end host generates a private-public key pair. The end host generates a certificate request, which it forwards to the CA. Manual human intervention is required to approve the enrollment request, which is received by the CA. After the CA operator approves the request, the CA signs the certificate request with its private key and returns the completed certificate to the end host. The end host writes the certificate into a nonvolatile storage area (PC hard disk or NVRAM on Cisco routers). Refer : https://www.ssh.com/manuals/server-zos-product/55/ch06s03s01.html","title":"Ciphers"},{"location":"level101/security/fundamentals/#login-security","text":"","title":"Login Security"},{"location":"level101/security/fundamentals/#ssh","text":"SSH, the Secure Shell, is a popular, powerful, software-based approach to network security. Whenever data is sent by a computer to the network, SSH automatically encrypts (scrambles) it. Then, when the data reaches its intended recipient, SSH automatically decrypts (unscrambles) it. The result is transparent encryption: users can work normally, unaware that their communications are safely encrypted on the network. In addition, SSH can use modern, secure encryption algorithms based on how it's being configured and is effective enough to be found within mission-critical applications at major corporations. SSH has a client/server architecture An SSH server program, typically installed and run by a system administrator, accepts or rejects incoming connections to its host computer. Users then run SSH client programs, typically on other computers, to make requests of the SSH server, such as \u201cPlease log me in,\u201d \u201cPlease send me a file,\u201d or \u201cPlease execute this command.\u201d All communications between clients and servers are securely encrypted and protected from modification. What SSH is not: Although SSH stands for Secure Shell, it is not a true shell in the sense of the Unix Bourne shell and C shell. It is not a command interpreter, nor does it provide wildcard expansion, command history, and so forth. Rather, SSH creates a channel for running a shell on a remote computer, with end-to-end encryption between the two systems. The major features and guarantees of the SSH protocol are: Privacy of your data, via strong encryption Integrity of communications, guaranteeing they haven\u2019t been altered Authentication, i.e., proof of identity of senders and receivers Authorization, i.e., access control to accounts Forwarding or tunnelling to encrypt other TCP/IP-based sessions","title":"SSH"},{"location":"level101/security/fundamentals/#kerberos","text":"According to Greek mythology Kerberos (Cerberus) was the gigantic, three-headed dog that guards the gates of the underworld to prevent the dead from leaving. So when it comes to Computer Science, Kerberos is a network authentication protocol and is currently the default authentication technology used by Microsoft Active Directory to authenticate users to services within a local area network. Kerberos uses symmetric-key cryptography and requires a trusted third-party authentication service to verify user identities. So they used the name of Kerberos for their computer network authentication protocol as the three heads of the Kerberos represent: a client: A user/ a service a server: Kerberos protected hosts reside - a Key Distribution Center (KDC), which acts as the trusted third-party authentication service. The KDC includes the following two servers: Authentication Server (AS) that performs the initial authentication and issues ticket-granting tickets (TGT) for users. Ticket-Granting Server (TGS) that issues service tickets that are based on the initial ticket-granting tickets (TGT).","title":"Kerberos"},{"location":"level101/security/fundamentals/#certificate-chain","text":"The first part of the output of the OpenSSL command shows three certificates numbered 0, 1, and 2(not 2 anymore). Each certificate has a subject, s, and an issuer, i. The first certificate, number 0, is called the end-entity certificate. The subject line tells us it\u2019s valid for any subdomain of google.com because its subject is set to *.google.com. $ openssl s_client -connect www.google.com:443 -CApath /etc/ssl/certs CONNECTED(00000005) depth=2 OU = GlobalSign Root CA - R2, O = GlobalSign, CN = GlobalSign verify return:1 depth=1 C = US, O = Google Trust Services, CN = GTS CA 1O1 verify return:1 depth=0 C = US, ST = California, L = Mountain View, O = Google LLC, CN = www.google.com verify return:1 --- Certificate chain 0 s:/C=US/ST=California/L=Mountain View/O=Google LLC/CN=www.google.com i:/C=US/O=Google Trust Services/CN=GTS CA 1O1 1 s:/C=US/O=Google Trust Services/CN=GTS CA 1O1 i:/OU=GlobalSign Root CA - R2/O=GlobalSign/CN=GlobalSign --- Server certificate The issuer line indicates it\u2019s issued by Google Internet Authority G2, which also happens to be the subject of the second certificate, number 1 What the OpenSSL command line doesn\u2019t show here is the trust store that contains the list of CA certificates trusted by the system OpenSSL runs on. The public certificate of GlobalSign Authority must be present in the system\u2019s trust store to close the verification chain. This is called a chain of trust, and the figure below summarizes its behaviour at a high level. High-level view of the concept of chain of trust applied to verifying the authenticity of a website. The Root CA in the Firefox trust store provides the initial trust to verify the entire chain and trust the end-entity certificate.","title":"Certificate Chain"},{"location":"level101/security/fundamentals/#tls-handshake","text":"The client sends a HELLO message to the server with a list of protocols and algorithms it supports. The server says HELLO back and sends its chain of certificates. Based on the capabilities of the client, the server picks a cipher suite. If the cipher suite supports ephemeral key exchange, like ECDHE does(ECDHE is an algorithm known as the Elliptic Curve Diffie-Hellman Exchange), the server and the client negotiate a pre-master key with the Diffie-Hellman algorithm. The pre-master key is never sent over the wire. The client and server create a session key that will be used to encrypt the data transiting through the connection. At the end of the handshake, both parties possess a secret session key used to encrypt data for the rest of the connection. This is what OpenSSL refers to as Master-Key NOTE There are 3 versions of TLS , TLS 1.0, 1.1 & 1.2 TLS 1.0 was released in 1999, making it a nearly two-decade-old protocol. It has been known to be vulnerable to attacks\u2014such as BEAST and POODLE\u2014for years, in addition to supporting weak cryptography, which doesn\u2019t keep modern-day connections sufficiently secure. TLS 1.1 is the forgotten \u201cmiddle child.\u201d It also has bad cryptography like its younger sibling. In most software, it was leapfrogged by TLS 1.2 and it\u2019s rare to see TLS 1.1 used.","title":"TLS Handshake"},{"location":"level101/security/fundamentals/#perfect-forward-secrecy","text":"The term \u201cephemeral\u201d in the key exchange provides an important security feature mis-named perfect forward secrecy (PFS) or just \u201cForward Secrecy\u201d. In a non-ephemeral key exchange, the client sends the pre-master key to the server by encrypting it with the server\u2019s public key. The server then decrypts the pre-master key with its private key. If at a later point in time, the private key of the server is compromised, an attacker can go back to this handshake, decrypt the pre-master key, obtain the session key, and decrypt the entire traffic. Non-ephemeral key exchanges are vulnerable to attacks that may happen in the future on recorded traffic. And because people seldom change their password, decrypting data from the past may still be valuable for an attacker. An ephemeral key exchange like DHE, or its variant on elliptic curve, ECDHE, solves this problem by not transmitting the pre-master key over the wire. Instead, the pre-master key is computed by both the client and the server in isolation, using nonsensitive information exchanged publicly. Because the pre-master key can\u2019t be decrypted later by an attacker, the session key is safe from future attacks: hence, the term perfect forward secrecy. Keys are changed every X blocks along the stream. That prevents an attacker from simply sniffing the stream and applying brute force to crack the whole thing. \"Forward secrecy\" means that just because I can decrypt block M, does not mean that I can decrypt block Q Downside: The downside to PFS is that all those extra computational steps induce latency on the handshake and slow the user down. To avoid repeating this expensive work at every connection, both sides cache the session key for future use via a technique called session resumption. This is what the session-ID and TLS ticket are for: they allow a client and server that share a session ID to skip over the negotiation of a session key, because they already agreed on one previously, and go directly to exchanging data securely.","title":"\u201cPerfect\u201d Forward Secrecy"},{"location":"level101/security/intro/","text":"Security Prerequisites Linux Basics Linux Networking What to expect from this course The course covers fundamentals of information security along with touching on subjects of system security, network & web security. This course aims to get you familiar with the basics of information security in day to day operations & then as an SRE develop the mindset of ensuring that security takes a front-seat while developing solutions. The course also serves as an introduction to common risks and best practices along with practical ways to find out vulnerable systems and loopholes which might become compromised if not secured. What is not covered under this course The courseware is not an ethical hacking workshop or a very deep dive into the fundamentals of the problems. The course does not deal with hacking or breaking into systems but rather an approach on how to ensure you don\u2019t get into those situations and also to make you aware of different ways a system can be compromised. Course Contents Fundamentals Network Security Threats, Attacks & Defence Writing Secure Code & More Conclusion","title":"Introduction"},{"location":"level101/security/intro/#security","text":"","title":"Security"},{"location":"level101/security/intro/#prerequisites","text":"Linux Basics Linux Networking","title":"Prerequisites"},{"location":"level101/security/intro/#what-to-expect-from-this-course","text":"The course covers fundamentals of information security along with touching on subjects of system security, network & web security. This course aims to get you familiar with the basics of information security in day to day operations & then as an SRE develop the mindset of ensuring that security takes a front-seat while developing solutions. The course also serves as an introduction to common risks and best practices along with practical ways to find out vulnerable systems and loopholes which might become compromised if not secured.","title":"What to expect from this course"},{"location":"level101/security/intro/#what-is-not-covered-under-this-course","text":"The courseware is not an ethical hacking workshop or a very deep dive into the fundamentals of the problems. The course does not deal with hacking or breaking into systems but rather an approach on how to ensure you don\u2019t get into those situations and also to make you aware of different ways a system can be compromised.","title":"What is not covered under this course"},{"location":"level101/security/intro/#course-contents","text":"Fundamentals Network Security Threats, Attacks & Defence Writing Secure Code & More Conclusion","title":"Course Contents"},{"location":"level101/security/network_security/","text":"Part II: Network Security Introduction TCP/IP is the dominant networking technology today. It is a five-layer architecture. These layers are, from top to bottom, the application layer, the transport layer (TCP), the network layer (IP), the data-link layer, and the physical layer. In addition to TCP/IP, there also are other networking technologies. For convenience, we use the OSI network model to represent non-TCP/IP network technologies. Different networks are interconnected using gateways. A gateway can be placed at any layer. The OSI model is a seven-layer architecture. The OSI architecture is similar to the TCP/IP architecture, except that the OSI model specifies two additional layers between the application layer and the transport layer in the TCP/IP architecture. These two layers are the presentation layer and the session layer. Figure 5.1 shows the relationship between the TCP/IP layers and the OSI layers. The application layer in TCP/IP corresponds to the application layer and the presentation layer in OSI. The transport layer in TCP/IP corresponds to the session layer and the transport layer in OSI. The remaining three layers in the TCP/IP architecture are one-to-one correspondent to the remaining three layers in the OSI model. Correspondence between layers of the TCP/IP architecture and the OSI model. Also shown are placements of cryptographic algorithms in network layers, where the dotted arrows indicate actual communications of cryptographic algorithms The functionalities of OSI layers are briefly described as follows: The application layer serves as an interface between applications and network programs. It supports application programs and end-user processing. Common application-layer programs include remote logins, file transfer, email, and Web browsing. The presentation layer is responsible for dealing with data that is formed differently. This protocol layer allows application-layer programs residing on different sides of a communication channel with different platforms to understand each other's data formats regardless of how they are presented. The session layer is responsible for creating, managing, and closing a communication connection. The transport layer is responsible for providing reliable connections, such as packet sequencing, traffic control, and congestion control. The network layer is responsible for routing device-independent data packets from the current hop to the next hop. The data-link layer is responsible for encapsulating device-independent data packets into device-dependent data frames. It has two sublayers: logical link control and media access control. The physical layer is responsible for transmitting device-dependent frames through some physical media. Starting from the application layer, data generated from an application program is passed down layer-by-layer to the physical layer. Data from the previous layer is enclosed in a new envelope at the current layer, where the data from the previous layer is also just an envelope containing the data from the layer before it. This is similar to enclosing a smaller envelope in a larger one. The envelope added at each layer contains sufficient information for handling the packet. Application-layer data are divided into blocks small enough to be encapsulated in an envelope at the next layer. Application data blocks are \u201cdressed up\u201d in the TCP/IP architecture according to the following basic steps. At the sending side, an application data block is encapsulated in a TCP packet when it is passed down to the TCP layer. In other words, a TCP packet consists of a header and a payload, where the header corresponds to the TCP envelope and the payload is the application data block. Likewise, the TCP packet will be encapsulated in an IP packet when it is passed down to the IP layer. An IP packet consists of a header and a payload, which is the TCP packet passed down from the TCP layer. The IP packet will be encapsulated in a device-dependent frame (e.g., an Ethernet frame) when it is passed down to the data-link layer. A frame has a header, and it may also have a trailer. For example, in addition to having a header, an Ethernet frame also has a 32-bit cyclic redundancy check (CRC) trailer. When it is passed down to the physical layer, a frame will be transformed into a sequence of media signals for transmission Flow Diagram of a Packet Generation At the destination side, the medium signals are converted by the physical layer into a frame, which is passed up to the data-link layer. The data-link layer passes the frame payload (i.e., the IP packet encapsulated in the frame) up to the IP layer. The IP layer passes the IP payload, namely, the TCP packet encapsulated in the IP packet, up to the TCP layer. The TCP layer passes the TCP payload, namely, the application data block, up to the application layer. When a packet arrives at a router, it only goes up to the IP layer, where certain fields in the IP header are modified (e.g., the value of TTL is decreased by 1). This modified packet is then passed back down layer-by-layer to the physical layer for further transmission. Public Key Infrastructure To deploy cryptographic algorithms in network applications, we need a way to distribute secret keys using open networks. Public-key cryptography is the best way to distribute these secret keys. To use public-key cryptography, we need to build a public-key infrastructure (PKI) to support and manage public-key certificates and certificate authority (CA) networks. In particular, PKIs are set up to perform the following functions: Determine the legitimacy of users before issuing public-key certificates to them. Issue public-key certificates upon user requests. Extend public-key certificates valid time upon user requests. Revoke public-key certificates upon users' requests or when the corresponding private keys are compromised. Store and manage public-key certificates. Prevent digital signature signers from denying their signatures. Support CA networks to allow different CAs to authenticate public-key certificates issued by other CAs. X.509: https://certificatedecoder.dev/?gclid=EAIaIQobChMI0M731O6G6gIVVSQrCh04bQaAEAAYASAAEgKRkPD_BwE IPsec: A Security Protocol at the Network Layer IPsec is a major security protocol at the network layer IPsec provides a potent platform for constructing virtual private networks (VPN). VPNs are private networks overlayed on public networks. The purpose of deploying cryptographic algorithms at the network layer is to encrypt or authenticate IP packets (either just the payloads or the whole packets). IPsec also specifies how to exchange keys. Thus, IPsec consists of authentication protocols, encryption protocols, and key exchange protocols. They are referred to, respectively, as authentication header (AH), encapsulating security payload (ESP), and Internet key exchange (IKE). PGP & S/MIME : Email Security There are several security protocols at the application layer. The most used of these protocols are email security protocols namely PGP and S/MIME. SMTP (\u201cSimple Mail Transfer Protocol\u201d) is used for sending and delivering from a client to a server via port 25: it\u2019s the outgoing server. On the contrary, POP (\u201cPost Office Protocol\u201d) allows the users to pick up the message and download it into their inbox: it\u2019s the incoming server. The latest version of the Post Office Protocol is named POP3, and it\u2019s been used since 1996; it uses port 110 PGP PGP implements all major cryptographic algorithms, the ZIP compression algorithm, and the Base64 encoding algorithm. It can be used to authenticate a message, encrypt a message, or both. PGP follows the following general process: authentication, ZIP compression, encryption, and Base64 encoding. The Base64 encoding procedure makes the message ready for SMTP transmission GPG (GnuPG) GnuPG is another free encryption standard that companies may use that is based on OpenPGP. GnuPG serves as a replacement for Symantec\u2019s PGP. The main difference is the supported algorithms. However, GnuPG plays nice with PGP by design. Because GnuPG is open, some businesses would prefer the technical support and the user interface that comes with Symantec\u2019s PGP. It is important to note that there are some nuances between the compatibility of GnuPG and PGP, such as the compatibility between certain algorithms, but in most applications such as email, there are workarounds. One such algorithm is the IDEA Module which isn\u2019t included in GnuPG out of the box due to patent issues. S/MIME SMTP can only handle 7-bit ASCII text (You can use UTF-8 extensions to alleviate these limitations, ) messages. While POP can handle other content types besides 7-bit ASCII, POP may, under a common default setting, download all the messages stored in the mail server to the user's local computer. After that, if POP removes these messages from the mail server. This makes it difficult for the users to read their messages from multiple computers. The Multipurpose Internet Mail Extension protocol (MIME) was designed to support sending and receiving email messages in various formats, including nontext files generated by word processors, graphics files, sound files, and video clips. Moreover, MIME allows a single message to include mixed types of data in any combination of these formats. The Internet Mail Access Protocol (IMAP), operated on TCP port 143(only for non-encrypted), stores (Configurable on both server & client just like PoP) incoming email messages in the mail server until the user deletes them deliberately. This allows the users to access their mailbox from multiple machines and download messages to a local machine without deleting it from the mailbox in the mail server. SSL/TLS SSL uses a PKI to decide if a server\u2019s public key is trustworthy by requiring servers to use a security certificate signed by a trusted CA. When Netscape Navigator 1.0 was released, it trusted a single CA operated by the RSA Data Security corporation. The server\u2019s public RSA keys were used to be stored in the security certificate, which can then be used by the browser to establish a secure communication channel. The security certificates we use today still rely on the same standard (named X.509) that Netscape Navigator 1.0 used back then. Netscape intended to train users(though this didn\u2019t work out later) to differentiate secure communications from insecure ones, so they put a lock icon next to the address bar. When the lock is open, the communication is insecure. A closed lock means communication has been secured with SSL, which required the server to provide a signed certificate. You\u2019re obviously familiar with this icon as it\u2019s been in every browser ever since. The engineers at Netscape truly created a standard for secure internet communications. A year after releasing SSL 2.0, Netscape fixed several security issues and released SSL 3.0, a protocol that, albeit being officially deprecated since June 2015, remains in use in certain parts of the world more than 20 years after its introduction. To standardize SSL, the Internet Engineering Task Force (IETF) created a slightly modified SSL 3.0 and, in 1999, unveiled it as Transport Layer Security (TLS) 1.0. The name change between SSL and TLS continues to confuse people today. Officially, TLS is the new SSL, but in practice, people use SSL and TLS interchangeably to talk about any version of the protocol. Must See: https://tls.ulfheim.net/ https://davidwong.fr/tls13/ Network Perimeter Security Let us see how we keep a check on the perimeter i.e the edges, the first layer of protection General Firewall Framework Firewalls are needed because encryption algorithms cannot effectively stop malicious packets from getting into an edge network. This is because IP packets, regardless of whether they are encrypted, can always be forwarded into an edge network. Firewalls that were developed in the 1990s are important instruments to help restrict network access. A firewall may be a hardware device, a software package, or a combination of both. Packets flowing into the internal network from the outside should be evaluated before they are allowed to enter. One of the critical elements of a firewall is its ability to examine packets without imposing a negative impact on communication speed while providing security protections for the internal network. The packet inspection that is carried out by firewalls can be done using several different methods. Based on the particular method used by the firewall, it can be characterized as either a packet filter, circuit gateway, application gateway, or dynamic packet filter. Packet Filters It inspects ingress packets coming to an internal network from outside and inspects egress packets going outside from an internal network Packing filtering only inspects IP headers and TCP headers, not the payloads generated at the application layer A packet-filtering firewall uses a set of rules to determine whether a packet should be allowed or denied to pass through. 2 types: Stateless It treats each packet as an independent object, and it does not keep track of any previously processed packets. In other words, stateless filtering inspects a packet when it arrives and makes a decision without leaving any record of the packet being inspected. Stateful Stateful filtering, also referred to as connection-state filtering, keeps track of connections between an internal host and an external host. A connection state (or state, for short) indicates whether it is a TCP connection or a UDP connection and whether the connection is established. Circuit Gateways Circuit gateways, also referred to as circuit-level gateways, are typically operated at the transportation layer They evaluate the information of the IP addresses and the port numbers contained in TCP (or UDP) headers and use it to determine whether to allow or to disallow an internal host and an external host to establish a connection. It is common practice to combine packet filters and circuit gateways to form a dynamic packet filter (DPF). Application Gateways(ALG) Aka PROXY Servers An Application Level Gateway (ALG) acts as a proxy for internal hosts, processing service requests from external clients. An ALG performs deep inspections on each IP packet (ingress or egress). In particular, an ALG inspects application program formats contained in the packet (e.g., MIME format or SQL format) and examines whether its payload is permitted. Thus, an ALG may be able to detect a computer virus contained in the payload. Because an ALG inspects packet payloads, it may be able to detect malicious code and quarantine suspicious packets, in addition to blocking packets with suspicious IP addresses and TCP ports. On the other hand, an ALG also incurs substantial computation and space overheads. Trusted Systems & Bastion Hosts A Trusted Operating System (TOS) is an operating system that meets a particular set of security requirements. Whether an operating system can be trusted or not depends on several elements. For example, for an operating system on a particular computer to be certified trusted, one needs to validate that, among other things, the following four requirements are satisfied: Its system design contains no defects; Its system software contains no loopholes; Its system is configured properly; and Its system management is appropriate. Bastion Hosts Bastion hosts are computers with strong defence mechanisms. They often serve as host computers for implementing application gateways, circuit gateways, and other types of firewalls. A bastion host is operated on a trusted operating system that must not contain unnecessary functionalities or programs. This measure helps to reduce error probabilities and makes it easier to conduct security checks. Only those network application programs that are necessary, for example, SSH, DNS, SMTP, and authentication programs, are installed on a bastion host. Bastion hosts are also primarily used as controlled ingress points so that the security monitoring can focus more narrowly on actions happening at a single point closely. Common Techniques & Scannings, Packet Capturing Scanning Ports with Nmap Nmap (\"Network Mapper\") is a free and open-source (license) utility for network discovery and security auditing. Many systems and network administrators also find it useful for tasks such as network inventory, managing service upgrade schedules, and monitoring host or service uptime. The best thing about Nmap is it\u2019s free and open-source and is very flexible and versatile Nmap is often used to determine alive hosts in a network, open ports on those hosts, services running on those open ports, and version identification of that service on that port. More at http://scanme.nmap.org/ nmap [scan type] [options] [target specification] Nmap uses 6 different port states: Open \u2014 An open port is one that is actively accepting TCP, UDP or SCTP connections. Open ports are what interests us the most because they are the ones that are vulnerable to attacks. Open ports also show the available services on a network. Closed \u2014 A port that receives and responds to Nmap probe packets but there is no application listening on that port. Useful for identifying that the host exists and for OS detection. Filtered \u2014 Nmap can\u2019t determine whether the port is open because packet filtering prevents its probes from reaching the port. Filtering could come from firewalls or router rules. Often little information is given from filtered ports during scans as the filters can drop the probes without responding or respond with useless error messages e.g. destination unreachable. Unfiltered \u2014 Port is accessible but Nmap doesn\u2019t know if it is open or closed. Only used in ACK scan which is used to map firewall rulesets. Other scan types can be used to identify whether the port is open. Open/filtered \u2014 Nmap is unable to determine between open and filtered. This happens when an open port gives no response. No response could mean that the probe was dropped by a packet filter or any response is blocked. Closed/filtered \u2014 Nmap is unable to determine whether a port is closed or filtered. Only used in the IP ID idle scan. Types of Nmap Scan: TCP Connect TCP Connect scan completes the 3-way handshake. If a port is open, the operating system completes the TCP three-way handshake and the port scanner immediately closes the connection to avoid DOS. This is \u201cnoisy\u201d because the services can log the sender IP address and might trigger Intrusion Detection Systems. UDP Scan This scan checks to see if any UDP ports are listening. Since UDP does not respond with a positive acknowledgement like TCP and only responds to an incoming UDP packet when the port is closed, SYN Scan SYN scan is another form of TCP scanning. This scan type is also known as \u201chalf-open scanning\u201d because it never actually opens a full TCP connection. The port scanner generates a SYN packet. If the target port is open, it will respond with an SYN-ACK packet. The scanner host responds with an RST packet, closing the connection before the handshake is completed. If the port is closed but unfiltered, the target will instantly respond with an RST packet. SYN scan has the advantage that the individual services never actually receive a connection. FIN Scan This is a stealthy scan, like the SYN scan, but sends a TCP FIN packet instead. ACK Scan Ack scanning determines whether the port is filtered or not. Null Scan Another very stealthy scan that sets all the TCP header flags to off or null. This is not normally a valid packet and some hosts will not know what to do with this. XMAS Scan Similar to the NULL scan except for all the flags in the TCP header is set to on RPC Scan This special type of scan looks for machine answering to RPC (Remote Procedure Call) services IDLE Scan It is a super stealthy method whereby the scan packets are bounced off an external host. You don\u2019t need to have control over the other host but it does have to set up and meet certain requirements. You must input the IP address of our \u201czombie\u201d host and what port number to use. It is one of the more controversial options in Nmap since it only has a use for malicious attacks. Scan Techniques A couple of scan techniques which can be used to gain more information about a system and its ports. You can read more at https://medium.com/infosec-adventures/nmap-cheatsheet-a423fcdda0ca OpenVAS OpenVAS is a full-featured vulnerability scanner. OpenVAS is a framework of services and tools that provides a comprehensive and powerful vulnerability scanning and management package OpenVAS, which is an open-source program, began as a fork of the once-more-popular scanning program, Nessus. OpenVAS is made up of three main parts. These are: a regularly updated feed of Network Vulnerability Tests (NVTs); a scanner, which runs the NVTs; and an SQLite 3 database for storing both your test configurations and the NVTs\u2019 results and configurations. https://www.greenbone.net/en/install_use_gce/ WireShark Wireshark is a protocol analyzer. This means Wireshark is designed to decode not only packet bits and bytes but also the relations between packets and protocols. Wireshark understands protocol sequences. A simple demo of Wireshark Capture only udp packets: Capture filter = \u201cudp\u201d Capture only tcp packets Capture filter = \u201ctcp\u201d TCP/IP 3 way Handshake Filter by IP address: displays all traffic from IP, be it source or destination ip.addr == 192.168.1.1 Filter by source address: display traffic only from IP source ip.src == 192.168.0.1 Filter by destination: display traffic only form IP destination ip.dst == 192.168.0.1 Filter by IP subnet: display traffic from subnet, be it source or destination ip.addr = 192.168.0.1/24 Filter by protocol: filter traffic by protocol name dns http ftp arp ssh telnet icmp Exclude IP address: remove traffic from and to IP address !ip.addr ==192.168.0.1 Display traffic between two specific subnet ip.addr == 192.168.0.1/24 and ip.addr == 192.168.1.1/24 Display traffic between two specific workstations ip.addr == 192.168.0.1 and ip.addr == 192.168.0.2 Filter by MAC eth.addr = 00:50:7f:c5:b6:78 Filter TCP port tcp.port == 80 Filter TCP port source tcp.srcport == 80 Filter TCP port destination tcp.dstport == 80 Find user agents http.user_agent contains Firefox !http.user_agent contains || !http.user_agent contains Chrome Filter broadcast traffic !(arp or icmp or dns) Filter IP address and port tcp.port == 80 && ip.addr == 192.168.0.1 Filter all http get requests http.request Filter all http get requests and responses http.request or http.response Filter three way handshake tcp.flags.syn==1 or (tcp.seq==1 and tcp.ack==1 and tcp.len==0 and tcp.analysis.initial_rtt) Find files by type frame contains \u201c(attachment|tar|exe|zip|pdf)\u201d Find traffic based on keyword tcp contains facebook frame contains facebook Detecting SYN Floods tcp.flags.syn == 1 and tcp.flags.ack == 0 Wireshark Promiscuous Mode - By default, Wireshark only captures packets going to and from the computer where it runs. By checking the box to run Wireshark in Promiscuous Mode in the Capture Settings, you can capture most of the traffic on the LAN. DumpCap Dumpcap is a network traffic dump tool. It captures packet data from a live network and writes the packets to a file. Dumpcap\u2019s native capture file format is pcapng, which is also the format used by Wireshark. By default, Dumpcap uses the pcap library to capture traffic from the first available network interface and writes the received raw packet data, along with the packets\u2019 time stamps into a pcapng file. The capture filter syntax follows the rules of the pcap library. The Wireshark command-line utility called 'dumpcap.exe' can be used to capture LAN traffic over an extended period of time. Wireshark itself can also be used, but dumpcap does not significantly utilize the computer's memory while capturing for long periods. DaemonLogger Daemonlogger is a packet logging application designed specifically for use in Network and Systems Management (NSM) environments. The biggest benefit Daemonlogger provides is that, like Dumpcap, it is simple to use for capturing packets. In order to begin capturing, you need only to invoke the command and specify an interface. daemonlogger \u2013i eth1 This option, by default, will begin capturing packets and logging them to the current working directory. Packets will be collected until the capture file size reaches 2 GB, and then a new file will be created. This will continue indefinitely until the process is halted. NetSniff-NG Netsniff-NG is a high-performance packet capture utility While the utilities we\u2019ve discussed to this point rely on Libpcap for capture, Netsniff-NG utilizes zero-copy mechanisms to capture packets. This is done with the intent to support full packet capture over high throughput links. To begin capturing packets with Netsniff-NG, we have to specify an input and output. In most cases, the input will be a network interface, and the output will be a file or folder on disk. netsniff-ng \u2013i eth1 \u2013o data.pcap Netflow NetFlow is a feature that was introduced on Cisco routers around 1996 that provides the ability to collect IP network traffic as it enters or exits an interface. By analyzing the data provided by NetFlow, a network administrator can determine things such as the source and destination of traffic, class of service, and the causes of congestion. A typical flow monitoring setup (using NetFlow) consists of three main components:[1] Flow exporter: aggregates packets into flows and exports flow records towards one or more flow collectors. Flow collector: responsible for reception, storage and pre-processing of flow data received from a flow exporter. Analysis application: analyzes received flow data in the context of intrusion detection or traffic profiling, for example. Routers and switches that support NetFlow can collect IP traffic statistics on all interfaces where NetFlow is enabled, and later export those statistics as NetFlow records toward at least one NetFlow collector\u2014typically a server that does the actual traffic analysis. IDS A security solution that detects security-related events in your environment but does not block them. IDS sensors can be software and hardware-based used to collect and analyze the network traffic. These sensors are available in two varieties, network IDS and host IDS. A host IDS is a server-specific agent running on a server with a minimum of overhead to monitor the operating system. A network IDS can be embedded in a networking device, a standalone appliance, or a module monitoring the network traffic. Signature Based IDS The signature-based IDS monitors the network traffic or observes the system and sends an alarm if a known malicious event is happening. It does so by comparing the data flow against a database of known attack patterns These signatures explicitly define what traffic or activity should be considered as malicious. Signature-based detection has been the bread and butter of network-based defensive security for over a decade, partially because it is very similar to how malicious activity is detected at the host level with antivirus utilities The formula is fairly simple: an analyst observes a malicious activity, derives indicators from the activity and develops them into signatures, and then those signatures will alert whenever the activity occurs again. ex: SNORT & SURICATA Policy-Based IDS The policy-based IDSs (mainly host IDSs) trigger an alarm whenever a violation occurs against the configured policy. This configured policy is or should be a representation of the security policies. This type of IDS is flexible and can be customized to a company's network requirements because it knows exactly what is permitted and what is not. On the other hand, the signature-based systems rely on vendor specifics and default settings. Anomaly Based IDS The anomaly-based IDS looks for traffic that deviates from the normal, but the definition of what is a normal network traffic pattern is the tricky part Two types of anomaly-based IDS exist: statistical and nonstatistical anomaly detection Statistical anomaly detection learns the traffic patterns interactively over a period of time. In the nonstatistical approach, the IDS has a predefined configuration of the supposedly acceptable and valid traffic patterns. Host-Based IDS & Network-Based IDS A host IDS can be described as a distributed agent residing on each server of the network that needs protection. These distributed agents are tied very closely to the underlying operating system. Network IDSs, on the other hand, can be described as intelligent sniffing devices. Data (raw packets) is captured from the network by a network IDS, whereas host IDSs capture the data from the host on which they are installed. Honeypots The use of decoy machines to direct intruders' attention away from the machines under protection is a major technique to preclude intrusion attacks. Any device, system, directory, or file used as a decoy to lure attackers away from important assets and to collect intrusion or abusive behaviours is referred to as a honeypot. A honeypot may be implemented as a physical device or as an emulation system. The idea is to set up decoy machines in a LAN, or decoy directories/files in a file system and make them appear important, but with several exploitable loopholes, to lure attackers to attack these machines or directories/files, so that other machines, directories, and files can evade intruders' attentions. A decoy machine may be a host computer or a server computer. Likewise, we may also set up decoy routers or even decoy LANs. Chinks In The Armour (TCP/IP Security Issues) IP Spoofing In this type of attack, the attacker replaces the IP address of the sender, or in some rare cases the destination, with a different address. IP spoofing is normally used to exploit a target host. In other cases, it is used to start a denial-of-service (DoS) attack. In a DoS attack, an attacker modifies the IP packet to mislead the target host into accepting the original packet as a packet sourced at a trusted host. The attacker must know the IP address of the trusted host to modify the packet headers (source IP address) so that it appears that the packets are coming from that host. IP Spoofing Detection Techniques Direct TTL Probes In this technique we send a packet to a host of suspect spoofed IP that triggers reply and compares TTL with suspect packet; if the TTL in the reply is not the same as the packet being checked; it is a spoofed packet. This Technique is successful when the attacker is in a different subnet from the victim. IP Identification Number. Send a probe to the host of suspect spoofed traffic that triggers a reply and compares IP ID with suspect traffic. If IP IDs are not in the near value of packet being checked, suspect traffic is spoofed TCP Flow Control Method Attackers sending spoofed TCP packets will not receive the target\u2019s SYN-ACK packets. Attackers cannot, therefore, be responsive to change in the congestion window size When the receiver still receives traffic even after a windows size is exhausted, most probably the packets are spoofed. Covert Channel A covert or clandestine channel can be best described as a pipe or communication channel between two entities that can be exploited by a process or application transferring information in a manner that violates the system's security specifications. More specifically for TCP/IP, in some instances, covert channels are established, and data can be secretly passed between two end systems. Ex: ICMP resides at the Internet layer of the TCP/IP protocol suite and is implemented in all TCP/IP hosts. Based on the specifications of the ICMP Protocol, an ICMP Echo Request message should have an 8-byte header and a 56-byte payload. The ICMP Echo Request packet should not carry any data in the payload. However, these packets are often used to carry secret information. The ICMP packets are altered slightly to carry secret data in the payload. This makes the size of the packet larger, but no control exists in the protocol stack to defeat this behaviour. The alteration of ICMP packets allows intruders to program specialized client-server pairs. These small pieces of code export confidential information without alerting the network administrator. ICMP can be leveraged for more than data exfiltration. For eg. some C&C tools such as Loki used ICMP channel to establish encrypted interactive session back in 1996. Deep packet inspection has since come a long way. A lot of IDS/IPS detect ICMP tunnelling. Check for echo responses that do not contain the same payload as request Check for the volume of ICMP traffic especially for volumes beyond an acceptable threshold IP Fragmentation Attack The TCP/IP protocol suite, or more specifically IP, allows the fragmentation of packets.(this is a feature & not a bug) IP fragmentation offset is used to keep track of the different parts of a datagram. The information or content in this field is used at the destination to reassemble the datagrams All such fragments have the same Identification field value, and the fragmentation offset indicates the position of the current fragment in the context of the original packet. Many access routers and firewalls do not perform packet reassembly. In normal operation, IP fragments do not overlap, but attackers can create artificially fragmented packets to mislead the routers or firewalls. Usually, these packets are small and almost impractical for end systems because of data and computational overhead. A good example of an IP fragmentation attack is the Ping of Death attack. The Ping of Death attack sends fragments that, when reassembled at the end station, create a larger packet than the maximum permissible length. TCP Flags Data exchange using TCP does not happen until a three-way handshake has been completed. This handshake uses different flags to influence the way TCP segments are processed. There are 6 bits in the TCP header that are often called flags. Namely: 6 different flags are part of the TCP header: Urgent pointer field (URG), Acknowledgment field (ACK), Push function (PSH), Reset the connection (RST), Synchronize sequence numbers (SYN), and the sender is finished with this connection (FIN). Abuse of the normal operation or settings of these flags can be used by attackers to launch DoS attacks. This causes network servers or web servers to crash or hang. | SYN | FIN | PSH | RST | Validity| |------|------|-------|------|---------| | 1 |1 |0 |0 |Illegal Combination | 1 |1 |1 |0 |Illegal Combination | 1 |1 |0 |1 |Illegal Combination | 1 |1 |1 |1 |Illegal Combination The attacker's ultimate goal is to write special programs or pieces of code that can construct these illegal combinations resulting in an efficient DoS attack. SYN FLOOD The timers (or lack of certain timers) in 3 way handshake are often used and exploited by attackers to disable services or even to enter systems. After step 2 of the three-way handshake, no limit is set on the time to wait after receiving a SYN. The attacker initiates many connection requests to the webserver of Company XYZ (almost certainly with a spoofed IP address). The SYN+ACK packets (Step 2) sent by the web server back to the originating source IP address are not replied to. This leaves a TCP session half-open on the webserver. Multiple packets cause multiple TCP sessions to stay open. Based on the hardware limitations of the server, a limited number of TCP sessions can stay open, and as a result, the webserver refuses further connection establishments attempts from any host as soon as a certain limit is reached. These half-open connections need to be completed or timed out before new connections can be established. FIN Attack In normal operation, the sender sets the TCP FIN flag indicating that no more data will be transmitted and the connection can be closed down. This is a four-way handshake mechanism, with both sender and receiver expected to send an acknowledgement on a received FIN packet. During an attack that is trying to kill connections, a spoofed FIN packet is constructed. This packet also has the correct sequence number, so the packets are seen as valid by the targeted host. These sequence numbers are easy to predict. This process is referred to as TCP sequence number prediction, whereby the attacker either sniffs the current Sequence and Acknowledgment (SEQ/ACK) numbers of the connection or can algorithmically predict these numbers. Connection Hijacking An authorized user (Employee X) sends HTTP requests over a TCP session with the webserver. The web server accepts the packets from Employee X only when the packet has the correct SEQ/ACK numbers. As seen previously, these numbers are important for the webserver to distinguish between different sessions and to make sure it is still talking to Employee X. Imagine that the cracker starts sending packets to the web server spoofing the IP address of Employee X, using the correct SEQ/ACK combination. The web server accepts the packet and increments the ACK number. In the meantime, Employee X continues to send packets but with incorrect SEQ/ACK numbers. As a result of sending unsynchronized packets, all data from Employee X is discarded when received by the webserver. The attacker pretends to be Employee X using the correct numbers. This finally results in the cracker hijacking the connection, whereby Employee X is completely confused and the webserver replies assuming the cracker is sending correct synchronized data. STEPS: The attacker examines the traffic flows with a network monitor and notices traffic from Employee X to a web server. The web server returns or echoes data back to the origination station (Employee X). Employee X acknowledges the packet. The cracker launches a spoofed packet to the server. The web server responds to the cracker. The cracker starts verifying SEQ/ACK numbers to double-check success. At this time, the cracker takes over the session from Employee X, which results in a session hanging for Employee X. The cracker can start sending traffic to the webserver. The web server returns the requested data to confirm delivery with the correct ACK number. The cracker can continue to send data (keeping track of the correct SEQ/ACK numbers) until eventually setting the FIN flag to terminate the session. Buffer Overflow A buffer is a temporary data storage area used to store program code and data. When a program or process tries to store more data in a buffer than it was originally anticipated to hold, a buffer overflow occurs. Buffers are temporary storage locations in memory (memory or buffer sizes are often measured in bytes) that can store a fixed amount of data in bytes. When more data is retrieved than can be stored in a buffer location, the additional information must go into an adjacent buffer, resulting in overwriting the valid data held in them. Mechanism: Buffer overflow vulnerabilities exist in different types. But the overall goal for all buffer overflow attacks is to take over the control of a privileged program and, if possible, the host. The attacker has two tasks to achieve this goal. First, the dirty code needs to be available in the program's code address space. Second, the privileged program should jump to that particular part of the code, which ensures that the proper parameters are loaded into memory. The first task can be achieved in two ways: by injecting the code in the right address space or by using the existing code and modifying certain parameters slightly. The second task is a little more complex because the program's control flow needs to be modified to make the program jump to the dirty code. CounterMeasure: The most important approach is to have a concerted focus on writing correct code. A second method is to make the data buffers (memory locations) address space of the program code non-executable. This type of address space makes it impossible to execute code, which might be infiltrated in the program's buffers during an attack. More Spoofing Address Resolution Protocol Spoofing The Address Resolution Protocol (ARP) provides a mechanism to resolve, or map, a known IP address to a MAC sublayer address. Using ARP spoofing, the cracker can exploit this hardware address authentication mechanism by spoofing the hardware address of Host B. Basically, the attacker can convince any host or network device on the local network that the cracker's workstation is the host to be trusted. This is a common method used in a switched environment. ARP spoofing can be prevented with the implementation of static ARP tables in all the hosts and routers of your network. Alternatively, you can implement an ARP server that responds to ARP requests on behalf of the target host. DNS Spoofing DNS spoofing is the method whereby the hacker convinces the target machine that the system it wants to connect to is the machine of the cracker. The cracker modifies some records so that name entries of hosts correspond to the attacker's IP address. There have been instances in which the complete DNS server was compromised by an attack. To counter DNS spoofing, the reverse lookup detects these attacks. The reverse lookup is a mechanism to verify the IP address against a name. The IP address and name files are usually kept on different servers to make compromise much more difficult","title":"Network Security"},{"location":"level101/security/network_security/#part-ii-network-security","text":"","title":"Part II: Network Security"},{"location":"level101/security/network_security/#introduction","text":"TCP/IP is the dominant networking technology today. It is a five-layer architecture. These layers are, from top to bottom, the application layer, the transport layer (TCP), the network layer (IP), the data-link layer, and the physical layer. In addition to TCP/IP, there also are other networking technologies. For convenience, we use the OSI network model to represent non-TCP/IP network technologies. Different networks are interconnected using gateways. A gateway can be placed at any layer. The OSI model is a seven-layer architecture. The OSI architecture is similar to the TCP/IP architecture, except that the OSI model specifies two additional layers between the application layer and the transport layer in the TCP/IP architecture. These two layers are the presentation layer and the session layer. Figure 5.1 shows the relationship between the TCP/IP layers and the OSI layers. The application layer in TCP/IP corresponds to the application layer and the presentation layer in OSI. The transport layer in TCP/IP corresponds to the session layer and the transport layer in OSI. The remaining three layers in the TCP/IP architecture are one-to-one correspondent to the remaining three layers in the OSI model. Correspondence between layers of the TCP/IP architecture and the OSI model. Also shown are placements of cryptographic algorithms in network layers, where the dotted arrows indicate actual communications of cryptographic algorithms The functionalities of OSI layers are briefly described as follows: The application layer serves as an interface between applications and network programs. It supports application programs and end-user processing. Common application-layer programs include remote logins, file transfer, email, and Web browsing. The presentation layer is responsible for dealing with data that is formed differently. This protocol layer allows application-layer programs residing on different sides of a communication channel with different platforms to understand each other's data formats regardless of how they are presented. The session layer is responsible for creating, managing, and closing a communication connection. The transport layer is responsible for providing reliable connections, such as packet sequencing, traffic control, and congestion control. The network layer is responsible for routing device-independent data packets from the current hop to the next hop. The data-link layer is responsible for encapsulating device-independent data packets into device-dependent data frames. It has two sublayers: logical link control and media access control. The physical layer is responsible for transmitting device-dependent frames through some physical media. Starting from the application layer, data generated from an application program is passed down layer-by-layer to the physical layer. Data from the previous layer is enclosed in a new envelope at the current layer, where the data from the previous layer is also just an envelope containing the data from the layer before it. This is similar to enclosing a smaller envelope in a larger one. The envelope added at each layer contains sufficient information for handling the packet. Application-layer data are divided into blocks small enough to be encapsulated in an envelope at the next layer. Application data blocks are \u201cdressed up\u201d in the TCP/IP architecture according to the following basic steps. At the sending side, an application data block is encapsulated in a TCP packet when it is passed down to the TCP layer. In other words, a TCP packet consists of a header and a payload, where the header corresponds to the TCP envelope and the payload is the application data block. Likewise, the TCP packet will be encapsulated in an IP packet when it is passed down to the IP layer. An IP packet consists of a header and a payload, which is the TCP packet passed down from the TCP layer. The IP packet will be encapsulated in a device-dependent frame (e.g., an Ethernet frame) when it is passed down to the data-link layer. A frame has a header, and it may also have a trailer. For example, in addition to having a header, an Ethernet frame also has a 32-bit cyclic redundancy check (CRC) trailer. When it is passed down to the physical layer, a frame will be transformed into a sequence of media signals for transmission Flow Diagram of a Packet Generation At the destination side, the medium signals are converted by the physical layer into a frame, which is passed up to the data-link layer. The data-link layer passes the frame payload (i.e., the IP packet encapsulated in the frame) up to the IP layer. The IP layer passes the IP payload, namely, the TCP packet encapsulated in the IP packet, up to the TCP layer. The TCP layer passes the TCP payload, namely, the application data block, up to the application layer. When a packet arrives at a router, it only goes up to the IP layer, where certain fields in the IP header are modified (e.g., the value of TTL is decreased by 1). This modified packet is then passed back down layer-by-layer to the physical layer for further transmission.","title":"Introduction"},{"location":"level101/security/network_security/#public-key-infrastructure","text":"To deploy cryptographic algorithms in network applications, we need a way to distribute secret keys using open networks. Public-key cryptography is the best way to distribute these secret keys. To use public-key cryptography, we need to build a public-key infrastructure (PKI) to support and manage public-key certificates and certificate authority (CA) networks. In particular, PKIs are set up to perform the following functions: Determine the legitimacy of users before issuing public-key certificates to them. Issue public-key certificates upon user requests. Extend public-key certificates valid time upon user requests. Revoke public-key certificates upon users' requests or when the corresponding private keys are compromised. Store and manage public-key certificates. Prevent digital signature signers from denying their signatures. Support CA networks to allow different CAs to authenticate public-key certificates issued by other CAs. X.509: https://certificatedecoder.dev/?gclid=EAIaIQobChMI0M731O6G6gIVVSQrCh04bQaAEAAYASAAEgKRkPD_BwE","title":"Public Key Infrastructure"},{"location":"level101/security/network_security/#ipsec-a-security-protocol-at-the-network-layer","text":"IPsec is a major security protocol at the network layer IPsec provides a potent platform for constructing virtual private networks (VPN). VPNs are private networks overlayed on public networks. The purpose of deploying cryptographic algorithms at the network layer is to encrypt or authenticate IP packets (either just the payloads or the whole packets). IPsec also specifies how to exchange keys. Thus, IPsec consists of authentication protocols, encryption protocols, and key exchange protocols. They are referred to, respectively, as authentication header (AH), encapsulating security payload (ESP), and Internet key exchange (IKE).","title":"IPsec: A Security Protocol at the Network Layer"},{"location":"level101/security/network_security/#pgp-smime-email-security","text":"There are several security protocols at the application layer. The most used of these protocols are email security protocols namely PGP and S/MIME. SMTP (\u201cSimple Mail Transfer Protocol\u201d) is used for sending and delivering from a client to a server via port 25: it\u2019s the outgoing server. On the contrary, POP (\u201cPost Office Protocol\u201d) allows the users to pick up the message and download it into their inbox: it\u2019s the incoming server. The latest version of the Post Office Protocol is named POP3, and it\u2019s been used since 1996; it uses port 110 PGP PGP implements all major cryptographic algorithms, the ZIP compression algorithm, and the Base64 encoding algorithm. It can be used to authenticate a message, encrypt a message, or both. PGP follows the following general process: authentication, ZIP compression, encryption, and Base64 encoding. The Base64 encoding procedure makes the message ready for SMTP transmission GPG (GnuPG) GnuPG is another free encryption standard that companies may use that is based on OpenPGP. GnuPG serves as a replacement for Symantec\u2019s PGP. The main difference is the supported algorithms. However, GnuPG plays nice with PGP by design. Because GnuPG is open, some businesses would prefer the technical support and the user interface that comes with Symantec\u2019s PGP. It is important to note that there are some nuances between the compatibility of GnuPG and PGP, such as the compatibility between certain algorithms, but in most applications such as email, there are workarounds. One such algorithm is the IDEA Module which isn\u2019t included in GnuPG out of the box due to patent issues. S/MIME SMTP can only handle 7-bit ASCII text (You can use UTF-8 extensions to alleviate these limitations, ) messages. While POP can handle other content types besides 7-bit ASCII, POP may, under a common default setting, download all the messages stored in the mail server to the user's local computer. After that, if POP removes these messages from the mail server. This makes it difficult for the users to read their messages from multiple computers. The Multipurpose Internet Mail Extension protocol (MIME) was designed to support sending and receiving email messages in various formats, including nontext files generated by word processors, graphics files, sound files, and video clips. Moreover, MIME allows a single message to include mixed types of data in any combination of these formats. The Internet Mail Access Protocol (IMAP), operated on TCP port 143(only for non-encrypted), stores (Configurable on both server & client just like PoP) incoming email messages in the mail server until the user deletes them deliberately. This allows the users to access their mailbox from multiple machines and download messages to a local machine without deleting it from the mailbox in the mail server. SSL/TLS SSL uses a PKI to decide if a server\u2019s public key is trustworthy by requiring servers to use a security certificate signed by a trusted CA. When Netscape Navigator 1.0 was released, it trusted a single CA operated by the RSA Data Security corporation. The server\u2019s public RSA keys were used to be stored in the security certificate, which can then be used by the browser to establish a secure communication channel. The security certificates we use today still rely on the same standard (named X.509) that Netscape Navigator 1.0 used back then. Netscape intended to train users(though this didn\u2019t work out later) to differentiate secure communications from insecure ones, so they put a lock icon next to the address bar. When the lock is open, the communication is insecure. A closed lock means communication has been secured with SSL, which required the server to provide a signed certificate. You\u2019re obviously familiar with this icon as it\u2019s been in every browser ever since. The engineers at Netscape truly created a standard for secure internet communications. A year after releasing SSL 2.0, Netscape fixed several security issues and released SSL 3.0, a protocol that, albeit being officially deprecated since June 2015, remains in use in certain parts of the world more than 20 years after its introduction. To standardize SSL, the Internet Engineering Task Force (IETF) created a slightly modified SSL 3.0 and, in 1999, unveiled it as Transport Layer Security (TLS) 1.0. The name change between SSL and TLS continues to confuse people today. Officially, TLS is the new SSL, but in practice, people use SSL and TLS interchangeably to talk about any version of the protocol. Must See: https://tls.ulfheim.net/ https://davidwong.fr/tls13/","title":"PGP & S/MIME : Email Security"},{"location":"level101/security/network_security/#network-perimeter-security","text":"Let us see how we keep a check on the perimeter i.e the edges, the first layer of protection","title":"Network Perimeter Security"},{"location":"level101/security/network_security/#general-firewall-framework","text":"Firewalls are needed because encryption algorithms cannot effectively stop malicious packets from getting into an edge network. This is because IP packets, regardless of whether they are encrypted, can always be forwarded into an edge network. Firewalls that were developed in the 1990s are important instruments to help restrict network access. A firewall may be a hardware device, a software package, or a combination of both. Packets flowing into the internal network from the outside should be evaluated before they are allowed to enter. One of the critical elements of a firewall is its ability to examine packets without imposing a negative impact on communication speed while providing security protections for the internal network. The packet inspection that is carried out by firewalls can be done using several different methods. Based on the particular method used by the firewall, it can be characterized as either a packet filter, circuit gateway, application gateway, or dynamic packet filter.","title":"General Firewall Framework"},{"location":"level101/security/network_security/#packet-filters","text":"It inspects ingress packets coming to an internal network from outside and inspects egress packets going outside from an internal network Packing filtering only inspects IP headers and TCP headers, not the payloads generated at the application layer A packet-filtering firewall uses a set of rules to determine whether a packet should be allowed or denied to pass through. 2 types: Stateless It treats each packet as an independent object, and it does not keep track of any previously processed packets. In other words, stateless filtering inspects a packet when it arrives and makes a decision without leaving any record of the packet being inspected. Stateful Stateful filtering, also referred to as connection-state filtering, keeps track of connections between an internal host and an external host. A connection state (or state, for short) indicates whether it is a TCP connection or a UDP connection and whether the connection is established.","title":"Packet Filters"},{"location":"level101/security/network_security/#circuit-gateways","text":"Circuit gateways, also referred to as circuit-level gateways, are typically operated at the transportation layer They evaluate the information of the IP addresses and the port numbers contained in TCP (or UDP) headers and use it to determine whether to allow or to disallow an internal host and an external host to establish a connection. It is common practice to combine packet filters and circuit gateways to form a dynamic packet filter (DPF).","title":"Circuit Gateways"},{"location":"level101/security/network_security/#application-gatewaysalg","text":"Aka PROXY Servers An Application Level Gateway (ALG) acts as a proxy for internal hosts, processing service requests from external clients. An ALG performs deep inspections on each IP packet (ingress or egress). In particular, an ALG inspects application program formats contained in the packet (e.g., MIME format or SQL format) and examines whether its payload is permitted. Thus, an ALG may be able to detect a computer virus contained in the payload. Because an ALG inspects packet payloads, it may be able to detect malicious code and quarantine suspicious packets, in addition to blocking packets with suspicious IP addresses and TCP ports. On the other hand, an ALG also incurs substantial computation and space overheads.","title":"Application Gateways(ALG)"},{"location":"level101/security/network_security/#trusted-systems-bastion-hosts","text":"A Trusted Operating System (TOS) is an operating system that meets a particular set of security requirements. Whether an operating system can be trusted or not depends on several elements. For example, for an operating system on a particular computer to be certified trusted, one needs to validate that, among other things, the following four requirements are satisfied: Its system design contains no defects; Its system software contains no loopholes; Its system is configured properly; and Its system management is appropriate. Bastion Hosts Bastion hosts are computers with strong defence mechanisms. They often serve as host computers for implementing application gateways, circuit gateways, and other types of firewalls. A bastion host is operated on a trusted operating system that must not contain unnecessary functionalities or programs. This measure helps to reduce error probabilities and makes it easier to conduct security checks. Only those network application programs that are necessary, for example, SSH, DNS, SMTP, and authentication programs, are installed on a bastion host. Bastion hosts are also primarily used as controlled ingress points so that the security monitoring can focus more narrowly on actions happening at a single point closely.","title":"Trusted Systems & Bastion Hosts"},{"location":"level101/security/network_security/#common-techniques-scannings-packet-capturing","text":"","title":"Common Techniques & Scannings, Packet Capturing"},{"location":"level101/security/network_security/#scanning-ports-with-nmap","text":"Nmap (\"Network Mapper\") is a free and open-source (license) utility for network discovery and security auditing. Many systems and network administrators also find it useful for tasks such as network inventory, managing service upgrade schedules, and monitoring host or service uptime. The best thing about Nmap is it\u2019s free and open-source and is very flexible and versatile Nmap is often used to determine alive hosts in a network, open ports on those hosts, services running on those open ports, and version identification of that service on that port. More at http://scanme.nmap.org/ nmap [scan type] [options] [target specification] Nmap uses 6 different port states: Open \u2014 An open port is one that is actively accepting TCP, UDP or SCTP connections. Open ports are what interests us the most because they are the ones that are vulnerable to attacks. Open ports also show the available services on a network. Closed \u2014 A port that receives and responds to Nmap probe packets but there is no application listening on that port. Useful for identifying that the host exists and for OS detection. Filtered \u2014 Nmap can\u2019t determine whether the port is open because packet filtering prevents its probes from reaching the port. Filtering could come from firewalls or router rules. Often little information is given from filtered ports during scans as the filters can drop the probes without responding or respond with useless error messages e.g. destination unreachable. Unfiltered \u2014 Port is accessible but Nmap doesn\u2019t know if it is open or closed. Only used in ACK scan which is used to map firewall rulesets. Other scan types can be used to identify whether the port is open. Open/filtered \u2014 Nmap is unable to determine between open and filtered. This happens when an open port gives no response. No response could mean that the probe was dropped by a packet filter or any response is blocked. Closed/filtered \u2014 Nmap is unable to determine whether a port is closed or filtered. Only used in the IP ID idle scan.","title":"Scanning Ports with Nmap"},{"location":"level101/security/network_security/#types-of-nmap-scan","text":"TCP Connect TCP Connect scan completes the 3-way handshake. If a port is open, the operating system completes the TCP three-way handshake and the port scanner immediately closes the connection to avoid DOS. This is \u201cnoisy\u201d because the services can log the sender IP address and might trigger Intrusion Detection Systems. UDP Scan This scan checks to see if any UDP ports are listening. Since UDP does not respond with a positive acknowledgement like TCP and only responds to an incoming UDP packet when the port is closed, SYN Scan SYN scan is another form of TCP scanning. This scan type is also known as \u201chalf-open scanning\u201d because it never actually opens a full TCP connection. The port scanner generates a SYN packet. If the target port is open, it will respond with an SYN-ACK packet. The scanner host responds with an RST packet, closing the connection before the handshake is completed. If the port is closed but unfiltered, the target will instantly respond with an RST packet. SYN scan has the advantage that the individual services never actually receive a connection. FIN Scan This is a stealthy scan, like the SYN scan, but sends a TCP FIN packet instead. ACK Scan Ack scanning determines whether the port is filtered or not. Null Scan Another very stealthy scan that sets all the TCP header flags to off or null. This is not normally a valid packet and some hosts will not know what to do with this. XMAS Scan Similar to the NULL scan except for all the flags in the TCP header is set to on RPC Scan This special type of scan looks for machine answering to RPC (Remote Procedure Call) services IDLE Scan It is a super stealthy method whereby the scan packets are bounced off an external host. You don\u2019t need to have control over the other host but it does have to set up and meet certain requirements. You must input the IP address of our \u201czombie\u201d host and what port number to use. It is one of the more controversial options in Nmap since it only has a use for malicious attacks. Scan Techniques A couple of scan techniques which can be used to gain more information about a system and its ports. You can read more at https://medium.com/infosec-adventures/nmap-cheatsheet-a423fcdda0ca","title":"Types of Nmap Scan:"},{"location":"level101/security/network_security/#openvas","text":"OpenVAS is a full-featured vulnerability scanner. OpenVAS is a framework of services and tools that provides a comprehensive and powerful vulnerability scanning and management package OpenVAS, which is an open-source program, began as a fork of the once-more-popular scanning program, Nessus. OpenVAS is made up of three main parts. These are: a regularly updated feed of Network Vulnerability Tests (NVTs); a scanner, which runs the NVTs; and an SQLite 3 database for storing both your test configurations and the NVTs\u2019 results and configurations. https://www.greenbone.net/en/install_use_gce/","title":"OpenVAS"},{"location":"level101/security/network_security/#wireshark","text":"Wireshark is a protocol analyzer. This means Wireshark is designed to decode not only packet bits and bytes but also the relations between packets and protocols. Wireshark understands protocol sequences. A simple demo of Wireshark Capture only udp packets: Capture filter = \u201cudp\u201d Capture only tcp packets Capture filter = \u201ctcp\u201d TCP/IP 3 way Handshake Filter by IP address: displays all traffic from IP, be it source or destination ip.addr == 192.168.1.1 Filter by source address: display traffic only from IP source ip.src == 192.168.0.1 Filter by destination: display traffic only form IP destination ip.dst == 192.168.0.1 Filter by IP subnet: display traffic from subnet, be it source or destination ip.addr = 192.168.0.1/24 Filter by protocol: filter traffic by protocol name dns http ftp arp ssh telnet icmp Exclude IP address: remove traffic from and to IP address !ip.addr ==192.168.0.1 Display traffic between two specific subnet ip.addr == 192.168.0.1/24 and ip.addr == 192.168.1.1/24 Display traffic between two specific workstations ip.addr == 192.168.0.1 and ip.addr == 192.168.0.2 Filter by MAC eth.addr = 00:50:7f:c5:b6:78 Filter TCP port tcp.port == 80 Filter TCP port source tcp.srcport == 80 Filter TCP port destination tcp.dstport == 80 Find user agents http.user_agent contains Firefox !http.user_agent contains || !http.user_agent contains Chrome Filter broadcast traffic !(arp or icmp or dns) Filter IP address and port tcp.port == 80 && ip.addr == 192.168.0.1 Filter all http get requests http.request Filter all http get requests and responses http.request or http.response Filter three way handshake tcp.flags.syn==1 or (tcp.seq==1 and tcp.ack==1 and tcp.len==0 and tcp.analysis.initial_rtt) Find files by type frame contains \u201c(attachment|tar|exe|zip|pdf)\u201d Find traffic based on keyword tcp contains facebook frame contains facebook Detecting SYN Floods tcp.flags.syn == 1 and tcp.flags.ack == 0 Wireshark Promiscuous Mode - By default, Wireshark only captures packets going to and from the computer where it runs. By checking the box to run Wireshark in Promiscuous Mode in the Capture Settings, you can capture most of the traffic on the LAN.","title":"WireShark"},{"location":"level101/security/network_security/#dumpcap","text":"Dumpcap is a network traffic dump tool. It captures packet data from a live network and writes the packets to a file. Dumpcap\u2019s native capture file format is pcapng, which is also the format used by Wireshark. By default, Dumpcap uses the pcap library to capture traffic from the first available network interface and writes the received raw packet data, along with the packets\u2019 time stamps into a pcapng file. The capture filter syntax follows the rules of the pcap library. The Wireshark command-line utility called 'dumpcap.exe' can be used to capture LAN traffic over an extended period of time. Wireshark itself can also be used, but dumpcap does not significantly utilize the computer's memory while capturing for long periods.","title":"DumpCap"},{"location":"level101/security/network_security/#daemonlogger","text":"Daemonlogger is a packet logging application designed specifically for use in Network and Systems Management (NSM) environments. The biggest benefit Daemonlogger provides is that, like Dumpcap, it is simple to use for capturing packets. In order to begin capturing, you need only to invoke the command and specify an interface. daemonlogger \u2013i eth1 This option, by default, will begin capturing packets and logging them to the current working directory. Packets will be collected until the capture file size reaches 2 GB, and then a new file will be created. This will continue indefinitely until the process is halted.","title":"DaemonLogger"},{"location":"level101/security/network_security/#netsniff-ng","text":"Netsniff-NG is a high-performance packet capture utility While the utilities we\u2019ve discussed to this point rely on Libpcap for capture, Netsniff-NG utilizes zero-copy mechanisms to capture packets. This is done with the intent to support full packet capture over high throughput links. To begin capturing packets with Netsniff-NG, we have to specify an input and output. In most cases, the input will be a network interface, and the output will be a file or folder on disk. netsniff-ng \u2013i eth1 \u2013o data.pcap","title":"NetSniff-NG"},{"location":"level101/security/network_security/#netflow","text":"NetFlow is a feature that was introduced on Cisco routers around 1996 that provides the ability to collect IP network traffic as it enters or exits an interface. By analyzing the data provided by NetFlow, a network administrator can determine things such as the source and destination of traffic, class of service, and the causes of congestion. A typical flow monitoring setup (using NetFlow) consists of three main components:[1] Flow exporter: aggregates packets into flows and exports flow records towards one or more flow collectors. Flow collector: responsible for reception, storage and pre-processing of flow data received from a flow exporter. Analysis application: analyzes received flow data in the context of intrusion detection or traffic profiling, for example. Routers and switches that support NetFlow can collect IP traffic statistics on all interfaces where NetFlow is enabled, and later export those statistics as NetFlow records toward at least one NetFlow collector\u2014typically a server that does the actual traffic analysis.","title":"Netflow"},{"location":"level101/security/network_security/#ids","text":"A security solution that detects security-related events in your environment but does not block them. IDS sensors can be software and hardware-based used to collect and analyze the network traffic. These sensors are available in two varieties, network IDS and host IDS. A host IDS is a server-specific agent running on a server with a minimum of overhead to monitor the operating system. A network IDS can be embedded in a networking device, a standalone appliance, or a module monitoring the network traffic. Signature Based IDS The signature-based IDS monitors the network traffic or observes the system and sends an alarm if a known malicious event is happening. It does so by comparing the data flow against a database of known attack patterns These signatures explicitly define what traffic or activity should be considered as malicious. Signature-based detection has been the bread and butter of network-based defensive security for over a decade, partially because it is very similar to how malicious activity is detected at the host level with antivirus utilities The formula is fairly simple: an analyst observes a malicious activity, derives indicators from the activity and develops them into signatures, and then those signatures will alert whenever the activity occurs again. ex: SNORT & SURICATA Policy-Based IDS The policy-based IDSs (mainly host IDSs) trigger an alarm whenever a violation occurs against the configured policy. This configured policy is or should be a representation of the security policies. This type of IDS is flexible and can be customized to a company's network requirements because it knows exactly what is permitted and what is not. On the other hand, the signature-based systems rely on vendor specifics and default settings. Anomaly Based IDS The anomaly-based IDS looks for traffic that deviates from the normal, but the definition of what is a normal network traffic pattern is the tricky part Two types of anomaly-based IDS exist: statistical and nonstatistical anomaly detection Statistical anomaly detection learns the traffic patterns interactively over a period of time. In the nonstatistical approach, the IDS has a predefined configuration of the supposedly acceptable and valid traffic patterns. Host-Based IDS & Network-Based IDS A host IDS can be described as a distributed agent residing on each server of the network that needs protection. These distributed agents are tied very closely to the underlying operating system. Network IDSs, on the other hand, can be described as intelligent sniffing devices. Data (raw packets) is captured from the network by a network IDS, whereas host IDSs capture the data from the host on which they are installed. Honeypots The use of decoy machines to direct intruders' attention away from the machines under protection is a major technique to preclude intrusion attacks. Any device, system, directory, or file used as a decoy to lure attackers away from important assets and to collect intrusion or abusive behaviours is referred to as a honeypot. A honeypot may be implemented as a physical device or as an emulation system. The idea is to set up decoy machines in a LAN, or decoy directories/files in a file system and make them appear important, but with several exploitable loopholes, to lure attackers to attack these machines or directories/files, so that other machines, directories, and files can evade intruders' attentions. A decoy machine may be a host computer or a server computer. Likewise, we may also set up decoy routers or even decoy LANs.","title":"IDS"},{"location":"level101/security/network_security/#chinks-in-the-armour-tcpip-security-issues","text":"","title":"Chinks In The Armour (TCP/IP Security Issues)"},{"location":"level101/security/network_security/#ip-spoofing","text":"In this type of attack, the attacker replaces the IP address of the sender, or in some rare cases the destination, with a different address. IP spoofing is normally used to exploit a target host. In other cases, it is used to start a denial-of-service (DoS) attack. In a DoS attack, an attacker modifies the IP packet to mislead the target host into accepting the original packet as a packet sourced at a trusted host. The attacker must know the IP address of the trusted host to modify the packet headers (source IP address) so that it appears that the packets are coming from that host. IP Spoofing Detection Techniques Direct TTL Probes In this technique we send a packet to a host of suspect spoofed IP that triggers reply and compares TTL with suspect packet; if the TTL in the reply is not the same as the packet being checked; it is a spoofed packet. This Technique is successful when the attacker is in a different subnet from the victim. IP Identification Number. Send a probe to the host of suspect spoofed traffic that triggers a reply and compares IP ID with suspect traffic. If IP IDs are not in the near value of packet being checked, suspect traffic is spoofed TCP Flow Control Method Attackers sending spoofed TCP packets will not receive the target\u2019s SYN-ACK packets. Attackers cannot, therefore, be responsive to change in the congestion window size When the receiver still receives traffic even after a windows size is exhausted, most probably the packets are spoofed.","title":"IP Spoofing"},{"location":"level101/security/network_security/#covert-channel","text":"A covert or clandestine channel can be best described as a pipe or communication channel between two entities that can be exploited by a process or application transferring information in a manner that violates the system's security specifications. More specifically for TCP/IP, in some instances, covert channels are established, and data can be secretly passed between two end systems. Ex: ICMP resides at the Internet layer of the TCP/IP protocol suite and is implemented in all TCP/IP hosts. Based on the specifications of the ICMP Protocol, an ICMP Echo Request message should have an 8-byte header and a 56-byte payload. The ICMP Echo Request packet should not carry any data in the payload. However, these packets are often used to carry secret information. The ICMP packets are altered slightly to carry secret data in the payload. This makes the size of the packet larger, but no control exists in the protocol stack to defeat this behaviour. The alteration of ICMP packets allows intruders to program specialized client-server pairs. These small pieces of code export confidential information without alerting the network administrator. ICMP can be leveraged for more than data exfiltration. For eg. some C&C tools such as Loki used ICMP channel to establish encrypted interactive session back in 1996. Deep packet inspection has since come a long way. A lot of IDS/IPS detect ICMP tunnelling. Check for echo responses that do not contain the same payload as request Check for the volume of ICMP traffic especially for volumes beyond an acceptable threshold","title":"Covert Channel"},{"location":"level101/security/network_security/#ip-fragmentation-attack","text":"The TCP/IP protocol suite, or more specifically IP, allows the fragmentation of packets.(this is a feature & not a bug) IP fragmentation offset is used to keep track of the different parts of a datagram. The information or content in this field is used at the destination to reassemble the datagrams All such fragments have the same Identification field value, and the fragmentation offset indicates the position of the current fragment in the context of the original packet. Many access routers and firewalls do not perform packet reassembly. In normal operation, IP fragments do not overlap, but attackers can create artificially fragmented packets to mislead the routers or firewalls. Usually, these packets are small and almost impractical for end systems because of data and computational overhead. A good example of an IP fragmentation attack is the Ping of Death attack. The Ping of Death attack sends fragments that, when reassembled at the end station, create a larger packet than the maximum permissible length. TCP Flags Data exchange using TCP does not happen until a three-way handshake has been completed. This handshake uses different flags to influence the way TCP segments are processed. There are 6 bits in the TCP header that are often called flags. Namely: 6 different flags are part of the TCP header: Urgent pointer field (URG), Acknowledgment field (ACK), Push function (PSH), Reset the connection (RST), Synchronize sequence numbers (SYN), and the sender is finished with this connection (FIN). Abuse of the normal operation or settings of these flags can be used by attackers to launch DoS attacks. This causes network servers or web servers to crash or hang. | SYN | FIN | PSH | RST | Validity| |------|------|-------|------|---------| | 1 |1 |0 |0 |Illegal Combination | 1 |1 |1 |0 |Illegal Combination | 1 |1 |0 |1 |Illegal Combination | 1 |1 |1 |1 |Illegal Combination The attacker's ultimate goal is to write special programs or pieces of code that can construct these illegal combinations resulting in an efficient DoS attack. SYN FLOOD The timers (or lack of certain timers) in 3 way handshake are often used and exploited by attackers to disable services or even to enter systems. After step 2 of the three-way handshake, no limit is set on the time to wait after receiving a SYN. The attacker initiates many connection requests to the webserver of Company XYZ (almost certainly with a spoofed IP address). The SYN+ACK packets (Step 2) sent by the web server back to the originating source IP address are not replied to. This leaves a TCP session half-open on the webserver. Multiple packets cause multiple TCP sessions to stay open. Based on the hardware limitations of the server, a limited number of TCP sessions can stay open, and as a result, the webserver refuses further connection establishments attempts from any host as soon as a certain limit is reached. These half-open connections need to be completed or timed out before new connections can be established. FIN Attack In normal operation, the sender sets the TCP FIN flag indicating that no more data will be transmitted and the connection can be closed down. This is a four-way handshake mechanism, with both sender and receiver expected to send an acknowledgement on a received FIN packet. During an attack that is trying to kill connections, a spoofed FIN packet is constructed. This packet also has the correct sequence number, so the packets are seen as valid by the targeted host. These sequence numbers are easy to predict. This process is referred to as TCP sequence number prediction, whereby the attacker either sniffs the current Sequence and Acknowledgment (SEQ/ACK) numbers of the connection or can algorithmically predict these numbers.","title":"IP Fragmentation Attack"},{"location":"level101/security/network_security/#connection-hijacking","text":"An authorized user (Employee X) sends HTTP requests over a TCP session with the webserver. The web server accepts the packets from Employee X only when the packet has the correct SEQ/ACK numbers. As seen previously, these numbers are important for the webserver to distinguish between different sessions and to make sure it is still talking to Employee X. Imagine that the cracker starts sending packets to the web server spoofing the IP address of Employee X, using the correct SEQ/ACK combination. The web server accepts the packet and increments the ACK number. In the meantime, Employee X continues to send packets but with incorrect SEQ/ACK numbers. As a result of sending unsynchronized packets, all data from Employee X is discarded when received by the webserver. The attacker pretends to be Employee X using the correct numbers. This finally results in the cracker hijacking the connection, whereby Employee X is completely confused and the webserver replies assuming the cracker is sending correct synchronized data. STEPS: The attacker examines the traffic flows with a network monitor and notices traffic from Employee X to a web server. The web server returns or echoes data back to the origination station (Employee X). Employee X acknowledges the packet. The cracker launches a spoofed packet to the server. The web server responds to the cracker. The cracker starts verifying SEQ/ACK numbers to double-check success. At this time, the cracker takes over the session from Employee X, which results in a session hanging for Employee X. The cracker can start sending traffic to the webserver. The web server returns the requested data to confirm delivery with the correct ACK number. The cracker can continue to send data (keeping track of the correct SEQ/ACK numbers) until eventually setting the FIN flag to terminate the session.","title":"Connection Hijacking"},{"location":"level101/security/network_security/#buffer-overflow","text":"A buffer is a temporary data storage area used to store program code and data. When a program or process tries to store more data in a buffer than it was originally anticipated to hold, a buffer overflow occurs. Buffers are temporary storage locations in memory (memory or buffer sizes are often measured in bytes) that can store a fixed amount of data in bytes. When more data is retrieved than can be stored in a buffer location, the additional information must go into an adjacent buffer, resulting in overwriting the valid data held in them. Mechanism: Buffer overflow vulnerabilities exist in different types. But the overall goal for all buffer overflow attacks is to take over the control of a privileged program and, if possible, the host. The attacker has two tasks to achieve this goal. First, the dirty code needs to be available in the program's code address space. Second, the privileged program should jump to that particular part of the code, which ensures that the proper parameters are loaded into memory. The first task can be achieved in two ways: by injecting the code in the right address space or by using the existing code and modifying certain parameters slightly. The second task is a little more complex because the program's control flow needs to be modified to make the program jump to the dirty code. CounterMeasure: The most important approach is to have a concerted focus on writing correct code. A second method is to make the data buffers (memory locations) address space of the program code non-executable. This type of address space makes it impossible to execute code, which might be infiltrated in the program's buffers during an attack.","title":"Buffer Overflow"},{"location":"level101/security/network_security/#more-spoofing","text":"Address Resolution Protocol Spoofing The Address Resolution Protocol (ARP) provides a mechanism to resolve, or map, a known IP address to a MAC sublayer address. Using ARP spoofing, the cracker can exploit this hardware address authentication mechanism by spoofing the hardware address of Host B. Basically, the attacker can convince any host or network device on the local network that the cracker's workstation is the host to be trusted. This is a common method used in a switched environment. ARP spoofing can be prevented with the implementation of static ARP tables in all the hosts and routers of your network. Alternatively, you can implement an ARP server that responds to ARP requests on behalf of the target host. DNS Spoofing DNS spoofing is the method whereby the hacker convinces the target machine that the system it wants to connect to is the machine of the cracker. The cracker modifies some records so that name entries of hosts correspond to the attacker's IP address. There have been instances in which the complete DNS server was compromised by an attack. To counter DNS spoofing, the reverse lookup detects these attacks. The reverse lookup is a mechanism to verify the IP address against a name. The IP address and name files are usually kept on different servers to make compromise much more difficult","title":"More Spoofing"},{"location":"level101/security/threats_attacks_defences/","text":"Part III: Threats, Attacks & Defense DNS Protection Cache Poisoning Attack Since DNS responses are cached, a quick response can be provided for repeated translations. DNS negative queries are also cached, e.g., misspelt words, and all cached data periodically times out. Cache poisoning is an issue in what is known as pharming. This term is used to describe a hacker\u2019s attack in which a website\u2019s traffic is redirected to a bogus website by forging the DNS mapping. In this case, an attacker attempts to insert a fake address record for an Internet domain into the DNS. If the server accepts the fake record, the cache is poisoned and subsequent requests for the address of the domain are answered with the address of a server controlled by the attacker. As long as the fake entry is cached by the server, browsers or e-mail servers will automatically go to the address provided by the compromised DNS server. the typical time to live (TTL) for cached entries is a couple of hours, thereby permitting ample time for numerous users to be affected by the attack. DNSSEC (Security Extension) The long-term solution to these DNS problems is authentication. If a resolver cannot distinguish between valid and invalid data in a response, then add source authentication to verify that the data received in response is equal to the data entered by the zone administrator DNS Security Extensions (DNSSEC) protects against data spoofing and corruption and provides mechanisms to authenticate servers and requests, as well as mechanisms to establish authenticity and integrity. When authenticating DNS responses, each DNS zone signs its data using a private key. It is recommended that this signing be done offline and in advance. The query for a particular record returns the requested resource record set (RRset) and signature (RRSIG) of the requested resource record set. The resolver then authenticates the response using a public key, which is pre-configured or learned via a sequence of key records in the DNS hierarchy. The goals of DNSSEC are to provide authentication and integrity for DNS responses without confidentiality or DDoS protection. BGP BGP stands for border gateway protocol. It is a routing protocol that exchanges routing information among multiple Autonomous Systems (AS) An Autonomous System is a collection of routers or networks with the same network policy usually under single administrative control. BGP tells routers which hop to use in order to reach the destination network. BGP is used for both communicating information among routers in an AS (interior) and between multiple ASes (exterior). How BGP Works BGP is responsible for finding a path to a destination router & the path it chooses should be the shortest and most reliable one. This decision is done through a protocol known as Link state. With the link-state protocol, each router broadcasts to all other routers in the network the state of its links and IP subnets. Each router then receives information from the other routers and constructs a complete topology view of the entire network. The next-hop routing table is based on this topology view. The link-state protocol uses a famous algorithm in the field of computer science, Dijkstra\u2019s shortest path algorithm: We start from our router considering the path cost to all our direct neighbours. The shortest path is then taken We then re-look at all our neighbours that we can reach and update our link state table with the cost information. We then continue taking the shortest path until every router has been visited. BGP Vulnerabilities By corrupting the BGP routing table we are able to influence the direction traffic flows on the internet! This action is known as BGP hijacking. Injecting bogus route advertising information into the BGP-distributed routing database by malicious sources, accidentally or routers can disrupt Internet backbone operations. Blackholing traffic: Blackhole route is a network route, i.e., routing table entry, that goes nowhere and packets matching the route prefix are dropped or ignored. Blackhole routes can only be detected by monitoring the lost traffic. Blackhole routes are the best defence against many common viral attacks where the traffic is dropped from infected machines to/from command & control hosts. Infamous BGP Injection attack on Youtube Ex: In 2008, Pakistan decided to block YouTube by creating a BGP route that led into a black hole. Instead, this routing information got transmitted to a hong kong ISP and from there accidentally got propagated to the rest of the world meaning millions were routed through to this black hole and therefore unable to access YouTube. Potentially, the greatest risk to BGP occurs in a denial of service attack in which a router is flooded with more packets than it can handle. Network overload and router resource exhaustion happen when the network begins carrying an excessive number of BGP messages, overloading the router control processors, memory, routing table and reducing the bandwidth available for data traffic. Refer: https://medium.com/bugbountywriteup/bgp-the-weak-link-in-the-internet-what-is-bgp-and-how-do-hackers-exploit-it-d899a68ba5bb Router flapping is another type of attack. Route flapping refers to repetitive changes to the BGP routing table, often several times a minute. Withdrawing and re-advertising at a high-rate can cause a serious problem for routers since they propagate the announcements of routes. If these route flaps happen fast enough, e.g., 30 to 50 times per second, the router becomes overloaded, which eventually prevents convergence on valid routes. The potential impact for Internet users is a slowdown in message delivery, and in some cases, packets may not be delivered at all. BGP Security Border Gateway Protocol Security recommends the use of BGP peer authentication since it is one of the strongest mechanisms for preventing malicious activity. The authentication mechanisms are Internet Protocol Security (IPsec) or BGP MD5. Another method, known as prefix limits, can be used to avoid filling router tables. In this approach, routers should be configured to disable or terminate a BGP peering session, and issue warning messages to administrators when a neighbour sends in excess of a preset number of prefixes. IETF is currently working on improving this space Web-Based Attacks HTTP Response Splitting Attacks HTTP response splitting attack may happen where the server script embeds user data in HTTP response headers without appropriate sanitation. This typically happens when the script embeds user data in the redirection URL of a redirection response (HTTP status code 3xx), or when the script embeds user data in a cookie value or name when the response sets a cookie. HTTP response splitting attacks can be used to perform web cache poisoning and cross-site scripting attacks. HTTP response splitting is the attacker\u2019s ability to send a single HTTP request that forces the webserver to form an output stream, which is then interpreted by the target as two HTTP responses instead of one response. Cross-Site Request Forgery (CSRF or XSRF) A Cross-Site Request Forgery attack tricks the victim\u2019s browser into issuing a command to a vulnerable web application. Vulnerability is caused by browsers automatically including user authentication data, session ID, IP address, Windows domain credentials, etc. with each request. Attackers typically use CSRF to initiate transactions such as transfer funds, login/logout user, close account, access sensitive data, and change account details. The vulnerability is caused by web browsers that automatically include credentials with each request, even for requests caused by a form, script, or image on another site. CSRF can also be dynamically constructed as part of a payload for a cross-site scripting attack All sites relying on automatic credentials are vulnerable. Popular browsers cannot prevent cross-site request forgery. Logging out of high-value sites as soon as possible can mitigate CSRF risk. It is recommended that a high-value website must require a client to manually provide authentication data in the same HTTP request used to perform any operation with security implications. Limiting the lifetime of session cookies can also reduce the chance of being used by other malicious sites. OWASP recommends website developers include a required security token in HTTP requests associated with sensitive business functions in order to mitigate CSRF attacks Cross-Site Scripting (XSS) Attacks Cross-Site Scripting occurs when dynamically generated web pages display user input, such as login information, that is not properly validated, allowing an attacker to embed malicious scripts into the generated page and then execute the script on the machine of any user that views the site. If successful, Cross-Site Scripting vulnerabilities can be exploited to manipulate or steal cookies, create requests that can be mistaken for those of a valid user, compromise confidential information, or execute malicious code on end-user systems. Cross-Site Scripting (XSS or CSS) attacks involve the execution of malicious scripts on the victim\u2019s browser. The victim is simply a user\u2019s host and not the server. XSS results from a failure to validate user input by a web-based application. Document Object Model (DOM) XSS Attacks The Document Object Model (DOM) based XSS does not require the webserver to receive the XSS payload for a successful attack. The attacker abuses the runtime by embedding their data on the client-side. An attacker can force the client (browser) to render the page with parts of the DOM controlled by the attacker. When the page is rendered and the data is processed by the page, typically by a client-side HTML-embedded script such as JavaScript, the page\u2019s code may insecurely embed the data in the page itself, thus delivering the cross-site scripting payload. There are several DOM objects which can serve as an attack vehicle for delivering malicious script to victims browser. Clickjacking The technique works by hiding malicious link/scripts under the cover of the content of a legitimate site. Buttons on a website actually contain invisible links, placed there by the attacker. So, an individual who clicks on an object they can visually see is actually being duped into visiting a malicious page or executing a malicious script. When mouseover is used together with clickjacking, the outcome is devastating. Facebook users have been hit by a clickjacking attack, which tricks people into \u201cliking\u201d a particular Facebook page, thus enabling the attack to spread since Memorial Day 2010. There is not yet effective defence against clickjacking, and disabling JavaScript is the only viable method DataBase Attacks & Defenses SQL injection Attacks It exploits improper input validation in database queries. A successful exploit will allow attackers to access, modify, or delete information in the database. It permits attackers to steal sensitive information stored within the backend databases of affected websites, which may include such things as user credentials, email addresses, personal information, and credit card numbers SELECT USERNAME,PASSWORD from USERS where USERNAME='' AND PASSWORD=''; Here the username & password is the input provided by the user. Suppose an attacker gives the input as \" OR '1'='1'\" in both fields. Therefore the SQL query will look like: SELECT USERNAME,PASSWORD from USERS where USERNAME='' OR '1'='1' AND PASSOWRD='' OR '1'='1'; This query results in a true statement & the user gets logged in. This example depicts the bost basic type of SQL injection SQL Injection Attack Defenses SQL injection can be protected by filtering the query to eliminate malicious syntax, which involves the employment of some tools in order to (a) scan the source code. In addition, the input fields should be restricted to the absolute minimum, typically anywhere from 7-12 characters, and validate any data, e.g., if a user inputs an age make sure the input is an integer with a maximum of 3 digits. VPN A virtual private network (VPN) is a service that offers a secure, reliable connection over a shared public infrastructure such as the Internet. Cisco defines a VPN as an encrypted connection between private networks over a public network. To date, there are three types of VPNs: Remote access Site-to-site Firewall-based Security Breach In spite of the most aggressive steps to protect computers from attacks, attackers sometimes get through. Any event that results in a violation of any of the confidentiality, integrity, or availability (CIA) security tenets is a security breach. Denial of Service Attacks Denial of service (DoS) attacks result in downtime or inability of a user to access a system. DoS attacks impact the availability of tenet of information systems security. A DoS attack is a coordinated attempt to deny service by occupying a computer to perform large amounts of unnecessary tasks. This excessive activity makes the system unavailable to perform legitimate operations Two common types of DoS attacks are as follows: Logic attacks\u2014Logic attacks use software flaws to crash or seriously hinder the performance of remote servers. You can prevent many of these attacks by installing the latest patches to keep your software up to date. Flooding attacks\u2014Flooding attacks overwhelm the victim computer\u2019s CPU, memory, or network resources by sending large numbers of useless requests to the machine. Most DoS attacks target weaknesses in the overall system architecture rather than a software bug or security flaw One popular technique for launching a packet flood is a SYN flood. One of the best defences against DoS attacks is to use intrusion prevention system (IPS) software or devices to detect and stop the attack. Distributed Denial of Service Attacks DDoS attacks differ from regular DoS attacks in their scope. In a DDoS attack, attackers hijack hundreds or even thousands of Internet computers, planting automated attack agents on those systems. The attacker then instructs the agents to bombard the target site with forged messages. This overloads the site and blocks legitimate traffic. The key here is strength in numbers. The attacker does more damage by distributing the attack across multiple computers. Wiretapping Although the term wiretapping is generally associated with voice telephone communications, attackers can also use wiretapping to intercept data communications. Attackers can tap telephone lines and data communication lines. Wiretapping can be active, where the attacker makes modifications to the line. It can also be passive, where an unauthorized user simply listens to the transmission without changing the contents. Passive intrusion can include the copying of data for a subsequent active attack. Two methods of active wiretapping are as follows: Between-the-lines wiretapping\u2014This type of wiretapping does not alter the messages sent by the legitimate user but inserts additional messages into the communication line when the legitimate user pauses. Piggyback-entry wiretapping\u2014This type of wiretapping intercepts and modifies the original message by breaking the communications line and routing the message to another computer that acts as a host. Backdoors Software developers sometimes include hidden access methods, called backdoors, in their programs. Backdoors give developers or support personnel easy access to a system without having to struggle with security controls. The problem is that backdoors don\u2019t always stay hidden. When an attacker discovers a backdoor, he or she can use it to bypass existing security controls such as passwords, encryption, and so on. Where legitimate users log on through front doors using a user ID and password, attackers use backdoors to bypass these normal access controls. Malicious Attacks Birthday Attack Once an attacker compromises a hashed password file, a birthday attack is performed. A birthday attack is a type of cryptographic attack that is used to make a brute-force attack of one-way hashes easier. It is a mathematical exploit that is based on the birthday problem in probability theory. Further Reading: https://www.sciencedirect.com/topics/computer-science/birthday-attack https://www.internetsecurity.tips/birthday-attack/ Brute-Force Password Attacks In a brute-force password attack, the attacker tries different passwords on a system until one of them is successful. Usually, the attacker employs a software program to try all possible combinations of a likely password, user ID, or security code until it locates a match. This occurs rapidly and in sequence. This type of attack is called a brute-force password attack because the attacker simply hammers away at the code. There is no skill or stealth involved\u2014just brute force that eventually breaks the code. Further Reading: https://owasp.org/www-community/attacks/Brute_force_attack https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks Dictionary Password Attacks A dictionary password attack is a simple attack that relies on users making poor password choices. In a dictionary password attack, a simple password-cracker program takes all the words from a dictionary file and attempts to log on by entering each dictionary entry as a password. Further Reading: https://capec.mitre.org/data/definitions/16.html Replay Attacks Replay attacks involve capturing data packets from a network and retransmitting them to produce an unauthorized effect. The receipt of duplicate, authenticated IP packets may disrupt service or have some other undesired consequence. Systems can be broken through replay attacks when attackers reuse old messages or parts of old messages to deceive system users. This helps intruders to gain information that allows unauthorized access into a system. Further reading: https://study.com/academy/lesson/replay-attack-definition-examples-prevention.html Man-in-the-Middle Attacks A man-in-the-middle attack takes advantage of the multihop process used by many types of networks. In this type of attack, an attacker intercepts messages between two parties before transferring them on to their intended destination. Web spoofing is a type of man-in-the-middle attack in which the user believes a secure session exists with a particular web server. In reality, the secure connection exists only with the attacker, not the webserver. The attacker then establishes a secure connection with the webserver, acting as an invisible go-between. The attacker passes traffic between the user and the webserver. In this way, the attacker can trick the user into supplying passwords, credit card information, and other private data. Further Reading: https://owasp.org/www-community/attacks/Man-in-the-middle_attack Masquerading In a masquerade attack, one user or computer pretends to be another user or computer. Masquerade attacks usually include one of the other forms of active attacks, such as IP address spoofing or replaying. Attackers can capture authentication sequences and then replay them later to log on again to an application or operating system. For example, an attacker might monitor usernames and passwords sent to a weak web application. The attacker could then use the intercepted credentials to log on to the web application and impersonate the user. Further Reading: https://dl.acm.org/doi/book/10.5555/2521792 https://ieeexplore.ieee.org/document/1653228 Eavesdropping Eavesdropping, or sniffing, occurs when a host sets its network interface on promiscuous mode and copies packets that pass by for later analysis. Promiscuous mode enables a network device to intercept and read each network packet(of course given some conditions) given sec, even if the packet\u2019s address doesn\u2019t match the network device. It is possible to attach hardware and software to monitor and analyze all packets on that segment of the transmission media without alerting any other users. Candidates for eavesdropping include satellite, wireless, mobile, and other transmission methods. Social Engineering Attackers often use a deception technique called social engineering to gain access to resources in an IT infrastructure. In nearly all cases, social engineering involves tricking authorized users into carrying out actions for unauthorized users. The success of social engineering attacks depends on the basic tendency of people to want to be helpful. Phreaking Phone phreaking, or simply phreaking, is a slang term that describes the activity of a subculture of people who study, experiment with, or explore telephone systems, telephone company equipment, and systems connected to public telephone networks. Phreaking is the art of exploiting bugs and glitches that exist in the telephone system. Phishing Phishing is a type of fraud in which an attacker attempts to trick the victim into providing private information such as credit card numbers, passwords, dates of birth, bank account numbers, automated teller machine (ATM) PINs, and Social Security numbers. Pharming Pharming is another type of attack that seeks to obtain personal or private financial information through domain spoofing. A pharming attack doesn\u2019t use messages to trick victims into visiting spoofed websites that appear legitimate, however. Instead, pharming \u201cpoisons\u201d a domain name on the domain name server (DNS), a process known as DNS poisoning. The result is that when a user enters the poisoned server\u2019s web address into his or her address bar, that user navigates to the attacker\u2019s site. The user\u2019s browser still shows the correct website, which makes pharming difficult to detect\u2014and therefore more serious. Where phishing attempts to scam people one at a time with an email or instant message, pharming enables scammers to target large groups of people at one time through domain spoofing.","title":"Threat, Attacks & Defences"},{"location":"level101/security/threats_attacks_defences/#part-iii-threats-attacks-defense","text":"","title":"Part III: Threats, Attacks & Defense"},{"location":"level101/security/threats_attacks_defences/#dns-protection","text":"","title":"DNS Protection"},{"location":"level101/security/threats_attacks_defences/#cache-poisoning-attack","text":"Since DNS responses are cached, a quick response can be provided for repeated translations. DNS negative queries are also cached, e.g., misspelt words, and all cached data periodically times out. Cache poisoning is an issue in what is known as pharming. This term is used to describe a hacker\u2019s attack in which a website\u2019s traffic is redirected to a bogus website by forging the DNS mapping. In this case, an attacker attempts to insert a fake address record for an Internet domain into the DNS. If the server accepts the fake record, the cache is poisoned and subsequent requests for the address of the domain are answered with the address of a server controlled by the attacker. As long as the fake entry is cached by the server, browsers or e-mail servers will automatically go to the address provided by the compromised DNS server. the typical time to live (TTL) for cached entries is a couple of hours, thereby permitting ample time for numerous users to be affected by the attack.","title":"Cache Poisoning Attack"},{"location":"level101/security/threats_attacks_defences/#dnssec-security-extension","text":"The long-term solution to these DNS problems is authentication. If a resolver cannot distinguish between valid and invalid data in a response, then add source authentication to verify that the data received in response is equal to the data entered by the zone administrator DNS Security Extensions (DNSSEC) protects against data spoofing and corruption and provides mechanisms to authenticate servers and requests, as well as mechanisms to establish authenticity and integrity. When authenticating DNS responses, each DNS zone signs its data using a private key. It is recommended that this signing be done offline and in advance. The query for a particular record returns the requested resource record set (RRset) and signature (RRSIG) of the requested resource record set. The resolver then authenticates the response using a public key, which is pre-configured or learned via a sequence of key records in the DNS hierarchy. The goals of DNSSEC are to provide authentication and integrity for DNS responses without confidentiality or DDoS protection.","title":"DNSSEC (Security Extension)"},{"location":"level101/security/threats_attacks_defences/#bgp","text":"BGP stands for border gateway protocol. It is a routing protocol that exchanges routing information among multiple Autonomous Systems (AS) An Autonomous System is a collection of routers or networks with the same network policy usually under single administrative control. BGP tells routers which hop to use in order to reach the destination network. BGP is used for both communicating information among routers in an AS (interior) and between multiple ASes (exterior).","title":"BGP"},{"location":"level101/security/threats_attacks_defences/#how-bgp-works","text":"BGP is responsible for finding a path to a destination router & the path it chooses should be the shortest and most reliable one. This decision is done through a protocol known as Link state. With the link-state protocol, each router broadcasts to all other routers in the network the state of its links and IP subnets. Each router then receives information from the other routers and constructs a complete topology view of the entire network. The next-hop routing table is based on this topology view. The link-state protocol uses a famous algorithm in the field of computer science, Dijkstra\u2019s shortest path algorithm: We start from our router considering the path cost to all our direct neighbours. The shortest path is then taken We then re-look at all our neighbours that we can reach and update our link state table with the cost information. We then continue taking the shortest path until every router has been visited.","title":"How BGP Works"},{"location":"level101/security/threats_attacks_defences/#bgp-vulnerabilities","text":"By corrupting the BGP routing table we are able to influence the direction traffic flows on the internet! This action is known as BGP hijacking. Injecting bogus route advertising information into the BGP-distributed routing database by malicious sources, accidentally or routers can disrupt Internet backbone operations. Blackholing traffic: Blackhole route is a network route, i.e., routing table entry, that goes nowhere and packets matching the route prefix are dropped or ignored. Blackhole routes can only be detected by monitoring the lost traffic. Blackhole routes are the best defence against many common viral attacks where the traffic is dropped from infected machines to/from command & control hosts. Infamous BGP Injection attack on Youtube Ex: In 2008, Pakistan decided to block YouTube by creating a BGP route that led into a black hole. Instead, this routing information got transmitted to a hong kong ISP and from there accidentally got propagated to the rest of the world meaning millions were routed through to this black hole and therefore unable to access YouTube. Potentially, the greatest risk to BGP occurs in a denial of service attack in which a router is flooded with more packets than it can handle. Network overload and router resource exhaustion happen when the network begins carrying an excessive number of BGP messages, overloading the router control processors, memory, routing table and reducing the bandwidth available for data traffic. Refer: https://medium.com/bugbountywriteup/bgp-the-weak-link-in-the-internet-what-is-bgp-and-how-do-hackers-exploit-it-d899a68ba5bb Router flapping is another type of attack. Route flapping refers to repetitive changes to the BGP routing table, often several times a minute. Withdrawing and re-advertising at a high-rate can cause a serious problem for routers since they propagate the announcements of routes. If these route flaps happen fast enough, e.g., 30 to 50 times per second, the router becomes overloaded, which eventually prevents convergence on valid routes. The potential impact for Internet users is a slowdown in message delivery, and in some cases, packets may not be delivered at all. BGP Security Border Gateway Protocol Security recommends the use of BGP peer authentication since it is one of the strongest mechanisms for preventing malicious activity. The authentication mechanisms are Internet Protocol Security (IPsec) or BGP MD5. Another method, known as prefix limits, can be used to avoid filling router tables. In this approach, routers should be configured to disable or terminate a BGP peering session, and issue warning messages to administrators when a neighbour sends in excess of a preset number of prefixes. IETF is currently working on improving this space","title":"BGP Vulnerabilities"},{"location":"level101/security/threats_attacks_defences/#web-based-attacks","text":"","title":"Web-Based Attacks"},{"location":"level101/security/threats_attacks_defences/#http-response-splitting-attacks","text":"HTTP response splitting attack may happen where the server script embeds user data in HTTP response headers without appropriate sanitation. This typically happens when the script embeds user data in the redirection URL of a redirection response (HTTP status code 3xx), or when the script embeds user data in a cookie value or name when the response sets a cookie. HTTP response splitting attacks can be used to perform web cache poisoning and cross-site scripting attacks. HTTP response splitting is the attacker\u2019s ability to send a single HTTP request that forces the webserver to form an output stream, which is then interpreted by the target as two HTTP responses instead of one response.","title":"HTTP Response Splitting Attacks"},{"location":"level101/security/threats_attacks_defences/#cross-site-request-forgery-csrf-or-xsrf","text":"A Cross-Site Request Forgery attack tricks the victim\u2019s browser into issuing a command to a vulnerable web application. Vulnerability is caused by browsers automatically including user authentication data, session ID, IP address, Windows domain credentials, etc. with each request. Attackers typically use CSRF to initiate transactions such as transfer funds, login/logout user, close account, access sensitive data, and change account details. The vulnerability is caused by web browsers that automatically include credentials with each request, even for requests caused by a form, script, or image on another site. CSRF can also be dynamically constructed as part of a payload for a cross-site scripting attack All sites relying on automatic credentials are vulnerable. Popular browsers cannot prevent cross-site request forgery. Logging out of high-value sites as soon as possible can mitigate CSRF risk. It is recommended that a high-value website must require a client to manually provide authentication data in the same HTTP request used to perform any operation with security implications. Limiting the lifetime of session cookies can also reduce the chance of being used by other malicious sites. OWASP recommends website developers include a required security token in HTTP requests associated with sensitive business functions in order to mitigate CSRF attacks","title":"Cross-Site Request Forgery (CSRF or XSRF)"},{"location":"level101/security/threats_attacks_defences/#cross-site-scripting-xss-attacks","text":"Cross-Site Scripting occurs when dynamically generated web pages display user input, such as login information, that is not properly validated, allowing an attacker to embed malicious scripts into the generated page and then execute the script on the machine of any user that views the site. If successful, Cross-Site Scripting vulnerabilities can be exploited to manipulate or steal cookies, create requests that can be mistaken for those of a valid user, compromise confidential information, or execute malicious code on end-user systems. Cross-Site Scripting (XSS or CSS) attacks involve the execution of malicious scripts on the victim\u2019s browser. The victim is simply a user\u2019s host and not the server. XSS results from a failure to validate user input by a web-based application.","title":"Cross-Site Scripting (XSS) Attacks"},{"location":"level101/security/threats_attacks_defences/#document-object-model-dom-xss-attacks","text":"The Document Object Model (DOM) based XSS does not require the webserver to receive the XSS payload for a successful attack. The attacker abuses the runtime by embedding their data on the client-side. An attacker can force the client (browser) to render the page with parts of the DOM controlled by the attacker. When the page is rendered and the data is processed by the page, typically by a client-side HTML-embedded script such as JavaScript, the page\u2019s code may insecurely embed the data in the page itself, thus delivering the cross-site scripting payload. There are several DOM objects which can serve as an attack vehicle for delivering malicious script to victims browser.","title":"Document Object Model (DOM) XSS Attacks"},{"location":"level101/security/threats_attacks_defences/#clickjacking","text":"The technique works by hiding malicious link/scripts under the cover of the content of a legitimate site. Buttons on a website actually contain invisible links, placed there by the attacker. So, an individual who clicks on an object they can visually see is actually being duped into visiting a malicious page or executing a malicious script. When mouseover is used together with clickjacking, the outcome is devastating. Facebook users have been hit by a clickjacking attack, which tricks people into \u201cliking\u201d a particular Facebook page, thus enabling the attack to spread since Memorial Day 2010. There is not yet effective defence against clickjacking, and disabling JavaScript is the only viable method","title":"Clickjacking"},{"location":"level101/security/threats_attacks_defences/#database-attacks-defenses","text":"","title":"DataBase Attacks & Defenses"},{"location":"level101/security/threats_attacks_defences/#sql-injection-attacks","text":"It exploits improper input validation in database queries. A successful exploit will allow attackers to access, modify, or delete information in the database. It permits attackers to steal sensitive information stored within the backend databases of affected websites, which may include such things as user credentials, email addresses, personal information, and credit card numbers SELECT USERNAME,PASSWORD from USERS where USERNAME='' AND PASSWORD=''; Here the username & password is the input provided by the user. Suppose an attacker gives the input as \" OR '1'='1'\" in both fields. Therefore the SQL query will look like: SELECT USERNAME,PASSWORD from USERS where USERNAME='' OR '1'='1' AND PASSOWRD='' OR '1'='1'; This query results in a true statement & the user gets logged in. This example depicts the bost basic type of SQL injection","title":"SQL injection Attacks"},{"location":"level101/security/threats_attacks_defences/#sql-injection-attack-defenses","text":"SQL injection can be protected by filtering the query to eliminate malicious syntax, which involves the employment of some tools in order to (a) scan the source code. In addition, the input fields should be restricted to the absolute minimum, typically anywhere from 7-12 characters, and validate any data, e.g., if a user inputs an age make sure the input is an integer with a maximum of 3 digits.","title":"SQL Injection Attack Defenses"},{"location":"level101/security/threats_attacks_defences/#vpn","text":"A virtual private network (VPN) is a service that offers a secure, reliable connection over a shared public infrastructure such as the Internet. Cisco defines a VPN as an encrypted connection between private networks over a public network. To date, there are three types of VPNs: Remote access Site-to-site Firewall-based","title":"VPN"},{"location":"level101/security/threats_attacks_defences/#security-breach","text":"In spite of the most aggressive steps to protect computers from attacks, attackers sometimes get through. Any event that results in a violation of any of the confidentiality, integrity, or availability (CIA) security tenets is a security breach.","title":"Security Breach"},{"location":"level101/security/threats_attacks_defences/#denial-of-service-attacks","text":"Denial of service (DoS) attacks result in downtime or inability of a user to access a system. DoS attacks impact the availability of tenet of information systems security. A DoS attack is a coordinated attempt to deny service by occupying a computer to perform large amounts of unnecessary tasks. This excessive activity makes the system unavailable to perform legitimate operations Two common types of DoS attacks are as follows: Logic attacks\u2014Logic attacks use software flaws to crash or seriously hinder the performance of remote servers. You can prevent many of these attacks by installing the latest patches to keep your software up to date. Flooding attacks\u2014Flooding attacks overwhelm the victim computer\u2019s CPU, memory, or network resources by sending large numbers of useless requests to the machine. Most DoS attacks target weaknesses in the overall system architecture rather than a software bug or security flaw One popular technique for launching a packet flood is a SYN flood. One of the best defences against DoS attacks is to use intrusion prevention system (IPS) software or devices to detect and stop the attack.","title":"Denial of Service Attacks"},{"location":"level101/security/threats_attacks_defences/#distributed-denial-of-service-attacks","text":"DDoS attacks differ from regular DoS attacks in their scope. In a DDoS attack, attackers hijack hundreds or even thousands of Internet computers, planting automated attack agents on those systems. The attacker then instructs the agents to bombard the target site with forged messages. This overloads the site and blocks legitimate traffic. The key here is strength in numbers. The attacker does more damage by distributing the attack across multiple computers.","title":"Distributed Denial of Service Attacks"},{"location":"level101/security/threats_attacks_defences/#wiretapping","text":"Although the term wiretapping is generally associated with voice telephone communications, attackers can also use wiretapping to intercept data communications. Attackers can tap telephone lines and data communication lines. Wiretapping can be active, where the attacker makes modifications to the line. It can also be passive, where an unauthorized user simply listens to the transmission without changing the contents. Passive intrusion can include the copying of data for a subsequent active attack. Two methods of active wiretapping are as follows: Between-the-lines wiretapping\u2014This type of wiretapping does not alter the messages sent by the legitimate user but inserts additional messages into the communication line when the legitimate user pauses. Piggyback-entry wiretapping\u2014This type of wiretapping intercepts and modifies the original message by breaking the communications line and routing the message to another computer that acts as a host.","title":"Wiretapping"},{"location":"level101/security/threats_attacks_defences/#backdoors","text":"Software developers sometimes include hidden access methods, called backdoors, in their programs. Backdoors give developers or support personnel easy access to a system without having to struggle with security controls. The problem is that backdoors don\u2019t always stay hidden. When an attacker discovers a backdoor, he or she can use it to bypass existing security controls such as passwords, encryption, and so on. Where legitimate users log on through front doors using a user ID and password, attackers use backdoors to bypass these normal access controls.","title":"Backdoors"},{"location":"level101/security/threats_attacks_defences/#malicious-attacks","text":"","title":"Malicious Attacks"},{"location":"level101/security/threats_attacks_defences/#birthday-attack","text":"Once an attacker compromises a hashed password file, a birthday attack is performed. A birthday attack is a type of cryptographic attack that is used to make a brute-force attack of one-way hashes easier. It is a mathematical exploit that is based on the birthday problem in probability theory. Further Reading: https://www.sciencedirect.com/topics/computer-science/birthday-attack https://www.internetsecurity.tips/birthday-attack/","title":"Birthday Attack"},{"location":"level101/security/threats_attacks_defences/#brute-force-password-attacks","text":"In a brute-force password attack, the attacker tries different passwords on a system until one of them is successful. Usually, the attacker employs a software program to try all possible combinations of a likely password, user ID, or security code until it locates a match. This occurs rapidly and in sequence. This type of attack is called a brute-force password attack because the attacker simply hammers away at the code. There is no skill or stealth involved\u2014just brute force that eventually breaks the code. Further Reading: https://owasp.org/www-community/attacks/Brute_force_attack https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks","title":"Brute-Force Password Attacks"},{"location":"level101/security/threats_attacks_defences/#dictionary-password-attacks","text":"A dictionary password attack is a simple attack that relies on users making poor password choices. In a dictionary password attack, a simple password-cracker program takes all the words from a dictionary file and attempts to log on by entering each dictionary entry as a password. Further Reading: https://capec.mitre.org/data/definitions/16.html","title":"Dictionary Password Attacks"},{"location":"level101/security/threats_attacks_defences/#replay-attacks","text":"Replay attacks involve capturing data packets from a network and retransmitting them to produce an unauthorized effect. The receipt of duplicate, authenticated IP packets may disrupt service or have some other undesired consequence. Systems can be broken through replay attacks when attackers reuse old messages or parts of old messages to deceive system users. This helps intruders to gain information that allows unauthorized access into a system. Further reading: https://study.com/academy/lesson/replay-attack-definition-examples-prevention.html","title":"Replay Attacks"},{"location":"level101/security/threats_attacks_defences/#man-in-the-middle-attacks","text":"A man-in-the-middle attack takes advantage of the multihop process used by many types of networks. In this type of attack, an attacker intercepts messages between two parties before transferring them on to their intended destination. Web spoofing is a type of man-in-the-middle attack in which the user believes a secure session exists with a particular web server. In reality, the secure connection exists only with the attacker, not the webserver. The attacker then establishes a secure connection with the webserver, acting as an invisible go-between. The attacker passes traffic between the user and the webserver. In this way, the attacker can trick the user into supplying passwords, credit card information, and other private data. Further Reading: https://owasp.org/www-community/attacks/Man-in-the-middle_attack","title":"Man-in-the-Middle Attacks"},{"location":"level101/security/threats_attacks_defences/#masquerading","text":"In a masquerade attack, one user or computer pretends to be another user or computer. Masquerade attacks usually include one of the other forms of active attacks, such as IP address spoofing or replaying. Attackers can capture authentication sequences and then replay them later to log on again to an application or operating system. For example, an attacker might monitor usernames and passwords sent to a weak web application. The attacker could then use the intercepted credentials to log on to the web application and impersonate the user. Further Reading: https://dl.acm.org/doi/book/10.5555/2521792 https://ieeexplore.ieee.org/document/1653228","title":"Masquerading"},{"location":"level101/security/threats_attacks_defences/#eavesdropping","text":"Eavesdropping, or sniffing, occurs when a host sets its network interface on promiscuous mode and copies packets that pass by for later analysis. Promiscuous mode enables a network device to intercept and read each network packet(of course given some conditions) given sec, even if the packet\u2019s address doesn\u2019t match the network device. It is possible to attach hardware and software to monitor and analyze all packets on that segment of the transmission media without alerting any other users. Candidates for eavesdropping include satellite, wireless, mobile, and other transmission methods.","title":"Eavesdropping"},{"location":"level101/security/threats_attacks_defences/#social-engineering","text":"Attackers often use a deception technique called social engineering to gain access to resources in an IT infrastructure. In nearly all cases, social engineering involves tricking authorized users into carrying out actions for unauthorized users. The success of social engineering attacks depends on the basic tendency of people to want to be helpful.","title":"Social Engineering"},{"location":"level101/security/threats_attacks_defences/#phreaking","text":"Phone phreaking, or simply phreaking, is a slang term that describes the activity of a subculture of people who study, experiment with, or explore telephone systems, telephone company equipment, and systems connected to public telephone networks. Phreaking is the art of exploiting bugs and glitches that exist in the telephone system.","title":"Phreaking"},{"location":"level101/security/threats_attacks_defences/#phishing","text":"Phishing is a type of fraud in which an attacker attempts to trick the victim into providing private information such as credit card numbers, passwords, dates of birth, bank account numbers, automated teller machine (ATM) PINs, and Social Security numbers.","title":"Phishing"},{"location":"level101/security/threats_attacks_defences/#pharming","text":"Pharming is another type of attack that seeks to obtain personal or private financial information through domain spoofing. A pharming attack doesn\u2019t use messages to trick victims into visiting spoofed websites that appear legitimate, however. Instead, pharming \u201cpoisons\u201d a domain name on the domain name server (DNS), a process known as DNS poisoning. The result is that when a user enters the poisoned server\u2019s web address into his or her address bar, that user navigates to the attacker\u2019s site. The user\u2019s browser still shows the correct website, which makes pharming difficult to detect\u2014and therefore more serious. Where phishing attempts to scam people one at a time with an email or instant message, pharming enables scammers to target large groups of people at one time through domain spoofing.","title":"Pharming"},{"location":"level101/security/writing_secure_code/","text":"PART IV: Writing Secure Code & More The first and most important step in reducing security and reliability issues is to educate developers. However, even the best-trained engineers make mistakes, security experts can write insecure code and SREs can miss reliability issues. It\u2019s difficult to keep the many considerations and tradeoffs involved in building secure and reliable systems in mind simultaneously, especially if you\u2019re also responsible for producing software. Use frameworks to enforce security and reliability while writing code A better approach is to handle security and reliability in common frameworks, languages, and libraries. Ideally, libraries only expose an interface that makes writing code with common classes of security vulnerabilities impossible. Multiple applications can use each library or framework. When domain experts fix an issue, they remove it from all the applications the framework supports, allowing this engineering approach to scale better. Common Security Vulnerabilities In large codebases, a handful of classes account for the majority of security vulnerabilities, despite ongoing efforts to educate developers and introduce code review. OWASP and SANS publish lists of common vulnerability classes Write Simple Code Try to keep your code clean and simple. Avoid Multi-Level Nesting Multilevel nesting is a common anti-pattern that can lead to simple mistakes. If the error is in the most common code path, it will likely be captured by the unit tests. However, unit tests don\u2019t always check error handling paths in multilevel nested code. The error might result in decreased reliability (for example, if the service crashes when it mishandles an error) or a security vulnerability (like a mishandled authorization check error). Eliminate YAGNI Smells Sometimes developers overengineer solutions by adding functionality that may be useful in the future, \u201cjust in case.\u201d This goes against the YAGNI (You Aren\u2019t Gonna Need It) principle, which recommends implementing only the code that you need. YAGNI code adds unnecessary complexity because it needs to be documented, tested, and maintained. To summarize, avoiding YAGNI code leads to improved reliability, and simpler code leads to fewer security bugs, fewer opportunities to make mistakes, and less developer time spent maintaining unused code. Repay Technical Debt It is a common practice for developers to mark places that require further attention with TODO or FIXME annotations. In the short term, this habit can accelerate the delivery velocity for the most critical functionality, and allow a team to meet early deadlines\u2014but it also incurs technical debt. Still, it\u2019s not necessarily a bad practice, as long as you have a clear process (and allocate time) for repaying such debt. Refactoring Refactoring is the most effective way to keep a codebase clean and simple. Even a healthy codebase occasionally needs to be Regardless of the reasons behind refactoring, you should always follow one golden rule: never mix refactoring and functional changes in a single commit to the code repository. Refactoring changes are typically significant and can be difficult to understand. If a commit also includes functional changes, there\u2019s a higher risk that an author or reviewer might overlook bugs. Unit Testing Unit testing can increase system security and reliability by pinpointing a wide range of bugs in individual software components before a release. This technique involves breaking software components into smaller, self-contained \u201cunits\u201d that have no external dependencies, and then testing each unit. Fuzz Testing Fuzz testing is a technique that complements the previously mentioned testing techniques. Fuzzing involves using a fuzzing engine to generate a large number of candidate inputs that are then passed through a fuzz driver to the fuzz target. The fuzzer then analyzes how the system handles the input. Complex inputs handled by all kinds of software are popular targets for fuzzing - for example, file parsers, compression algorithms, network protocol implementation and audio codec. Integration Testing Integration testing moves beyond individual units and abstractions, replacing fake or stubbed-out implementations of abstractions like databases or network services with real implementations. As a result, integration tests exercise more complete code paths. Because you must initialize and configure these other dependencies, integration testing may be slower and flakier than unit testing\u2014to execute the test, this approach incorporates real-world variables like network latency as services communicate end-to-end. As you move from testing individual low-level units of code to testing how they interact when composed together, the net result is a higher degree of confidence that the system is behaving as expected. Last But not the least Code Reviews Rely on Automation Don\u2019t check in Secrets Verifiable Builds","title":"Writing Secure code"},{"location":"level101/security/writing_secure_code/#part-iv-writing-secure-code-more","text":"The first and most important step in reducing security and reliability issues is to educate developers. However, even the best-trained engineers make mistakes, security experts can write insecure code and SREs can miss reliability issues. It\u2019s difficult to keep the many considerations and tradeoffs involved in building secure and reliable systems in mind simultaneously, especially if you\u2019re also responsible for producing software.","title":"PART IV: Writing Secure Code & More"},{"location":"level101/security/writing_secure_code/#use-frameworks-to-enforce-security-and-reliability-while-writing-code","text":"A better approach is to handle security and reliability in common frameworks, languages, and libraries. Ideally, libraries only expose an interface that makes writing code with common classes of security vulnerabilities impossible. Multiple applications can use each library or framework. When domain experts fix an issue, they remove it from all the applications the framework supports, allowing this engineering approach to scale better.","title":"Use frameworks to enforce security and reliability while writing code"},{"location":"level101/security/writing_secure_code/#common-security-vulnerabilities","text":"In large codebases, a handful of classes account for the majority of security vulnerabilities, despite ongoing efforts to educate developers and introduce code review. OWASP and SANS publish lists of common vulnerability classes","title":"Common Security Vulnerabilities"},{"location":"level101/security/writing_secure_code/#write-simple-code","text":"Try to keep your code clean and simple.","title":"Write Simple Code"},{"location":"level101/security/writing_secure_code/#avoid-multi-level-nesting","text":"Multilevel nesting is a common anti-pattern that can lead to simple mistakes. If the error is in the most common code path, it will likely be captured by the unit tests. However, unit tests don\u2019t always check error handling paths in multilevel nested code. The error might result in decreased reliability (for example, if the service crashes when it mishandles an error) or a security vulnerability (like a mishandled authorization check error).","title":"Avoid Multi-Level Nesting"},{"location":"level101/security/writing_secure_code/#eliminate-yagni-smells","text":"Sometimes developers overengineer solutions by adding functionality that may be useful in the future, \u201cjust in case.\u201d This goes against the YAGNI (You Aren\u2019t Gonna Need It) principle, which recommends implementing only the code that you need. YAGNI code adds unnecessary complexity because it needs to be documented, tested, and maintained. To summarize, avoiding YAGNI code leads to improved reliability, and simpler code leads to fewer security bugs, fewer opportunities to make mistakes, and less developer time spent maintaining unused code.","title":"Eliminate YAGNI Smells"},{"location":"level101/security/writing_secure_code/#repay-technical-debt","text":"It is a common practice for developers to mark places that require further attention with TODO or FIXME annotations. In the short term, this habit can accelerate the delivery velocity for the most critical functionality, and allow a team to meet early deadlines\u2014but it also incurs technical debt. Still, it\u2019s not necessarily a bad practice, as long as you have a clear process (and allocate time) for repaying such debt.","title":"Repay Technical Debt"},{"location":"level101/security/writing_secure_code/#refactoring","text":"Refactoring is the most effective way to keep a codebase clean and simple. Even a healthy codebase occasionally needs to be Regardless of the reasons behind refactoring, you should always follow one golden rule: never mix refactoring and functional changes in a single commit to the code repository. Refactoring changes are typically significant and can be difficult to understand. If a commit also includes functional changes, there\u2019s a higher risk that an author or reviewer might overlook bugs.","title":"Refactoring"},{"location":"level101/security/writing_secure_code/#unit-testing","text":"Unit testing can increase system security and reliability by pinpointing a wide range of bugs in individual software components before a release. This technique involves breaking software components into smaller, self-contained \u201cunits\u201d that have no external dependencies, and then testing each unit.","title":"Unit Testing"},{"location":"level101/security/writing_secure_code/#fuzz-testing","text":"Fuzz testing is a technique that complements the previously mentioned testing techniques. Fuzzing involves using a fuzzing engine to generate a large number of candidate inputs that are then passed through a fuzz driver to the fuzz target. The fuzzer then analyzes how the system handles the input. Complex inputs handled by all kinds of software are popular targets for fuzzing - for example, file parsers, compression algorithms, network protocol implementation and audio codec.","title":"Fuzz Testing"},{"location":"level101/security/writing_secure_code/#integration-testing","text":"Integration testing moves beyond individual units and abstractions, replacing fake or stubbed-out implementations of abstractions like databases or network services with real implementations. As a result, integration tests exercise more complete code paths. Because you must initialize and configure these other dependencies, integration testing may be slower and flakier than unit testing\u2014to execute the test, this approach incorporates real-world variables like network latency as services communicate end-to-end. As you move from testing individual low-level units of code to testing how they interact when composed together, the net result is a higher degree of confidence that the system is behaving as expected.","title":"Integration Testing"},{"location":"level101/security/writing_secure_code/#last-but-not-the-least","text":"Code Reviews Rely on Automation Don\u2019t check in Secrets Verifiable Builds","title":"Last But not the least"},{"location":"level101/systems_design/availability/","text":"HA - Availability - Common \u201cNines\u201d Availability is generally expressed as \u201cNines\u201d, common \u2018Nines\u2019 are listed below. Availability % Downtime per year Downtime per month Downtime per week Downtime per day 99%(Two Nines) 3.65 days 7.31 hours 1.68 hours 14.40 minutes 99.5%(Two and a half Nines) 1.83 days 3.65 hours 50.40 minutes 7.20 minutes 99.9%(Three Nines) 8.77 hours 43.83 minutes 10.08 minutes 1.44 minutes 99.95%(Three and a half Nines) 4.38 hours 21.92 minutes 5.04 minutes 43.20 seconds 99.99%(Four Nines) 52.60 minutes 4.38 minutes 1.01 minutes 8.64 seconds 99.995%(Four and a half Nines) 26.30 minutes 2.19 minutes 30.24 seconds 4.32 seconds 99.999%(Five Nines) 5.26 minutes 26.30 seconds 6.05 seconds 864.0 ms Refer https://en.wikipedia.org/wiki/High_availability#Percentage_calculation HA - Availability Serial Components A System with components is operating in the series If the failure of a part leads to the combination becoming inoperable. For example, if LB in our architecture fails, all access to app tiers will fail. LB and app tiers are connected serially. The combined availability of the system is the product of individual components availability A = Ax x Ay x \u2026.. Refer http://www.eventhelix.com/RealtimeMantra/FaultHandling/system_reliability_availability.htm HA - Availability Parallel Components A System with components is operating in parallel If the failure of a part leads to the other part taking over the operations of the failed part. If we have more than one LB and if the rest of the LBs can take over the traffic during one LB failure then LBs are operating in parallel The combined availability of the system is A = 1 - ( (1-Ax) x (1-Ax) x \u2026.. ) Refer http://www.eventhelix.com/RealtimeMantra/FaultHandling/system_reliability_availability.htm HA - Core Principles Elimination of single points of failure (SPOF) This means adding redundancy to the system so that the failure of a component does not mean failure of the entire system. Reliable crossover In redundant systems, the crossover point itself tends to become a single point of failure. Reliable systems must provide for reliable crossover. Detection of failures as they occur If the two principles above are observed, then a user may never see a failure Refer https://en.wikipedia.org/wiki/High_availability#Principles HA - SPOF WHAT: Never implement and always eliminate single points of failure. WHEN TO USE: During architecture reviews and new designs. HOW TO USE: Identify single instances on architectural diagrams. Strive for active/active configurations. At the very least we should have a standby to take control when active instances fail. WHY: Maximize availability through multiple instances. KEY TAKEAWAYS: Strive for active/active rather than active/passive solutions. Use load balancers to balance traffic across instances of a service. Use control services with active/passive instances for patterns that require singletons. HA - Reliable Crossover WHAT: Ensure when system components failover they do so reliably. WHEN TO USE: During architecture reviews, failure modeling, and designs. HOW TO USE: Identify how available a system is during the crossover and ensure it is within acceptable limits. WHY: Maximize availability and ensure data handling semantics are preserved. KEY TAKEAWAYS: Strive for active/active rather than active/passive solutions, they have a lesser risk of cross over being unreliable. Use LB and the right load balancing methods to ensure reliable failover. Model and build your data systems to ensure data is correctly handled when crossover happens. Generally, DB systems follow active/passive semantics for writes. Masters accept writes and when the master goes down, the follower is promoted to master(active from being passive) to accept writes. We have to be careful here that the cutover never introduces more than one master. This problem is called a split brain. Applications in SRE role SRE works on deciding an acceptable SLA and make sure the system is available to achieve the SLA SRE is involved in architecture design right from building the data center to make sure the site is not affected by a network switch, hardware, power, or software failures SRE also run mock drills of failures to see how the system behaves in uncharted territory and comes up with a plan to improve availability if there are misses. https://engineering.linkedin.com/blog/2017/11/resilience-engineering-at-linkedin-with-project-waterbear Post our understanding about HA, our architecture diagram looks something like this below","title":"Availability"},{"location":"level101/systems_design/availability/#ha-availability-common-nines","text":"Availability is generally expressed as \u201cNines\u201d, common \u2018Nines\u2019 are listed below. Availability % Downtime per year Downtime per month Downtime per week Downtime per day 99%(Two Nines) 3.65 days 7.31 hours 1.68 hours 14.40 minutes 99.5%(Two and a half Nines) 1.83 days 3.65 hours 50.40 minutes 7.20 minutes 99.9%(Three Nines) 8.77 hours 43.83 minutes 10.08 minutes 1.44 minutes 99.95%(Three and a half Nines) 4.38 hours 21.92 minutes 5.04 minutes 43.20 seconds 99.99%(Four Nines) 52.60 minutes 4.38 minutes 1.01 minutes 8.64 seconds 99.995%(Four and a half Nines) 26.30 minutes 2.19 minutes 30.24 seconds 4.32 seconds 99.999%(Five Nines) 5.26 minutes 26.30 seconds 6.05 seconds 864.0 ms","title":"HA - Availability - Common \u201cNines\u201d"},{"location":"level101/systems_design/availability/#refer","text":"https://en.wikipedia.org/wiki/High_availability#Percentage_calculation","title":"Refer"},{"location":"level101/systems_design/availability/#ha-availability-serial-components","text":"A System with components is operating in the series If the failure of a part leads to the combination becoming inoperable. For example, if LB in our architecture fails, all access to app tiers will fail. LB and app tiers are connected serially. The combined availability of the system is the product of individual components availability A = Ax x Ay x \u2026..","title":"HA - Availability Serial Components"},{"location":"level101/systems_design/availability/#refer_1","text":"http://www.eventhelix.com/RealtimeMantra/FaultHandling/system_reliability_availability.htm","title":"Refer"},{"location":"level101/systems_design/availability/#ha-availability-parallel-components","text":"A System with components is operating in parallel If the failure of a part leads to the other part taking over the operations of the failed part. If we have more than one LB and if the rest of the LBs can take over the traffic during one LB failure then LBs are operating in parallel The combined availability of the system is A = 1 - ( (1-Ax) x (1-Ax) x \u2026.. )","title":"HA - Availability Parallel Components"},{"location":"level101/systems_design/availability/#refer_2","text":"http://www.eventhelix.com/RealtimeMantra/FaultHandling/system_reliability_availability.htm","title":"Refer"},{"location":"level101/systems_design/availability/#ha-core-principles","text":"Elimination of single points of failure (SPOF) This means adding redundancy to the system so that the failure of a component does not mean failure of the entire system. Reliable crossover In redundant systems, the crossover point itself tends to become a single point of failure. Reliable systems must provide for reliable crossover. Detection of failures as they occur If the two principles above are observed, then a user may never see a failure","title":"HA - Core Principles"},{"location":"level101/systems_design/availability/#refer_3","text":"https://en.wikipedia.org/wiki/High_availability#Principles","title":"Refer"},{"location":"level101/systems_design/availability/#ha-spof","text":"WHAT: Never implement and always eliminate single points of failure. WHEN TO USE: During architecture reviews and new designs. HOW TO USE: Identify single instances on architectural diagrams. Strive for active/active configurations. At the very least we should have a standby to take control when active instances fail. WHY: Maximize availability through multiple instances. KEY TAKEAWAYS: Strive for active/active rather than active/passive solutions. Use load balancers to balance traffic across instances of a service. Use control services with active/passive instances for patterns that require singletons.","title":"HA - SPOF"},{"location":"level101/systems_design/availability/#ha-reliable-crossover","text":"WHAT: Ensure when system components failover they do so reliably. WHEN TO USE: During architecture reviews, failure modeling, and designs. HOW TO USE: Identify how available a system is during the crossover and ensure it is within acceptable limits. WHY: Maximize availability and ensure data handling semantics are preserved. KEY TAKEAWAYS: Strive for active/active rather than active/passive solutions, they have a lesser risk of cross over being unreliable. Use LB and the right load balancing methods to ensure reliable failover. Model and build your data systems to ensure data is correctly handled when crossover happens. Generally, DB systems follow active/passive semantics for writes. Masters accept writes and when the master goes down, the follower is promoted to master(active from being passive) to accept writes. We have to be careful here that the cutover never introduces more than one master. This problem is called a split brain.","title":"HA - Reliable Crossover"},{"location":"level101/systems_design/availability/#applications-in-sre-role","text":"SRE works on deciding an acceptable SLA and make sure the system is available to achieve the SLA SRE is involved in architecture design right from building the data center to make sure the site is not affected by a network switch, hardware, power, or software failures SRE also run mock drills of failures to see how the system behaves in uncharted territory and comes up with a plan to improve availability if there are misses. https://engineering.linkedin.com/blog/2017/11/resilience-engineering-at-linkedin-with-project-waterbear Post our understanding about HA, our architecture diagram looks something like this below","title":"Applications in SRE role"},{"location":"level101/systems_design/conclusion/","text":"Conclusion Armed with these principles, we hope the course will give a fresh perspective to design software systems. It might be over-engineering to get all this on day zero. But some are really important from day 0 like eliminating single points of failure, making scalable services by just increasing replicas. As a bottleneck is reached, we can split code by services, shard data to scale. As the organization matures, bringing in chaos engineering to measure how systems react to failure will help in designing robust software systems.","title":"Conclusion"},{"location":"level101/systems_design/conclusion/#conclusion","text":"Armed with these principles, we hope the course will give a fresh perspective to design software systems. It might be over-engineering to get all this on day zero. But some are really important from day 0 like eliminating single points of failure, making scalable services by just increasing replicas. As a bottleneck is reached, we can split code by services, shard data to scale. As the organization matures, bringing in chaos engineering to measure how systems react to failure will help in designing robust software systems.","title":"Conclusion"},{"location":"level101/systems_design/fault-tolerance/","text":"Fault Tolerance Failures are not avoidable in any system and will happen all the time, hence we need to build systems that can tolerate failures or recover from them. In systems, failure is the norm rather than the exception. \"Anything that can go wrong will go wrong\u201d -- Murphy\u2019s Law \u201cComplex systems contain changing mixtures of failures latent within them\u201d -- How Complex Systems Fail. Fault Tolerance - Failure Metrics Common failure metrics that get measured and tracked for any system. Mean time to repair (MTTR): The average time to repair and restore a failed system. Mean time between failures (MTBF): The average operational time between one device failure or system breakdown and the next. Mean time to failure (MTTF): The average time a device or system is expected to function before it fails. Mean time to detect (MTTD): The average time between the onset of a problem and when the organization detects it. Mean time to investigate (MTTI): The average time between the detection of an incident and when the organization begins to investigate its cause and solution. Mean time to restore service (MTRS): The average elapsed time from the detection of an incident until the affected system or component is again available to users. Mean time between system incidents (MTBSI): The average elapsed time between the detection of two consecutive incidents. MTBSI can be calculated by adding MTBF and MTRS (MTBSI = MTBF + MTRS). Failure rate: Another reliability metric, which measures the frequency with which a component or system fails. It is expressed as a number of failures over a unit of time. Refer https://www.splunk.com/en_us/data-insider/what-is-mean-time-to-repair.html Fault Tolerance - Fault Isolation Terms Systems should have a short circuit. Say in our content sharing system, if \u201cNotifications\u201d is not working, the site should gracefully handle that failure by removing the functionality instead of taking the whole site down. Swimlane is one of the commonly used fault isolation methodologies. Swimlane adds a barrier to the service from other services so that failure on either of them won\u2019t affect the other. Say we roll out a new feature \u2018Advertisement\u2019 in our content sharing app. We can have two architectures If Ads are generated on the fly synchronously during each Newsfeed request, the faults in the Ads feature get propagated to the Newsfeed feature. Instead if we swimlane the \u201cGeneration of Ads\u201d service and use a shared storage to populate Newsfeed App, Ads failures won\u2019t cascade to Newsfeed, and worst case if Ads don\u2019t meet SLA , we can have Newsfeed without Ads. Let's take another example, we have come up with a new model for our Content sharing App. Here we roll out an enterprise content sharing App where enterprises pay for the service and the content should never be shared outside the enterprise. Swimlane Principles Principle 1: Nothing is shared (also known as \u201cshare as little as possible\u201d). The less that is shared within a swim lane, the more fault isolative the swim lane becomes. (as shown in Enterprise use-case) Principle 2: Nothing crosses a swim lane boundary. Synchronous (defined by expecting a request\u2014not the transfer protocol) communication never crosses a swim lane boundary; if it does, the boundary is drawn incorrectly. (as shown in Ads feature) Swimlane Approaches Approach 1: Swim lane the money-maker. Never allow your cash register to be compromised by other systems. (Tier 1 vs Tier 2 in enterprise use case) Approach 2: Swim lane the biggest sources of incidents. Identify the recurring causes of pain and isolate them. (if Ads feature is in code yellow, swim laning it is the best option) Approach 3: Swim lane natural barriers. Customer boundaries make good swim lanes. (Public vs Enterprise customers) Refer https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch21.html#ch21 Applications in SRE role Work with the DC tech or cloud team to distribute infrastructure such that its immune to switch or power failures by creating fault zones within a Data Center https://docs.microsoft.com/en-us/azure/virtual-machines/manage-availability#use-availability-zones-to-protect-from-datacenter-level-failures Work with the partners and design interaction between services such that one service breakdown is not amplified in a cascading fashion to all upstreams","title":"Fault Tolerance"},{"location":"level101/systems_design/fault-tolerance/#fault-tolerance","text":"Failures are not avoidable in any system and will happen all the time, hence we need to build systems that can tolerate failures or recover from them. In systems, failure is the norm rather than the exception. \"Anything that can go wrong will go wrong\u201d -- Murphy\u2019s Law \u201cComplex systems contain changing mixtures of failures latent within them\u201d -- How Complex Systems Fail.","title":"Fault Tolerance"},{"location":"level101/systems_design/fault-tolerance/#fault-tolerance-failure-metrics","text":"Common failure metrics that get measured and tracked for any system. Mean time to repair (MTTR): The average time to repair and restore a failed system. Mean time between failures (MTBF): The average operational time between one device failure or system breakdown and the next. Mean time to failure (MTTF): The average time a device or system is expected to function before it fails. Mean time to detect (MTTD): The average time between the onset of a problem and when the organization detects it. Mean time to investigate (MTTI): The average time between the detection of an incident and when the organization begins to investigate its cause and solution. Mean time to restore service (MTRS): The average elapsed time from the detection of an incident until the affected system or component is again available to users. Mean time between system incidents (MTBSI): The average elapsed time between the detection of two consecutive incidents. MTBSI can be calculated by adding MTBF and MTRS (MTBSI = MTBF + MTRS). Failure rate: Another reliability metric, which measures the frequency with which a component or system fails. It is expressed as a number of failures over a unit of time.","title":"Fault Tolerance - Failure Metrics"},{"location":"level101/systems_design/fault-tolerance/#refer","text":"https://www.splunk.com/en_us/data-insider/what-is-mean-time-to-repair.html","title":"Refer"},{"location":"level101/systems_design/fault-tolerance/#fault-tolerance-fault-isolation-terms","text":"Systems should have a short circuit. Say in our content sharing system, if \u201cNotifications\u201d is not working, the site should gracefully handle that failure by removing the functionality instead of taking the whole site down. Swimlane is one of the commonly used fault isolation methodologies. Swimlane adds a barrier to the service from other services so that failure on either of them won\u2019t affect the other. Say we roll out a new feature \u2018Advertisement\u2019 in our content sharing app. We can have two architectures If Ads are generated on the fly synchronously during each Newsfeed request, the faults in the Ads feature get propagated to the Newsfeed feature. Instead if we swimlane the \u201cGeneration of Ads\u201d service and use a shared storage to populate Newsfeed App, Ads failures won\u2019t cascade to Newsfeed, and worst case if Ads don\u2019t meet SLA , we can have Newsfeed without Ads. Let's take another example, we have come up with a new model for our Content sharing App. Here we roll out an enterprise content sharing App where enterprises pay for the service and the content should never be shared outside the enterprise.","title":"Fault Tolerance - Fault Isolation Terms"},{"location":"level101/systems_design/fault-tolerance/#swimlane-principles","text":"Principle 1: Nothing is shared (also known as \u201cshare as little as possible\u201d). The less that is shared within a swim lane, the more fault isolative the swim lane becomes. (as shown in Enterprise use-case) Principle 2: Nothing crosses a swim lane boundary. Synchronous (defined by expecting a request\u2014not the transfer protocol) communication never crosses a swim lane boundary; if it does, the boundary is drawn incorrectly. (as shown in Ads feature)","title":"Swimlane Principles"},{"location":"level101/systems_design/fault-tolerance/#swimlane-approaches","text":"Approach 1: Swim lane the money-maker. Never allow your cash register to be compromised by other systems. (Tier 1 vs Tier 2 in enterprise use case) Approach 2: Swim lane the biggest sources of incidents. Identify the recurring causes of pain and isolate them. (if Ads feature is in code yellow, swim laning it is the best option) Approach 3: Swim lane natural barriers. Customer boundaries make good swim lanes. (Public vs Enterprise customers)","title":"Swimlane Approaches"},{"location":"level101/systems_design/fault-tolerance/#refer_1","text":"https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch21.html#ch21","title":"Refer"},{"location":"level101/systems_design/fault-tolerance/#applications-in-sre-role","text":"Work with the DC tech or cloud team to distribute infrastructure such that its immune to switch or power failures by creating fault zones within a Data Center https://docs.microsoft.com/en-us/azure/virtual-machines/manage-availability#use-availability-zones-to-protect-from-datacenter-level-failures Work with the partners and design interaction between services such that one service breakdown is not amplified in a cascading fashion to all upstreams","title":"Applications in SRE role"},{"location":"level101/systems_design/intro/","text":"Systems Design Prerequisites Fundamentals of common software system components: Linux Basics Linux Networking Databases RDBMS NoSQL Concepts What to expect from this course Thinking about and designing for scalability, availability, and reliability of large scale software systems. What is not covered under this course Individual software components\u2019 scalability and reliability concerns like e.g. Databases, while the same scalability principles and thinking can be applied, these individual components have their own specific nuances when scaling them and thinking about their reliability. More light will be shed on concepts rather than on setting up and configuring components like Loadbalancers to achieve scalability, availability, and reliability of systems Course Contents Introduction Scalability High Availability Fault Tolerance Introduction So, how do you go about learning to design a system? \u201d Like most great questions, it showed a level of naivety that was breathtaking. The only short answer I could give was, essentially, that you learned how to design a system by designing systems and finding out what works and what doesn\u2019t work.\u201d Jim Waldo, Sun Microsystems, On System Design As software and hardware systems have multiple moving parts, we need to think about how those parts will grow, their failure modes, their inter-dependencies, how it will impact the users and the business. There is no one-shot method or way to learn or do system design, we only learn to design systems by designing and iterating on them. This course will be a starter to make one think about scalability, availability, and fault tolerance during systems design. Backstory Let\u2019s design a simple content sharing application where users can share photos, media in our application which can be liked by their friends. Let\u2019s start with a simple design of the application and evolve it as we learn system design concepts","title":"Introduction"},{"location":"level101/systems_design/intro/#systems-design","text":"","title":"Systems Design"},{"location":"level101/systems_design/intro/#prerequisites","text":"Fundamentals of common software system components: Linux Basics Linux Networking Databases RDBMS NoSQL Concepts","title":"Prerequisites"},{"location":"level101/systems_design/intro/#what-to-expect-from-this-course","text":"Thinking about and designing for scalability, availability, and reliability of large scale software systems.","title":"What to expect from this course"},{"location":"level101/systems_design/intro/#what-is-not-covered-under-this-course","text":"Individual software components\u2019 scalability and reliability concerns like e.g. Databases, while the same scalability principles and thinking can be applied, these individual components have their own specific nuances when scaling them and thinking about their reliability. More light will be shed on concepts rather than on setting up and configuring components like Loadbalancers to achieve scalability, availability, and reliability of systems","title":"What is not covered under this course"},{"location":"level101/systems_design/intro/#course-contents","text":"Introduction Scalability High Availability Fault Tolerance","title":"Course Contents"},{"location":"level101/systems_design/intro/#introduction","text":"So, how do you go about learning to design a system? \u201d Like most great questions, it showed a level of naivety that was breathtaking. The only short answer I could give was, essentially, that you learned how to design a system by designing systems and finding out what works and what doesn\u2019t work.\u201d Jim Waldo, Sun Microsystems, On System Design As software and hardware systems have multiple moving parts, we need to think about how those parts will grow, their failure modes, their inter-dependencies, how it will impact the users and the business. There is no one-shot method or way to learn or do system design, we only learn to design systems by designing and iterating on them. This course will be a starter to make one think about scalability, availability, and fault tolerance during systems design.","title":"Introduction"},{"location":"level101/systems_design/intro/#backstory","text":"Let\u2019s design a simple content sharing application where users can share photos, media in our application which can be liked by their friends. Let\u2019s start with a simple design of the application and evolve it as we learn system design concepts","title":"Backstory"},{"location":"level101/systems_design/scalability/","text":"Scalability What does scalability mean for a system/service? A system is composed of services/components, each service/component scalability needs to be tackled separately, and the scalability of the system as a whole. A service is said to be scalable if, as resources are added to the system, it results in increased performance in a manner proportional to resources added An always-on service is said to be scalable if adding resources to facilitate redundancy does not result in a loss of performance Refer https://www.allthingsdistributed.com/2006/03/a_word_on_scalability.html Scalability - AKF Scale Cube The Scale Cube is a model for segmenting services, defining microservices, and scaling products. It also creates a common language for teams to discuss scale related options in designing solutions. The following section talks about certain scaling patterns based on our inferences from the AKF cube Scalability - Horizontal scaling Horizontal scaling stands for cloning of an application or service such that work can easily be distributed across instances with absolutely no bias. Let's see how our monolithic application improves with this principle Here DB is scaled separately from the application. This is to let you know each component\u2019s scaling capabilities can be different. Usually, web applications can be scaled by adding resources unless there is state stored inside the application. But DBs can be scaled only for Reads by adding more followers but Writes have to go to only one leader to make sure data is consistent. There are some DBs that support multi-leader writes but we are keeping them out of scope at this point. Apps should be able to differentiate between Reads and Writes to choose appropriate DB servers. Load balancers can split traffic between identical servers transparently. WHAT: Duplication of services or databases to spread transaction load. WHEN TO USE: Databases with a very high read-to-write ratio (5:1 or greater\u2014the higher the better). Because only read replicas of DBs can be scaled, not the Leader. HOW TO USE: Simply clone services and implement a load balancer. For databases, ensure that the accessing code understands the difference between a read and a write. WHY: Allows for the fast scale of transactions at the cost of duplicated data and functionality. KEY TAKEAWAYS: This is fast to implement, is a low cost from a developer effort perspective, and can scale transaction volumes nicely. However, they tend to be high cost from the perspective of the operational cost of data. The cost here means if we have 3 followers and 1 Leader DB, the same database will be stored as 4 copies in the 4 servers. Hence added storage cost Refer https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html Scalability Pattern - Load Balancing Improves the distribution of workloads across multiple computing resources, such as computers, a computer cluster, network links, central processing units, or disk drives. A commonly used technique is load balancing traffic across identical server clusters. A similar philosophy is used to load balance traffic across network links by ECMP , disk drives by RAID ,etc Aims to optimize resource use, maximize throughput, minimize response time, and avoid overload of any single resource. Using multiple components with load balancing instead of a single component may increase reliability and availability through redundancy. In our updated architecture diagram we have 4 servers to handle app traffic instead of a single server The device or system that performs load balancing is called a load balancer, abbreviated as LB. Refer https://en.wikipedia.org/wiki/Load_balancing_(computing) https://blog.envoyproxy.io/introduction-to-modern-network-load-balancing-and-proxying-a57f6ff80236 https://learning.oreilly.com/library/view/load-balancing-in/9781492038009/ https://learning.oreilly.com/library/view/practical-load-balancing/9781430236801/ http://shop.oreilly.com/product/9780596000509.do Scalability Pattern - LB Tasks What does an LB do? Service discovery: What backends are available in the system? In our architecture, 4 servers are available to serve App traffic. LB acts as a single endpoint that clients can use transparently to reach one of the 4 servers. Health checking: What backends are currently healthy and available to accept requests? If one out of the 4 App servers turns bad, LB should automatically short circuit the path so that clients don\u2019t sense any application downtime Load balancing: What algorithm should be used to balance individual requests across the healthy backends? There are many algorithms to distribute traffic across one of the four servers. Based on observations/experience, SRE can pick the algorithm that suits their pattern Scalability Pattern - LB Methods Common Load Balancing Methods Least Connection Method directs traffic to the server with the fewest active connections. Most useful when there are a large number of persistent connections in the traffic unevenly distributed between the servers. Works if clients maintain long-lived connections Least Response Time Method directs traffic to the server with the fewest active connections and the lowest average response time. Here response time is used to provide feedback of the server\u2019s health Round Robin Method rotates servers by directing traffic to the first available server and then moves that server to the bottom of the queue. Most useful when servers are of equal specification and there are not many persistent connections. IP Hash the IP address of the client determines which server receives the request. This can sometimes cause skewness in distribution but is useful if apps store some state locally and need some stickiness More advanced client/server-side example techniques - https://docs.nginx.com/nginx/admin-guide/load-balancer/ - http://cbonte.github.io/haproxy-dconv/2.2/intro.html#3.3.5 - https://twitter.github.io/finagle/guide/Clients.html#load-balancing Scalability Pattern - Caching - Content Delivery Networks (CDN) CDNs are added closer to the client\u2019s location. If the app has static data like images, Javascript, CSS which don\u2019t change very often, they can be cached. Since our example is a content sharing site, static content can be cached in CDNs with a suitable expiry. WHAT: Use CDNs (content delivery networks) to offload traffic from your site. WHEN TO USE: When speed improvements and scale warrant the additional cost. HOW TO USE: Most CDNs leverage DNS to serve content on your site\u2019s behalf. Thus you may need to make minor DNS changes or additions and move content to be served from new subdomains. Eg media-exp1.licdn.com is a domain used by Linkedin to serve static content Here a CNAME points the domain to the DNS of the CDN provider dig media-exp1.licdn.com +short 2-01-2c3e-005c.cdx.cedexis.net. WHY: CDNs help offload traffic spikes and are often economical ways to scale parts of a site\u2019s traffic. They also often substantially improve page download times. KEY TAKEAWAYS: CDNs are a fast and simple way to offset the spikiness of traffic as well as traffic growth in general. Make sure you perform a cost-benefit analysis and monitor the CDN usage. If CDNs have a lot of cache misses, then we don\u2019t gain much from CDN and are still serving requests using our compute resources. Scalability - Microservices This pattern represents the separation of work by service or function within the application. Microservices are meant to address the issues associated with growth and complexity in the code base and data sets. The intent is to create fault isolation as well as to reduce response times. Microservices can scale transactions, data sizes, and codebase sizes. They are most effective in scaling the size and complexity of your codebase. They tend to cost a bit more than horizontal scaling because the engineering team needs to rewrite services or, at the very least, disaggregate them from the original monolithic application. WHAT: Sometimes referred to as scale through services or resources, this rule focuses on scaling by splitting data sets, transactions, and engineering teams along verb (services) or noun (resources) boundaries. WHEN TO USE: Very large data sets where relations between data are not necessary. Large, complex systems where scaling engineering resources requires specialization. HOW TO USE: Split up actions by using verbs, or resources by using nouns, or use a mix. Split both the services and the data along the lines defined by the verb/noun approach. WHY: Allows for efficient scaling of not only transactions but also very large data sets associated with those transactions. It also allows for the efficient scaling of teams. KEY TAKEAWAYS: Microservices allow for efficient scaling of transactions, large data sets, and can help with fault isolation. It helps reduce the communication overhead of teams. The codebase becomes less complex as disjoint features are decoupled and spun as new services thereby letting each service scale independently specific to its requirement. Refer https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html Scalability - Sharding This pattern represents the separation of work based on attributes that are looked up to or determined at the time of the transaction. Most often, these are implemented as splits by requestor, customer, or client. Very often, a lookup service or deterministic algorithm will need to be written for these types of splits. Sharding aids in scaling transaction growth, scaling instruction sets, and decreasing processing time (the last by limiting the data necessary to perform any transaction). This is more effective at scaling growth in customers or clients. It can aid with disaster recovery efforts, and limit the impact of incidents to only a specific segment of customers. Here the auth data is sharded based on user names so that DBs can respond faster as the amount of data DBs have to work on has drastically reduced during queries. There can be other ways to split Here the whole data center is split and replicated and clients are directed to a data center based on their geography. This helps in improving performance as clients are directed to the closest data center and performance increases as we add more data centers. There are some replication and consistency overhead with this approach one needs to be aware of. This also gives fault tolerance by rolling out test features to one site and rollback if there is an impact to that geography WHAT: This is very often a split by some unique aspect of the customer such as customer ID, name, geography, and so on. WHEN TO USE: Very large, similar data sets such as large and rapidly growing customer bases or when the response time for a geographically distributed customer base is important. HOW TO USE: Identify something you know about the customer, such as customer ID, last name, geography, or device, and split or partition both data and services based on that attribute. WHY: Rapid customer growth exceeds other forms of data growth, or you have the need to perform fault isolation between certain customer groups as you scale. KEY TAKEAWAYS: Shards are effective at helping you to scale customer bases but can also be applied to other very large data sets that can\u2019t be pulled apart using the microservices methodology. Refer https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html Applications in SRE role SREs in coordination with the network team work on how to map users' traffic to a particular site. https://engineering.linkedin.com/blog/2017/05/trafficshift--load-testing-at-scale SREs work closely with the Dev team to split monoliths to multiple microservices that are easy to run and manage SREs work on improving Load Balancers' reliability, service discovery, and performance SREs work closely to split Data into shards and manage data integrity and consistency. https://engineering.linkedin.com/espresso/introducing-espresso-linkedins-hot-new-distributed-document-store SREs work to set up, configure, and improve the CDN cache hit rate.","title":"Scalability"},{"location":"level101/systems_design/scalability/#scalability","text":"What does scalability mean for a system/service? A system is composed of services/components, each service/component scalability needs to be tackled separately, and the scalability of the system as a whole. A service is said to be scalable if, as resources are added to the system, it results in increased performance in a manner proportional to resources added An always-on service is said to be scalable if adding resources to facilitate redundancy does not result in a loss of performance","title":"Scalability"},{"location":"level101/systems_design/scalability/#refer","text":"https://www.allthingsdistributed.com/2006/03/a_word_on_scalability.html","title":"Refer"},{"location":"level101/systems_design/scalability/#scalability-akf-scale-cube","text":"The Scale Cube is a model for segmenting services, defining microservices, and scaling products. It also creates a common language for teams to discuss scale related options in designing solutions. The following section talks about certain scaling patterns based on our inferences from the AKF cube","title":"Scalability - AKF Scale Cube"},{"location":"level101/systems_design/scalability/#scalability-horizontal-scaling","text":"Horizontal scaling stands for cloning of an application or service such that work can easily be distributed across instances with absolutely no bias. Let's see how our monolithic application improves with this principle Here DB is scaled separately from the application. This is to let you know each component\u2019s scaling capabilities can be different. Usually, web applications can be scaled by adding resources unless there is state stored inside the application. But DBs can be scaled only for Reads by adding more followers but Writes have to go to only one leader to make sure data is consistent. There are some DBs that support multi-leader writes but we are keeping them out of scope at this point. Apps should be able to differentiate between Reads and Writes to choose appropriate DB servers. Load balancers can split traffic between identical servers transparently. WHAT: Duplication of services or databases to spread transaction load. WHEN TO USE: Databases with a very high read-to-write ratio (5:1 or greater\u2014the higher the better). Because only read replicas of DBs can be scaled, not the Leader. HOW TO USE: Simply clone services and implement a load balancer. For databases, ensure that the accessing code understands the difference between a read and a write. WHY: Allows for the fast scale of transactions at the cost of duplicated data and functionality. KEY TAKEAWAYS: This is fast to implement, is a low cost from a developer effort perspective, and can scale transaction volumes nicely. However, they tend to be high cost from the perspective of the operational cost of data. The cost here means if we have 3 followers and 1 Leader DB, the same database will be stored as 4 copies in the 4 servers. Hence added storage cost","title":"Scalability - Horizontal scaling"},{"location":"level101/systems_design/scalability/#refer_1","text":"https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html","title":"Refer"},{"location":"level101/systems_design/scalability/#scalability-pattern-load-balancing","text":"Improves the distribution of workloads across multiple computing resources, such as computers, a computer cluster, network links, central processing units, or disk drives. A commonly used technique is load balancing traffic across identical server clusters. A similar philosophy is used to load balance traffic across network links by ECMP , disk drives by RAID ,etc Aims to optimize resource use, maximize throughput, minimize response time, and avoid overload of any single resource. Using multiple components with load balancing instead of a single component may increase reliability and availability through redundancy. In our updated architecture diagram we have 4 servers to handle app traffic instead of a single server The device or system that performs load balancing is called a load balancer, abbreviated as LB.","title":"Scalability Pattern - Load Balancing"},{"location":"level101/systems_design/scalability/#refer_2","text":"https://en.wikipedia.org/wiki/Load_balancing_(computing) https://blog.envoyproxy.io/introduction-to-modern-network-load-balancing-and-proxying-a57f6ff80236 https://learning.oreilly.com/library/view/load-balancing-in/9781492038009/ https://learning.oreilly.com/library/view/practical-load-balancing/9781430236801/ http://shop.oreilly.com/product/9780596000509.do","title":"Refer"},{"location":"level101/systems_design/scalability/#scalability-pattern-lb-tasks","text":"What does an LB do?","title":"Scalability Pattern - LB Tasks"},{"location":"level101/systems_design/scalability/#service-discovery","text":"What backends are available in the system? In our architecture, 4 servers are available to serve App traffic. LB acts as a single endpoint that clients can use transparently to reach one of the 4 servers.","title":"Service discovery:"},{"location":"level101/systems_design/scalability/#health-checking","text":"What backends are currently healthy and available to accept requests? If one out of the 4 App servers turns bad, LB should automatically short circuit the path so that clients don\u2019t sense any application downtime","title":"Health checking:"},{"location":"level101/systems_design/scalability/#load-balancing","text":"What algorithm should be used to balance individual requests across the healthy backends? There are many algorithms to distribute traffic across one of the four servers. Based on observations/experience, SRE can pick the algorithm that suits their pattern","title":"Load balancing:"},{"location":"level101/systems_design/scalability/#scalability-pattern-lb-methods","text":"Common Load Balancing Methods","title":"Scalability Pattern - LB Methods"},{"location":"level101/systems_design/scalability/#least-connection-method","text":"directs traffic to the server with the fewest active connections. Most useful when there are a large number of persistent connections in the traffic unevenly distributed between the servers. Works if clients maintain long-lived connections","title":"Least Connection Method"},{"location":"level101/systems_design/scalability/#least-response-time-method","text":"directs traffic to the server with the fewest active connections and the lowest average response time. Here response time is used to provide feedback of the server\u2019s health","title":"Least Response Time Method"},{"location":"level101/systems_design/scalability/#round-robin-method","text":"rotates servers by directing traffic to the first available server and then moves that server to the bottom of the queue. Most useful when servers are of equal specification and there are not many persistent connections.","title":"Round Robin Method"},{"location":"level101/systems_design/scalability/#ip-hash","text":"the IP address of the client determines which server receives the request. This can sometimes cause skewness in distribution but is useful if apps store some state locally and need some stickiness More advanced client/server-side example techniques - https://docs.nginx.com/nginx/admin-guide/load-balancer/ - http://cbonte.github.io/haproxy-dconv/2.2/intro.html#3.3.5 - https://twitter.github.io/finagle/guide/Clients.html#load-balancing","title":"IP Hash"},{"location":"level101/systems_design/scalability/#scalability-pattern-caching-content-delivery-networks-cdn","text":"CDNs are added closer to the client\u2019s location. If the app has static data like images, Javascript, CSS which don\u2019t change very often, they can be cached. Since our example is a content sharing site, static content can be cached in CDNs with a suitable expiry. WHAT: Use CDNs (content delivery networks) to offload traffic from your site. WHEN TO USE: When speed improvements and scale warrant the additional cost. HOW TO USE: Most CDNs leverage DNS to serve content on your site\u2019s behalf. Thus you may need to make minor DNS changes or additions and move content to be served from new subdomains. Eg media-exp1.licdn.com is a domain used by Linkedin to serve static content Here a CNAME points the domain to the DNS of the CDN provider dig media-exp1.licdn.com +short 2-01-2c3e-005c.cdx.cedexis.net. WHY: CDNs help offload traffic spikes and are often economical ways to scale parts of a site\u2019s traffic. They also often substantially improve page download times. KEY TAKEAWAYS: CDNs are a fast and simple way to offset the spikiness of traffic as well as traffic growth in general. Make sure you perform a cost-benefit analysis and monitor the CDN usage. If CDNs have a lot of cache misses, then we don\u2019t gain much from CDN and are still serving requests using our compute resources.","title":"Scalability Pattern - Caching - Content Delivery Networks (CDN)"},{"location":"level101/systems_design/scalability/#scalability-microservices","text":"This pattern represents the separation of work by service or function within the application. Microservices are meant to address the issues associated with growth and complexity in the code base and data sets. The intent is to create fault isolation as well as to reduce response times. Microservices can scale transactions, data sizes, and codebase sizes. They are most effective in scaling the size and complexity of your codebase. They tend to cost a bit more than horizontal scaling because the engineering team needs to rewrite services or, at the very least, disaggregate them from the original monolithic application. WHAT: Sometimes referred to as scale through services or resources, this rule focuses on scaling by splitting data sets, transactions, and engineering teams along verb (services) or noun (resources) boundaries. WHEN TO USE: Very large data sets where relations between data are not necessary. Large, complex systems where scaling engineering resources requires specialization. HOW TO USE: Split up actions by using verbs, or resources by using nouns, or use a mix. Split both the services and the data along the lines defined by the verb/noun approach. WHY: Allows for efficient scaling of not only transactions but also very large data sets associated with those transactions. It also allows for the efficient scaling of teams. KEY TAKEAWAYS: Microservices allow for efficient scaling of transactions, large data sets, and can help with fault isolation. It helps reduce the communication overhead of teams. The codebase becomes less complex as disjoint features are decoupled and spun as new services thereby letting each service scale independently specific to its requirement.","title":"Scalability - Microservices"},{"location":"level101/systems_design/scalability/#refer_3","text":"https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html","title":"Refer"},{"location":"level101/systems_design/scalability/#scalability-sharding","text":"This pattern represents the separation of work based on attributes that are looked up to or determined at the time of the transaction. Most often, these are implemented as splits by requestor, customer, or client. Very often, a lookup service or deterministic algorithm will need to be written for these types of splits. Sharding aids in scaling transaction growth, scaling instruction sets, and decreasing processing time (the last by limiting the data necessary to perform any transaction). This is more effective at scaling growth in customers or clients. It can aid with disaster recovery efforts, and limit the impact of incidents to only a specific segment of customers. Here the auth data is sharded based on user names so that DBs can respond faster as the amount of data DBs have to work on has drastically reduced during queries. There can be other ways to split Here the whole data center is split and replicated and clients are directed to a data center based on their geography. This helps in improving performance as clients are directed to the closest data center and performance increases as we add more data centers. There are some replication and consistency overhead with this approach one needs to be aware of. This also gives fault tolerance by rolling out test features to one site and rollback if there is an impact to that geography WHAT: This is very often a split by some unique aspect of the customer such as customer ID, name, geography, and so on. WHEN TO USE: Very large, similar data sets such as large and rapidly growing customer bases or when the response time for a geographically distributed customer base is important. HOW TO USE: Identify something you know about the customer, such as customer ID, last name, geography, or device, and split or partition both data and services based on that attribute. WHY: Rapid customer growth exceeds other forms of data growth, or you have the need to perform fault isolation between certain customer groups as you scale. KEY TAKEAWAYS: Shards are effective at helping you to scale customer bases but can also be applied to other very large data sets that can\u2019t be pulled apart using the microservices methodology.","title":"Scalability - Sharding"},{"location":"level101/systems_design/scalability/#refer_4","text":"https://learning.oreilly.com/library/view/the-art-of/9780134031408/ch23.html","title":"Refer"},{"location":"level101/systems_design/scalability/#applications-in-sre-role","text":"SREs in coordination with the network team work on how to map users' traffic to a particular site. https://engineering.linkedin.com/blog/2017/05/trafficshift--load-testing-at-scale SREs work closely with the Dev team to split monoliths to multiple microservices that are easy to run and manage SREs work on improving Load Balancers' reliability, service discovery, and performance SREs work closely to split Data into shards and manage data integrity and consistency. https://engineering.linkedin.com/espresso/introducing-espresso-linkedins-hot-new-distributed-document-store SREs work to set up, configure, and improve the CDN cache hit rate.","title":"Applications in SRE role"},{"location":"level102/containerization_and_orchestration/conclusion/","text":"Conclusion In this sub-module we have toured the world of containers starting from why we use containers, how containers evolved from the virtual machine past (though they are, in no means, obsolete) and how they are different from virtual machines. We then saw how containers are implemented with emphasis on cgroups and namespaces along with some hands-on exercises. Finally we concluded our journey with container orchestration where we learnt a bit of Kubernetes with some practical examples. Hope this module gives you enough knowledge and interest to continue learning and applying these technologies in greater depth!","title":"Conclusion"},{"location":"level102/containerization_and_orchestration/conclusion/#conclusion","text":"In this sub-module we have toured the world of containers starting from why we use containers, how containers evolved from the virtual machine past (though they are, in no means, obsolete) and how they are different from virtual machines. We then saw how containers are implemented with emphasis on cgroups and namespaces along with some hands-on exercises. Finally we concluded our journey with container orchestration where we learnt a bit of Kubernetes with some practical examples. Hope this module gives you enough knowledge and interest to continue learning and applying these technologies in greater depth!","title":"Conclusion"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/","text":"Introduction Docker has gained huge popularity among other container engines since it was released to the public in 2013. Here are some of the reasons why Docker so popular: Improved portability Docker containers can be shipped and run across environments be it local machine, on-prem or cloud instances in the form of Docker images. Compared to docker containers, LXC containers have more machine specifications. - Lighter weight Docker images are light weight compared to VM images. For example, an Ubuntu 18.04 VM size is about 3GB whereas the docker image is 45MB! Versioning of container images Docker supports maintaining multiple versions of images which makes it easier to look up the history of an image and even rollback. Reuse of images Since Docker images are in the form of layers, one image can be used as base on top of which new images are built. For example, Alpine is a light weight image (5MB) which is commonly used as a base image. Docker layers are managed using storage drivers . Community support Docker hub is a container registry where anyone logged in can upload or download a container image. Docker images of popular OS distros are regularly updated in docker hub and receive large community support. Let\u2019s look at some terms which come up during our discussion of Docker. Docker terminology Docker images Docker image contains the executable version of the application along with the dependencies (config files, libraries, binaries) required for the application to run as a standalone container. It can be understood as a snapshot of a container. Docker images are present as layers on top of the base layer. These layers are the ones that are versioned. The most recent version of layer is the one that is used on top of the base image. docker image ls lists the images present in the host machine. Docker containers Docker container is the running instance of the docker image. While images are static, containers created from the images can be executed into and interacted with. This is actually the \u201ccontainer\u201d from the previous sections of the module. docker run is the command used to instantiate containers from images. docker ps lists docker containers currently running in the host machine. Docker file It is a plain text file of instructions based on which an image is assembled by docker engine (daemon, to be precise). It contains information on base image, ENV variables to be injected. docker build is used to build images from dockerfile. Docker hub It is Docker\u2019s official container registry of images. Any user with a docker login can upload custom images to Docker hub using docker push and fetch images using docker pull . Having known the basic terminologies let\u2019s look at how docker engine works; how CLI commands are interpreted and container life-cycle is managed. Components of Docker engine Let\u2019s start with the diagram of Docker Engine to understand better: The docker engine follows a client-server architecture. It consists of 3 components: Docker client This is the component the user directly interacts with. When you execute docker commands which we saw earlier (push, pull, container ls, image ls) , we are actually using the docker client. A single docker client can communicate with multiple docker daemons. REST API Provides an interface for the docker client and daemon to communicate. Docker Daemon (server) This is the main component of the docker engine. It builds images from dockerfile, fetches images from docker registry, pushes images to the registry, stops, starts containers etc. It also manages networking between containers. LAB The official docker github provides labs at several levels for learning Docker. We're linking one of the labs which we found great for people beginning from scratch. Please follow the labs in this order: Setting up local environment for the labs Basics for using docker CLI Creating and containerizing a basic Flask app Here is another beginner level lab from Katacoda for dockerizing a node js application. You don\u2019t even need a local setup for this and it\u2019s easy to follow along. Advanced features of Docker While we have covered the basics of containerization and how a standalone application can be dockerized, processes in the real world need to communicate with each other. This need is particularly prevalent in applications which follow a microservice architecture. Docker networks Docker networks facilitate the interaction between containers running on the same hosts or even different hosts. There are several options provided through docker network command which specifies how the container interacts with the host and with other containers. The host option allows sharing of network stack with the host, bridge allows communication between containers running on the same host but not external to the host, overlay facilitates interaction between containers across hosts attached to the same network and macvlan which assigns a separate MAC address to a container for legacy containers are some important types of networks supported by Docker. This however is outside the scope of this module. The official documentation on docker networks itself is a good place to start. Volumes Apart from images, containers and networks, Docker also provides the option to create and mount volumes within containers. Generally, data within docker containers is non-persistent i.e once you kill the container the data is lost. Volumes are used for storing persistent data in containers. This KataKoda lab is a great place to start playing with volumes. In the next section we see how container deployments are orchestrated with Kubernetes.","title":"Containerization With Docker"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/#introduction","text":"Docker has gained huge popularity among other container engines since it was released to the public in 2013. Here are some of the reasons why Docker so popular: Improved portability Docker containers can be shipped and run across environments be it local machine, on-prem or cloud instances in the form of Docker images. Compared to docker containers, LXC containers have more machine specifications. - Lighter weight Docker images are light weight compared to VM images. For example, an Ubuntu 18.04 VM size is about 3GB whereas the docker image is 45MB! Versioning of container images Docker supports maintaining multiple versions of images which makes it easier to look up the history of an image and even rollback. Reuse of images Since Docker images are in the form of layers, one image can be used as base on top of which new images are built. For example, Alpine is a light weight image (5MB) which is commonly used as a base image. Docker layers are managed using storage drivers . Community support Docker hub is a container registry where anyone logged in can upload or download a container image. Docker images of popular OS distros are regularly updated in docker hub and receive large community support. Let\u2019s look at some terms which come up during our discussion of Docker.","title":"Introduction"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/#docker-terminology","text":"Docker images Docker image contains the executable version of the application along with the dependencies (config files, libraries, binaries) required for the application to run as a standalone container. It can be understood as a snapshot of a container. Docker images are present as layers on top of the base layer. These layers are the ones that are versioned. The most recent version of layer is the one that is used on top of the base image. docker image ls lists the images present in the host machine. Docker containers Docker container is the running instance of the docker image. While images are static, containers created from the images can be executed into and interacted with. This is actually the \u201ccontainer\u201d from the previous sections of the module. docker run is the command used to instantiate containers from images. docker ps lists docker containers currently running in the host machine. Docker file It is a plain text file of instructions based on which an image is assembled by docker engine (daemon, to be precise). It contains information on base image, ENV variables to be injected. docker build is used to build images from dockerfile. Docker hub It is Docker\u2019s official container registry of images. Any user with a docker login can upload custom images to Docker hub using docker push and fetch images using docker pull . Having known the basic terminologies let\u2019s look at how docker engine works; how CLI commands are interpreted and container life-cycle is managed.","title":"Docker terminology"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/#components-of-docker-engine","text":"Let\u2019s start with the diagram of Docker Engine to understand better: The docker engine follows a client-server architecture. It consists of 3 components: Docker client This is the component the user directly interacts with. When you execute docker commands which we saw earlier (push, pull, container ls, image ls) , we are actually using the docker client. A single docker client can communicate with multiple docker daemons. REST API Provides an interface for the docker client and daemon to communicate. Docker Daemon (server) This is the main component of the docker engine. It builds images from dockerfile, fetches images from docker registry, pushes images to the registry, stops, starts containers etc. It also manages networking between containers.","title":"Components of Docker engine"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/#lab","text":"The official docker github provides labs at several levels for learning Docker. We're linking one of the labs which we found great for people beginning from scratch. Please follow the labs in this order: Setting up local environment for the labs Basics for using docker CLI Creating and containerizing a basic Flask app Here is another beginner level lab from Katacoda for dockerizing a node js application. You don\u2019t even need a local setup for this and it\u2019s easy to follow along.","title":"LAB"},{"location":"level102/containerization_and_orchestration/containerization_with_docker/#advanced-features-of-docker","text":"While we have covered the basics of containerization and how a standalone application can be dockerized, processes in the real world need to communicate with each other. This need is particularly prevalent in applications which follow a microservice architecture. Docker networks Docker networks facilitate the interaction between containers running on the same hosts or even different hosts. There are several options provided through docker network command which specifies how the container interacts with the host and with other containers. The host option allows sharing of network stack with the host, bridge allows communication between containers running on the same host but not external to the host, overlay facilitates interaction between containers across hosts attached to the same network and macvlan which assigns a separate MAC address to a container for legacy containers are some important types of networks supported by Docker. This however is outside the scope of this module. The official documentation on docker networks itself is a good place to start. Volumes Apart from images, containers and networks, Docker also provides the option to create and mount volumes within containers. Generally, data within docker containers is non-persistent i.e once you kill the container the data is lost. Volumes are used for storing persistent data in containers. This KataKoda lab is a great place to start playing with volumes. In the next section we see how container deployments are orchestrated with Kubernetes.","title":"Advanced features of Docker"},{"location":"level102/containerization_and_orchestration/intro/","text":"Containers and orchestration Introduction Containers, Docker and Kubernetes are \"cool\" terms that are being spoken of by everyone involved with software in some way. Let's dive into each of these pieces of technology at enough depth to understand what the whole deal is about! In this module we talk about the ins and outs of containers: the internals and usage of containers; how they are implemented, how to containerize your application and finally, how to deploy containerized applications on a large scale without losing your sleep. We'll also get our hands dirty by trying out a few lab exercises. Prerequisites Basic knowledge of linux will be helpful understanding the internals of containers Basic knowledge of shell commands (will come handy when we're containerizing applications) Knowledge of running a basic web application. You can go through our Python And Web module to gain familiarity with this. What to expect from this course This module is divided into 3 sub-modules. In the first sub module, we will cover the internals of containerization and why they\u2019re used for. The second sub-module introduces Docker, a popular container engine and contains lab exercises on dockerizing a basic webapp. The last module talks about container orchestration with Kubernetes and some lab exercises to show how it makes the lives of SREs easy. What is not covered under this course We will not cover advanced docker and kubernetes concepts. However, we will be leading you to links and references from where you can pick them up as per your interest. Course Contents The following topics has been covered in this course: Introduction to containers What are containers Why containers Difference between virtual machines and containers How are containers implemented Namespaces Cgroups Container engines Containerization with Docker Introduction Basic docker terminology Components of Docker engine Hands-on Introduction to Advanced Docker Container orchestration with Kubernetes Introduction Motivation to use Kubernetes Kubernetes Architecture Hands-on Introduction to Advanced Kubernetes concepts Conclusion","title":"Introduction"},{"location":"level102/containerization_and_orchestration/intro/#containers-and-orchestration","text":"","title":"Containers and orchestration"},{"location":"level102/containerization_and_orchestration/intro/#introduction","text":"Containers, Docker and Kubernetes are \"cool\" terms that are being spoken of by everyone involved with software in some way. Let's dive into each of these pieces of technology at enough depth to understand what the whole deal is about! In this module we talk about the ins and outs of containers: the internals and usage of containers; how they are implemented, how to containerize your application and finally, how to deploy containerized applications on a large scale without losing your sleep. We'll also get our hands dirty by trying out a few lab exercises.","title":"Introduction"},{"location":"level102/containerization_and_orchestration/intro/#prerequisites","text":"Basic knowledge of linux will be helpful understanding the internals of containers Basic knowledge of shell commands (will come handy when we're containerizing applications) Knowledge of running a basic web application. You can go through our Python And Web module to gain familiarity with this.","title":"Prerequisites"},{"location":"level102/containerization_and_orchestration/intro/#what-to-expect-from-this-course","text":"This module is divided into 3 sub-modules. In the first sub module, we will cover the internals of containerization and why they\u2019re used for. The second sub-module introduces Docker, a popular container engine and contains lab exercises on dockerizing a basic webapp. The last module talks about container orchestration with Kubernetes and some lab exercises to show how it makes the lives of SREs easy.","title":"What to expect from this course"},{"location":"level102/containerization_and_orchestration/intro/#what-is-not-covered-under-this-course","text":"We will not cover advanced docker and kubernetes concepts. However, we will be leading you to links and references from where you can pick them up as per your interest.","title":"What is not covered under this course"},{"location":"level102/containerization_and_orchestration/intro/#course-contents","text":"The following topics has been covered in this course: Introduction to containers What are containers Why containers Difference between virtual machines and containers How are containers implemented Namespaces Cgroups Container engines Containerization with Docker Introduction Basic docker terminology Components of Docker engine Hands-on Introduction to Advanced Docker Container orchestration with Kubernetes Introduction Motivation to use Kubernetes Kubernetes Architecture Hands-on Introduction to Advanced Kubernetes concepts Conclusion","title":"Course Contents"},{"location":"level102/containerization_and_orchestration/intro_to_containers/","text":"What are containers Here's a popular definition of containers according to Docker , a popular containerization engine : A container is a standard unit of software that packages up code and all its dependencies so the application runs quickly and reliably from one computing environment to another Let's break this down. A container is your code bundled along with its entire runtime environment. That includes your system libraries, binaries and config files needed for your application to run. Why containers You might wonder why we need to pack your application along with its dependencies. This is where the second part of the definition comes, ...so the application runs quickly and reliably from one computing environment to another. Developers usually write code in their dev environment (or local machine), test it in one or two staging/test environments before pushing their code into production. Ideally, for reliably testing applications before pushing to production, we need all these environments to be uniform to a tee (underlying OS, system libraries etc). Of course, the ideal is hard to achieve especially when we're using a mix of on-prem (complete control) and cloud infrastructure providers (more restrictive in terms of control of hardware and security options), a scenario which is more common today. This is exactly why we need to package not only the code but also the dependencies; so that your application runs reliably irrespective of which infrastructure or environment it runs on. We can run several containers on a single host. Due to how containers are implemented, each container has its own isolated environment within the same host. This means that a monolithic application can be broken down into micro-services and packaged into containers. Each microservice runs in the host machine in isolated environments. This is another reason why containers are used: separation of concerns . Providing isolated environments does not let the failure of one application in one container affect the other. This is called fault isolation . Isolation also gives the added benefit of increased security due to restricted visibility of processes in a container. Due to how most of the containerization solutions are implemented, we also have the option to cap the amount of resources consumed by applications running within a container. This is called resource limiting . Will will discuss this feature in more detail in the section on cgroups. Difference between virtual machines and containers Let's digress a little and go into some history. In the previous section we talked about how containers help us in achieving separation of concerns. Before the wide-spread usage of containers, virtualization was used for running applications in isolated environments in the same host (it\u2019s still being used today in some cases). In plain terms, virtualization is where we package software along with a copy of the OS on which it runs. This package is called a virtual machine (VM). The image of the OS bundled in the VM is called Guest OS. A component called Hypervisor sits between the Guest and the Host OS and is responsible for facilitating the access of the underlying OS\u2019s hardware to the Guest OS. You can learn more about hypervisors here . Similar to how multiple containers can be run in a single host machine, multiple VMs can be run on a single host and in this way, it\u2019s possible to run applications (or each microservice) in a separate VM and achieve separation of concerns. The main focus here is on the size of the VMs and containers. VMs come along with a copy of the guest operating system and therefore are heavy-weight compared to containers. If you\u2019re more interested in comparison of VMs and containers, you can check these articles from Backblaze and NetApp . While it is possible to run an operating system on a host with an incompatible kernel using hypervisors (e.g Windows 10 VM on CentOS 7), in cases where kernels can be shared (e.g Ubuntu on CentOS 7) containers are preferred over VMs due to the size factor. Sharing kernels, as you will see later, also gives containers many performance benefits over VMs like quicker boot-ups. Let\u2019s look at the diagram of how containers work. Comparing the two diagrams, we notice two things: Containers do not have a separate (guest) OS Container engine is the intermediary between containers and Host OS. It is used to facilitate the life-cycle of a container on the Host OS (it is not a necessity, however). The next section explains in detail how containers share the same operating system (kernel, to be precise) as the host machine and yet provide isolated environments for applications to run. How are containers implemented We\u2019ve talked about how containers, unlike virtual machines, share the same kernel as the host operating system and provide isolated environments for applications to run. This is achieved without the overhead of running a guest operating system on the host OS, thanks to two features of linux kernel called cgroups and kernel namespaces. Now that we are touching upon the internals of containers, it would be appropriate to give a more technically accurate representation of what they are. A container is a linux process or a group of linux processes which is restricted in - visibility into processes outside the container (implemented using namespace) - quantity of resources it can use (implemented using cgroups) and - system calls that can be made from the container. Refer seccomp , if interested in knowing more. These restrictions are what make a containerized application remain isolated from other processes running in the same host. Now let\u2019s talk about namespaces and cgroup in a little more detail. Namespaces Visibility of processes inside a container should be restricted within itself. This is what linux namespaces do. The idea is that processes within a namespace can\u2019t affect those which it can\u2019t \u201csee\u201d. Processes sharing a single namespace have identities, service and/or interfaces unique to the namespace they exist in. Here\u2019s a list of namespaces in linux: Mount Process groups sharing a mount namespace share a separate, private set of mount points and file system view. Any modifications made to these namespaced mount points are not visible outside the namespace. For example it is possible to have a /var within the a mount namespace which is different from /var in the host. PID A processes in a pid namespace have process ids which are unique only within the namespace. A process can be a root process (pid 1) in its own pid namespace and have an entire tree of processes under it. Network Each network namespace will have its own network device instances that can be configured with individual network addresses. Processes in the same network namespace can have their own ports and route tables. User User namespaces can have their own users and group ids. It\u2019s possible for a process using a non-privileged user in the host machine to have a root user identity within a user namespace. Cgroup Allows creation of cgroups which can be used only within the cgroup namespace. Cgroups will be covered in more detail in the following section. UTS This namespace has its own hostname and domain name IPC. Each IPC namespace has its own System V and POSIX message queues. As complex as it seems, creating namespaces in linux is quite simple. Let\u2019s see a quick demo to create a PID namespace. You\u2019ll need a linux based OS with sudoers permission to follow along. DEMO: namespaces First we check which processes are running in the host system (output varies from system to system). Note the process with pid 1. Let\u2019s create a PID namespace with the unshare command and create a bash process in the namespace You can see that ps aux (which itself is a process launched in the PID namespace so created) can only see processes within its own namespace. Hence, the output shows only 2 processes running within the namespace. Also note, the root process (pid 1) in the namespace is not init but it is the bash shell which we specified while creating the namespace. Let\u2019s create another process in the same namespace which sleeps for 1000 seconds in the background. In my case the pid of the sleep process is 44 within the PID namespace . On a separate terminal, check for the process id of the sleep process as seen from the host. Note the difference in pid (23844 in the host and 44 within the namespace) though both refer to the same process (start time and all other attributes are same). It\u2019s also possible to nest namespaces i.e create a pid namespace from another pid namespace. Try out sudo nsenter -t 23844 --pid -r bash to reenter the namespace and create another pid namespace within it. It should be fun to do! Cgroups A cgroup can be defined as a set of processes whose usage of resources is metered and monitored. The resources can be memory pages, disk i/o, CPU etc. In fact, cgroups are classified based on which resource the limit is imposed on and nature of action taken when a limit is violated. The component in the cgroup which tracks resource utilization and controls the behaviour of processes in a cgroup is called resource-subsystem or resource controller. Following is the set of resource controllers and their function according to RHEL\u2019s introduction to cgroups : blkio \u2014 this subsystem sets limits on input/output access to and from block devices such as physical drives (disk, solid state, or USB). cpu \u2014 this subsystem uses the scheduler to provide cgroup processes access to the CPU. cpuacct \u2014 this subsystem generates automatic reports on CPU resources used by processes in a cgroup. cpuset \u2014 this subsystem assigns individual CPUs (on a multicore system) and memory nodes to processes in a cgroup. devices \u2014 this subsystem allows or denies access to devices by processes in a cgroup. freezer \u2014 this subsystem suspends or resumes processes in a cgroup. memory \u2014 this subsystem sets limits on memory use by processes in a cgroup and generates automatic reports on memory resources used by those processes. Cgroups follow a hierarchical, tree-like structure for each resource controller i.e one cgroup exists for each controller. Each cgroup in a hierarchy inherits certain attributes (e.g limits) from its parent cgroup. Let\u2019s try out a quick demo with memory cgroups to wrap our heads around the above ideas. You\u2019ll need a linux based OS (here, RedHat) with sudo permission to follow along. DEMO: cgroups Let\u2019s start by checking if cgroup tools are installed in your machine. Execute mount | grep \"^cgroup\" . If you have the tools installed you\u2019ll see a output like this: If not, install the tools with sudo yum install libcgroup-tools -y . Now, we create a memory cgroup called mem_group with \u201croot\u201d as the owner of the cgroup. Command executed sudo cgcreate -a root -g memory:mem_group . Verify that cgroup is created. /sys/fs/cgroup/ is the pseudo filesystem where a newly created cgroup is added as a sub-group. Memory cgroup puts a limit on the memory usage of processes in the cgroup. Let\u2019s see what the limits are for mem_group. The file for checking the memory limit is memory.limit_in_bytes( more information here , if you\u2019re interested). Note that mem_group has inherited the limit from its parent cgroup Now, let\u2019s reduce the memory usage limit to 20KB for the purpose of our demo (the actual limit is rounded off to the nearest power of 2). This limit is too low and hence most of the processes attached to mem_group should be OOM killed. Create a new shell and attach it to the cgroup. We need sudo permissions for this. The process is OOM killed as expected. You can confirm the same with dmesg logs (mm_fault_error). If you want to try out a more in-depth exercise on cgroups, check out this tutorial from Geeks for Geeks . Let\u2019s come back to containers again. Containers share the same kernel as the underlying host operating system and provide an isolated environment of the application within. Cgroups help in managing resources used by processes within a container and namespaces help isolate network stack, pids, users, group ids and mount points in a container from another container running on the same host. Of course, there are more components to containers which truly make it fully functional but that discussion is out of scope of this module. Container engine Container engines ease the process of creating and managing containers in a host machine. How? The container creation workflow typically begins with a container image. A container image is a packaged, portable version of the target application bundled with all dependencies for it to run. These container images are either available on the host machine (container host) from previous builds or need to be pulled from a remote repository of images. Sometimes the container engine might need to build the container image from a set of instructions. Finally once the container image is fetched/built, the container engine unpacks the image and creates an isolated environment for the application as per the image specifications. The files in the container image are then mounted to the isolated environment to get the application up and running within the container. There are several container engines available like Docker, RKT, LXC (one of the first container engines) which require different image formats (Docker, LXD). OCI (Open Container Initiative) is a collaborative project started by Docker that aims to standardize container runtime specifications and image formats across vendors. OCI FAQ section is a good place to start if you\u2019re curious about this project. We will focus on Docker in the next section .","title":"Introduction To Containers"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#what-are-containers","text":"Here's a popular definition of containers according to Docker , a popular containerization engine : A container is a standard unit of software that packages up code and all its dependencies so the application runs quickly and reliably from one computing environment to another Let's break this down. A container is your code bundled along with its entire runtime environment. That includes your system libraries, binaries and config files needed for your application to run.","title":"What are containers"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#why-containers","text":"You might wonder why we need to pack your application along with its dependencies. This is where the second part of the definition comes, ...so the application runs quickly and reliably from one computing environment to another. Developers usually write code in their dev environment (or local machine), test it in one or two staging/test environments before pushing their code into production. Ideally, for reliably testing applications before pushing to production, we need all these environments to be uniform to a tee (underlying OS, system libraries etc). Of course, the ideal is hard to achieve especially when we're using a mix of on-prem (complete control) and cloud infrastructure providers (more restrictive in terms of control of hardware and security options), a scenario which is more common today. This is exactly why we need to package not only the code but also the dependencies; so that your application runs reliably irrespective of which infrastructure or environment it runs on. We can run several containers on a single host. Due to how containers are implemented, each container has its own isolated environment within the same host. This means that a monolithic application can be broken down into micro-services and packaged into containers. Each microservice runs in the host machine in isolated environments. This is another reason why containers are used: separation of concerns . Providing isolated environments does not let the failure of one application in one container affect the other. This is called fault isolation . Isolation also gives the added benefit of increased security due to restricted visibility of processes in a container. Due to how most of the containerization solutions are implemented, we also have the option to cap the amount of resources consumed by applications running within a container. This is called resource limiting . Will will discuss this feature in more detail in the section on cgroups.","title":"Why containers"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#difference-between-virtual-machines-and-containers","text":"Let's digress a little and go into some history. In the previous section we talked about how containers help us in achieving separation of concerns. Before the wide-spread usage of containers, virtualization was used for running applications in isolated environments in the same host (it\u2019s still being used today in some cases). In plain terms, virtualization is where we package software along with a copy of the OS on which it runs. This package is called a virtual machine (VM). The image of the OS bundled in the VM is called Guest OS. A component called Hypervisor sits between the Guest and the Host OS and is responsible for facilitating the access of the underlying OS\u2019s hardware to the Guest OS. You can learn more about hypervisors here . Similar to how multiple containers can be run in a single host machine, multiple VMs can be run on a single host and in this way, it\u2019s possible to run applications (or each microservice) in a separate VM and achieve separation of concerns. The main focus here is on the size of the VMs and containers. VMs come along with a copy of the guest operating system and therefore are heavy-weight compared to containers. If you\u2019re more interested in comparison of VMs and containers, you can check these articles from Backblaze and NetApp . While it is possible to run an operating system on a host with an incompatible kernel using hypervisors (e.g Windows 10 VM on CentOS 7), in cases where kernels can be shared (e.g Ubuntu on CentOS 7) containers are preferred over VMs due to the size factor. Sharing kernels, as you will see later, also gives containers many performance benefits over VMs like quicker boot-ups. Let\u2019s look at the diagram of how containers work. Comparing the two diagrams, we notice two things: Containers do not have a separate (guest) OS Container engine is the intermediary between containers and Host OS. It is used to facilitate the life-cycle of a container on the Host OS (it is not a necessity, however). The next section explains in detail how containers share the same operating system (kernel, to be precise) as the host machine and yet provide isolated environments for applications to run.","title":"Difference between virtual machines and containers"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#how-are-containers-implemented","text":"We\u2019ve talked about how containers, unlike virtual machines, share the same kernel as the host operating system and provide isolated environments for applications to run. This is achieved without the overhead of running a guest operating system on the host OS, thanks to two features of linux kernel called cgroups and kernel namespaces. Now that we are touching upon the internals of containers, it would be appropriate to give a more technically accurate representation of what they are. A container is a linux process or a group of linux processes which is restricted in - visibility into processes outside the container (implemented using namespace) - quantity of resources it can use (implemented using cgroups) and - system calls that can be made from the container. Refer seccomp , if interested in knowing more. These restrictions are what make a containerized application remain isolated from other processes running in the same host. Now let\u2019s talk about namespaces and cgroup in a little more detail.","title":"How are containers implemented"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#namespaces","text":"Visibility of processes inside a container should be restricted within itself. This is what linux namespaces do. The idea is that processes within a namespace can\u2019t affect those which it can\u2019t \u201csee\u201d. Processes sharing a single namespace have identities, service and/or interfaces unique to the namespace they exist in. Here\u2019s a list of namespaces in linux: Mount Process groups sharing a mount namespace share a separate, private set of mount points and file system view. Any modifications made to these namespaced mount points are not visible outside the namespace. For example it is possible to have a /var within the a mount namespace which is different from /var in the host. PID A processes in a pid namespace have process ids which are unique only within the namespace. A process can be a root process (pid 1) in its own pid namespace and have an entire tree of processes under it. Network Each network namespace will have its own network device instances that can be configured with individual network addresses. Processes in the same network namespace can have their own ports and route tables. User User namespaces can have their own users and group ids. It\u2019s possible for a process using a non-privileged user in the host machine to have a root user identity within a user namespace. Cgroup Allows creation of cgroups which can be used only within the cgroup namespace. Cgroups will be covered in more detail in the following section. UTS This namespace has its own hostname and domain name IPC. Each IPC namespace has its own System V and POSIX message queues. As complex as it seems, creating namespaces in linux is quite simple. Let\u2019s see a quick demo to create a PID namespace. You\u2019ll need a linux based OS with sudoers permission to follow along.","title":"Namespaces"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#demo-namespaces","text":"First we check which processes are running in the host system (output varies from system to system). Note the process with pid 1. Let\u2019s create a PID namespace with the unshare command and create a bash process in the namespace You can see that ps aux (which itself is a process launched in the PID namespace so created) can only see processes within its own namespace. Hence, the output shows only 2 processes running within the namespace. Also note, the root process (pid 1) in the namespace is not init but it is the bash shell which we specified while creating the namespace. Let\u2019s create another process in the same namespace which sleeps for 1000 seconds in the background. In my case the pid of the sleep process is 44 within the PID namespace . On a separate terminal, check for the process id of the sleep process as seen from the host. Note the difference in pid (23844 in the host and 44 within the namespace) though both refer to the same process (start time and all other attributes are same). It\u2019s also possible to nest namespaces i.e create a pid namespace from another pid namespace. Try out sudo nsenter -t 23844 --pid -r bash to reenter the namespace and create another pid namespace within it. It should be fun to do!","title":"DEMO: namespaces"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#cgroups","text":"A cgroup can be defined as a set of processes whose usage of resources is metered and monitored. The resources can be memory pages, disk i/o, CPU etc. In fact, cgroups are classified based on which resource the limit is imposed on and nature of action taken when a limit is violated. The component in the cgroup which tracks resource utilization and controls the behaviour of processes in a cgroup is called resource-subsystem or resource controller. Following is the set of resource controllers and their function according to RHEL\u2019s introduction to cgroups : blkio \u2014 this subsystem sets limits on input/output access to and from block devices such as physical drives (disk, solid state, or USB). cpu \u2014 this subsystem uses the scheduler to provide cgroup processes access to the CPU. cpuacct \u2014 this subsystem generates automatic reports on CPU resources used by processes in a cgroup. cpuset \u2014 this subsystem assigns individual CPUs (on a multicore system) and memory nodes to processes in a cgroup. devices \u2014 this subsystem allows or denies access to devices by processes in a cgroup. freezer \u2014 this subsystem suspends or resumes processes in a cgroup. memory \u2014 this subsystem sets limits on memory use by processes in a cgroup and generates automatic reports on memory resources used by those processes. Cgroups follow a hierarchical, tree-like structure for each resource controller i.e one cgroup exists for each controller. Each cgroup in a hierarchy inherits certain attributes (e.g limits) from its parent cgroup. Let\u2019s try out a quick demo with memory cgroups to wrap our heads around the above ideas. You\u2019ll need a linux based OS (here, RedHat) with sudo permission to follow along.","title":"Cgroups"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#demo-cgroups","text":"Let\u2019s start by checking if cgroup tools are installed in your machine. Execute mount | grep \"^cgroup\" . If you have the tools installed you\u2019ll see a output like this: If not, install the tools with sudo yum install libcgroup-tools -y . Now, we create a memory cgroup called mem_group with \u201croot\u201d as the owner of the cgroup. Command executed sudo cgcreate -a root -g memory:mem_group . Verify that cgroup is created. /sys/fs/cgroup/ is the pseudo filesystem where a newly created cgroup is added as a sub-group. Memory cgroup puts a limit on the memory usage of processes in the cgroup. Let\u2019s see what the limits are for mem_group. The file for checking the memory limit is memory.limit_in_bytes( more information here , if you\u2019re interested). Note that mem_group has inherited the limit from its parent cgroup Now, let\u2019s reduce the memory usage limit to 20KB for the purpose of our demo (the actual limit is rounded off to the nearest power of 2). This limit is too low and hence most of the processes attached to mem_group should be OOM killed. Create a new shell and attach it to the cgroup. We need sudo permissions for this. The process is OOM killed as expected. You can confirm the same with dmesg logs (mm_fault_error). If you want to try out a more in-depth exercise on cgroups, check out this tutorial from Geeks for Geeks . Let\u2019s come back to containers again. Containers share the same kernel as the underlying host operating system and provide an isolated environment of the application within. Cgroups help in managing resources used by processes within a container and namespaces help isolate network stack, pids, users, group ids and mount points in a container from another container running on the same host. Of course, there are more components to containers which truly make it fully functional but that discussion is out of scope of this module.","title":"DEMO: cgroups"},{"location":"level102/containerization_and_orchestration/intro_to_containers/#container-engine","text":"Container engines ease the process of creating and managing containers in a host machine. How? The container creation workflow typically begins with a container image. A container image is a packaged, portable version of the target application bundled with all dependencies for it to run. These container images are either available on the host machine (container host) from previous builds or need to be pulled from a remote repository of images. Sometimes the container engine might need to build the container image from a set of instructions. Finally once the container image is fetched/built, the container engine unpacks the image and creates an isolated environment for the application as per the image specifications. The files in the container image are then mounted to the isolated environment to get the application up and running within the container. There are several container engines available like Docker, RKT, LXC (one of the first container engines) which require different image formats (Docker, LXD). OCI (Open Container Initiative) is a collaborative project started by Docker that aims to standardize container runtime specifications and image formats across vendors. OCI FAQ section is a good place to start if you\u2019re curious about this project. We will focus on Docker in the next section .","title":"Container engine"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/","text":"Introduction Now we finally arrive at the most awaited part: running and managing containers at scale. So far, we have seen how Docker facilitates managing the life-cycle of containers and provides improved portability of applications. Docker does provide a solution for easing the deployment of containers on a large scale ( you can check out Docker Swarm, if interested) which integrates well with Docker containers. However, Kubernetes has become the de-facto tool for orchestrating the management of microservices (as containers) in large distributed environments. Let\u2019s see the points of interest for us, SREs, to use container orchestration tools and Kubernetes in particular. Motivation to use Kubernetes Ease of usage Though there is a steep learning curve associated with Kubernetes, once learnt , can be used as a one stop tool to manage your microservices. With a single command it is possible to deploy full fledged production ready environments. The desired state of an application needs to be recorded as a YAML manifest and Kubernetes manages the application for you. Ensure optimum usage of resources We can specify limits on resources used by each container in a deployment. We can also specify our choice of nodes where Kubernetes can schedule nodes to be deployed (e.g microservices with high CPU consumption can be instructed to be deployed in high compute nodes). Fault tolerance Self-healing is built into basic resource types of Kubernetes. This removes the headache of designing a fault tolerant application system from scratch. This applies especially to stateless applications. Infrastructure agnostic Kubernetes does not have vendor lock-in. It can be set up in multiple cloud environments or in on-prem data centers. Strong community support and documentation Kubernetes is open-source and many technologies like operators, service mesh etc. have been built by the community to manage and monitor Kubernetes-orchestrated applications better. Extensible and customisable We can build our custom resource definitions which fit our use case for managing applications and use Kubernetes to manage them (with custom controllers). You can check out this article if you are more interested in this topic. Architecture of Kubernetes Here\u2019s a diagram (from the official Kubernetes documentation ) containing different components which make Kubernetes work: Kubernetes components can be divided into two parts: control plane components and data plane components . A Kubernetes cluster consists of 1 or more host machines (called nodes) where the containers managed by Kubernetes are run. This constitutes the data plane (or node plane). The brain of Kuberentes which responds to events from the node plane (e.g create a pod, replicas mismatch) and does the main orchestration is called the control plane. All control plane components are typically installed in a master node. This master node does not run any user containers. The Kubernetes components themselves are run as containers wrapped in Pods (which is the most basic kubernetes resource object). Control plane components: kube-apiserver etcd kube-scheduler kube-controller-manager Node plane components kubelet kube-proxy This workflow might help you understand the working on components better: An SRE installs kubectl in their local machine. This is the client which interacts with the Kubernetes control plane (and hence the cluster). They create a YAML file, called manifest which specifies the desired state of the resource (e.g a deployment names \u201cfrontend\u201d needs 3 pods to always be running) When they issue a command to create objects based in the YAML file, the kubectl CLI tool sends a rest API request to the kube-apiserver . If the manifest is valid, it is stored as key value pairs in the etcd server on the control plane. kube-scheduler chooses which nodes to put the containers on (basically schedules them) There are controller processes (managed by kube-controller manager) which makes sure the current state of the cluster is equivalent to the desired state (here, 3 pods are indeed running in the cluster -> all is fine). On the node plane side, kubelet makes sure that pods are locally kept in running state. LAB Prerequisites The best way to start this exercise is to use a Katacoda kubernetes playground . A single node kubernetes cluster is already set up for you here for quick experimentation. You can also use this to play with docker. The environment gets torn down after 10 mins. So make sure that you save your files if you want to resume them. For persistent kubernetes clusters, you can set it up either in your local (using minikube ) or you can create a kubernetes cluster in Azure , GCP or any other cloud provider. Knowledge of YAML is nice to have for understanding the manifest files. Hands-on Lab 1: We are going to create an object called Pod which is the most basic unit for running a container in Kubernetes. Here, we will create a pod called \u2018nginx-pod\u201d which contains an nginx container called \u201cweb\u201d. We will also expose port 80 in the container so that we can interact with the nginx container. Save the below manifest in a file called nginx-pod.yaml apiVersion: v1 #[1] kind: Pod #[2] metadata: #[3] name: nginx-pod #[4] labels: #[5] app: nginx spec: #[6] containers: #[7] - name: web #[8] image: nginx #[9] ports: #[10] - name: web #[11] containerPort: 80 #[12] protocol: TCP #[13] Let\u2019s very briefly understand what\u2019s here: #[2] - kind: The \u201ckind\u201d of object that\u2019s being created. Here it is a Pod #[1] - apiVersion: The apiVersion of the \u201cPod\u201d resource. There could be minor changes in the values or keys in the yaml file if the version varies. #[3] - metadata: The metadata section of the file where pod labels and name is given #[6] - spec: This is the main part where the things inside the pod are defined These are not random key value pairs! They have to be interpretable by the kubeapiserver. You can check which key value pairs are optional/mandatory using kubectl explain pod command. Do try it out! Apply the manifest using the command kubectl apply -f nginx-pod.yaml . This creates the \u201cnginx-pod\u201d pod in the kubernetes cluster. Verify that the pod is in running state using kubectl get pod . It shows that nginx-pod is in Running state. 1/1 indicates that out of 1 out of 1 container(s) inside the pod is healthy. To check if the container running in \u201cnginx-pod\u201d is indeed \u201cweb\u201d we do the kubectl describe pod/nginx-pod command. This gives a lengthy output with a detailed description of the pod and the events that happened since the pod was created. This command is very useful for debugging. The part we are concerned here is this: You can see \u201cweb\u201d under the Containers section with Image as nginx. This is what we are looking for. How do we access the welcome page of nginx \u201cweb\u201d container? In the describe command you can see the IP address of the pod. Each pod is assigned an IP address on creation. Here, this is 10.244.1.3 Issue a curl request from the host curl 10.244.1.3:80 . You will get the welcome page! Let\u2019s say we want to use a specific tag of nginx (say 1.20.1) in the same pod i.e we want to modify some property of the pod. You can try editing nginx-pod.yaml (image: nginx:1.20.1 in #[9])and reapplying (step 2.). It will create a new container in the same pod with the new image. A container is created within the pod but the pod is the same. You can verify by checking the pod start time in describe command. It would show a much older time. You can actually see the nginx container by doing docker ps on the node01 terminal (if you\u2019re using Katacoda). What if we want to change the image to 1.20.1 for 1000 nginx pods? Stepping a little back, what if we want to create 1000 nginx pods. Of course, we can write a script but Kubernetes already offers a resource type called \u201cdeployment\u201d to manage large scale deployments better. Lab 2: We\u2019ll go a step further to see how we can create more than a single instance of the nginx pod at the same time. We will first create Save the below manifest in a file called nginx-deploy.yaml apiVersion: apps/v1 kind: Deployment #[1] metadata: name: nginx-deployment labels: app: nginx spec: replicas: 3 #[2] selector: matchLabels: app: nginx #[3] template: #[4] metadata: labels: app: nginx #[5] spec: containers: - name: web image: nginx ports: - name: web containerPort: 80 protocol: \"TCP\" You can see that it is similar to a pod definition till spec ( #[1] has Deployment as kind, api version is also different). Another thing interesting observation is the metadata and spec parts under #[4] is almost the same as the metadata and spec section under the Pod definition in Lab 1 (do go up and cross check this). What this implies is that we are deploying 3 nginx pods similar to Lab1. Also, the labels in matchLabels should be the same as labels under #[4] . Now apply the manifest using kubectl apply -f nginx-deploy.yaml Verify that 3 pods are indeed created. If you\u2019re curious, check the output of kubectl get deploy and kubectl describe deploy nginx-deployment . Delete one of the 3 pods using kubectl delete pod . After a few seconds again do kubectl get pod . You can see that a new pod is spawned to keep the total number of pods as 3 (see AGE 15s compared to others created 27 minutes ago)! This is a demonstration of how Kubernetes does fault tolerance. This is a property of Kubernetes deployment object (kill the pod from Lab1, it won\u2019t be respawned :) ) Let\u2019s say we want to increase the number of pods to 10. Try out kubectl scale deploy --replicas=10 nginx-deployment . You can see that 3/10 pods are older than the rest. This means Kubernetes has added 7 extra pods to scale the deployment to 10. This shows how simple it is to scale up and scale down containers using Kubernetes. Let\u2019s put all these pods behind a ClusterIP service. Execute kubectl expose deployment nginx-deployment --name=nginx-service . Curl the IP corresponding to 10.96.114.184. This curl request reaches one of the 10 pods in the deployment \u201cnginx-deployment\u201d in a round robin fashion. What happens when we execute the expose command is that a kubernetes Service is created of type Cluster IP so that all the pods behind this service are accessible through a single local IP (10.96.114.184, here). It is possible to have a public IP instead (i.e an actual external load balancer) by creating a Service of type LoadBalancer . Do feel free to play around with it! The above exercises a pretty good exposure to using Kubernetes to manage large scale deployments. Trust me, the process is very similar to the above for operating 1000 deployments and containers too! While a Deployment object is good enough for managing stateless applications, Kuberenetes provides other resources like Job, Daemonset, Cronjob, Statefulset etc. to manage special use cases. eAdditional labs: https://www.katacoda.com/lizrice/scenarios/kube-web https://www.katacoda.com/courses/kubernetes (Huge number of free follow-along exercises to play with Kubernetes) Advanced topics Most often than not, microservices orchestrated with Kubernetes contain dozens of instances of resources like deployment, services and configs. The manifests for these applications can be auto- generated with Helm templates and passed on as Helm charts. Similar to how we have PiPy for python packages there are remote repositories like Bitnami where Helm charts (e.g for setting up a production-ready Prometheus or Kafka with a single click) can be downloaded and used. This is a good place to begin . Kuberenetes provides the flexibility to create our custom resources (similar to Deployment or the Pod which we saw). For instance, if you want to create 5 instances of a resource with kind as SchoolOfSre you can! The only thing is that you have to write your custom resource for it. You can also build a custom operator for your custom resource to take certain actions on the resource instance. You can check here for more information.","title":"Orchestration With Kubernetes"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#introduction","text":"Now we finally arrive at the most awaited part: running and managing containers at scale. So far, we have seen how Docker facilitates managing the life-cycle of containers and provides improved portability of applications. Docker does provide a solution for easing the deployment of containers on a large scale ( you can check out Docker Swarm, if interested) which integrates well with Docker containers. However, Kubernetes has become the de-facto tool for orchestrating the management of microservices (as containers) in large distributed environments. Let\u2019s see the points of interest for us, SREs, to use container orchestration tools and Kubernetes in particular.","title":"Introduction"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#motivation-to-use-kubernetes","text":"Ease of usage Though there is a steep learning curve associated with Kubernetes, once learnt , can be used as a one stop tool to manage your microservices. With a single command it is possible to deploy full fledged production ready environments. The desired state of an application needs to be recorded as a YAML manifest and Kubernetes manages the application for you. Ensure optimum usage of resources We can specify limits on resources used by each container in a deployment. We can also specify our choice of nodes where Kubernetes can schedule nodes to be deployed (e.g microservices with high CPU consumption can be instructed to be deployed in high compute nodes). Fault tolerance Self-healing is built into basic resource types of Kubernetes. This removes the headache of designing a fault tolerant application system from scratch. This applies especially to stateless applications. Infrastructure agnostic Kubernetes does not have vendor lock-in. It can be set up in multiple cloud environments or in on-prem data centers. Strong community support and documentation Kubernetes is open-source and many technologies like operators, service mesh etc. have been built by the community to manage and monitor Kubernetes-orchestrated applications better. Extensible and customisable We can build our custom resource definitions which fit our use case for managing applications and use Kubernetes to manage them (with custom controllers). You can check out this article if you are more interested in this topic.","title":"Motivation to use Kubernetes"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#architecture-of-kubernetes","text":"Here\u2019s a diagram (from the official Kubernetes documentation ) containing different components which make Kubernetes work: Kubernetes components can be divided into two parts: control plane components and data plane components . A Kubernetes cluster consists of 1 or more host machines (called nodes) where the containers managed by Kubernetes are run. This constitutes the data plane (or node plane). The brain of Kuberentes which responds to events from the node plane (e.g create a pod, replicas mismatch) and does the main orchestration is called the control plane. All control plane components are typically installed in a master node. This master node does not run any user containers. The Kubernetes components themselves are run as containers wrapped in Pods (which is the most basic kubernetes resource object). Control plane components: kube-apiserver etcd kube-scheduler kube-controller-manager Node plane components kubelet kube-proxy This workflow might help you understand the working on components better: An SRE installs kubectl in their local machine. This is the client which interacts with the Kubernetes control plane (and hence the cluster). They create a YAML file, called manifest which specifies the desired state of the resource (e.g a deployment names \u201cfrontend\u201d needs 3 pods to always be running) When they issue a command to create objects based in the YAML file, the kubectl CLI tool sends a rest API request to the kube-apiserver . If the manifest is valid, it is stored as key value pairs in the etcd server on the control plane. kube-scheduler chooses which nodes to put the containers on (basically schedules them) There are controller processes (managed by kube-controller manager) which makes sure the current state of the cluster is equivalent to the desired state (here, 3 pods are indeed running in the cluster -> all is fine). On the node plane side, kubelet makes sure that pods are locally kept in running state.","title":"Architecture of Kubernetes"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#lab","text":"","title":"LAB"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#prerequisites","text":"The best way to start this exercise is to use a Katacoda kubernetes playground . A single node kubernetes cluster is already set up for you here for quick experimentation. You can also use this to play with docker. The environment gets torn down after 10 mins. So make sure that you save your files if you want to resume them. For persistent kubernetes clusters, you can set it up either in your local (using minikube ) or you can create a kubernetes cluster in Azure , GCP or any other cloud provider. Knowledge of YAML is nice to have for understanding the manifest files.","title":"Prerequisites"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#hands-on","text":"","title":"Hands-on"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#lab-1","text":"We are going to create an object called Pod which is the most basic unit for running a container in Kubernetes. Here, we will create a pod called \u2018nginx-pod\u201d which contains an nginx container called \u201cweb\u201d. We will also expose port 80 in the container so that we can interact with the nginx container. Save the below manifest in a file called nginx-pod.yaml apiVersion: v1 #[1] kind: Pod #[2] metadata: #[3] name: nginx-pod #[4] labels: #[5] app: nginx spec: #[6] containers: #[7] - name: web #[8] image: nginx #[9] ports: #[10] - name: web #[11] containerPort: 80 #[12] protocol: TCP #[13] Let\u2019s very briefly understand what\u2019s here: #[2] - kind: The \u201ckind\u201d of object that\u2019s being created. Here it is a Pod #[1] - apiVersion: The apiVersion of the \u201cPod\u201d resource. There could be minor changes in the values or keys in the yaml file if the version varies. #[3] - metadata: The metadata section of the file where pod labels and name is given #[6] - spec: This is the main part where the things inside the pod are defined These are not random key value pairs! They have to be interpretable by the kubeapiserver. You can check which key value pairs are optional/mandatory using kubectl explain pod command. Do try it out! Apply the manifest using the command kubectl apply -f nginx-pod.yaml . This creates the \u201cnginx-pod\u201d pod in the kubernetes cluster. Verify that the pod is in running state using kubectl get pod . It shows that nginx-pod is in Running state. 1/1 indicates that out of 1 out of 1 container(s) inside the pod is healthy. To check if the container running in \u201cnginx-pod\u201d is indeed \u201cweb\u201d we do the kubectl describe pod/nginx-pod command. This gives a lengthy output with a detailed description of the pod and the events that happened since the pod was created. This command is very useful for debugging. The part we are concerned here is this: You can see \u201cweb\u201d under the Containers section with Image as nginx. This is what we are looking for. How do we access the welcome page of nginx \u201cweb\u201d container? In the describe command you can see the IP address of the pod. Each pod is assigned an IP address on creation. Here, this is 10.244.1.3 Issue a curl request from the host curl 10.244.1.3:80 . You will get the welcome page! Let\u2019s say we want to use a specific tag of nginx (say 1.20.1) in the same pod i.e we want to modify some property of the pod. You can try editing nginx-pod.yaml (image: nginx:1.20.1 in #[9])and reapplying (step 2.). It will create a new container in the same pod with the new image. A container is created within the pod but the pod is the same. You can verify by checking the pod start time in describe command. It would show a much older time. You can actually see the nginx container by doing docker ps on the node01 terminal (if you\u2019re using Katacoda). What if we want to change the image to 1.20.1 for 1000 nginx pods? Stepping a little back, what if we want to create 1000 nginx pods. Of course, we can write a script but Kubernetes already offers a resource type called \u201cdeployment\u201d to manage large scale deployments better.","title":"Lab 1:"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#lab-2","text":"We\u2019ll go a step further to see how we can create more than a single instance of the nginx pod at the same time. We will first create Save the below manifest in a file called nginx-deploy.yaml apiVersion: apps/v1 kind: Deployment #[1] metadata: name: nginx-deployment labels: app: nginx spec: replicas: 3 #[2] selector: matchLabels: app: nginx #[3] template: #[4] metadata: labels: app: nginx #[5] spec: containers: - name: web image: nginx ports: - name: web containerPort: 80 protocol: \"TCP\" You can see that it is similar to a pod definition till spec ( #[1] has Deployment as kind, api version is also different). Another thing interesting observation is the metadata and spec parts under #[4] is almost the same as the metadata and spec section under the Pod definition in Lab 1 (do go up and cross check this). What this implies is that we are deploying 3 nginx pods similar to Lab1. Also, the labels in matchLabels should be the same as labels under #[4] . Now apply the manifest using kubectl apply -f nginx-deploy.yaml Verify that 3 pods are indeed created. If you\u2019re curious, check the output of kubectl get deploy and kubectl describe deploy nginx-deployment . Delete one of the 3 pods using kubectl delete pod . After a few seconds again do kubectl get pod . You can see that a new pod is spawned to keep the total number of pods as 3 (see AGE 15s compared to others created 27 minutes ago)! This is a demonstration of how Kubernetes does fault tolerance. This is a property of Kubernetes deployment object (kill the pod from Lab1, it won\u2019t be respawned :) ) Let\u2019s say we want to increase the number of pods to 10. Try out kubectl scale deploy --replicas=10 nginx-deployment . You can see that 3/10 pods are older than the rest. This means Kubernetes has added 7 extra pods to scale the deployment to 10. This shows how simple it is to scale up and scale down containers using Kubernetes. Let\u2019s put all these pods behind a ClusterIP service. Execute kubectl expose deployment nginx-deployment --name=nginx-service . Curl the IP corresponding to 10.96.114.184. This curl request reaches one of the 10 pods in the deployment \u201cnginx-deployment\u201d in a round robin fashion. What happens when we execute the expose command is that a kubernetes Service is created of type Cluster IP so that all the pods behind this service are accessible through a single local IP (10.96.114.184, here). It is possible to have a public IP instead (i.e an actual external load balancer) by creating a Service of type LoadBalancer . Do feel free to play around with it! The above exercises a pretty good exposure to using Kubernetes to manage large scale deployments. Trust me, the process is very similar to the above for operating 1000 deployments and containers too! While a Deployment object is good enough for managing stateless applications, Kuberenetes provides other resources like Job, Daemonset, Cronjob, Statefulset etc. to manage special use cases. eAdditional labs: https://www.katacoda.com/lizrice/scenarios/kube-web https://www.katacoda.com/courses/kubernetes (Huge number of free follow-along exercises to play with Kubernetes)","title":"Lab 2:"},{"location":"level102/containerization_and_orchestration/orchestration_with_kubernetes/#advanced-topics","text":"Most often than not, microservices orchestrated with Kubernetes contain dozens of instances of resources like deployment, services and configs. The manifests for these applications can be auto- generated with Helm templates and passed on as Helm charts. Similar to how we have PiPy for python packages there are remote repositories like Bitnami where Helm charts (e.g for setting up a production-ready Prometheus or Kafka with a single click) can be downloaded and used. This is a good place to begin . Kuberenetes provides the flexibility to create our custom resources (similar to Deployment or the Pod which we saw). For instance, if you want to create 5 instances of a resource with kind as SchoolOfSre you can! The only thing is that you have to write your custom resource for it. You can also build a custom operator for your custom resource to take certain actions on the resource instance. You can check here for more information.","title":"Advanced topics"},{"location":"level102/continuous_integration_and_continuous_delivery/cicd_brief_history/","text":"The Evolution of the CI/CD Traditional development approaches have been around for a very long time. The waterfall model has been widely used in both large and small projects and has been successful. Despite the success, it has a lot of drawbacks like longer cycle times or delivery. While multiple team members are working on the project, the code changes get accumulated and never integrated until the planned build date. The build usually happens on agreed cycles that range from a month to a quarter. This results in several integration issues and build failures as the developers were working on their features in silos. It was a nightmare situation for the operations teams/for anyone to deploy the new builds/releases to the production environment because of lack of proper documentation on every change and the configuration requirements. So, to deploy successfully, often it required hot fixes and immediate patches. Another big challenge was collaboration. It is rare that the developer meets the operation engineers and does not have a full understanding of the production environment. All these challenges have given rise to longer cycle times for the delivery of the code changes. Agile methodology prescribes the delivery of incremental delivery of features in multiple iterations. So, the developers commit their code changes in smaller increments and roll out more frequently. Every code commit triggers a new build, and the integration issues are identified much early. This has improved the build process and thereby reduced the cycle time. This process is known as continuous integration or CI . The big barrier between the developers and the operation teams has been shrunken with the emergence of the trend where organizations are adapting to the DevOps and SRE disciplines. The collaboration between the developers and the operation teams is improved. Moreover, the use of the same tools and processes by both the teams has improved coordination and avoided conflicting understanding of the process. One of the main drivers in this regard is the continuous delivery (CD) process that ensures the incremental deployment of smaller changes. There are multiple pre-production environments also called the staging environments before deploying to production environments. CI/CD and DevOps The term DevOps represents the combination of Development (Dev) and Operations (Ops) teams. That is bringing developers and operations teams together for more collaboration. The development team often wants to introduce more features and more changes while the operation teams are more focused on the stability of the application in production. A change is always taken as a threat by the operations team as it can shake the stability of the environment. DevOps is termed as a culture that introduces the processes to reduce the barriers between developers and operations. The collaboration between Dev and Ops allows better follow-up of end-to-end production deployments and more frequent deployments. So, thus CI/CD is a key element in the DevOps processes.","title":"Brief History"},{"location":"level102/continuous_integration_and_continuous_delivery/cicd_brief_history/#the-evolution-of-the-cicd","text":"Traditional development approaches have been around for a very long time. The waterfall model has been widely used in both large and small projects and has been successful. Despite the success, it has a lot of drawbacks like longer cycle times or delivery. While multiple team members are working on the project, the code changes get accumulated and never integrated until the planned build date. The build usually happens on agreed cycles that range from a month to a quarter. This results in several integration issues and build failures as the developers were working on their features in silos. It was a nightmare situation for the operations teams/for anyone to deploy the new builds/releases to the production environment because of lack of proper documentation on every change and the configuration requirements. So, to deploy successfully, often it required hot fixes and immediate patches. Another big challenge was collaboration. It is rare that the developer meets the operation engineers and does not have a full understanding of the production environment. All these challenges have given rise to longer cycle times for the delivery of the code changes. Agile methodology prescribes the delivery of incremental delivery of features in multiple iterations. So, the developers commit their code changes in smaller increments and roll out more frequently. Every code commit triggers a new build, and the integration issues are identified much early. This has improved the build process and thereby reduced the cycle time. This process is known as continuous integration or CI . The big barrier between the developers and the operation teams has been shrunken with the emergence of the trend where organizations are adapting to the DevOps and SRE disciplines. The collaboration between the developers and the operation teams is improved. Moreover, the use of the same tools and processes by both the teams has improved coordination and avoided conflicting understanding of the process. One of the main drivers in this regard is the continuous delivery (CD) process that ensures the incremental deployment of smaller changes. There are multiple pre-production environments also called the staging environments before deploying to production environments.","title":"The Evolution of the CI/CD"},{"location":"level102/continuous_integration_and_continuous_delivery/cicd_brief_history/#cicd-and-devops","text":"The term DevOps represents the combination of Development (Dev) and Operations (Ops) teams. That is bringing developers and operations teams together for more collaboration. The development team often wants to introduce more features and more changes while the operation teams are more focused on the stability of the application in production. A change is always taken as a threat by the operations team as it can shake the stability of the environment. DevOps is termed as a culture that introduces the processes to reduce the barriers between developers and operations. The collaboration between Dev and Ops allows better follow-up of end-to-end production deployments and more frequent deployments. So, thus CI/CD is a key element in the DevOps processes.","title":"CI/CD and DevOps"},{"location":"level102/continuous_integration_and_continuous_delivery/conclusion/","text":"Applications in SRE Role The Monitoring, Automation and Eliminating the toil are some of the core pillars of the SRE discipline. As an SRE, you may require spending about 50% of time on automating the repetitive tasks and to eliminate the toil. CI/CD pipelines are one of the crucial tools for the SRE. They help in delivering the quality application with the smaller and regular and more frequent builds. Additionally, the CI/CD metrics such as Deployment time, Success rate, Cycle time and Automated test success rate etc. are the key things to watch to improve the quality of the product thus improving the reliability of the applications. Infrastructure-as-code is one of the standard practices followed in SRE for automating the repetitive configuration tasks. Every configuration is maintained as code, so it can be deployed using CI/CD pipelines. It is important to deliver the configuration changes to the production environments through CI/CD pipelines to maintain the versioning, consistency of the changes across environments and to avoid manual errors. Often, as an SRE, you are required to review the application CI/CD pipelines and recommend additional stages such as static code analysis and the security and privacy checks in the code to improve the security and reliability of the product. Conclusion In this chapter, we have studied the CI/CD pipelines with brief history on the challenges with the traditional build practices. We have also looked at how the CI/CD pipelines augments the SRE discipline. Use of CI/CD pipelines in software development life cycle is a modern approach in the SRE realm that helps achieve greater efficiency. We have also performed a hands-on lab activity on creating the CI/CD pipeline using Jenkins. References Continuous Integration(martinfowler.com) CI/CD for microservices - Azure Architecture Center | Microsoft Docs SREFoundationBlueprint_2 (devopsinstitute.com) Jenkins User Documentation","title":"Conclusion"},{"location":"level102/continuous_integration_and_continuous_delivery/conclusion/#applications-in-sre-role","text":"The Monitoring, Automation and Eliminating the toil are some of the core pillars of the SRE discipline. As an SRE, you may require spending about 50% of time on automating the repetitive tasks and to eliminate the toil. CI/CD pipelines are one of the crucial tools for the SRE. They help in delivering the quality application with the smaller and regular and more frequent builds. Additionally, the CI/CD metrics such as Deployment time, Success rate, Cycle time and Automated test success rate etc. are the key things to watch to improve the quality of the product thus improving the reliability of the applications. Infrastructure-as-code is one of the standard practices followed in SRE for automating the repetitive configuration tasks. Every configuration is maintained as code, so it can be deployed using CI/CD pipelines. It is important to deliver the configuration changes to the production environments through CI/CD pipelines to maintain the versioning, consistency of the changes across environments and to avoid manual errors. Often, as an SRE, you are required to review the application CI/CD pipelines and recommend additional stages such as static code analysis and the security and privacy checks in the code to improve the security and reliability of the product.","title":"Applications in SRE Role"},{"location":"level102/continuous_integration_and_continuous_delivery/conclusion/#conclusion","text":"In this chapter, we have studied the CI/CD pipelines with brief history on the challenges with the traditional build practices. We have also looked at how the CI/CD pipelines augments the SRE discipline. Use of CI/CD pipelines in software development life cycle is a modern approach in the SRE realm that helps achieve greater efficiency. We have also performed a hands-on lab activity on creating the CI/CD pipeline using Jenkins.","title":"Conclusion"},{"location":"level102/continuous_integration_and_continuous_delivery/conclusion/#references","text":"Continuous Integration(martinfowler.com) CI/CD for microservices - Azure Architecture Center | Microsoft Docs SREFoundationBlueprint_2 (devopsinstitute.com) Jenkins User Documentation","title":"References"},{"location":"level102/continuous_integration_and_continuous_delivery/continuous_delivery_release_pipeline/","text":"Continuous Delivery means deploying the application builds more frequently in the non-production environments such as SIT, UAT, INT and performing the integration tests and the acceptance tests automatically. In the CD, the tests are performed on the integrated application instead of the single microservice in the cases of microservice based application. The tests must include all the functional tests and the acceptance tests that may contain the UI tests. The build must be immutable in nature, that is the same package must be deployed across all the environments including the Production. The deployment to the Production is often manual after performing additional acceptance tests such as performance tests etc. So, the fully automated deployment to the Production environments is called the Continuous Deployment (whereas CD \u2013 Continuous delivery doesn\u2019t automatically deploy to Production). The continuous deployment must have a feature toggle so that a feature can be toggled off without the need for redeploying the code. Often, the deployment involves more than one production environment, for example in blue-green environments the application is first deployed to the blue environment and then to the green environment so that the downtime is not required. Fig 3: Continuous Delivery Pipeline","title":"Continuous Delivery and Deployment"},{"location":"level102/continuous_integration_and_continuous_delivery/continuous_integration_build_pipeline/","text":"CI is a software development practice where members of a team integrate their work frequently. Each integration is verified by an automated build (including test) to detect integration errors as quickly as possible. Continuous integration requires that all the code changes be maintained in a single code repository where all the members can push the changes to their feature branches regularly. The code changes must be quickly integrated with the rest of the code and automated builds should happen and feedback to the member to resolve them early. There should be a CI server where it can trigger a build as soon as the code is pushed by a member. The build typically involves compiling the code and transforming it to an executable file such as JARs or DLLs etc. called packaging. It must also perform unit tests with code coverage. Optionally, the build process can have additional stages such as static code analysis and vulnerability checks etc. Jenkins , Bamboo , Travis CI , GitLab , Azure DevOps etc. are the few popular CI tools. These tools provide various plugins and integration such as ant , maven etc. for building and packaging, and Junit, selenium etc. are for performing the unit tests. SonarQube can be used for static code analysis and code security. Fig 1: Continuous Integration Pipeline Fig 2: Continuous Integration Process","title":"Continuous Integration"},{"location":"level102/continuous_integration_and_continuous_delivery/introduction/","text":"Prerequisites Software Development and Maintenance Git Docker What to expect from this course? In this course, you will learn the basics of CI/CD and how it helps drive the SRE discipline in an organization. It also discusses the various DevOps tools in CI/CD practice and a hands-on lab session on Jenkins based pipeline. Finally, it will conclude by explaining the role in the growing SRE philosophy. What is not covered under this course? The course does not cover DevOps elements such as Infrastructure as a code, continuous monitoring applications and infrastructure comprehensively. Table of Contents What is CI/CD? Brief History to CI/CD and DevOps Continuous Integration Continuous Delivery and Deployment Jenkins based CI/CD pipeline - Hands-on Conclusion","title":"Introduction"},{"location":"level102/continuous_integration_and_continuous_delivery/introduction/#prerequisites","text":"Software Development and Maintenance Git Docker","title":"Prerequisites"},{"location":"level102/continuous_integration_and_continuous_delivery/introduction/#what-to-expect-from-this-course","text":"In this course, you will learn the basics of CI/CD and how it helps drive the SRE discipline in an organization. It also discusses the various DevOps tools in CI/CD practice and a hands-on lab session on Jenkins based pipeline. Finally, it will conclude by explaining the role in the growing SRE philosophy.","title":"What to expect from this course?"},{"location":"level102/continuous_integration_and_continuous_delivery/introduction/#what-is-not-covered-under-this-course","text":"The course does not cover DevOps elements such as Infrastructure as a code, continuous monitoring applications and infrastructure comprehensively.","title":"What is not covered under this course?"},{"location":"level102/continuous_integration_and_continuous_delivery/introduction/#table-of-contents","text":"What is CI/CD? Brief History to CI/CD and DevOps Continuous Integration Continuous Delivery and Deployment Jenkins based CI/CD pipeline - Hands-on Conclusion","title":"Table of Contents"},{"location":"level102/continuous_integration_and_continuous_delivery/introduction_to_cicd/","text":"Continuous Integration and Continuous Delivery, also known as CI/CD, is a set of processes that helps in faster integration of software code changes and deployment to the end user in a reliable manner. The more frequent integrations and deployments helps reduce the software development lifecycle. There are three practices in CI/CD: Continuous Integration Continuous Delivery Continuous Deployment Let\u2019s look in detail at each of these in the coming sections. The Benefits of CI/CD Significant reduction in integration problems. Teams can develop cohesive software more rapidly. Improved Collaboration between developers and operation teams can reduce the production integration issues. Faster delivery of new features with less friction Better debugging the production issues and fixing them in the next release/patch.","title":"What is CI/CD?"},{"location":"level102/continuous_integration_and_continuous_delivery/introduction_to_cicd/#the-benefits-of-cicd","text":"Significant reduction in integration problems. Teams can develop cohesive software more rapidly. Improved Collaboration between developers and operation teams can reduce the production integration issues. Faster delivery of new features with less friction Better debugging the production issues and fixing them in the next release/patch.","title":"The Benefits of CI/CD"},{"location":"level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/","text":"Jenkins based CI/CD Pipeline Jenkins is an open-source continuous integration server for orchestrating the CI/CD pipelines. It supports integration with several components, infrastructure such as git, cloud etc. that helps in complete software development life cycle. In this hands-on lab, let us: * Create a build pipeline (CI) for a simple java application. * Adding Test stage to build pipeline This hands-on is based on the Jenkins running on docker on your local workstation, designed for Windows OS. For Linux OS, please follow the demo Note: The hands-on lab is designed with Jenkins on the docker. However, the steps are applicable for the direct docker installation on your windows workstation as well. Installing Git, Docker and Jenkins: Install git command line tool on your workstation. (Follow this to install Git Locally\u00b7) Docker Desktop for windows is installed on the workstation. Follow the instructions to install docker. Ensure that your Docker for Windows installation is configured to run Linux Containers rather than Windows Containers. See the Docker documentation for instructions to switch to Linux containers. Refer this to run and setup the Jenkins on docker. Configure Jenkins with initial steps such as create an admin user etc. Follow Setup wizard. If you have installed the Jenkins on your local workstation, make sure the maven tool is installed. Follow this to installl maven. Forking Sample java application: For this hands-on, let us fork a simple java application from the GitHub simple-java-maven-app . 1. Sign up for the GitHub account Join GitHub \u00b7 GitHub . Once signed up, proceed to login . 2. Open the simple-java-maven-app by clicking on this link 3. On the top right corner, click on the \u2018Fork\u2019 to create a copy of the project to your GitHub account. (Refer Fork A Repo ) 4. Once forked, clone this repository to your local workstation. Create Jenkins Project: Login to the Jenkins portal at http://localhost:8080 using the admin account created earlier during Jenkins\u2019s setup. On your first login, the following screen will appear. Click on \u201c Create a Job \u201d. Fig 4: Jenkins - Create a Job On the next screen, type simple-java-pipeline in the Enter an Item Name field. Select Pipeline from the list of items and click OK . Fig 5: Jenkins - Create Pipeline Click the Pipeline tab at the top of the page to scroll down to the Pipeline section. From the Definition field, choose the Pipeline script from SCM option. This option instructs Jenkins to obtain your Pipeline from Source Control Management (SCM), which will be your locally cloned Git repository. From the SCM field, choose Git . In the Repository URL field, specify the directory path of your locally cloned repository from the Forking Sample Java application section above. Screen looks like below after entering the details. Fig 6: Jenkins - Pipeline Configuration Create Build pipeline using the Jenkinsfile: Jenkinsfile is a script file containing the pipeline configuration and the stages and other instructions to Jenkins to create a pipeline from the file. This file will be saved at the root of the code repository. 1. Using your favorite text editor or IDE, create and save a new text file with the name Jenkinsfile at the root of your local simple-java-maven-app Git repository. 2. Copy the following declarative pipeline code and paste it into the empty Jenkinsfile . pipeline { agent { docker { image 'maven:3.8.1-adoptopenjdk-11' args '-v /root/.m2:/root/.m2' } } stages { stage('Build') { steps { sh 'mvn -B -DskipTests clean package' } } } } Note: If you are running Jenkins on your local workstation without the docker, please change the agent to any as shown below so that it runs on the localhost. Please ensure that the maven tool is installed on your local workstation. pipeline { agent any stages { stage('Build') { steps { sh 'mvn -B -DskipTests clean package' } } } } In the above Jenkinsfile: * We specified an agent where the pipeline should run. 'docker\u2019 in the agent section indicates to run a new docker container with the specified image. * In the stages section, we can define multiple steps as different stages. Here, we have a stage called \u2018Build\u2019, with the maven command for building the java application. Save your Jenkinsfile and commit and push to your forked repository. Run the following commands from the command prompt. cd git add . git commit -m \"Add initial Jenkinsfile\" git push origin master Go to Jenkins portal on your browser and click on the Dashboard . Open the simple-java-pipeline and from the left-menu, click on Build Now . Fig 7: Jenkins - Building the Pipeline Notice the build running under the Build History menu. Click on the build number and it shows the stages. Fig 8: Jenkins - View Running Builds We have successfully created a build pipeline with single stage and ran it. We can check the logs by clicking on the Console Output menu. Additional stages in the build pipeline: In the previous section, we have created the pipeline with a single stage. Typically, your CI pipeline contains multiple stages such as Build, Test and other optional stages such Code scanning etc. In this section, let us add a Test stage to the build pipeline and run. Go back to your text editor/IDE and open Jenkinsfile and the Test stage shown below. stage('Test') { steps { sh 'mvn test' } post { always { junit 'target/surefire-reports/*.xml' } } } The Jenkinsfile looks like below after adding the Test stage. pipeline { agent { docker { image 'maven:3.8.1-adoptopenjdk-11' args '-v /root/.m2:/root/.m2' } } stages { stage('Build') { steps { sh 'mvn -B -DskipTests clean package' } } stage('Test') { steps { sh 'mvn test' } post { always { junit 'target/surefire-reports/*.xml' } } } } } Here the stage \u2018Test\u2019 is added which runs the maven command test. The post -> always section ensures that this step is executed always after the steps are completed. The test report is available through Jenkins\u2019s interface. Note: If you are running Jenkins on your local workstation without the docker, please change the agent to any so that it runs on the localhost. Please ensure that the maven tool is installed on your local workstation. pipeline { agent any stages {\u2026 } } Save your Jenkinsfile and commit and push to your forked repository. Run the following commands from the command prompt. cd git add . git commit -m \"Test stage is added to Jenkinsfile\" git push origin master Go to Jenkins portal on your browser and click on the Dashboard . Open the simple-java-pipeline and from the left-menu, click on Build Now. Notice the Build and Test stages are showing in the Build screen. Fig 9: Jenkins - Viewing the Running Builds with Test stage Included We have now successfully created CI pipeline with two stages: Build and Test stages.","title":"CI/CD Pipeline - Hands-on"},{"location":"level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/#jenkins-based-cicd-pipeline","text":"Jenkins is an open-source continuous integration server for orchestrating the CI/CD pipelines. It supports integration with several components, infrastructure such as git, cloud etc. that helps in complete software development life cycle. In this hands-on lab, let us: * Create a build pipeline (CI) for a simple java application. * Adding Test stage to build pipeline This hands-on is based on the Jenkins running on docker on your local workstation, designed for Windows OS. For Linux OS, please follow the demo Note: The hands-on lab is designed with Jenkins on the docker. However, the steps are applicable for the direct docker installation on your windows workstation as well.","title":"Jenkins based CI/CD Pipeline"},{"location":"level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/#installing-git-docker-and-jenkins","text":"Install git command line tool on your workstation. (Follow this to install Git Locally\u00b7) Docker Desktop for windows is installed on the workstation. Follow the instructions to install docker. Ensure that your Docker for Windows installation is configured to run Linux Containers rather than Windows Containers. See the Docker documentation for instructions to switch to Linux containers. Refer this to run and setup the Jenkins on docker. Configure Jenkins with initial steps such as create an admin user etc. Follow Setup wizard. If you have installed the Jenkins on your local workstation, make sure the maven tool is installed. Follow this to installl maven.","title":"Installing Git, Docker and Jenkins:"},{"location":"level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/#forking-sample-java-application","text":"For this hands-on, let us fork a simple java application from the GitHub simple-java-maven-app . 1. Sign up for the GitHub account Join GitHub \u00b7 GitHub . Once signed up, proceed to login . 2. Open the simple-java-maven-app by clicking on this link 3. On the top right corner, click on the \u2018Fork\u2019 to create a copy of the project to your GitHub account. (Refer Fork A Repo ) 4. Once forked, clone this repository to your local workstation.","title":"Forking Sample java application:"},{"location":"level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/#create-jenkins-project","text":"Login to the Jenkins portal at http://localhost:8080 using the admin account created earlier during Jenkins\u2019s setup. On your first login, the following screen will appear. Click on \u201c Create a Job \u201d. Fig 4: Jenkins - Create a Job On the next screen, type simple-java-pipeline in the Enter an Item Name field. Select Pipeline from the list of items and click OK . Fig 5: Jenkins - Create Pipeline Click the Pipeline tab at the top of the page to scroll down to the Pipeline section. From the Definition field, choose the Pipeline script from SCM option. This option instructs Jenkins to obtain your Pipeline from Source Control Management (SCM), which will be your locally cloned Git repository. From the SCM field, choose Git . In the Repository URL field, specify the directory path of your locally cloned repository from the Forking Sample Java application section above. Screen looks like below after entering the details. Fig 6: Jenkins - Pipeline Configuration","title":"Create Jenkins Project:"},{"location":"level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/#create-build-pipeline-using-the-jenkinsfile","text":"Jenkinsfile is a script file containing the pipeline configuration and the stages and other instructions to Jenkins to create a pipeline from the file. This file will be saved at the root of the code repository. 1. Using your favorite text editor or IDE, create and save a new text file with the name Jenkinsfile at the root of your local simple-java-maven-app Git repository. 2. Copy the following declarative pipeline code and paste it into the empty Jenkinsfile . pipeline { agent { docker { image 'maven:3.8.1-adoptopenjdk-11' args '-v /root/.m2:/root/.m2' } } stages { stage('Build') { steps { sh 'mvn -B -DskipTests clean package' } } } } Note: If you are running Jenkins on your local workstation without the docker, please change the agent to any as shown below so that it runs on the localhost. Please ensure that the maven tool is installed on your local workstation. pipeline { agent any stages { stage('Build') { steps { sh 'mvn -B -DskipTests clean package' } } } } In the above Jenkinsfile: * We specified an agent where the pipeline should run. 'docker\u2019 in the agent section indicates to run a new docker container with the specified image. * In the stages section, we can define multiple steps as different stages. Here, we have a stage called \u2018Build\u2019, with the maven command for building the java application. Save your Jenkinsfile and commit and push to your forked repository. Run the following commands from the command prompt. cd git add . git commit -m \"Add initial Jenkinsfile\" git push origin master Go to Jenkins portal on your browser and click on the Dashboard . Open the simple-java-pipeline and from the left-menu, click on Build Now . Fig 7: Jenkins - Building the Pipeline Notice the build running under the Build History menu. Click on the build number and it shows the stages. Fig 8: Jenkins - View Running Builds We have successfully created a build pipeline with single stage and ran it. We can check the logs by clicking on the Console Output menu.","title":"Create Build pipeline using the Jenkinsfile:"},{"location":"level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/#additional-stages-in-the-build-pipeline","text":"In the previous section, we have created the pipeline with a single stage. Typically, your CI pipeline contains multiple stages such as Build, Test and other optional stages such Code scanning etc. In this section, let us add a Test stage to the build pipeline and run. Go back to your text editor/IDE and open Jenkinsfile and the Test stage shown below. stage('Test') { steps { sh 'mvn test' } post { always { junit 'target/surefire-reports/*.xml' } } } The Jenkinsfile looks like below after adding the Test stage. pipeline { agent { docker { image 'maven:3.8.1-adoptopenjdk-11' args '-v /root/.m2:/root/.m2' } } stages { stage('Build') { steps { sh 'mvn -B -DskipTests clean package' } } stage('Test') { steps { sh 'mvn test' } post { always { junit 'target/surefire-reports/*.xml' } } } } } Here the stage \u2018Test\u2019 is added which runs the maven command test. The post -> always section ensures that this step is executed always after the steps are completed. The test report is available through Jenkins\u2019s interface. Note: If you are running Jenkins on your local workstation without the docker, please change the agent to any so that it runs on the localhost. Please ensure that the maven tool is installed on your local workstation. pipeline { agent any stages {\u2026 } } Save your Jenkinsfile and commit and push to your forked repository. Run the following commands from the command prompt. cd git add . git commit -m \"Test stage is added to Jenkinsfile\" git push origin master Go to Jenkins portal on your browser and click on the Dashboard . Open the simple-java-pipeline and from the left-menu, click on Build Now. Notice the Build and Test stages are showing in the Build screen. Fig 9: Jenkins - Viewing the Running Builds with Test stage Included We have now successfully created CI pipeline with two stages: Build and Test stages.","title":"Additional stages in the build pipeline:"},{"location":"level102/linux_intermediate/archiving_backup/","text":"Archiving and Backup Introduction One of the things SREs make sure of is the services are up all the time (at least 99.99% of the time), but the amount of data generated at each server running those services are immense. This data could be logs, user data in the database, or any other kind of metadata. Hence we need to compress, archive, rotate, and Backup the data in a timely manner for data safety and to make sure we don\u2019t run out of space. Archiving We usually archive the data that are no longer needed but are kept mostly for compliance purposes. This helps in storing the data into compressed format saving a lot of space. Below section is to familiarize with the archiving tools and commands. gzip gzip is a program used to compress one or more files, it replaces the original file with a compressed version of the original file. Here we can see that the messages log file is compressed to almost one-fifth of the original size and replaced with messages.gz. We can uncompress this file using gunzip command. tar tar program is a tool for archiving files and directories into a single file (often called tarball). This tool is usually used to prepare archives of files before it is transferred to a long term backup server. tar doesn\u2019t replace the existing files and folders but creates a new file with extension .tar . It provides lot of flag to choose from for archiving Flags Description -c Creates archive -x Extracts the archive -f Creates archive with the given filename -t Displays or lists files in archived file -u Archives and adds to an existing archive file -v Displays verbose information -A Concatenates the archived file -z Compresses the tar file using gzip -j Compresses the tar file using bzip2 -W Verifies an archive file -r Updates or adds file or directory in already existing .tar file Create an archive with files and folder Flag c is used for creating the archive where f is the filename. Listing files in the archive We can use flag t for listing out what an archive contains. Extract files from the archive We can use flag x to unarchive the archive. Backup Backup is a process of copying/duplicating the existing data, This backup can be used to restore the dataset in case of data loss. Data backup also becomes critical when the data is not needed in a day to day job but can be referred to as a source of truth and for compliance reasons in future. Different types of backup are : Incremental backup Incremental backup is the backup of data since the last backup, this reduces data redundancy and storage efficiency. Differential backup Sometimes our data keeps on modifying/updating. In that case we take backup of changes that occurred since the last backup called differential backup. Network backup Network backup refers to sending out data over the network from the source to a backup destination in a client-server model. This backup destination can be centralized or decentralized. Decentralized backups are useful for disaster recovery scenarios. rsync is one of the linux command which sync up file from one server to the destination server over the network. The syntax for rsync goes like rsync \\[options\\] . We can locate the file on the path specified after : (colon) in the \u201c destination\u201d . If nothing is specified the default path is the home directory of the user used for backup. /home/azureuser in this case. You can always look for different options for rsync using the man rsync command. Cloud Backup There are various third parties which provide the backup of data to the cloud. These cloud backups are much more reliable than stored backups on local machines or any server without RAID configuration as these providers manage redundancy of data, data recovery along with the data security. Two most widely used cloud backup options are Azure backup (from Microsoft) and Amazon Glacier backup (from AWS).","title":"Archiving and Backup"},{"location":"level102/linux_intermediate/archiving_backup/#archiving-and-backup","text":"","title":"Archiving and Backup"},{"location":"level102/linux_intermediate/archiving_backup/#introduction","text":"One of the things SREs make sure of is the services are up all the time (at least 99.99% of the time), but the amount of data generated at each server running those services are immense. This data could be logs, user data in the database, or any other kind of metadata. Hence we need to compress, archive, rotate, and Backup the data in a timely manner for data safety and to make sure we don\u2019t run out of space.","title":"Introduction"},{"location":"level102/linux_intermediate/archiving_backup/#archiving","text":"We usually archive the data that are no longer needed but are kept mostly for compliance purposes. This helps in storing the data into compressed format saving a lot of space. Below section is to familiarize with the archiving tools and commands.","title":"Archiving"},{"location":"level102/linux_intermediate/archiving_backup/#gzip","text":"gzip is a program used to compress one or more files, it replaces the original file with a compressed version of the original file. Here we can see that the messages log file is compressed to almost one-fifth of the original size and replaced with messages.gz. We can uncompress this file using gunzip command.","title":"gzip"},{"location":"level102/linux_intermediate/archiving_backup/#tar","text":"tar program is a tool for archiving files and directories into a single file (often called tarball). This tool is usually used to prepare archives of files before it is transferred to a long term backup server. tar doesn\u2019t replace the existing files and folders but creates a new file with extension .tar . It provides lot of flag to choose from for archiving Flags Description -c Creates archive -x Extracts the archive -f Creates archive with the given filename -t Displays or lists files in archived file -u Archives and adds to an existing archive file -v Displays verbose information -A Concatenates the archived file -z Compresses the tar file using gzip -j Compresses the tar file using bzip2 -W Verifies an archive file -r Updates or adds file or directory in already existing .tar file","title":"tar"},{"location":"level102/linux_intermediate/archiving_backup/#create-an-archive-with-files-and-folder","text":"Flag c is used for creating the archive where f is the filename.","title":"Create an archive with files and folder"},{"location":"level102/linux_intermediate/archiving_backup/#listing-files-in-the-archive","text":"We can use flag t for listing out what an archive contains.","title":"Listing files in the archive"},{"location":"level102/linux_intermediate/archiving_backup/#extract-files-from-the-archive","text":"We can use flag x to unarchive the archive.","title":"Extract files from the archive"},{"location":"level102/linux_intermediate/archiving_backup/#backup","text":"Backup is a process of copying/duplicating the existing data, This backup can be used to restore the dataset in case of data loss. Data backup also becomes critical when the data is not needed in a day to day job but can be referred to as a source of truth and for compliance reasons in future. Different types of backup are :","title":"Backup"},{"location":"level102/linux_intermediate/archiving_backup/#incremental-backup","text":"Incremental backup is the backup of data since the last backup, this reduces data redundancy and storage efficiency.","title":"Incremental backup"},{"location":"level102/linux_intermediate/archiving_backup/#differential-backup","text":"Sometimes our data keeps on modifying/updating. In that case we take backup of changes that occurred since the last backup called differential backup.","title":"Differential backup"},{"location":"level102/linux_intermediate/archiving_backup/#network-backup","text":"Network backup refers to sending out data over the network from the source to a backup destination in a client-server model. This backup destination can be centralized or decentralized. Decentralized backups are useful for disaster recovery scenarios. rsync is one of the linux command which sync up file from one server to the destination server over the network. The syntax for rsync goes like rsync \\[options\\] . We can locate the file on the path specified after : (colon) in the \u201c destination\u201d . If nothing is specified the default path is the home directory of the user used for backup. /home/azureuser in this case. You can always look for different options for rsync using the man rsync command.","title":"Network backup"},{"location":"level102/linux_intermediate/archiving_backup/#cloud-backup","text":"There are various third parties which provide the backup of data to the cloud. These cloud backups are much more reliable than stored backups on local machines or any server without RAID configuration as these providers manage redundancy of data, data recovery along with the data security. Two most widely used cloud backup options are Azure backup (from Microsoft) and Amazon Glacier backup (from AWS).","title":"Cloud Backup"},{"location":"level102/linux_intermediate/bashscripting/","text":"Bash Scripting Introduction As an SRE, the Linux system sits at the core of our day to day work and so is bash scripting. It\u2019s a scripting language that is run by Linux Bash Interpreter. Until now we have covered a lot of features mostly on a command line, now we will use this command line as an interpreter to write programs that will ease our day to day job as an SRE. Writing the first bash script: We will start with a simple program, we will use Vim as the editor during the whole journey. #!/bin/bash # This if my first bash script # Line starting with # is commented echo \"Hello world!\" The first line of the script starting with \u201c#!\u201d is called she-bang. This is simply to let the system which interpreter to use while executing the script. Any Line starting with \u201c#\u201d (other than #!) is referred to as comments in script and is ignored by the interpreter while executing the script. Line 6 shows the \u201cecho\u201d command that we would be running. We will save this script as \u201cfirstscript.sh\u201d and make the script executable using chmod . Next thing is to run the script with the explicit path. We can see the desired \u201cHello World!\u201d as output. Taking user input and working with variables: Taking standard input using the read command and working with variables in bash. #!/bin/bash #We will take standard input #Will list all files at the path #We will concate variable and string echo \"Enter the path\" read path echo \"How deep in directory you want to go:\" read depth echo \"All files at path \" $path du -d $depth -all -h $path We are reading path in variable \u201c path \u201d and variable \u201c depth \u201d to list files and directories up to that depth. We concatenated strings with variables. We always use $ (dollar-sign) to reference the value it contains. We pass these variables to the du command to list out all the files and directories in that path upto the desired depth. Exit status: Every command and script when it completes executing, returns an integer in the range from 0 to 255 to the system, this is called exit status. \u201c0\u201d denotes success of the command while non-zero return code usually indicates various kinds of errors. We use $? special shell variable to get exit status of the last executed script or command. Command line arguments and understanding If \u2026 else branching: Another way to pass some values to the script is using command line arguments. Usually command line arguments in bash are accessed by $ followed by the index. The 0th index refers to the file itself, $1 to the first argument and so on. We use $# to check the count of arguments passed to the script. Making decisions in the programming language is it\u2019s integral part, and to tackle different conditions we use if \u2026 else statements or some more nested variant of it. The below script uses multiple concepts in one script. The aim of the script is to get some properties of the file. Line 4 to 7 is the standard example of \"if statement\" in bash. Syntax is as explained below: If [ condition ]; then If_block_to_execute else else_block_to_execute fi fi is to close the if \u2026 else block. We are comparing count of argument($#) if it is equal to 1 or not. If not we prompt for only one argument and exit the script with status code 1(not a success). One or more if statements can exist without else statement but vice versa doesn\u2019t make any sense. Operator -ne is used to compare two integers, read as \u201cinteger1 not equal to integer 2\u201d. Other comparison operators are: Operations Description num1 -eq num2 check if 1st number is equal to 2nd number num1 -ge num2 checks if 1st number is greater than or equal to 2nd number num1 -gt num2 checks if 1st number is greater than 2nd number num1 -le num2 checks if 1st number is less than or equal to 2nd number num1 -lt num2 checks if 1st number is less than 2nd number #!/bin/bash # This script evaluate the status of a file if [ $# -ne 1 ]; then echo \"Please pass one file name as argument\" exit 1 fi FILE=$1 if [ -e \"$FILE\" ]; then if [ -f \"$FILE\" ]; then echo \"$FILE is a regular file.\" fi if [ -d \"$FILE\" ]; then echo \"$FILE is a directory.\" fi if [ -r \"$FILE\" ]; then echo \"$FILE is readable.\" fi if [ -w \"$FILE\" ]; then echo \"$FILE is writable.\" fi if [ -x \"$FILE\" ]; then echo \"$FILE is executable/searchable.\" fi else echo \"$FILE does not exist\" exit 2 fi exit 0 There are lots of file expressions to evaluate file,like in bash script \u201c-e\u201d in line 10 returns true if the file passed as argument exist, false otherwise. Below are the some widely used file expressions: File Operations Description -e file File exists -d file File exists and is directory -f file File exists and is regular file -L file File exists and is symbolic link -r file File exists and has readable permission -w file File exists and has writable permission -x file File exists and has executable permission -s file File exists and size is greater than zero -S file File exists and is a network socket. Exit status is 2 when the file is not found. And if the file is found it prints out the properties it holds with exit status 0(success). Looping over to do a repeated task. We usually come up with tasks that are mostly repetitive, looping helps us to code those repetitive tasks in a more formal manner. There are different types of loop statement we can use in bash: Loop Syntax while while [ expression ] do [ while_block_to_execute ] done for for variable in 1,2,3 .. n do [ for_block_to_execute ] done until until [ expression ] do [ until_block_to_execute ] done !/bin/bash #Script to monitor the server hosts=`cat host_list` while true do for i in $hosts do h=\"$i\" ping -c 1 -q \"$h\" &>/dev/null if [ $? -eq 0 ] then echo `date` \"server $h alive\" else echo `date` \"server $h is dead\" fi done sleep 60 done Monitoring a server is an important part of being an SRE. The file \u201chost_list\u201d contains the list of host which we want to monitor. We used an infinite \u201cwhile\u201d loop that will sleep every 60seconds. And for each host in the host_list we want to ping that host and check if that ping was successful with its exit status, if it\u2019s successful we say server is live or it\u2019s dead. The output of the script shows it is running every minute with the timestamp. Function Developers always try to make their applications/programs in modular fashion so that they don\u2019t have to write the same code every time and everywhere to carry out similar tasks. Functions help us achieve this. We usually call functions with some arguments and expect result based on that argument. The backup process we discussed in earlier section, we will try to automate that process using the below script and also get familiar with some more concepts like string comparison, functions and logical AND and OR operations. In the below code \u201clog_backup\u201d is a function which won\u2019t be executed until it is called. Line37 will be executed first where we will check the no. of arguments passed to the script. There are many logical operators like AND,OR, XOR etc. Logical Operator Symbol AND && OR | NOT ! Passing the wrong argument to script \u201cbackup.sh\u201d will prompt for correct usage. We have to pass whether we want to have incremental backup of the directory or the full backup along with the path of the directory we want to backup. If we want the incremental backup we will an additional argument as a meta file which is used to store the information of previous backed up files.(usually a metafile is .snar extension). #!/bin/bash #Scripts to take incremental and full backup backup_dir=\"/mnt/backup/\" time_stamp=\"`date +%d-%m-%Y-%Hh-%Mm-%Ss`\" log_backup(){ if [ $# -lt 2 ]; then echo \"Usage: ./backup.sh [backup_type] [log_path]\" exit 1; fi if [ $1 == \"incremental\" ]; then if [ $# -ne 3 ]; then echo \"Usage: ./backup.sh [backup_type] [log_path] [meta_file]\" exit 3; fi tar --create --listed-incremental=$3 --verbose --verbose --file=\"${backup_dir}incremental-${time_stamp}.tar\" $2 if [ $? -eq 0 ]; then echo \"Incremental backup succesful at '${backup_dir}incremental-${time_stamp}.tar'\" else echo \"Incremental Backup Failure\" fi elif [ $1 == \"full\" ];then tar cf \"${backup_dir}fullbackup-${time_stamp}.tar\" $2 if [ $? -eq 0 ];then echo \"Full backup successful at '${backup_dir}fullbackup-${time_stamp}.tar'\" else echo \"Full Backup Failure\" fi else echo \"Unknown parameter passed\" echo \"Usage: ./backup.sh [incremental|full] [log_path]\" exit 2; fi } if [ $# -lt 2 ] || [ $# -gt 3 ];then echo \"Usage: ./backup.sh [incremental|full] [log_path]\" exit 1 elif [ $# -eq 2 ];then log_backup $1 $2 elif [ $# -eq 3 ];then log_backup $1 $2 $3 fi exit 0 Passing all 3 arguments for incremental backup will take incremental backup at \u201c/mnt/backup/\u201d with each archive having timestamp concatenated to each file. The arguments passed inside the function can be accessed via $ followed by the index. The 0th index refers to the function itself, $1 to the first argument and so on. We use #$ to check the count of arguments passed to the function. Once we pass the string \u201cincremental\u201d or \u201cfull\u201d it gets compared inside the function and the specific block is executed. Below are some more operations that can be performed over strings. String Operations Description string1 == string2 Returns true if string1 equals string 2 otherwise false. string1 != string2 Returns true if string NOT equal string 2 otherwise false. string1 ~= regex Returns true if string1 matches the extended regular expression. -z string Returns true if string length is zero otherwise false. -n string Returns true if string length is non-zero otherwise false.","title":"Bash Scripting"},{"location":"level102/linux_intermediate/bashscripting/#bash-scripting","text":"","title":"Bash Scripting"},{"location":"level102/linux_intermediate/bashscripting/#introduction","text":"As an SRE, the Linux system sits at the core of our day to day work and so is bash scripting. It\u2019s a scripting language that is run by Linux Bash Interpreter. Until now we have covered a lot of features mostly on a command line, now we will use this command line as an interpreter to write programs that will ease our day to day job as an SRE.","title":"Introduction"},{"location":"level102/linux_intermediate/bashscripting/#writing-the-first-bash-script","text":"We will start with a simple program, we will use Vim as the editor during the whole journey. #!/bin/bash # This if my first bash script # Line starting with # is commented echo \"Hello world!\" The first line of the script starting with \u201c#!\u201d is called she-bang. This is simply to let the system which interpreter to use while executing the script. Any Line starting with \u201c#\u201d (other than #!) is referred to as comments in script and is ignored by the interpreter while executing the script. Line 6 shows the \u201cecho\u201d command that we would be running. We will save this script as \u201cfirstscript.sh\u201d and make the script executable using chmod . Next thing is to run the script with the explicit path. We can see the desired \u201cHello World!\u201d as output.","title":"Writing the first bash script:"},{"location":"level102/linux_intermediate/bashscripting/#taking-user-input-and-working-with-variables","text":"Taking standard input using the read command and working with variables in bash. #!/bin/bash #We will take standard input #Will list all files at the path #We will concate variable and string echo \"Enter the path\" read path echo \"How deep in directory you want to go:\" read depth echo \"All files at path \" $path du -d $depth -all -h $path We are reading path in variable \u201c path \u201d and variable \u201c depth \u201d to list files and directories up to that depth. We concatenated strings with variables. We always use $ (dollar-sign) to reference the value it contains. We pass these variables to the du command to list out all the files and directories in that path upto the desired depth.","title":"Taking user input and working with variables:"},{"location":"level102/linux_intermediate/bashscripting/#exit-status","text":"Every command and script when it completes executing, returns an integer in the range from 0 to 255 to the system, this is called exit status. \u201c0\u201d denotes success of the command while non-zero return code usually indicates various kinds of errors. We use $? special shell variable to get exit status of the last executed script or command.","title":"Exit status:"},{"location":"level102/linux_intermediate/bashscripting/#command-line-arguments-and-understanding-if-else-branching","text":"Another way to pass some values to the script is using command line arguments. Usually command line arguments in bash are accessed by $ followed by the index. The 0th index refers to the file itself, $1 to the first argument and so on. We use $# to check the count of arguments passed to the script. Making decisions in the programming language is it\u2019s integral part, and to tackle different conditions we use if \u2026 else statements or some more nested variant of it. The below script uses multiple concepts in one script. The aim of the script is to get some properties of the file. Line 4 to 7 is the standard example of \"if statement\" in bash. Syntax is as explained below: If [ condition ]; then If_block_to_execute else else_block_to_execute fi fi is to close the if \u2026 else block. We are comparing count of argument($#) if it is equal to 1 or not. If not we prompt for only one argument and exit the script with status code 1(not a success). One or more if statements can exist without else statement but vice versa doesn\u2019t make any sense. Operator -ne is used to compare two integers, read as \u201cinteger1 not equal to integer 2\u201d. Other comparison operators are: Operations Description num1 -eq num2 check if 1st number is equal to 2nd number num1 -ge num2 checks if 1st number is greater than or equal to 2nd number num1 -gt num2 checks if 1st number is greater than 2nd number num1 -le num2 checks if 1st number is less than or equal to 2nd number num1 -lt num2 checks if 1st number is less than 2nd number #!/bin/bash # This script evaluate the status of a file if [ $# -ne 1 ]; then echo \"Please pass one file name as argument\" exit 1 fi FILE=$1 if [ -e \"$FILE\" ]; then if [ -f \"$FILE\" ]; then echo \"$FILE is a regular file.\" fi if [ -d \"$FILE\" ]; then echo \"$FILE is a directory.\" fi if [ -r \"$FILE\" ]; then echo \"$FILE is readable.\" fi if [ -w \"$FILE\" ]; then echo \"$FILE is writable.\" fi if [ -x \"$FILE\" ]; then echo \"$FILE is executable/searchable.\" fi else echo \"$FILE does not exist\" exit 2 fi exit 0 There are lots of file expressions to evaluate file,like in bash script \u201c-e\u201d in line 10 returns true if the file passed as argument exist, false otherwise. Below are the some widely used file expressions: File Operations Description -e file File exists -d file File exists and is directory -f file File exists and is regular file -L file File exists and is symbolic link -r file File exists and has readable permission -w file File exists and has writable permission -x file File exists and has executable permission -s file File exists and size is greater than zero -S file File exists and is a network socket. Exit status is 2 when the file is not found. And if the file is found it prints out the properties it holds with exit status 0(success).","title":"Command line arguments and understanding If \u2026 else branching:"},{"location":"level102/linux_intermediate/bashscripting/#looping-over-to-do-a-repeated-task","text":"We usually come up with tasks that are mostly repetitive, looping helps us to code those repetitive tasks in a more formal manner. There are different types of loop statement we can use in bash: Loop Syntax while while [ expression ] do [ while_block_to_execute ] done for for variable in 1,2,3 .. n do [ for_block_to_execute ] done until until [ expression ] do [ until_block_to_execute ] done !/bin/bash #Script to monitor the server hosts=`cat host_list` while true do for i in $hosts do h=\"$i\" ping -c 1 -q \"$h\" &>/dev/null if [ $? -eq 0 ] then echo `date` \"server $h alive\" else echo `date` \"server $h is dead\" fi done sleep 60 done Monitoring a server is an important part of being an SRE. The file \u201chost_list\u201d contains the list of host which we want to monitor. We used an infinite \u201cwhile\u201d loop that will sleep every 60seconds. And for each host in the host_list we want to ping that host and check if that ping was successful with its exit status, if it\u2019s successful we say server is live or it\u2019s dead. The output of the script shows it is running every minute with the timestamp.","title":"Looping over to do a repeated task."},{"location":"level102/linux_intermediate/bashscripting/#function","text":"Developers always try to make their applications/programs in modular fashion so that they don\u2019t have to write the same code every time and everywhere to carry out similar tasks. Functions help us achieve this. We usually call functions with some arguments and expect result based on that argument. The backup process we discussed in earlier section, we will try to automate that process using the below script and also get familiar with some more concepts like string comparison, functions and logical AND and OR operations. In the below code \u201clog_backup\u201d is a function which won\u2019t be executed until it is called. Line37 will be executed first where we will check the no. of arguments passed to the script. There are many logical operators like AND,OR, XOR etc. Logical Operator Symbol AND && OR | NOT ! Passing the wrong argument to script \u201cbackup.sh\u201d will prompt for correct usage. We have to pass whether we want to have incremental backup of the directory or the full backup along with the path of the directory we want to backup. If we want the incremental backup we will an additional argument as a meta file which is used to store the information of previous backed up files.(usually a metafile is .snar extension). #!/bin/bash #Scripts to take incremental and full backup backup_dir=\"/mnt/backup/\" time_stamp=\"`date +%d-%m-%Y-%Hh-%Mm-%Ss`\" log_backup(){ if [ $# -lt 2 ]; then echo \"Usage: ./backup.sh [backup_type] [log_path]\" exit 1; fi if [ $1 == \"incremental\" ]; then if [ $# -ne 3 ]; then echo \"Usage: ./backup.sh [backup_type] [log_path] [meta_file]\" exit 3; fi tar --create --listed-incremental=$3 --verbose --verbose --file=\"${backup_dir}incremental-${time_stamp}.tar\" $2 if [ $? -eq 0 ]; then echo \"Incremental backup succesful at '${backup_dir}incremental-${time_stamp}.tar'\" else echo \"Incremental Backup Failure\" fi elif [ $1 == \"full\" ];then tar cf \"${backup_dir}fullbackup-${time_stamp}.tar\" $2 if [ $? -eq 0 ];then echo \"Full backup successful at '${backup_dir}fullbackup-${time_stamp}.tar'\" else echo \"Full Backup Failure\" fi else echo \"Unknown parameter passed\" echo \"Usage: ./backup.sh [incremental|full] [log_path]\" exit 2; fi } if [ $# -lt 2 ] || [ $# -gt 3 ];then echo \"Usage: ./backup.sh [incremental|full] [log_path]\" exit 1 elif [ $# -eq 2 ];then log_backup $1 $2 elif [ $# -eq 3 ];then log_backup $1 $2 $3 fi exit 0 Passing all 3 arguments for incremental backup will take incremental backup at \u201c/mnt/backup/\u201d with each archive having timestamp concatenated to each file. The arguments passed inside the function can be accessed via $ followed by the index. The 0th index refers to the function itself, $1 to the first argument and so on. We use #$ to check the count of arguments passed to the function. Once we pass the string \u201cincremental\u201d or \u201cfull\u201d it gets compared inside the function and the specific block is executed. Below are some more operations that can be performed over strings. String Operations Description string1 == string2 Returns true if string1 equals string 2 otherwise false. string1 != string2 Returns true if string NOT equal string 2 otherwise false. string1 ~= regex Returns true if string1 matches the extended regular expression. -z string Returns true if string length is zero otherwise false. -n string Returns true if string length is non-zero otherwise false.","title":"Function"},{"location":"level102/linux_intermediate/conclusion/","text":"Conclusion Understanding package management is very crucial as an SRE, we always want the right set of software with their compatible versions to work in harmony to drive the big infrastructure and organization. We also saw how we can configure and use storage drives and how we can have redundancy of data using RAID to avoid the data loss, how data is placed over disk and use of file systems. Archiving and Backup is also a crucial part of being an SRE, It\u2019s our responsibility to keep the data safe and in a more efficient manner. Bash is very useful to automate the day to day toil that an SRE stumbles into. The above walkthrough of bash gives us an idea to get started, but mere reading through it won\u2019t take you much further. I believe \u201ctaking action and practicing the topic\u201d would give you confidence and will help you become a better SRE.","title":"Conclusion"},{"location":"level102/linux_intermediate/conclusion/#conclusion","text":"Understanding package management is very crucial as an SRE, we always want the right set of software with their compatible versions to work in harmony to drive the big infrastructure and organization. We also saw how we can configure and use storage drives and how we can have redundancy of data using RAID to avoid the data loss, how data is placed over disk and use of file systems. Archiving and Backup is also a crucial part of being an SRE, It\u2019s our responsibility to keep the data safe and in a more efficient manner. Bash is very useful to automate the day to day toil that an SRE stumbles into. The above walkthrough of bash gives us an idea to get started, but mere reading through it won\u2019t take you much further. I believe \u201ctaking action and practicing the topic\u201d would give you confidence and will help you become a better SRE.","title":"Conclusion"},{"location":"level102/linux_intermediate/introduction/","text":"Linux-Intermediate Prerequisites Expect to have gone through the School Of SRE Linux Basics . What to expect from this course This course is divided into two sections. In the first section we will cover where we left off the Linux Basics, earlier in the School of SRE curriculum, we will deep dive into some of the more advanced linux commands and concepts. In this second section we will discuss how we use Bash scripting in day to day work, automation and toil reduction as an SRE with the help of real life examples of any SRE. What is not covered under this course This course aims to make you familiar with the intersection of Linux commands, shell scripting and how SRE uses it. We would not be covering Linux internals. Lab Environment Setup Install docker on your system. https://docs.docker.com/engine/install/ We would be using RedHat Enterprise Linux (RHEL) 8. We would be running most of the commands in the above docker container. __________________________________________________________________________ Course Content Package Management Package: Dependencies Repository High Level and Low-Level Package management tools Storage Media Listing the mounted storage devices Creating a FileSystem Mounting the device Unmounting the device Making it easier with /etc/fstab file? Checking and Repairing FS RAID RAID levels RAID 0 (Striping) RAID 1(Mirroring) RAID 5(Striping with distributed parity) RAID 6(Striping with double parity) RAID 10(RAID 1+0 : Mirroring and Striping) Commands to monitor RAID LVM Archiving and Backup Archiving gzip tar Create an archive with files and folder Listing files in the archive Extract files from the archive Backup Incremental backup Differential backup Network backup Cloud Backup Introduction to Vim Opening a file and using insert mode Saving a file Exiting the VIM editor Bash Scripting Writing the first bash script Taking user input and working with variables Exit status Command line arguments and understanding If \u2026 else branching Looping over to do a repeated task Function Conclusion","title":"Introduction"},{"location":"level102/linux_intermediate/introduction/#linux-intermediate","text":"","title":"Linux-Intermediate"},{"location":"level102/linux_intermediate/introduction/#prerequisites","text":"Expect to have gone through the School Of SRE Linux Basics .","title":"Prerequisites"},{"location":"level102/linux_intermediate/introduction/#what-to-expect-from-this-course","text":"This course is divided into two sections. In the first section we will cover where we left off the Linux Basics, earlier in the School of SRE curriculum, we will deep dive into some of the more advanced linux commands and concepts. In this second section we will discuss how we use Bash scripting in day to day work, automation and toil reduction as an SRE with the help of real life examples of any SRE.","title":"What to expect from this course"},{"location":"level102/linux_intermediate/introduction/#what-is-not-covered-under-this-course","text":"This course aims to make you familiar with the intersection of Linux commands, shell scripting and how SRE uses it. We would not be covering Linux internals.","title":"What is not covered under this course"},{"location":"level102/linux_intermediate/introduction/#lab-environment-setup","text":"Install docker on your system. https://docs.docker.com/engine/install/ We would be using RedHat Enterprise Linux (RHEL) 8. We would be running most of the commands in the above docker container. __________________________________________________________________________","title":"Lab Environment Setup"},{"location":"level102/linux_intermediate/introduction/#course-content","text":"Package Management Package: Dependencies Repository High Level and Low-Level Package management tools Storage Media Listing the mounted storage devices Creating a FileSystem Mounting the device Unmounting the device Making it easier with /etc/fstab file? Checking and Repairing FS RAID RAID levels RAID 0 (Striping) RAID 1(Mirroring) RAID 5(Striping with distributed parity) RAID 6(Striping with double parity) RAID 10(RAID 1+0 : Mirroring and Striping) Commands to monitor RAID LVM Archiving and Backup Archiving gzip tar Create an archive with files and folder Listing files in the archive Extract files from the archive Backup Incremental backup Differential backup Network backup Cloud Backup Introduction to Vim Opening a file and using insert mode Saving a file Exiting the VIM editor Bash Scripting Writing the first bash script Taking user input and working with variables Exit status Command line arguments and understanding If \u2026 else branching Looping over to do a repeated task Function Conclusion","title":"Course Content"},{"location":"level102/linux_intermediate/introvim/","text":"Introduction to Vim Introduction As an SRE we several times log into into the servers and make changes to the config file, edit and modify scripts and the editor which comes handy and available in almost all linux distribution is Vim. Vim is an open-source and free command line editor, widely accepted and used. We will see some basics of how to use vim for creating and editing files. This knowledge will help us in understanding the next section, Scripting. Opening a file and using insert mode We use the command vim filename to open a file filename . The terminal will open an editor but once you start writing, it won\u2019t work. It\u2019s because we are not in \"INSERT\" mode in vim. Press i and get into insert mode and start writing. You will see on the bottom left \u201cINSERT\u201d after pressing \u201c i \u201d . You can use * ESC \u201d key to get back to normal mode. Saving a file After you insert your text in INSERT mode press ESC(escape) key on your keyboard to get out of it. Press : (colon shift +;) and press w and hit enter, the text you entered will get written in the file. Exiting the VIM editor Exiting vim can get real challenging for the beginners. There are various ways you can exit the Vim like exit without saving the work, exit with saving the work. Try below commands after exiting insert mode and pressing : (colon). Vim Commands Description :q Exit the file but won\u2019t exit if file has unsaved changes :wq Write(save) and exit the file. :q! Exit without saving the changes. This is basic we would be needing in bash scripting in the next section. You can always visit tutorial for learning more. For quick practice of vim commands visit: https://www.openvim.com/","title":"Introduction to Vim"},{"location":"level102/linux_intermediate/introvim/#introduction-to-vim","text":"","title":"Introduction to Vim"},{"location":"level102/linux_intermediate/introvim/#introduction","text":"As an SRE we several times log into into the servers and make changes to the config file, edit and modify scripts and the editor which comes handy and available in almost all linux distribution is Vim. Vim is an open-source and free command line editor, widely accepted and used. We will see some basics of how to use vim for creating and editing files. This knowledge will help us in understanding the next section, Scripting.","title":"Introduction"},{"location":"level102/linux_intermediate/introvim/#opening-a-file-and-using-insert-mode","text":"We use the command vim filename to open a file filename . The terminal will open an editor but once you start writing, it won\u2019t work. It\u2019s because we are not in \"INSERT\" mode in vim. Press i and get into insert mode and start writing. You will see on the bottom left \u201cINSERT\u201d after pressing \u201c i \u201d . You can use * ESC \u201d key to get back to normal mode.","title":"Opening a file and using insert mode"},{"location":"level102/linux_intermediate/introvim/#saving-a-file","text":"After you insert your text in INSERT mode press ESC(escape) key on your keyboard to get out of it. Press : (colon shift +;) and press w and hit enter, the text you entered will get written in the file.","title":"Saving a file"},{"location":"level102/linux_intermediate/introvim/#exiting-the-vim-editor","text":"Exiting vim can get real challenging for the beginners. There are various ways you can exit the Vim like exit without saving the work, exit with saving the work. Try below commands after exiting insert mode and pressing : (colon). Vim Commands Description :q Exit the file but won\u2019t exit if file has unsaved changes :wq Write(save) and exit the file. :q! Exit without saving the changes. This is basic we would be needing in bash scripting in the next section. You can always visit tutorial for learning more. For quick practice of vim commands visit: https://www.openvim.com/","title":"Exiting the VIM editor"},{"location":"level102/linux_intermediate/package_management/","text":"Package Management Introduction One of the main features of any operating system is the ability to run other programs and softwares, and hence Package management comes into picture. Package management is a method of installing and maintaining software programs on any operating system. Package In the early days of Linux, one had to download source code of any software and compile it to install and run the software. As the Linux space became more mature, it is understood the software landscape is very dynamic and started distributing software in the form of packages. Package file is a compressed collection of files that contains software, its dependencies, installation instructions and metadata about the package. Dependencies It is rare that a software package is stand-alone, it depends on the different software, libraries and modules. These subroutines are stored and made available in the form of shared libraries which may serve more than one program. These shared resources are called dependencies. Package management does this hard job of resolving dependencies and installing them for the user along with the software. Repository Repository is a storage location where all the packages, updates, dependencies are stored. Each repository can contain thousands of software packages hosted on a remote server intended to be installed and updated on linux systems. We usually update the package information ( often referred to as metadata ) by running \u201c sudo dnf update\u201d. Try out sudo dnf repolist all to list all the repositories. We usually add repositories for installing packages from third party vendors. dnf config-manager --add-repo http://www.example.com/example.repo High Level and Low-Level Package management tools There are mainly two types of packages management tools: 1. Low-level tools : This is mostly used for installing, removing and upgrading package files. 2. High-Level tools : In addition to Low-level tools, High-level tools do metadata searching and dependency resolution as well. Linux Distribution Low-Level Tools High-Level tools Debian dpkg apt-get Fedora, RedHat dnf dnf","title":"Package Management"},{"location":"level102/linux_intermediate/package_management/#package-management","text":"","title":"Package Management"},{"location":"level102/linux_intermediate/package_management/#introduction","text":"One of the main features of any operating system is the ability to run other programs and softwares, and hence Package management comes into picture. Package management is a method of installing and maintaining software programs on any operating system.","title":"Introduction"},{"location":"level102/linux_intermediate/package_management/#package","text":"In the early days of Linux, one had to download source code of any software and compile it to install and run the software. As the Linux space became more mature, it is understood the software landscape is very dynamic and started distributing software in the form of packages. Package file is a compressed collection of files that contains software, its dependencies, installation instructions and metadata about the package.","title":"Package"},{"location":"level102/linux_intermediate/package_management/#dependencies","text":"It is rare that a software package is stand-alone, it depends on the different software, libraries and modules. These subroutines are stored and made available in the form of shared libraries which may serve more than one program. These shared resources are called dependencies. Package management does this hard job of resolving dependencies and installing them for the user along with the software.","title":"Dependencies"},{"location":"level102/linux_intermediate/package_management/#repository","text":"Repository is a storage location where all the packages, updates, dependencies are stored. Each repository can contain thousands of software packages hosted on a remote server intended to be installed and updated on linux systems. We usually update the package information ( often referred to as metadata ) by running \u201c sudo dnf update\u201d. Try out sudo dnf repolist all to list all the repositories. We usually add repositories for installing packages from third party vendors. dnf config-manager --add-repo http://www.example.com/example.repo","title":"Repository"},{"location":"level102/linux_intermediate/package_management/#high-level-and-low-level-package-management-tools","text":"There are mainly two types of packages management tools: 1. Low-level tools : This is mostly used for installing, removing and upgrading package files. 2. High-Level tools : In addition to Low-level tools, High-level tools do metadata searching and dependency resolution as well. Linux Distribution Low-Level Tools High-Level tools Debian dpkg apt-get Fedora, RedHat dnf dnf","title":"High Level and Low-Level Package management tools"},{"location":"level102/linux_intermediate/storage_media/","text":"Storage Media Introduction Storage media are devices which are used to store data and information. Linux has amazing capabilities when it comes to handling external devices including storage devices. There are many kinds of storage devices physical storage devices like hard drives, virtual storage devices like RAID or LVM, network storage and so on. In this section we will learn to work with any storage device and configure it to our needs. Listing the mounted storage devices: We can use command mount to list all the storage devices mounted to your computer. The format in which we see above output is: device on mount_point type file\\_system\\_type (options) For example in the first line the device virtual sysfs is mounted at /sys path and has a sysfs file system. Now let\u2019s see what and how a filesystem is created. Creating a FileSystem Imagine a disk where all the data stored in the disk is in the form of one large chunk, there is nothing to figure out where one piece of data starts and ends, which piece of data is located at which place of the whole chunk of data and hence the File System comes into picture. File System(fs) is responsible for data storage, indexing and retrieval on any storage device. Below are the most popularly used file systems: FS Type Description FAT File Allocation Table, initially used on DOS and Microsoft Windows and now widely used for portable USB storage NTFS (New Technology File System) Used on Microsoft\u2019s Windows based operating systems ext Extended file system, designed for Linux systems. ext4 Fourth extended filesystem, is a journaled file system that is commonly used by the Linux kernel. HFS Hierarchical File System, in use until HFS+ was introduced on Mac OS 8.1. HFS+ Supports file system journaling, enabling recovery of data after a system crash. NFS Network File System originally from Sun Microsystems is the standard in UNIX-based networks. We will try to create an ext4 file system which is linux native fs using mkfs . Discalimer: Run this command on empty disk as this will wipe out the existing data. Here the device /dev/sdb1 is formatted and it\u2019s filesystem is changed to ext4 . Mounting the device: In Linux systems all files are arranged in a tree structure with (/) as root. Mounting a fs simply means making that fs accessible to a certain point in the Linux directory tree. We need a mount point(location) where we want to mount the above formatted device. We created a mount point /mount and used the mount command to attach the filesystem. Here -t flag specifies what is the fs type and after that the /dev/sdb1 (device name) and /mount (mount point we created earlier). Unmounting the device: Now let\u2019s see how we can unmount the device, which is equally important if we have removable storage media and want to mount on another host. We use umount for unmounting the device. Our first attempt did not unmount the /sdb1 because we were inside the storage device and it was being used. Once we jumped back to the home directory we were successfully able to unmount the device. Making it easier with /etc/fstab file? In our production environment, we can have servers with many storage devices that need to be mounted, and it is not feasible to mount each device using the command every time we reboot the system. To ease this burden, we can make use of configuration table called \u201cfstab\u201d usually found in /etc/fstab on Linux systems. Here on the first line we have /dev/mapper/rootvg-rootlv (storage device ) mounted on / (root mount point) which has the xfs filesystem type followed by options. We can run mount -a to reload this file after making changes. Checking and Repairing FS Filesystems encounter issues in case of any hardware failure, power failure and sometimes due to improper shutdown. Linux usually checks and repairs the corrupted disk if any during startup. We can also manually check for filesystem corruption using the command fsck . We can repair the same filesystem using fsck -y /dev/sdb1 . There are error codes attached to each kind of file system error ,and A sum of active errors is returned. Error Codes Description 0 No errors 1 Filesystem errors corrected 2 System should be rebooted 4 Filesystem errors left uncorrected 8 Operational error 16 Usage or syntax error 32 Checking canceled by user request 128 Shared-library error In the above fs check we got return code as 12 which is the sum of error code 8(operational error) and 4(uncorrected FS error). RAID RAID or \u201cRedundant Arrays of Independent Disks\u201d is a technique that distributes I/O across multiple disks to achieve increased performance and data redundancy. RAID has the ability to increase overall disk performance and survive disk failures. Software RAID uses the computer\u2019s CPU to carry out RAID operations whereas hardware RAID uses specialized processors, on disk controllers, to manage the disks. Three essential features of RAID are mirroring, striping and parity. RAID levels The below section discusses the RAID levels that are commonly used. For information on all RAID levels, please refer to here . RAID 0 (Striping) Striping is the method by which data is split up into \u201cblocks\u201d and written across all the disks present in the array. By spreading data across multiple drives, it means multiple disks can access the file, resulting in faster read/write speeds. The first disk in the array is not reused until an equal amount of data is written to each of the other disks in the array. Advantages It can be easily implemented. Bottlenecks caused due to I/O operations from the same disk are avoided, increasing the performance of such operations. Disadvantages It does not offer any kind of redundancy. If any one of the disks fails, then the data of the entire disk is lost and cannot be recovered. Use cases RAID 0 can be used for systems with non-critical data that has to be read at high speed, such as a video/audio editing station or gaming environments. RAID 1(Mirroring) Mirroring writes a copy of data to each disk which is part of the array. This means that the data is written as many times as disks in the array . It stores an exact replica of all data on a separate disk or disks. As expected, this would result in a slow write performance compared to that of a single disk. On the other hand, read operations can be done parallelly improving read performance. Advantages RAID 1 offers a better read performance than RAID 0 or single disk. It can survive multiple disk failures without the need for special data recovery algorithms Disadvantages It is costly since the effective storage capacity is only half of the number of disks due to replication of data. Use cases Applications that require low downtime but can have a slight hit on write performance. RAID 4(Striping with dedicated parity) RAID 4 works uses block-level striping (data can be striped in blocks of a variety of sizes depending on the applications and data to be stored) and a dedicated drive used to store parity information.The parity information is generated by an algorithm every time data is written to an array disk. The use of a parity bit is a way of adding checksums into data that can enable the target device to determine whether the data has been received correctly. In the event of a drive failure , the algorithm can be reversed and missing data can be generated based on the remaining data and parity information. Advantages Each drive in a RAID 4 array operates independently so I/O requests take place in parallel, speeding up performance over previous RAID levels. It can survive multiple disk failures without the need for special data recovery algorithms Disadvantages A minimum of 3 disks is required for setup. It needs hardware support for parity calculation. Write speeds are slow since parity relies on a single disk drive and carry out modifications of parity blocks for each I/O session. Use cases Operations dealing with really large files \u2013 when sequential read and write data process is used RAID 5(Striping with distributed parity) RAID 5 is similar to RAID 4, except that the parity information is spread across all drives in the array. This helps reduce the bottleneck inherent in writing parity information to a single drive during each write operation. RAID 5 is the most common secure RAID level. Advantages Read data transactions are fast as compared to write data transactions that are somewhat slow due to the calculation of parity. Data remains accessible even after drive failure and during replacement of a failed hard drive because the storage controller rebuilds the data on the new drive. Disadvantages RAID 5 requires a minimum of 3 drives and can work up to a maximum of 16 drives It needs hardware support for parity calculation. More than two drive failures can cause data loss. Use cases File storage and application servers, such as email, general storage servers, etc. RAID 6(Striping with double parity) RAID 6 is similar to RAID 5 with an added advantage of double distributed parity, which provides fault tolerance up to two failed drives. Advantages Read data transactions are fast. This provides a fault tolerance up to 2 failed drives. RAID 6 is more resilient than RAID 5. Disadvantages Write data transactions are slow due to double parity. Rebuilding the RAID array takes a longer time because of complex structure. Use cases Office automation, online customer service, and applications that require very high availability. RAID 10(RAID 1+0 : Mirroring and Striping) RAID 10 is a combination of RAID 0 and RAID 1. It means that both mirroring and striping in one single RAID array. Advantages Rebuilding the RAID array is fast. Read and write operations performance are good. Disadvantages Just like RAID 1, only half the drive capacity is available. It can be expensive to implement RAID 10. Use cases Transactional databases with sensitive information that require high performance and high data security. Commands to monitor RAID The command cat /proc/mdstat will give the status of a software RAID. Let us examine the output of the command: Personalities : [raid1] md0 : active raid1 sdb1[2] sda1[0] 10476544 blocks super 1.1 [2/2] [UU] bitmap: 0/1 pages [0KB], 65536KB chunk md1 : active raid1 sdb2[2] sda2[0] 10476544 blocks super 1.1 [2/2] [UU] bitmap: 1/1 pages [4KB], 65536KB chunk md2 : active raid1 sdb3[2] 41909248 blocks super 1.1 [2/1] [_U] bitmap: 1/1 pages [4KB], 65536KB chunk The \u201cpersonalities\u201d gives us the raid level that the raid is configured. In the above example, the raid is configured with RAID 1. md0 : active raid1 sdb1[2] sda1[0] tells us that there is an active raid of RAID 1 between sdb1(which is device 2) and sda1(which is device 0).An inactive array generally means that one of the disks are faulty. Md2 in the above example shows that we have 41909248 blocks super 1.1 [2/1] [_U] , this means that one disk is down in this particular raid. The command mdadm --detail /dev/ gives detailed information about that particular array. sudo mdadm --detail /dev/md0 /dev/md0: Version : 1.1 Creation Time : Fri Nov 17 11:49:20 2019 Raid Level : raid1 Array Size : 10476544 (9.99 GiB 10.32 GB) Used Dev Size : 10476544 (9.99 GiB 10.32 GB) Raid Devices : 2 Total Devices : 2 Persistence : Superblock is persistent Intent Bitmap : Internal Update Time : Sun Dec 2 01:00:53 2019 State : clean Active Devices : 2 Working Devices : 2 Failed Devices : 0 Spare Devices : 0 UUID : xxxxxxx:yyyyyy:zzzzzz:ffffff Events : 987 Number Major Minor RaidDevice State 0 8 1 0 active sync /dev/sda1 1 8 49 1 active sync /dev/sdb1 Incase of a missing disk in the above example, the State of the raid would be \u2018dirty\u2019 and Active Devices and Working Devices would be reduced to one. One of the entries(either /dev/sda1 or /dev/sdb1 depending on the missing disk) would have their RaidDevice changed to faulty. LVM LVM stands for Logical Volume Management. In the above section we saw how we can create FS and use individual disks according to our need the traditional way but using LVM we can achieve more flexibility in storage allocation like we can stitch three 2TB disks to make one single partition of 6TB, or we can attach another physical disk of 4TB to the server and add that disk to the logical volume group to make it 10TB in total. Refer to know more about LVM: https://www.redhat.com/sysadmin/lvm-vs-partitioning","title":"Storage Media"},{"location":"level102/linux_intermediate/storage_media/#storage-media","text":"","title":"Storage Media"},{"location":"level102/linux_intermediate/storage_media/#introduction","text":"Storage media are devices which are used to store data and information. Linux has amazing capabilities when it comes to handling external devices including storage devices. There are many kinds of storage devices physical storage devices like hard drives, virtual storage devices like RAID or LVM, network storage and so on. In this section we will learn to work with any storage device and configure it to our needs.","title":"Introduction"},{"location":"level102/linux_intermediate/storage_media/#listing-the-mounted-storage-devices","text":"We can use command mount to list all the storage devices mounted to your computer. The format in which we see above output is: device on mount_point type file\\_system\\_type (options) For example in the first line the device virtual sysfs is mounted at /sys path and has a sysfs file system. Now let\u2019s see what and how a filesystem is created.","title":"Listing the mounted storage devices:"},{"location":"level102/linux_intermediate/storage_media/#creating-a-filesystem","text":"Imagine a disk where all the data stored in the disk is in the form of one large chunk, there is nothing to figure out where one piece of data starts and ends, which piece of data is located at which place of the whole chunk of data and hence the File System comes into picture. File System(fs) is responsible for data storage, indexing and retrieval on any storage device. Below are the most popularly used file systems: FS Type Description FAT File Allocation Table, initially used on DOS and Microsoft Windows and now widely used for portable USB storage NTFS (New Technology File System) Used on Microsoft\u2019s Windows based operating systems ext Extended file system, designed for Linux systems. ext4 Fourth extended filesystem, is a journaled file system that is commonly used by the Linux kernel. HFS Hierarchical File System, in use until HFS+ was introduced on Mac OS 8.1. HFS+ Supports file system journaling, enabling recovery of data after a system crash. NFS Network File System originally from Sun Microsystems is the standard in UNIX-based networks. We will try to create an ext4 file system which is linux native fs using mkfs . Discalimer: Run this command on empty disk as this will wipe out the existing data. Here the device /dev/sdb1 is formatted and it\u2019s filesystem is changed to ext4 .","title":"Creating a FileSystem"},{"location":"level102/linux_intermediate/storage_media/#mounting-the-device","text":"In Linux systems all files are arranged in a tree structure with (/) as root. Mounting a fs simply means making that fs accessible to a certain point in the Linux directory tree. We need a mount point(location) where we want to mount the above formatted device. We created a mount point /mount and used the mount command to attach the filesystem. Here -t flag specifies what is the fs type and after that the /dev/sdb1 (device name) and /mount (mount point we created earlier).","title":"Mounting the device:"},{"location":"level102/linux_intermediate/storage_media/#unmounting-the-device","text":"Now let\u2019s see how we can unmount the device, which is equally important if we have removable storage media and want to mount on another host. We use umount for unmounting the device. Our first attempt did not unmount the /sdb1 because we were inside the storage device and it was being used. Once we jumped back to the home directory we were successfully able to unmount the device.","title":"Unmounting the device:"},{"location":"level102/linux_intermediate/storage_media/#making-it-easier-with-etcfstab-file","text":"In our production environment, we can have servers with many storage devices that need to be mounted, and it is not feasible to mount each device using the command every time we reboot the system. To ease this burden, we can make use of configuration table called \u201cfstab\u201d usually found in /etc/fstab on Linux systems. Here on the first line we have /dev/mapper/rootvg-rootlv (storage device ) mounted on / (root mount point) which has the xfs filesystem type followed by options. We can run mount -a to reload this file after making changes.","title":"Making it easier with /etc/fstab file?"},{"location":"level102/linux_intermediate/storage_media/#checking-and-repairing-fs","text":"Filesystems encounter issues in case of any hardware failure, power failure and sometimes due to improper shutdown. Linux usually checks and repairs the corrupted disk if any during startup. We can also manually check for filesystem corruption using the command fsck . We can repair the same filesystem using fsck -y /dev/sdb1 . There are error codes attached to each kind of file system error ,and A sum of active errors is returned. Error Codes Description 0 No errors 1 Filesystem errors corrected 2 System should be rebooted 4 Filesystem errors left uncorrected 8 Operational error 16 Usage or syntax error 32 Checking canceled by user request 128 Shared-library error In the above fs check we got return code as 12 which is the sum of error code 8(operational error) and 4(uncorrected FS error).","title":"Checking and Repairing FS"},{"location":"level102/linux_intermediate/storage_media/#raid","text":"RAID or \u201cRedundant Arrays of Independent Disks\u201d is a technique that distributes I/O across multiple disks to achieve increased performance and data redundancy. RAID has the ability to increase overall disk performance and survive disk failures. Software RAID uses the computer\u2019s CPU to carry out RAID operations whereas hardware RAID uses specialized processors, on disk controllers, to manage the disks. Three essential features of RAID are mirroring, striping and parity.","title":"RAID"},{"location":"level102/linux_intermediate/storage_media/#raid-levels","text":"The below section discusses the RAID levels that are commonly used. For information on all RAID levels, please refer to here .","title":"RAID levels"},{"location":"level102/linux_intermediate/storage_media/#raid-0-striping","text":"Striping is the method by which data is split up into \u201cblocks\u201d and written across all the disks present in the array. By spreading data across multiple drives, it means multiple disks can access the file, resulting in faster read/write speeds. The first disk in the array is not reused until an equal amount of data is written to each of the other disks in the array. Advantages It can be easily implemented. Bottlenecks caused due to I/O operations from the same disk are avoided, increasing the performance of such operations. Disadvantages It does not offer any kind of redundancy. If any one of the disks fails, then the data of the entire disk is lost and cannot be recovered. Use cases RAID 0 can be used for systems with non-critical data that has to be read at high speed, such as a video/audio editing station or gaming environments.","title":"RAID 0 (Striping)"},{"location":"level102/linux_intermediate/storage_media/#raid-1mirroring","text":"Mirroring writes a copy of data to each disk which is part of the array. This means that the data is written as many times as disks in the array . It stores an exact replica of all data on a separate disk or disks. As expected, this would result in a slow write performance compared to that of a single disk. On the other hand, read operations can be done parallelly improving read performance. Advantages RAID 1 offers a better read performance than RAID 0 or single disk. It can survive multiple disk failures without the need for special data recovery algorithms Disadvantages It is costly since the effective storage capacity is only half of the number of disks due to replication of data. Use cases Applications that require low downtime but can have a slight hit on write performance.","title":"RAID 1(Mirroring)"},{"location":"level102/linux_intermediate/storage_media/#raid-4striping-with-dedicated-parity","text":"RAID 4 works uses block-level striping (data can be striped in blocks of a variety of sizes depending on the applications and data to be stored) and a dedicated drive used to store parity information.The parity information is generated by an algorithm every time data is written to an array disk. The use of a parity bit is a way of adding checksums into data that can enable the target device to determine whether the data has been received correctly. In the event of a drive failure , the algorithm can be reversed and missing data can be generated based on the remaining data and parity information. Advantages Each drive in a RAID 4 array operates independently so I/O requests take place in parallel, speeding up performance over previous RAID levels. It can survive multiple disk failures without the need for special data recovery algorithms Disadvantages A minimum of 3 disks is required for setup. It needs hardware support for parity calculation. Write speeds are slow since parity relies on a single disk drive and carry out modifications of parity blocks for each I/O session. Use cases Operations dealing with really large files \u2013 when sequential read and write data process is used","title":"RAID 4(Striping with dedicated parity)"},{"location":"level102/linux_intermediate/storage_media/#raid-5striping-with-distributed-parity","text":"RAID 5 is similar to RAID 4, except that the parity information is spread across all drives in the array. This helps reduce the bottleneck inherent in writing parity information to a single drive during each write operation. RAID 5 is the most common secure RAID level. Advantages Read data transactions are fast as compared to write data transactions that are somewhat slow due to the calculation of parity. Data remains accessible even after drive failure and during replacement of a failed hard drive because the storage controller rebuilds the data on the new drive. Disadvantages RAID 5 requires a minimum of 3 drives and can work up to a maximum of 16 drives It needs hardware support for parity calculation. More than two drive failures can cause data loss. Use cases File storage and application servers, such as email, general storage servers, etc.","title":"RAID 5(Striping with distributed parity)"},{"location":"level102/linux_intermediate/storage_media/#raid-6striping-with-double-parity","text":"RAID 6 is similar to RAID 5 with an added advantage of double distributed parity, which provides fault tolerance up to two failed drives. Advantages Read data transactions are fast. This provides a fault tolerance up to 2 failed drives. RAID 6 is more resilient than RAID 5. Disadvantages Write data transactions are slow due to double parity. Rebuilding the RAID array takes a longer time because of complex structure. Use cases Office automation, online customer service, and applications that require very high availability.","title":"RAID 6(Striping with double parity)"},{"location":"level102/linux_intermediate/storage_media/#raid-10raid-10-mirroring-and-striping","text":"RAID 10 is a combination of RAID 0 and RAID 1. It means that both mirroring and striping in one single RAID array. Advantages Rebuilding the RAID array is fast. Read and write operations performance are good. Disadvantages Just like RAID 1, only half the drive capacity is available. It can be expensive to implement RAID 10. Use cases Transactional databases with sensitive information that require high performance and high data security.","title":"RAID 10(RAID 1+0 : Mirroring and Striping)"},{"location":"level102/linux_intermediate/storage_media/#commands-to-monitor-raid","text":"The command cat /proc/mdstat will give the status of a software RAID. Let us examine the output of the command: Personalities : [raid1] md0 : active raid1 sdb1[2] sda1[0] 10476544 blocks super 1.1 [2/2] [UU] bitmap: 0/1 pages [0KB], 65536KB chunk md1 : active raid1 sdb2[2] sda2[0] 10476544 blocks super 1.1 [2/2] [UU] bitmap: 1/1 pages [4KB], 65536KB chunk md2 : active raid1 sdb3[2] 41909248 blocks super 1.1 [2/1] [_U] bitmap: 1/1 pages [4KB], 65536KB chunk The \u201cpersonalities\u201d gives us the raid level that the raid is configured. In the above example, the raid is configured with RAID 1. md0 : active raid1 sdb1[2] sda1[0] tells us that there is an active raid of RAID 1 between sdb1(which is device 2) and sda1(which is device 0).An inactive array generally means that one of the disks are faulty. Md2 in the above example shows that we have 41909248 blocks super 1.1 [2/1] [_U] , this means that one disk is down in this particular raid. The command mdadm --detail /dev/ gives detailed information about that particular array. sudo mdadm --detail /dev/md0 /dev/md0: Version : 1.1 Creation Time : Fri Nov 17 11:49:20 2019 Raid Level : raid1 Array Size : 10476544 (9.99 GiB 10.32 GB) Used Dev Size : 10476544 (9.99 GiB 10.32 GB) Raid Devices : 2 Total Devices : 2 Persistence : Superblock is persistent Intent Bitmap : Internal Update Time : Sun Dec 2 01:00:53 2019 State : clean Active Devices : 2 Working Devices : 2 Failed Devices : 0 Spare Devices : 0 UUID : xxxxxxx:yyyyyy:zzzzzz:ffffff Events : 987 Number Major Minor RaidDevice State 0 8 1 0 active sync /dev/sda1 1 8 49 1 active sync /dev/sdb1 Incase of a missing disk in the above example, the State of the raid would be \u2018dirty\u2019 and Active Devices and Working Devices would be reduced to one. One of the entries(either /dev/sda1 or /dev/sdb1 depending on the missing disk) would have their RaidDevice changed to faulty.","title":"Commands to monitor RAID"},{"location":"level102/linux_intermediate/storage_media/#lvm","text":"LVM stands for Logical Volume Management. In the above section we saw how we can create FS and use individual disks according to our need the traditional way but using LVM we can achieve more flexibility in storage allocation like we can stitch three 2TB disks to make one single partition of 6TB, or we can attach another physical disk of 4TB to the server and add that disk to the logical volume group to make it 10TB in total. Refer to know more about LVM: https://www.redhat.com/sysadmin/lvm-vs-partitioning","title":"LVM"},{"location":"level102/networking/conclusion/","text":"This course would have given some background on deploying services in datacentre and various parameters to consider and available solutions. It has to be noted that, each of the solution discussed here have various pros and cons, so specific to the scenario/requirement, the right fit among these are to be identified and used. As we didnt go the depth of various technologies/solution in this course, it might have made the reader curious to know about some of the topics. Here are some of the reference or online training content, for further learning. linked engineering blog : has information about how Linkedin datacentres are setup and some of the key problems are solved. IPSpace blog : Has lot of articles about datacentre networking. Networking Basics course in edx. Happy learning !!","title":"Conclusion"},{"location":"level102/networking/infrastructure-features/","text":"Some of the aspects to consider are, whether the underlying data centre infrastructure supports ToR resiliency, i.e. features like link bundling (bonds), BGP, support for anycast service, load balancer, firewall, Quality of Service. As seen in previous sections, to deploy applications at scale, it will need certain capabilities to be supported from the infrastructure. This section will cover different options available, and their suitability. ToR connectivity This being one of the most frequent points of failure (considering the scale of deployment), there are different options available to connect the servers to the ToR. We are going to see them in detail below, Single ToR This is the simplest of all the options. Where a NIC of the server is connected to one ToR. The advantage of this approach is, there is a minimal number of switch ports used, allowing the DC fabric to support the rapid growth of server infrastructure (Note: Not only the ToR ports are used efficiently, but the upper switching layer in DC fabric as well, the port usage will be efficient). On the downside, the servers can be unreachable if there is an issue with the ToR, link or NIC. This will impact the stateful apps more, as the existing connections get abruptly disconnected. Fig 4: Single ToR design Dual ToR In this option, each server is connected to two ToR, of the same cabinet. This can be set up in active/passive mode, thereby providing resiliency during ToR/link/NIC failures. The resiliency can be achieved either in layer 2 or in layer 3. Layer 2 In this case, both the links are bundled together as a bond on the server side (with one NIC taking the active role and the other being passive). On the switch side, these two links are made part of multi-chassis lag (similar to bonding, but spread across switches). The prerequisite here is, both the ToR should be part of the same layer 2 domain. The IP addresses are configured on the bond interface on the server and SVI on the switch side. Note: In this, the ToR 2 role is only to provide resiliency. Fig 5: Dual ToR layer 2 setup Layer 3 In this case, both the links are configured as separate layer 3 interfaces. The resiliency is achieved by setting up a routing protocol (like BGP). Wherein one link is given higher preference over the other. In this case, the two ToR's can be set up independently, in layer 3 mode. The servers would need a virtual address, to which the services have to be bound. Note: In this, the ToR 2 role is only to provide resiliency. Fig 6: Dual ToR layer 3 setup Though the resiliency is better with dual ToR, the drawback is, the number of ports being used. As the access port in the ToR doubles up, the number of ports required in the Spine layer also doubles up, and this keeps cascading to higher layers. Type Single ToR Dual ToR (layer 2) Dual ToR (layer 3) Resiliency 1 No 2 Yes Yes Port usage 1:1 1:2 1:2 Cabling Less More More Cost of DC fabric Low High High ToR features required Low High Medium 1 Resiliency in terms of ToR/Link/NIC 2 As an alternative, resiliency can be addressed at the application layer. Along with the above-mentioned ones, an application might need more capabilities out of the infrastructure to deploy at scale. Some of them are, Anycast As seen in the previous section, of deploying at scale, anycast is one of the means to have services distributed across cabinets and still have traffic flowing to each one of the servers. To achieve this, two things are required Routing protocol between ToR and server (to announce the anycast address) Support for ECMP (Equal Cost Multi-Path) load balancing in the infrastructure, to distribute the flows across the cabinets. Load balancing Similar to Anycast, another means to achieve load balancing across servers (host a particular app), is using load balancers. These could be implemented in different ways Hardware load balancers: A LB device is placed inline of the traffic flow, and looks at the layer 3 and layer 4 information in an incoming packet. Then determine the set of real hosts, to which the connections are to be redirected. As covered in the Scale topic, these load balancers can be set up in two ways, Single-arm mode: In this mode, the load balancer handles only the incoming requests to the VIP. The response from the server goes directly to the clients. There are two ways to implement this, L2 DSR: Where the load balancer and the real servers remain in the same VLAN. Upon getting an incoming request, the load balancer identifies the real server to redirect the request and then modifies the destination mac address of that Ethernet frame. Upon processing this packet, the real server responds directly to the client. L3 DSR : In this case, the load balancer and real servers need not be in the same VLAN (does away with layer 2 complexities like running STP, managing wider broadcast domain, etc). Upon incoming request, the load balancer redirects to the real server, by modifying the destination IP address of the packet. Along with this, the DSCP value of the packet is set to a predefined value (mapped for that VIP). Upon receipt of this packet, the real server uses the DSCP value to determine the loopback address (VIP address). The response again goes directly to the client. Two arm mode: In this case, the load balancer is in line for incoming and outgoing traffic. DNS based load balancer: Here the DNS servers keep a check of the health of the real servers and resolve the domain in such a way that the client can connect to different servers in that cluster. This part was explained in detail in the deployment at scale section. IPVS based load balancing: This is another means, where an IPVS server presents itself as the service endpoint to the clients. Upon incoming request, the IPVS directs the request to the real servers. The IPVS can be set up to do health for the real servers. NAT Network Address Translation (NAT) will be required for hosts that need to connect to destinations on the Internet, but don't want to expose their configured NIC address. In this case, the address (of the internal server) is translated to a public address by a firewall. Few examples of this are proxy servers, mail servers, etc. QoS Quality of Service is a means to provide, differentiate treatment to few packets over others. These could provide priority in forwarding queues, or bandwidth reservations. In the data centre scenario, depending upon the bandwidth subscription ratio, the need for QoS varies, 1:1 bandwidth subscription ratio: In this case, the server to ToR connectivity (all servers in that cabinet) bandwidth should be equivalent to the ToR to Spine switch connectivity. Similarly for the upper layers as well. In this design, congestion on a link is not going to happen, as enough bandwidth will always be available. In this case, the only difference QoS can bring, it provides priority treatment for certain packets in the forwarding queue. Note: Packet buffering happens, when the packet moves between ports of different speeds, like 100Gbps, 10Gbps. Oversubscribed network: In this case, not all layers maintain a bandwidth subscription ratio, for example, the ToR uplink may be of lower bandwidth, compared to ToR to Server bandwidth (This is sometimes referred to as oversubscription ratio). In this case, there is a possibility of congestion. Here QoS might be required, to give priority as well as bandwidth reservation, for certain types of traffic flows.","title":"Infrastructure Services"},{"location":"level102/networking/infrastructure-features/#tor-connectivity","text":"This being one of the most frequent points of failure (considering the scale of deployment), there are different options available to connect the servers to the ToR. We are going to see them in detail below,","title":"ToR connectivity"},{"location":"level102/networking/infrastructure-features/#single-tor","text":"This is the simplest of all the options. Where a NIC of the server is connected to one ToR. The advantage of this approach is, there is a minimal number of switch ports used, allowing the DC fabric to support the rapid growth of server infrastructure (Note: Not only the ToR ports are used efficiently, but the upper switching layer in DC fabric as well, the port usage will be efficient). On the downside, the servers can be unreachable if there is an issue with the ToR, link or NIC. This will impact the stateful apps more, as the existing connections get abruptly disconnected. Fig 4: Single ToR design","title":"Single ToR"},{"location":"level102/networking/infrastructure-features/#dual-tor","text":"In this option, each server is connected to two ToR, of the same cabinet. This can be set up in active/passive mode, thereby providing resiliency during ToR/link/NIC failures. The resiliency can be achieved either in layer 2 or in layer 3.","title":"Dual ToR"},{"location":"level102/networking/infrastructure-features/#layer-2","text":"In this case, both the links are bundled together as a bond on the server side (with one NIC taking the active role and the other being passive). On the switch side, these two links are made part of multi-chassis lag (similar to bonding, but spread across switches). The prerequisite here is, both the ToR should be part of the same layer 2 domain. The IP addresses are configured on the bond interface on the server and SVI on the switch side. Note: In this, the ToR 2 role is only to provide resiliency. Fig 5: Dual ToR layer 2 setup","title":"Layer 2"},{"location":"level102/networking/infrastructure-features/#layer-3","text":"In this case, both the links are configured as separate layer 3 interfaces. The resiliency is achieved by setting up a routing protocol (like BGP). Wherein one link is given higher preference over the other. In this case, the two ToR's can be set up independently, in layer 3 mode. The servers would need a virtual address, to which the services have to be bound. Note: In this, the ToR 2 role is only to provide resiliency. Fig 6: Dual ToR layer 3 setup Though the resiliency is better with dual ToR, the drawback is, the number of ports being used. As the access port in the ToR doubles up, the number of ports required in the Spine layer also doubles up, and this keeps cascading to higher layers. Type Single ToR Dual ToR (layer 2) Dual ToR (layer 3) Resiliency 1 No 2 Yes Yes Port usage 1:1 1:2 1:2 Cabling Less More More Cost of DC fabric Low High High ToR features required Low High Medium 1 Resiliency in terms of ToR/Link/NIC 2 As an alternative, resiliency can be addressed at the application layer. Along with the above-mentioned ones, an application might need more capabilities out of the infrastructure to deploy at scale. Some of them are,","title":"Layer 3"},{"location":"level102/networking/infrastructure-features/#anycast","text":"As seen in the previous section, of deploying at scale, anycast is one of the means to have services distributed across cabinets and still have traffic flowing to each one of the servers. To achieve this, two things are required Routing protocol between ToR and server (to announce the anycast address) Support for ECMP (Equal Cost Multi-Path) load balancing in the infrastructure, to distribute the flows across the cabinets.","title":"Anycast"},{"location":"level102/networking/infrastructure-features/#load-balancing","text":"Similar to Anycast, another means to achieve load balancing across servers (host a particular app), is using load balancers. These could be implemented in different ways Hardware load balancers: A LB device is placed inline of the traffic flow, and looks at the layer 3 and layer 4 information in an incoming packet. Then determine the set of real hosts, to which the connections are to be redirected. As covered in the Scale topic, these load balancers can be set up in two ways, Single-arm mode: In this mode, the load balancer handles only the incoming requests to the VIP. The response from the server goes directly to the clients. There are two ways to implement this, L2 DSR: Where the load balancer and the real servers remain in the same VLAN. Upon getting an incoming request, the load balancer identifies the real server to redirect the request and then modifies the destination mac address of that Ethernet frame. Upon processing this packet, the real server responds directly to the client. L3 DSR : In this case, the load balancer and real servers need not be in the same VLAN (does away with layer 2 complexities like running STP, managing wider broadcast domain, etc). Upon incoming request, the load balancer redirects to the real server, by modifying the destination IP address of the packet. Along with this, the DSCP value of the packet is set to a predefined value (mapped for that VIP). Upon receipt of this packet, the real server uses the DSCP value to determine the loopback address (VIP address). The response again goes directly to the client. Two arm mode: In this case, the load balancer is in line for incoming and outgoing traffic. DNS based load balancer: Here the DNS servers keep a check of the health of the real servers and resolve the domain in such a way that the client can connect to different servers in that cluster. This part was explained in detail in the deployment at scale section. IPVS based load balancing: This is another means, where an IPVS server presents itself as the service endpoint to the clients. Upon incoming request, the IPVS directs the request to the real servers. The IPVS can be set up to do health for the real servers.","title":"Load balancing"},{"location":"level102/networking/infrastructure-features/#nat","text":"Network Address Translation (NAT) will be required for hosts that need to connect to destinations on the Internet, but don't want to expose their configured NIC address. In this case, the address (of the internal server) is translated to a public address by a firewall. Few examples of this are proxy servers, mail servers, etc.","title":"NAT"},{"location":"level102/networking/infrastructure-features/#qos","text":"Quality of Service is a means to provide, differentiate treatment to few packets over others. These could provide priority in forwarding queues, or bandwidth reservations. In the data centre scenario, depending upon the bandwidth subscription ratio, the need for QoS varies, 1:1 bandwidth subscription ratio: In this case, the server to ToR connectivity (all servers in that cabinet) bandwidth should be equivalent to the ToR to Spine switch connectivity. Similarly for the upper layers as well. In this design, congestion on a link is not going to happen, as enough bandwidth will always be available. In this case, the only difference QoS can bring, it provides priority treatment for certain packets in the forwarding queue. Note: Packet buffering happens, when the packet moves between ports of different speeds, like 100Gbps, 10Gbps. Oversubscribed network: In this case, not all layers maintain a bandwidth subscription ratio, for example, the ToR uplink may be of lower bandwidth, compared to ToR to Server bandwidth (This is sometimes referred to as oversubscription ratio). In this case, there is a possibility of congestion. Here QoS might be required, to give priority as well as bandwidth reservation, for certain types of traffic flows.","title":"QoS"},{"location":"level102/networking/introduction/","text":"Prerequisites It is recommended to have basic knowledge of network security, TCP and datacenter setup and the common terminologies used in them. Also, the readers are expected to go through the School of Sre contents - Linux Networking system design security What to expect from this course This part will cover how a datacenter infrastructure is segregated for different application needs as well as the consideration of deciding where to place an application. These will be broadly based on, Security, Scale, RTT (latency), Infrastructure features. Each of these topics will be covered in detail, Security - Will cover threat vectors faced by services facing external/internal clients. Potential mitigation options to consider while deploying them. This will touch upon perimeter security, DDoS protection, Network demarcation and ring-fencing the server clusters. Scale - Deploying large scale applications, require a better understanding of infrastructure capabilities, in terms of resource availability, failure domains, scaling options like using anycast, layer 4/7 load balancer, DNS based load balancing. RTT (latency) - Latency plays a key role in determining the overall performance of the distributed service/application, where calls are made between hosts to serve the users. Infrastructure features - Some of the aspects to consider are, whether the underlying data centre infrastructure supports ToR resiliency, i.e., features like link bundling (bonds), BGP (Border Gateway Protocol), support for anycast service, load balancer, firewall, Quality of Service. What is not covered under this course Though these parameters play a role in designing an application, we will not go into the details of the design. Each of these topics are vast, hence the objective is to introduce the terms and relevance of the parameters in them, and not to provide extensive details about each one of them. Course Contents Security Scale RTT Infrastructure features Conclusion Terminology Before discussing each of the topics, it is important to get familiar with few commonly used terms Cloud This refers to hosted solutions from different providers like Azure, AWS, GCP. Wherein enterprises can host their applications for either public or private usage. On-prem This term refers to physical Data Center(DC) infrastructure, built and managed by enterprises themselves. This can be used for private access as well as public (like users connecting over the Internet). Leaf switch (ToR) This refers to the switch, where the servers connect to, in a DC. They are called by many names, like access switch, Top of the Rack switch, Leaf switch. The term leaf switch comes from the Spine-leaf architecture , where the access switches are called leaf switches. Spine-leaf architecture is commonly used in large/hyper-scale data centres, which brings very high scalability options for the DC switching layer and is also more efficient in building and implementing these switches. Sometimes these are referred to as Clos architecture. Spine switch Spine switches are the aggregation point of several leaf switches, they provide the inter-leaf communication and also connect to the upper layer of DC infrastructure. DC fabric As the data centre grows, multiple Clos networks need to be interconnected, to support the scale, and fabric switches help to interconnect them. Cabinet This refers to the rack, where the servers and ToR are installed. One cabinet refers to the entire rack. BGP It is the Border Gateway Protocol, used to exchange routing information between routers and switches. This is one of the common protocols used in the Internet and as well Data Centers as well. Other protocols are also used in place of BGP, like OSPF. VPN A Virtual Private Network is a tunnel solution, where two private networks (like offices, datacentres, etc) can be interconnected over a public network (internet). These VPN tunnels encrypt the traffic before sending over the Internet, as a security measure. NIC Network Interface Card refers to the module in Servers, which consists of the Ethernet port and the interconnection to the system bus. It is used to connect to the switches (commonly ToR switches). Flow Flows refer to a traffic exchange between two nodes (could be servers, switches, routers, etc), which has common parameters like source/destination IP address, source/destination port number, IP Protocol number. This helps in traffic a particular traffic exchange session, between two nodes (like a file copy session, or an HTTP connection, etc). ECMP Equal Cost Multi-Path means, a switch/router can distribute the traffic to a destination, among multiple exit interfaces. The flow information is used to build a hash value and based on that, exit interfaces are selected. Once a flow is mapped to a particular exit interface, all the packets of that flow exit via the same interface only. This helps in preventing out of order delivery of packets. RTT This is a measure of the time it takes for a packet from the source to reach the destination and return to the source. This is most commonly used in measuring network performance and also troubleshooting. TCP throughput This is the measure of the data transfer rate achieved between two nodes. This is impacted by many parameters like RTT, packet size, window size, etc. Unicast This refers to the traffic flow between a single source to a single destination (i.e.) like ssh sessions, where there is one to one communication. Anycast This refers to one-to-one traffic flow as above, but endpoints could be multiple (i.e.) a single source can send traffic to any one of the destination hosts in that group. This is achieved by having the same IP address configured in multiple servers and every new traffic flow is mapped to one of the servers. Multicast This refers to one-to-many traffic flow (i.e.) a single source can send traffic to multiple destinations. To make it feasible, the network routers replicate the traffic to different hosts (which register as members of that particular multicast group).","title":"Introduction"},{"location":"level102/networking/introduction/#prerequisites","text":"It is recommended to have basic knowledge of network security, TCP and datacenter setup and the common terminologies used in them. Also, the readers are expected to go through the School of Sre contents - Linux Networking system design security","title":"Prerequisites"},{"location":"level102/networking/introduction/#what-to-expect-from-this-course","text":"This part will cover how a datacenter infrastructure is segregated for different application needs as well as the consideration of deciding where to place an application. These will be broadly based on, Security, Scale, RTT (latency), Infrastructure features. Each of these topics will be covered in detail, Security - Will cover threat vectors faced by services facing external/internal clients. Potential mitigation options to consider while deploying them. This will touch upon perimeter security, DDoS protection, Network demarcation and ring-fencing the server clusters. Scale - Deploying large scale applications, require a better understanding of infrastructure capabilities, in terms of resource availability, failure domains, scaling options like using anycast, layer 4/7 load balancer, DNS based load balancing. RTT (latency) - Latency plays a key role in determining the overall performance of the distributed service/application, where calls are made between hosts to serve the users. Infrastructure features - Some of the aspects to consider are, whether the underlying data centre infrastructure supports ToR resiliency, i.e., features like link bundling (bonds), BGP (Border Gateway Protocol), support for anycast service, load balancer, firewall, Quality of Service.","title":"What to expect from this course"},{"location":"level102/networking/introduction/#what-is-not-covered-under-this-course","text":"Though these parameters play a role in designing an application, we will not go into the details of the design. Each of these topics are vast, hence the objective is to introduce the terms and relevance of the parameters in them, and not to provide extensive details about each one of them.","title":"What is not covered under this course"},{"location":"level102/networking/introduction/#course-contents","text":"Security Scale RTT Infrastructure features Conclusion","title":"Course Contents"},{"location":"level102/networking/introduction/#terminology","text":"Before discussing each of the topics, it is important to get familiar with few commonly used terms Cloud This refers to hosted solutions from different providers like Azure, AWS, GCP. Wherein enterprises can host their applications for either public or private usage. On-prem This term refers to physical Data Center(DC) infrastructure, built and managed by enterprises themselves. This can be used for private access as well as public (like users connecting over the Internet). Leaf switch (ToR) This refers to the switch, where the servers connect to, in a DC. They are called by many names, like access switch, Top of the Rack switch, Leaf switch. The term leaf switch comes from the Spine-leaf architecture , where the access switches are called leaf switches. Spine-leaf architecture is commonly used in large/hyper-scale data centres, which brings very high scalability options for the DC switching layer and is also more efficient in building and implementing these switches. Sometimes these are referred to as Clos architecture. Spine switch Spine switches are the aggregation point of several leaf switches, they provide the inter-leaf communication and also connect to the upper layer of DC infrastructure. DC fabric As the data centre grows, multiple Clos networks need to be interconnected, to support the scale, and fabric switches help to interconnect them. Cabinet This refers to the rack, where the servers and ToR are installed. One cabinet refers to the entire rack. BGP It is the Border Gateway Protocol, used to exchange routing information between routers and switches. This is one of the common protocols used in the Internet and as well Data Centers as well. Other protocols are also used in place of BGP, like OSPF. VPN A Virtual Private Network is a tunnel solution, where two private networks (like offices, datacentres, etc) can be interconnected over a public network (internet). These VPN tunnels encrypt the traffic before sending over the Internet, as a security measure. NIC Network Interface Card refers to the module in Servers, which consists of the Ethernet port and the interconnection to the system bus. It is used to connect to the switches (commonly ToR switches). Flow Flows refer to a traffic exchange between two nodes (could be servers, switches, routers, etc), which has common parameters like source/destination IP address, source/destination port number, IP Protocol number. This helps in traffic a particular traffic exchange session, between two nodes (like a file copy session, or an HTTP connection, etc). ECMP Equal Cost Multi-Path means, a switch/router can distribute the traffic to a destination, among multiple exit interfaces. The flow information is used to build a hash value and based on that, exit interfaces are selected. Once a flow is mapped to a particular exit interface, all the packets of that flow exit via the same interface only. This helps in preventing out of order delivery of packets. RTT This is a measure of the time it takes for a packet from the source to reach the destination and return to the source. This is most commonly used in measuring network performance and also troubleshooting. TCP throughput This is the measure of the data transfer rate achieved between two nodes. This is impacted by many parameters like RTT, packet size, window size, etc. Unicast This refers to the traffic flow between a single source to a single destination (i.e.) like ssh sessions, where there is one to one communication. Anycast This refers to one-to-one traffic flow as above, but endpoints could be multiple (i.e.) a single source can send traffic to any one of the destination hosts in that group. This is achieved by having the same IP address configured in multiple servers and every new traffic flow is mapped to one of the servers. Multicast This refers to one-to-many traffic flow (i.e.) a single source can send traffic to multiple destinations. To make it feasible, the network routers replicate the traffic to different hosts (which register as members of that particular multicast group).","title":"Terminology"},{"location":"level102/networking/rtt/","text":"Latency plays a key role in determining the overall performance of the distributed service/application, where calls are made between hosts to serve the users. RTT is a measure of time, it takes for a packet to reach B from A, and return to A. It is measured in milliseconds. This measure plays a role in determining the performance of the services. Its impact is seen in calls made between different servers/services, to serve the user, as well as the TCP throughput that can be achieved. It is fairly common that service makes multiple calls to servers within its cluster or to different services like authentication, logging, database, etc, to respond to each user/client request. These servers can be spread across different cabinets, at times even between different data centres in the same region. Such cases are quite possible in cloud solutions, where the deployment spreads across different sites within a region. As the RTT increases, the response time for each of the calls gets longer and thereby has a cascading effect on the end response being sent to the user. Relation of RTT and throughput RTT is inversely proportional to the TCP throughput. As RTT increases, it reduces the TCP throughput, just like packet loss. Below is a formula to estimate the TCP throughput, based on TCP mss, RTT and packet loss. As within a data centre, these calculations are also, important for communication over the internet, where a client can connect to the DC hosted services, over different telco networks and the RTT is not very stable, due to the unpredictability of the Internet routing policies.","title":"RTT"},{"location":"level102/networking/rtt/#relation-of-rtt-and-throughput","text":"RTT is inversely proportional to the TCP throughput. As RTT increases, it reduces the TCP throughput, just like packet loss. Below is a formula to estimate the TCP throughput, based on TCP mss, RTT and packet loss. As within a data centre, these calculations are also, important for communication over the internet, where a client can connect to the DC hosted services, over different telco networks and the RTT is not very stable, due to the unpredictability of the Internet routing policies.","title":"Relation of RTT and throughput"},{"location":"level102/networking/scale/","text":"Deploying large scale applications, require a better understanding of infrastructure capabilities, in terms of resource availability, failure domains, scaling options like using anycast, layer 4/7 load balancer, DNS based load balancing. Building large scale applications is a complex activity, which should cover many aspects in design, development and as well as operationalisation. This section will talk about the considerations to look for while deploying them. Failure domains In any infrastructure, failures due to hardware or software issues are common. Though these may be a pain from a service availability perspective, these failures do happen and a pragmatic goal would be to, try to keep these failures to the minimum. Hence while deploying any service, failures/non-availability of some of the nodes to be factored in. Server failures A server could fail, due to power or NIC or software bug. And at times it may not be a complete failure but could be an error in the NIC, which causes some packet loss. This is a very common scenario and will impact the stateful services more. While designing such services, it is important to accommodate some level of tolerance to such failures. ToR failures This is one of the common scenarios, where the leaf switch connecting the servers goes down, along with it taking down the entire cabinet. There could be more than one server of the same service that can go down in this case. It requires planning to decide how much server loss can be handled without overloading other servers. Based on this, the service can be distributed across many cabinets. These calculations may vary, depending upon the resiliency in the ToR design, which will be covered in ToR connectivity section. Site failures Here site failure is a generic term, which could mean, a particular service is down in a site, maybe due to new version rollout, or failures of devices like firewall, load balancer, if the service depends on them, or loss of connectivity to remote sites (which might have limited options for resiliency) or issues with critical services like DNS, etc. Though these events may not be common, they can have a significant impact. In summary, handling these failure scenarios has to be thought about while designing the application itself. That will provide the tolerance required within the application to recover from unexpected failures. This will help not only for failures, even for planned maintenance work, as it will be easier to take part of the infrastructure, out of service. Resource availability The other aspect to consider while deploying applications at scale is the availability of the required infrastructure and the features the service is dependent upon. For example, for the resiliency of a cabinet, if one decides to distribute the service to 5 cabinets, but the service needs a load balancer (to distribute incoming connections to different servers), it may become challenging if load balancers are not supported in all cabinets. Or there could be a case that there are not enough cabinets available (that meet the minimum required specification for service to be set up). The best approach in these cases is to identify the requirements and gaps and then work with the Infrastructure team to best solve them. Scaling options While distributing the application to different cabinets, the incoming traffic to these services has to be distributed across these servers. To achieve this, the following may be considered Anycast This is one of the quickest ways to roll out traffic distribution across multiple cabinets. In this, each server, part of the cluster (where the service is set up), advertises a loopback address (/32 IPv4 or /128 IPv6 address), to the DC switch fabric (most commonly BGP is used for this purpose). The service has to be set up to be listening to this loopback address. When the clients try to connect to the service, get resolved to this virtual address and forward their queries. The DC switch fabric distributes each flow into different available next hops (eventually to all the servers in that service cluster). Note: The DC switch computes a hash, based on the IP packet header, this could include any combination of source and destination addresses, source and destination port, mac address and IP protocol number. Based on this hash value, a particular next-hop is picked up. Since all the packets in a traffic flow, carry the same values for these headers, all the packets in that flow will be mapped to the same path. Fig 1: Anycast setup To achieve a proportionate distribution of flows across these servers, it is important to maintain uniformity in each of the cabinets and pods. But remember, the distribution happens only based on flows, and if there are any elephant (large) flows, some servers might receive a higher volume of traffic. If there are any server or ToR failures, the advertisement of loopback address to the switches will stop, and thereby the new packets will be forwarded to the remaining available servers. Load balancer Another common approach is to use a load balancer. A Virtual IP is set up in the load balancers, to which the client connects while trying to access the service. The load balancer, in turn, redirects these connections to, one of the actual servers, where the service is running. In order to, verify the server is in the serviceable state, the load balancer does periodic health checks, and if it fails, the LB stops redirecting the connection to these servers. The load balancer can be deployed in single-arm mode, where the traffic to the VIP is redirected by the LB, and the return traffic from the server to the client is sent directly. The other option is the two-arm mode, where the return traffic is also passed through the LB. Fig 2: Single-arm mode Fig 3: Two-arm mode One of the cons of this approach is, at a higher scale, the load balancer can become the bottleneck, to support higher traffic volumes or concurrent connections per second. DNS based load balancing This is similar to the above approach, with the only difference is instead of an appliance, the load balancing is done at the DNS. The clients get different IP's to connect when they query for the DNS records of the service. The DNS server has to do a health check, to know which servers are in a good state. This approach alleviates the bottleneck of the load balancer solution. But require shorter TTL for the DNS records, so that problematic servers can be taken out of rotation quickly, which means, there will be far more DNS queries.","title":"Scale"},{"location":"level102/networking/scale/#failure-domains","text":"In any infrastructure, failures due to hardware or software issues are common. Though these may be a pain from a service availability perspective, these failures do happen and a pragmatic goal would be to, try to keep these failures to the minimum. Hence while deploying any service, failures/non-availability of some of the nodes to be factored in.","title":"Failure domains"},{"location":"level102/networking/scale/#server-failures","text":"A server could fail, due to power or NIC or software bug. And at times it may not be a complete failure but could be an error in the NIC, which causes some packet loss. This is a very common scenario and will impact the stateful services more. While designing such services, it is important to accommodate some level of tolerance to such failures.","title":"Server failures"},{"location":"level102/networking/scale/#tor-failures","text":"This is one of the common scenarios, where the leaf switch connecting the servers goes down, along with it taking down the entire cabinet. There could be more than one server of the same service that can go down in this case. It requires planning to decide how much server loss can be handled without overloading other servers. Based on this, the service can be distributed across many cabinets. These calculations may vary, depending upon the resiliency in the ToR design, which will be covered in ToR connectivity section.","title":"ToR failures"},{"location":"level102/networking/scale/#site-failures","text":"Here site failure is a generic term, which could mean, a particular service is down in a site, maybe due to new version rollout, or failures of devices like firewall, load balancer, if the service depends on them, or loss of connectivity to remote sites (which might have limited options for resiliency) or issues with critical services like DNS, etc. Though these events may not be common, they can have a significant impact. In summary, handling these failure scenarios has to be thought about while designing the application itself. That will provide the tolerance required within the application to recover from unexpected failures. This will help not only for failures, even for planned maintenance work, as it will be easier to take part of the infrastructure, out of service.","title":"Site failures"},{"location":"level102/networking/scale/#resource-availability","text":"The other aspect to consider while deploying applications at scale is the availability of the required infrastructure and the features the service is dependent upon. For example, for the resiliency of a cabinet, if one decides to distribute the service to 5 cabinets, but the service needs a load balancer (to distribute incoming connections to different servers), it may become challenging if load balancers are not supported in all cabinets. Or there could be a case that there are not enough cabinets available (that meet the minimum required specification for service to be set up). The best approach in these cases is to identify the requirements and gaps and then work with the Infrastructure team to best solve them.","title":"Resource availability"},{"location":"level102/networking/scale/#scaling-options","text":"While distributing the application to different cabinets, the incoming traffic to these services has to be distributed across these servers. To achieve this, the following may be considered","title":"Scaling options"},{"location":"level102/networking/scale/#anycast","text":"This is one of the quickest ways to roll out traffic distribution across multiple cabinets. In this, each server, part of the cluster (where the service is set up), advertises a loopback address (/32 IPv4 or /128 IPv6 address), to the DC switch fabric (most commonly BGP is used for this purpose). The service has to be set up to be listening to this loopback address. When the clients try to connect to the service, get resolved to this virtual address and forward their queries. The DC switch fabric distributes each flow into different available next hops (eventually to all the servers in that service cluster). Note: The DC switch computes a hash, based on the IP packet header, this could include any combination of source and destination addresses, source and destination port, mac address and IP protocol number. Based on this hash value, a particular next-hop is picked up. Since all the packets in a traffic flow, carry the same values for these headers, all the packets in that flow will be mapped to the same path. Fig 1: Anycast setup To achieve a proportionate distribution of flows across these servers, it is important to maintain uniformity in each of the cabinets and pods. But remember, the distribution happens only based on flows, and if there are any elephant (large) flows, some servers might receive a higher volume of traffic. If there are any server or ToR failures, the advertisement of loopback address to the switches will stop, and thereby the new packets will be forwarded to the remaining available servers.","title":"Anycast"},{"location":"level102/networking/scale/#load-balancer","text":"Another common approach is to use a load balancer. A Virtual IP is set up in the load balancers, to which the client connects while trying to access the service. The load balancer, in turn, redirects these connections to, one of the actual servers, where the service is running. In order to, verify the server is in the serviceable state, the load balancer does periodic health checks, and if it fails, the LB stops redirecting the connection to these servers. The load balancer can be deployed in single-arm mode, where the traffic to the VIP is redirected by the LB, and the return traffic from the server to the client is sent directly. The other option is the two-arm mode, where the return traffic is also passed through the LB. Fig 2: Single-arm mode Fig 3: Two-arm mode One of the cons of this approach is, at a higher scale, the load balancer can become the bottleneck, to support higher traffic volumes or concurrent connections per second.","title":"Load balancer"},{"location":"level102/networking/scale/#dns-based-load-balancing","text":"This is similar to the above approach, with the only difference is instead of an appliance, the load balancing is done at the DNS. The clients get different IP's to connect when they query for the DNS records of the service. The DNS server has to do a health check, to know which servers are in a good state. This approach alleviates the bottleneck of the load balancer solution. But require shorter TTL for the DNS records, so that problematic servers can be taken out of rotation quickly, which means, there will be far more DNS queries.","title":"DNS based load balancing"},{"location":"level102/networking/security/","text":"This section will cover threat vectors faced by services facing external/internal clients. Potential mitigation options to consider while deploying them. This will touch upon perimeter security, DDoS protection, Network demarcation and operational practices. Security Threat Security is one of the major considerations in any infrastructure. There are various security threats, which could amount to data theft, loss of service, fraudulent activity, etc. An attacker can use techniques like phishing, spamming, malware, Dos/DDoS, exploiting vulnerabilities, man-in-the-middle attack, and many more. In this section, we will cover some of these threats and possible mitigation. As there are numerous means to attack and secure the infrastructure, we will only focus on some of the most common ones. Phishing is mostly done via email (and other mass communication methods), where an attacker provides links to fake websites/URLs. Upon accessing that, victim's sensitive information like login credentials or personal data is collected and can be misused. Spamming is also similar to phishing, but the attacker doesn't collect data from users but tries to spam a particular website and probably overwhelm them (to cause slowness) and well use that opportunity to, compromise the security of the attacked website. Malware is like a trojan horse, where an attacker manages to install a piece of code on the secured systems in the infrastructure. Using this, the hacker can collect sensitive data and as well infect the critical services of the target company. Exploiting vulnerabilities is another method an attacker can gain access to the systems. These could be bugs or misconfiguration in web servers, internet-facing routers/switches/firewalls, etc. DoS/DDoS is one of the common attacks seen on internet-based services/solutions, especially those businesses based on eyeball traffic. Here the attacker tries to overwhelm the resources of the victim by generating spurious traffic to the external-facing services. By this, primarily the services turn slow or non-responsive, during this time, the attacker could try to hack into the network, if some of the security mechanism fails to filter through the attack traffic due to overload. Securing the infrastructure The first and foremost aspect for any infrastructure administration is to identify the various security threats that could affect the business running over this infrastructure. Once different threats are known, the security defence mechanism has to be designed and implemented. Some of the common means to securing the infrastructure are Perimeter security This is the first line of defence in any infrastructure, where unwanted/unexpected traffic flows into the infrastructure are filtered/blocked. These could be filters in the edge routers, that allow expected services (like port 443 traffic for web service running on HTTPS), or this filter can be set up to block unwanted traffic, like blocking UDP ports, if the services are not dependent on UDP. Similar to the application traffic entering the network, there could be other traffic like BGP messages for Internet peers, VPN tunnels traffic, as well other services like email/DNS, etc. There are means to protect every one of these, like using authentication mechanisms (password or key-based) for peers of BGP, VPN, and whitelisting these specific peers to make inbound connections (in perimeter filters). Along with these, the amount of messages/traffic can be rate-limited to known scale or expected load, so the resources are not overwhelmed. DDoS mitigation Protecting against a DDoS attack is another important aspect. The attack traffic will look similar to the genuine users/client request, but with the intention to flood the externally exposed app, which could be a web server, DNS, etc. Therefore it is essential to differentiate between the attack traffic and genuine traffic, for this, there are different methods to do at the application level, one such example using Captcha on a web service, to catch traffic originating from bots. For these methods to be useful, the nodes should be capable of handling both the attack traffic and genuine traffic. It may be possible in cloud-based infrastructure to dynamically add more virtual machines/resources, to handle the sudden spike in volume of traffic, but on-prem, the option to add additional resources might be challenging. To handle a large volume of attack traffic, there are solutions available, which can inspect the packets/traffic flows and identify anomalies (i.e.) traffic patterns that don't resemble a genuine connection, like client initiating TCP connection, but fail to complete the handshake, or set of sources, which have abnormally huge traffic flow. Once this unwanted traffic is identified, these are dropped at the edge of the network itself, thereby protecting the resources of app nodes. This topic alone can be discussed more in detail, but that will be beyond the scope of this section. Network Demarcation Network demarcation is another common strategy deployed in different networks when applications are grouped based on their security needs and vulnerability to an attack. Some common demarcations are, the external/internet facing nodes are grouped into a separate zone, whereas those nodes having sensitive data are segregated into a separate zone. And any communication between these zones is restricted with the help of security tools to limit exposure to unwanted hosts/ports. These inter-zone communication filters are sometimes called ring-fencing. The number of zones to be created, varies for different deployments, for example, there could be a host which should be able to communicate to the external world as well as internal servers, like proxy, email, in this case, these can be grouped under one zone, say De-Militarized Zones (DMZ). The main advantage of creating zones is that, even if there is a compromised host, that doesn't act as a back door entry for the rest of the infrastructure. Node protection Be it server, router, switches, load balancers, firewall, etc, each of these devices come with certain capabilities to secure themselves, like support for filters (e.g. Access-list, Iptables) to control what traffic to process and what to drop, anti-virus software can be used in servers to check on the software installed in them. Operational practices There are numerous security threats for infrastructure, and there are different solutions to defend them. The key part to the defence, is not only identifying the right solution and the tools for it but also making sure there are robust operational procedures in place, to respond promptly, decisively and with clarity, for any security incident. Standard Operating Procedures (SOP) SOP need to be well defined and act as a reference for on-call to follow during a security incident. This SoP should cover things like, When a security incident happens, how it will be alerted, to whom it will be alerted. Identify the scale and severity of the security incident. Who are the points of escalation and the threshold/time to intimate them, there could be other concerned teams or to the management or even to the security operations in-charge. Which solutions to use (and the procedure to follow in them) to mitigate the security incident. Also the data about the security incident has to be collated for further analysis. Many organisations have a dedicated team focused on security, and they drive most of the activities, during an attack and even before, to come up with best practices, guidelines and compliance audits. It is the responsibility of respective technical teams, to ensure the infrastructure meets these recommendations and gaps are fixed. Periodic review Along with defining SoP's, the entire security of the infrastructure has to be reviewed periodically. This review should include, Identifying any new/improved security threat that could potentially target the infrastructure. The SoP's have to be reviewed periodically, depending upon new security threats or changes in the procedure (to implement the solutions) Ensuring software upgrades/patches are done in a timely manner. Audit the infrastructure for any non-compliance of the security standards. Review of recent security incidents and find means to improvise the defence mechanisms.","title":"Security"},{"location":"level102/networking/security/#security-threat","text":"Security is one of the major considerations in any infrastructure. There are various security threats, which could amount to data theft, loss of service, fraudulent activity, etc. An attacker can use techniques like phishing, spamming, malware, Dos/DDoS, exploiting vulnerabilities, man-in-the-middle attack, and many more. In this section, we will cover some of these threats and possible mitigation. As there are numerous means to attack and secure the infrastructure, we will only focus on some of the most common ones. Phishing is mostly done via email (and other mass communication methods), where an attacker provides links to fake websites/URLs. Upon accessing that, victim's sensitive information like login credentials or personal data is collected and can be misused. Spamming is also similar to phishing, but the attacker doesn't collect data from users but tries to spam a particular website and probably overwhelm them (to cause slowness) and well use that opportunity to, compromise the security of the attacked website. Malware is like a trojan horse, where an attacker manages to install a piece of code on the secured systems in the infrastructure. Using this, the hacker can collect sensitive data and as well infect the critical services of the target company. Exploiting vulnerabilities is another method an attacker can gain access to the systems. These could be bugs or misconfiguration in web servers, internet-facing routers/switches/firewalls, etc. DoS/DDoS is one of the common attacks seen on internet-based services/solutions, especially those businesses based on eyeball traffic. Here the attacker tries to overwhelm the resources of the victim by generating spurious traffic to the external-facing services. By this, primarily the services turn slow or non-responsive, during this time, the attacker could try to hack into the network, if some of the security mechanism fails to filter through the attack traffic due to overload.","title":"Security Threat"},{"location":"level102/networking/security/#securing-the-infrastructure","text":"The first and foremost aspect for any infrastructure administration is to identify the various security threats that could affect the business running over this infrastructure. Once different threats are known, the security defence mechanism has to be designed and implemented. Some of the common means to securing the infrastructure are","title":"Securing the infrastructure"},{"location":"level102/networking/security/#perimeter-security","text":"This is the first line of defence in any infrastructure, where unwanted/unexpected traffic flows into the infrastructure are filtered/blocked. These could be filters in the edge routers, that allow expected services (like port 443 traffic for web service running on HTTPS), or this filter can be set up to block unwanted traffic, like blocking UDP ports, if the services are not dependent on UDP. Similar to the application traffic entering the network, there could be other traffic like BGP messages for Internet peers, VPN tunnels traffic, as well other services like email/DNS, etc. There are means to protect every one of these, like using authentication mechanisms (password or key-based) for peers of BGP, VPN, and whitelisting these specific peers to make inbound connections (in perimeter filters). Along with these, the amount of messages/traffic can be rate-limited to known scale or expected load, so the resources are not overwhelmed.","title":"Perimeter security"},{"location":"level102/networking/security/#ddos-mitigation","text":"Protecting against a DDoS attack is another important aspect. The attack traffic will look similar to the genuine users/client request, but with the intention to flood the externally exposed app, which could be a web server, DNS, etc. Therefore it is essential to differentiate between the attack traffic and genuine traffic, for this, there are different methods to do at the application level, one such example using Captcha on a web service, to catch traffic originating from bots. For these methods to be useful, the nodes should be capable of handling both the attack traffic and genuine traffic. It may be possible in cloud-based infrastructure to dynamically add more virtual machines/resources, to handle the sudden spike in volume of traffic, but on-prem, the option to add additional resources might be challenging. To handle a large volume of attack traffic, there are solutions available, which can inspect the packets/traffic flows and identify anomalies (i.e.) traffic patterns that don't resemble a genuine connection, like client initiating TCP connection, but fail to complete the handshake, or set of sources, which have abnormally huge traffic flow. Once this unwanted traffic is identified, these are dropped at the edge of the network itself, thereby protecting the resources of app nodes. This topic alone can be discussed more in detail, but that will be beyond the scope of this section.","title":"DDoS mitigation"},{"location":"level102/networking/security/#network-demarcation","text":"Network demarcation is another common strategy deployed in different networks when applications are grouped based on their security needs and vulnerability to an attack. Some common demarcations are, the external/internet facing nodes are grouped into a separate zone, whereas those nodes having sensitive data are segregated into a separate zone. And any communication between these zones is restricted with the help of security tools to limit exposure to unwanted hosts/ports. These inter-zone communication filters are sometimes called ring-fencing. The number of zones to be created, varies for different deployments, for example, there could be a host which should be able to communicate to the external world as well as internal servers, like proxy, email, in this case, these can be grouped under one zone, say De-Militarized Zones (DMZ). The main advantage of creating zones is that, even if there is a compromised host, that doesn't act as a back door entry for the rest of the infrastructure.","title":"Network Demarcation"},{"location":"level102/networking/security/#node-protection","text":"Be it server, router, switches, load balancers, firewall, etc, each of these devices come with certain capabilities to secure themselves, like support for filters (e.g. Access-list, Iptables) to control what traffic to process and what to drop, anti-virus software can be used in servers to check on the software installed in them.","title":"Node protection"},{"location":"level102/networking/security/#operational-practices","text":"There are numerous security threats for infrastructure, and there are different solutions to defend them. The key part to the defence, is not only identifying the right solution and the tools for it but also making sure there are robust operational procedures in place, to respond promptly, decisively and with clarity, for any security incident.","title":"Operational practices"},{"location":"level102/networking/security/#standard-operating-procedures-sop","text":"SOP need to be well defined and act as a reference for on-call to follow during a security incident. This SoP should cover things like, When a security incident happens, how it will be alerted, to whom it will be alerted. Identify the scale and severity of the security incident. Who are the points of escalation and the threshold/time to intimate them, there could be other concerned teams or to the management or even to the security operations in-charge. Which solutions to use (and the procedure to follow in them) to mitigate the security incident. Also the data about the security incident has to be collated for further analysis. Many organisations have a dedicated team focused on security, and they drive most of the activities, during an attack and even before, to come up with best practices, guidelines and compliance audits. It is the responsibility of respective technical teams, to ensure the infrastructure meets these recommendations and gaps are fixed.","title":"Standard Operating Procedures (SOP)"},{"location":"level102/networking/security/#periodic-review","text":"Along with defining SoP's, the entire security of the infrastructure has to be reviewed periodically. This review should include, Identifying any new/improved security threat that could potentially target the infrastructure. The SoP's have to be reviewed periodically, depending upon new security threats or changes in the procedure (to implement the solutions) Ensuring software upgrades/patches are done in a timely manner. Audit the infrastructure for any non-compliance of the security standards. Review of recent security incidents and find means to improvise the defence mechanisms.","title":"Periodic review"},{"location":"level102/system_calls_and_signals/conclusion/","text":"Conclusion One of the main goals of a SRE is to improve the reliability of high scale systems. Inorder to achieve this, a basic understanding of the internal workings of a system is necessary. Getting to know about how signals work is important since they play a big role in the lifecycle of processes. We see the use of signals in a range of operations on processes : from creating a process to killing a process. Knowledge of signals is important especially when handling them in programs. If you anticipate an event that causes signals, you can define a handler function and tell the operating system to run it when that particular type of signal arrives. Understanding system calls is especially useful to SRE's while debugging any Linux process. System calls provide precise knowledge of the internal functionalities of an operating system. It gives an in-depth understanding for programmers about C library functions which implement system calls at a lower level. With the use of strace command, one may easily debug slow or hung processes. Further Reading https://www.oreilly.com/library/view/understanding-the-linux/0596002130/ch01s06.html https://jvns.ca/blog/2021/04/03/what-problems-do-people-solve-with-strace/ https://medium.com/@akhandmishra/important-system-calls-every-programmer-should-know-8884381ceadb https://www.brendangregg.com/blog/2014-05-11/strace-wow-much-syscall.html","title":"Conclusion"},{"location":"level102/system_calls_and_signals/conclusion/#conclusion","text":"One of the main goals of a SRE is to improve the reliability of high scale systems. Inorder to achieve this, a basic understanding of the internal workings of a system is necessary. Getting to know about how signals work is important since they play a big role in the lifecycle of processes. We see the use of signals in a range of operations on processes : from creating a process to killing a process. Knowledge of signals is important especially when handling them in programs. If you anticipate an event that causes signals, you can define a handler function and tell the operating system to run it when that particular type of signal arrives. Understanding system calls is especially useful to SRE's while debugging any Linux process. System calls provide precise knowledge of the internal functionalities of an operating system. It gives an in-depth understanding for programmers about C library functions which implement system calls at a lower level. With the use of strace command, one may easily debug slow or hung processes.","title":"Conclusion"},{"location":"level102/system_calls_and_signals/conclusion/#further-reading","text":"https://www.oreilly.com/library/view/understanding-the-linux/0596002130/ch01s06.html https://jvns.ca/blog/2021/04/03/what-problems-do-people-solve-with-strace/ https://medium.com/@akhandmishra/important-system-calls-every-programmer-should-know-8884381ceadb https://www.brendangregg.com/blog/2014-05-11/strace-wow-much-syscall.html","title":"Further Reading"},{"location":"level102/system_calls_and_signals/intro/","text":"System Calls and Signals Prerequisites Linux Basics Python Basics What to expect from this course The course covers a fundamental understanding of signals and system calls. It sheds light on how the knowledge of signals and system calls can be helpful for an SRE. What is not covered under this course The course does not discuss any other interrupts or interrupt handling apart from signals. The course will not deep dive into signal handler and GNU C library. Course Contents Signals Introduction to interrupts and signals Types of signals Sending signals to process Handling signals Role of signals in system calls with the example of wait() System calls Introduction Types of system calls User mode,kernel mode and their transitions Working of write() system call Debugging in Linux with strace","title":"Introduction"},{"location":"level102/system_calls_and_signals/intro/#system-calls-and-signals","text":"","title":"System Calls and Signals"},{"location":"level102/system_calls_and_signals/intro/#prerequisites","text":"Linux Basics Python Basics","title":"Prerequisites"},{"location":"level102/system_calls_and_signals/intro/#what-to-expect-from-this-course","text":"The course covers a fundamental understanding of signals and system calls. It sheds light on how the knowledge of signals and system calls can be helpful for an SRE.","title":"What to expect from this course"},{"location":"level102/system_calls_and_signals/intro/#what-is-not-covered-under-this-course","text":"The course does not discuss any other interrupts or interrupt handling apart from signals. The course will not deep dive into signal handler and GNU C library.","title":"What is not covered under this course"},{"location":"level102/system_calls_and_signals/intro/#course-contents","text":"Signals Introduction to interrupts and signals Types of signals Sending signals to process Handling signals Role of signals in system calls with the example of wait() System calls Introduction Types of system calls User mode,kernel mode and their transitions Working of write() system call Debugging in Linux with strace","title":"Course Contents"},{"location":"level102/system_calls_and_signals/signals/","text":"Introduction to interrupts and signals An interrupt is an event that alters the normal execution flow of a program and can be generated by hardware devices or even by the CPU itself. When an interrupt occurs the current flow of execution is suspended and the interrupt handler runs. After the interrupt handler runs the previous execution flow is resumed. There are three types of events that can cause the CPU to interrupt: hardware interrupts, software interrupts, and exceptions. Signals are nothing but software interrupts that notifies a process that an event has occurred. These events might be requests from users or indications that a system problem (such as a memory access error) has occurred. Every signal has a signal number and a default action defined. A process can react to them in any of the following ways: a default (OS-provided) way catch the signal and handle them in a program-defined way ignore the signal entirely Types of signals To list available signals in a Linux system, you can use the command kill -l . The table below lists the signals 1 to 20. To get a full list of signals, you can refer here . Signal name Signal number Default Action Meaning SIGHUP 1 Terminate Hangup detected on controlling terminal or death of controlling process SIGINT 2 Terminate Interrupt from keyboard SIGQUIT 3 Core dump Quit from keyboard SIGILL 4 Core dump Illegal instruction SIGTRAP 5 Core dump Trace/breakpoint trap for debugging SIGABRT , SIGIOT 6 Core dump Abnormal termination SIGBUS 7 Core dump Bus error SIGFPE 8 Core dump Floating point exception SIGKILL 9 Terminate Kill signal(cannot be caught or ignored) SIGUSR1 10 Terminate User-defined signal 1 SIGSEGV 11 Core dump Invalid memory reference SIGUSR2 12 Terminate User-defined signal 2 SIGPIPE 13 Terminate Broken pipe;write pipe with no readers SIGALRM 14 Terminate Timer signal from alarm SIGTERM 15 Terminate Process termination SIGSTKFLT 16 Terminate Stack fault on math co-processor SIGCHLD 17 Ignore Child stopped or terminated SIGCONT 18 Continue Continue if stopped SIGSTOP 19 Stop Stop process (can not be caught or ignore) SIGTSTP 20 Stop Stop types at tty Sending signals to process There are three different ways to send signals to processes: Sending signal to process using kill Kill command can be used to send signals to process. By default a SIGTERM signal is sent but a different type of signal can be sent to the process by defining the signal number(or signal name). For example, the command kill -9 367 sends SIGKILL to the process with PID 367 Sending signal to process via keyboard Signals can be sent to a running process by pressing some specific keys. For example, holding Ctrl+C sends SIGINT to the process which kills it. Sending signal to process via another process A process can send a signal to another process via the kill() system call. int kill(pid_t pid, int sig) system call takes 2 arguments, pid of the process you wish to send the signal to and the signal number of the desired signal. Handling signals Referring to the table of signals in the previous section, you can see that there are default handlers attached to all signals when the program is started. When we invoke signal to attach our own handler, we are over-riding the default behaviour of the program in response to that signal. Specifically, if we attach a handler to SIGINT, the program will no longer terminate when you press +C (or send the program a SIGINT by any other means); rather, the function specified as the handler will be invoked instead which will define the behaviour of the program in response to that signal. Let\u2019s take an example of handling SIGINT signal and terminating a program. We will use Python\u2019s signal library to achieve this. When we press Ctrl+C, SIGINT signal is sent. From the signals table, we see that the default action for SIGINT is to terminate the process. To illustrate how the process reacts to the default action and a signal handler, let us consider the below example. Default Action of SIGINT: Let us first run the below lines in a python environment: while 1: continue Now let us press \"Ctrl+C\". On pressing \"Ctrl+C\" , a SIGINT interrupt is sent to the process and the default action for SIGINT as per the table we saw in the previous section is to terminate the process. We see that the while loop is terminated and we get the below on our console: ^CTraceback (most recent call last): File \"\", line 2, in KeyboardInterrupt The process terminated(default action) since it received a SIGINT(Keyboard Interrupt) when we pressed Ctrl+C. Signal Handler for SIGINT: Let us run the below lines of code in the Python environment. import signal import sys #Start of signal_handler function def signal_handler(signal, frame): print ('You pressed Ctrl+C!') # End of signal_handler function signal.signal(signal.SIGINT, signal_handler) This is an example of a program that defines its own signal handler for SIGINT , overriding the default action. Now let us run the while and continue statement as we did previously. while 1: continue Do we see any changes when Ctrl+C is pressed? Does the program terminate? We see the below output: ^CYou pressed Ctrl+C! Everytime we press Ctrl+C, we just the see the above message and the program does not terminate. Inorder to terminate the program, you can press Ctrl+Z which sends the SIGSTOP signal whose default action is to stop the process. In the case of the signal handler, we define a function signal_handler() which prints \u201cYou pressed Ctrl+C!\u201d and does not terminate the program. The handler is called with two arguments, the signal number and the current stack frame (None or a frame object ). signal.signal() allows defining custom handlers to be executed when a signal is received. Its two arguments are the signal number(name) you want to trap and the name of the signal handler. Role of signals in system calls with the example of wait() The wait() system call waits for one of the children of the calling process to terminate and returns the termination status of that child in the buffer pointed to by statusPtr . If the parent process calls the wait() system call, then the execution of the parent is suspended until the child is terminated. At the termination of the child, a SIGCHLD signal is generated which is delivered to the parent by the kernel. SIGCHLD signal indicates to the parent that there is some information on the child that needs to be collected. Parent, on receipt of SIGCHLD , reaps the status of the child from the process table. Even though the child is terminated, there is an entry in the process table corresponding to the child where the process entry and PID is stored. When the parent collects the status, this entry is deleted. Thus, all the traces of the child process are removed from the system. If the parent decides not to wait for the child\u2019s termination and it executes its subsequent task, or fails to read the exit status of the child, there remains an entry in the process table even after the termination of the child. This state of the child process is known as the Zombie state. In order to avoid long-lasting zombies, we need to have code that calls wait() after the child process is created. It is generally good to create a signal handler for the SIGCHLD signal, calling one of the wait-family functions in a loop, until no uncollected child data remains. A child process becomes orphaned, if its parent process terminates before the child .The orphaned child is adopted by init/systemd, the ancestor of all processes, whose process ID is 1. Further calls to fetch the parent pid of this process returns 1.","title":"Signals"},{"location":"level102/system_calls_and_signals/signals/#introduction-to-interrupts-and-signals","text":"An interrupt is an event that alters the normal execution flow of a program and can be generated by hardware devices or even by the CPU itself. When an interrupt occurs the current flow of execution is suspended and the interrupt handler runs. After the interrupt handler runs the previous execution flow is resumed. There are three types of events that can cause the CPU to interrupt: hardware interrupts, software interrupts, and exceptions. Signals are nothing but software interrupts that notifies a process that an event has occurred. These events might be requests from users or indications that a system problem (such as a memory access error) has occurred. Every signal has a signal number and a default action defined. A process can react to them in any of the following ways: a default (OS-provided) way catch the signal and handle them in a program-defined way ignore the signal entirely","title":"Introduction to interrupts and signals"},{"location":"level102/system_calls_and_signals/signals/#types-of-signals","text":"To list available signals in a Linux system, you can use the command kill -l . The table below lists the signals 1 to 20. To get a full list of signals, you can refer here . Signal name Signal number Default Action Meaning SIGHUP 1 Terminate Hangup detected on controlling terminal or death of controlling process SIGINT 2 Terminate Interrupt from keyboard SIGQUIT 3 Core dump Quit from keyboard SIGILL 4 Core dump Illegal instruction SIGTRAP 5 Core dump Trace/breakpoint trap for debugging SIGABRT , SIGIOT 6 Core dump Abnormal termination SIGBUS 7 Core dump Bus error SIGFPE 8 Core dump Floating point exception SIGKILL 9 Terminate Kill signal(cannot be caught or ignored) SIGUSR1 10 Terminate User-defined signal 1 SIGSEGV 11 Core dump Invalid memory reference SIGUSR2 12 Terminate User-defined signal 2 SIGPIPE 13 Terminate Broken pipe;write pipe with no readers SIGALRM 14 Terminate Timer signal from alarm SIGTERM 15 Terminate Process termination SIGSTKFLT 16 Terminate Stack fault on math co-processor SIGCHLD 17 Ignore Child stopped or terminated SIGCONT 18 Continue Continue if stopped SIGSTOP 19 Stop Stop process (can not be caught or ignore) SIGTSTP 20 Stop Stop types at tty","title":"Types of signals"},{"location":"level102/system_calls_and_signals/signals/#sending-signals-to-process","text":"There are three different ways to send signals to processes: Sending signal to process using kill Kill command can be used to send signals to process. By default a SIGTERM signal is sent but a different type of signal can be sent to the process by defining the signal number(or signal name). For example, the command kill -9 367 sends SIGKILL to the process with PID 367 Sending signal to process via keyboard Signals can be sent to a running process by pressing some specific keys. For example, holding Ctrl+C sends SIGINT to the process which kills it. Sending signal to process via another process A process can send a signal to another process via the kill() system call. int kill(pid_t pid, int sig) system call takes 2 arguments, pid of the process you wish to send the signal to and the signal number of the desired signal.","title":"Sending signals to process"},{"location":"level102/system_calls_and_signals/signals/#handling-signals","text":"Referring to the table of signals in the previous section, you can see that there are default handlers attached to all signals when the program is started. When we invoke signal to attach our own handler, we are over-riding the default behaviour of the program in response to that signal. Specifically, if we attach a handler to SIGINT, the program will no longer terminate when you press +C (or send the program a SIGINT by any other means); rather, the function specified as the handler will be invoked instead which will define the behaviour of the program in response to that signal. Let\u2019s take an example of handling SIGINT signal and terminating a program. We will use Python\u2019s signal library to achieve this. When we press Ctrl+C, SIGINT signal is sent. From the signals table, we see that the default action for SIGINT is to terminate the process. To illustrate how the process reacts to the default action and a signal handler, let us consider the below example. Default Action of SIGINT: Let us first run the below lines in a python environment: while 1: continue Now let us press \"Ctrl+C\". On pressing \"Ctrl+C\" , a SIGINT interrupt is sent to the process and the default action for SIGINT as per the table we saw in the previous section is to terminate the process. We see that the while loop is terminated and we get the below on our console: ^CTraceback (most recent call last): File \"\", line 2, in KeyboardInterrupt The process terminated(default action) since it received a SIGINT(Keyboard Interrupt) when we pressed Ctrl+C. Signal Handler for SIGINT: Let us run the below lines of code in the Python environment. import signal import sys #Start of signal_handler function def signal_handler(signal, frame): print ('You pressed Ctrl+C!') # End of signal_handler function signal.signal(signal.SIGINT, signal_handler) This is an example of a program that defines its own signal handler for SIGINT , overriding the default action. Now let us run the while and continue statement as we did previously. while 1: continue Do we see any changes when Ctrl+C is pressed? Does the program terminate? We see the below output: ^CYou pressed Ctrl+C! Everytime we press Ctrl+C, we just the see the above message and the program does not terminate. Inorder to terminate the program, you can press Ctrl+Z which sends the SIGSTOP signal whose default action is to stop the process. In the case of the signal handler, we define a function signal_handler() which prints \u201cYou pressed Ctrl+C!\u201d and does not terminate the program. The handler is called with two arguments, the signal number and the current stack frame (None or a frame object ). signal.signal() allows defining custom handlers to be executed when a signal is received. Its two arguments are the signal number(name) you want to trap and the name of the signal handler.","title":"Handling signals"},{"location":"level102/system_calls_and_signals/signals/#role-of-signals-in-system-calls-with-the-example-of-wait","text":"The wait() system call waits for one of the children of the calling process to terminate and returns the termination status of that child in the buffer pointed to by statusPtr . If the parent process calls the wait() system call, then the execution of the parent is suspended until the child is terminated. At the termination of the child, a SIGCHLD signal is generated which is delivered to the parent by the kernel. SIGCHLD signal indicates to the parent that there is some information on the child that needs to be collected. Parent, on receipt of SIGCHLD , reaps the status of the child from the process table. Even though the child is terminated, there is an entry in the process table corresponding to the child where the process entry and PID is stored. When the parent collects the status, this entry is deleted. Thus, all the traces of the child process are removed from the system. If the parent decides not to wait for the child\u2019s termination and it executes its subsequent task, or fails to read the exit status of the child, there remains an entry in the process table even after the termination of the child. This state of the child process is known as the Zombie state. In order to avoid long-lasting zombies, we need to have code that calls wait() after the child process is created. It is generally good to create a signal handler for the SIGCHLD signal, calling one of the wait-family functions in a loop, until no uncollected child data remains. A child process becomes orphaned, if its parent process terminates before the child .The orphaned child is adopted by init/systemd, the ancestor of all processes, whose process ID is 1. Further calls to fetch the parent pid of this process returns 1.","title":"Role of signals in system calls with the example of wait()"},{"location":"level102/system_calls_and_signals/system_calls/","text":"Introduction A system call is a controlled entry point into the kernel, allowing a process to request the kernel to perform some action on the process\u2019s behalf. The kernel makes a range of services accessible to programs via the system call application programming interface (API). Application developers often do not have direct access to the system calls, but can access them through this API. These services include, for example, creating a new process, performing I/O, and creating a pipe for interprocess communication. The set of system calls is fixed. Each system call is identified by a unique number. The list of different system calls can be found here . A system call changes the processor state from user mode to kernel mode, so that the CPU can access protected kernel memory. Each system call may have a set of arguments that specify information to be transferred from user space (i.e., the process\u2019s virtual address space) to kernel space and vice versa. From a programming point of view, invoking a system call looks much like calling a C function. Types of system calls There are mainly 5 types of different system calls. They are : Process Control: These system calls are used to handle tasks related to a process such as process creation, termination,etc. File Management: These system calls are used for operations on files such as reading/writing a file. Device Management: These system calls are used to deal with devices such as reading/writing into device buffers. Information Maintenance: These system calls handle information and its transfer between the operating system and the user program. Communication: These system calls are useful for inter-process communication. They are also used for creating and deleting a communication connection. Types Of System Calls Examples in Linux Process Control fork(),exit(),wait() File Management open(), read(),write() Device Management ioctl(),read(),write() Information Maintenance getpid(),alarm(),sleep() Communication pipe(),shmget(),mmap() User mode, kernel mode and their transitions Modern processor architectures typically allow the CPU to operate in at least two different modes: user mode and kernel mode . Correspondingly, areas of virtual memory can be marked as being part of user space or kernel space. When running in user mode, the CPU can access only memory that is marked as being in user space; attempts to access memory in kernel space result in a hardware exception. At any given time, a process may be executing in either user mode or kernel mode. The type of instructions that can be executed depends on the mode and this is enforced at the hardware level. CPU modes (also called processor modes, CPU states, CPU privilege levels) are operating modes for the central processing unit of some computer architectures that place restrictions on the type and scope of operations that can be performed by certain processes being run by the CPU. The kernel itself is not a process but a process manager. The kernel model assumes that processes that require a kernel service use specific programming constructs called system calls. When a program is executed in user mode, it cannot directly access the kernel data structures or the kernel programs. When an application executes in kernel mode, however, these restrictions no longer apply. A program usually executes in user mode and switches to kernel mode only when requesting a service provided by the kernel. If an application needs access to hardware resources on the system(like peripherals,memory,disks), it must issue a system call, which causes a context switch from user mode to kernel mode. This procedure is followed when reading/writing from/to files, etc. It is only the system call itself which runs in kernel mode, not the application code. When the system call is complete, the process returns to the user mode with the return value using an inverse context switch. Apart from system calls, kernel routines can be activated in the below ways as well: The CPU executing the process signals an exception , which is an unusual condition such as an invalid instruction. The kernel handles the exception on behalf of the process that caused it. A peripheral device issues an interrupt signal to the CPU to notify it of an event such as a request for attention, a status change, or the completion of an I/O operation. Each interrupt signal is dealt by a kernel program called an interrupt handler . Since peripheral devices operate asynchronously with respect to the CPU, interrupts occur at unpredictable times. A kernel thread is executed. Since it runs in kernel Mode, the corresponding program must be considered part of the kernel. In the above diagram, Process 1 in User Mode issues a system call, after which the process switches to Kernel Mode and the system call is serviced. Process 1 then resumes execution in User Mode until a timer interrupt occurs and the scheduler is activated in Kernel Mode. A process switch takes place and Process 2 starts its execution in User Mode until a hardware device raises an interrupt. As a consequence of the interrupt, Process 2 switches to Kernel Mode and services the interrupt. Working of write() system call The write() system call writes data to an open file. # include ssize_t write(int fd, void *buffer, size_t count); buffer is the address of the data to be written; count is the number of bytes to write from buffer; and fd is a file descriptor referring to the file to which data is to be written. write() call writes up to count bytes from buffer to the open file referred to by fd . On success, write() call returns the number of bytes actually written, which may be less than count and returns -1 on error. When performing I/O on a disk file, a successful return from write() doesn\u2019t guarantee that the data has been transferred to disk, because the kernel performs buffering of disk I/O in order to reduce disk activity and expedite write() calls. It simply copies data between a user-space buffer and a buffer in the kernel buffer cache. At some later point, the kernel writes (flushes) its buffer to the disk. If, in the interim, another process attempts to read these bytes of the file, then the kernel automatically supplies the data from the buffer cache, rather than from (the outdated contents of) the file. The aim of this design is to allow write() to be fast, since they don\u2019t need to wait on a (slow) disk operation. This design is also efficient, since it reduces the number of disk transfers that the kernel must perform. Debugging in Linux with strace strace is a tool used to trace the transition between user processes and the Linux kernel. Inorder to use the tool, we need ensure that it is installed in the system by running the command: $ rpm -qa | grep -i strace strace-4.12-9.el7.x86_64 If the above command does not give any output, you can install the tool via: $ yum install strace The functions which are a part of standard C library are known as library functions. The purposes of these functions are very diverse, including such tasks as opening a file, converting a time to a human-readable format, and comparing two character strings. Some library functions are layered on top of system calls. Often, library functions are designed to provide a more caller-friendly interface than the underlying system call. For example, the printf() function provides output formatting and data buffering, whereas the write() system call just outputs a block of bytes.The most commonly used implementation of the standard C library on Linux is the GNU C library glibc . The C programming language gives printf() that lets the user write data in many different formats. So printf() as a function converts your data into a formatted sequence of bytes and that calls write() to write those bytes onto the output. Let us examine what happens when a printf() statement is executed with the use of strace command : strace printf %s \u201cHello world\u201d ~]$ strace printf %s \"Hello world\" execve(\"/usr/bin/printf\", [\"printf\", \"%s\", \"Hello world\"], [/* 47 vars */]) = 0 brk(NULL) = 0x90d000 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672f000 access(\"/etc/ld.so.preload\", R_OK) = -1 ENOENT (No such file or directory) open(\"/etc/ld.so.cache\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=98854, ...}) = 0 mmap(NULL, 98854, PROT_READ, MAP_PRIVATE, 3, 0) = 0x7f8fc6716000 close(3) = 0 open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 read(3, \"\\177ELF\\2\\1\\1\\3\\0\\0\\0\\0\\0\\0\\0\\0\\3\\0>\\0\\1\\0\\0\\0\\20&\\2\\0\\0\\0\\0\\0\"..., 832) = 832 fstat(3, {st_mode=S_IFREG|0755, st_size=2156160, ...}) = 0 mmap(NULL, 3985888, PROT_READ|PROT_EXEC, MAP_PRIVATE|MAP_DENYWRITE, 3, 0) = 0x7f8fc6141000 mprotect(0x7f8fc6304000, 2097152, PROT_NONE) = 0 mmap(0x7f8fc6504000, 24576, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_DENYWRITE, 3, 0x1c3000) = 0x7f8fc6504000 mmap(0x7f8fc650a000, 16864, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_ANONYMOUS, -1, 0) = 0x7f8fc650a000 close(3) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc6715000 mmap(NULL, 8192, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc6713000 arch_prctl(ARCH_SET_FS, 0x7f8fc6713740) = 0 mprotect(0x7f8fc6504000, 16384, PROT_READ) = 0 mprotect(0x60a000, 4096, PROT_READ) = 0 mprotect(0x7f8fc6730000, 4096, PROT_READ) = 0 munmap(0x7f8fc6716000, 98854) = 0 brk(NULL) = 0x90d000 brk(0x92e000) = 0x92e000 brk(NULL) = 0x92e000 open(\"/usr/lib/locale/locale-archive\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=106075056, ...}) = 0 mmap(NULL, 106075056, PROT_READ, MAP_PRIVATE, 3, 0) = 0x7f8fbfc17000 close(3) = 0 open(\"/usr/share/locale/locale.alias\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=2502, ...}) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672e000 read(3, \"# Locale name alias data base.\\n#\"..., 4096) = 2502 read(3, \"\", 4096) = 0 close(3) = 0 munmap(0x7f8fc672e000, 4096) = 0 open(\"/usr/lib/locale/UTF-8/LC_CTYPE\", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory) fstat(1, {st_mode=S_IFCHR|0620, st_rdev=makedev(136, 1), ...}) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672e000 write(1, \"Hello world\", 11Hello world) = 11 close(1) = 0 munmap(0x7f8fc672e000, 4096) = 0 close(2) = 0 exit_group(0) = ? +++ exited with 0 +++ execve(\"/usr/bin/printf\", [\"printf\", \"%s\", \"Hello world\"], [/ 47 vars /]) = 0 The first system call made is execve() and does three things: The operating system (OS) stops the duplicated process (of the parent). OS loads up the new program (in this case: printf() ), and starts the new program. execve() replaces defining parts of the current process's memory stack with the new stuff loaded from the printf executable file. The first word of the line, execve, is the name of the system call being executed. The first parameter must be the path of a binary executable or a script. The second is an array of argument strings passed to the new program. By convention, the first of these strings should contain the filename associated with the file being executed. The third parameter must be an environment variable. The number after the = sign (which is 0 in this case) is a value returned by the execve system call which indicates that the call was successful. open(\"/usr/lib/locale/UTF-8/LC_CTYPE\", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory) In this line, the program tried to open() file /usr/lib/locale/UTF-8/LC_CTYPE . However the system call failed (with -1 status) with the descriptive error message No such file or directory , as the file wasn\u2019t found (ENOENT). brk(NULL) = 0x90d000 brk(0x92e000) = 0x92e000 brk(NULL) = 0x92e000 The system call brk() is used to increase or decrease the process\u2019s data segment. It returns the new address where the data segment of the process is to end. open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 read(3, \"\\177ELF\\2\\1\\1\\3\\0\\0\\0\\0\\0\\0\\0\\0\\3\\0>\\0\\1\\0\\0\\0\\20&\\2\\0\\0\\0\\0\\0\"..., 832) = 832 In the above lines of the console output, we see that a successful open() call is made, followed by read() system call. In open() , the first parameter is the path to file which you want to use and the second parameter defines the permissions. In this example, O_RDONLY which means the file is read only and O_CLOEXEC which enables the close-on-exec flag for the opened file. This is useful to avoid race conditions in multithreaded programs where one thread opens a file descriptor at the same time as another thread. 3 indicates the file descriptor used to open the file. Since fd 0, 1, 2 are already taken by stdin, stdout and stderr. So first unused file descriptor is 3 in file descriptor table. If open() In read() , the first parameter is the file descriptor which is 3(the file was opened using this file descriptor by open() . The second parameter is the buffer to read data from and the third parameter is the length of the buffer. The return value is 832 which is the number of bytes read. close(3) = 0 A close system call is used to close a file descriptor by the kernel. For most file systems, a program terminates access to a file in a filesystem using the close system call. 0 after the = sign indicates that the system call was successful. write(1, \"Hello world\", 11Hello world) = 11 In the previous section, we described the write() system call and the arguments that it takes. Whenever we see any output to the video screen, it\u2019s from the file named /dev/tty and written to stdout on screen through fd 1. The first parameter is the file descriptor , second parameter is the buffer containing the information to be written and the last parameter contains the count of characters. On success, the number of bytes written are returned (zero indicates nothing was written) which is 11 in this example. +++ exited with 0 +++ This indicates that the program exited successfully with exit code 0. An exit code of 0 generally indicates successful execution and termination in Linux programs. You don't need to memorize all the system calls or what they do, because you can refer to documentation when you need to. Ensure the following package is installed before running the man command: $ rpm -qa | grep -i man-pages man-pages-3.53-5.el7.noarch Run the following man command with the system call name to see the documentation for that system call(for eg, execve): man 2 execve Apart from system calls, strace can be used to detect the files that are being accessed by the program. In the above trace, we have a system call open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 which is opening the libc shared object /lib64/libc.so.6 which is the C implementation of various standard functions. It is the file where we see the printf() definition needed for printing Hello World . Strace can also be used to check if a program is hanging or stuck. When we have the trace, we can observe at which operation the program is stuck as well. Furthermore, as we go through the trace, we can also find errors(if there are any) to point out why the program is hung/stuck. Strace can be very helpful in finding the reason behind slow performance of a program. Alhough strace has the aforementioned uses to it, if you're running a trace in a production environment, strace is not a good choice. It introduces a substantial amount of overhead. According to a performance test conducted by Arnaldo Carvalho de Melo, a senior software engineer at Red Hat, the process traced using strace ran 173 times slower, which can be disastrous for a production environment.","title":"System Calls"},{"location":"level102/system_calls_and_signals/system_calls/#introduction","text":"A system call is a controlled entry point into the kernel, allowing a process to request the kernel to perform some action on the process\u2019s behalf. The kernel makes a range of services accessible to programs via the system call application programming interface (API). Application developers often do not have direct access to the system calls, but can access them through this API. These services include, for example, creating a new process, performing I/O, and creating a pipe for interprocess communication. The set of system calls is fixed. Each system call is identified by a unique number. The list of different system calls can be found here . A system call changes the processor state from user mode to kernel mode, so that the CPU can access protected kernel memory. Each system call may have a set of arguments that specify information to be transferred from user space (i.e., the process\u2019s virtual address space) to kernel space and vice versa. From a programming point of view, invoking a system call looks much like calling a C function.","title":"Introduction"},{"location":"level102/system_calls_and_signals/system_calls/#types-of-system-calls","text":"There are mainly 5 types of different system calls. They are : Process Control: These system calls are used to handle tasks related to a process such as process creation, termination,etc. File Management: These system calls are used for operations on files such as reading/writing a file. Device Management: These system calls are used to deal with devices such as reading/writing into device buffers. Information Maintenance: These system calls handle information and its transfer between the operating system and the user program. Communication: These system calls are useful for inter-process communication. They are also used for creating and deleting a communication connection. Types Of System Calls Examples in Linux Process Control fork(),exit(),wait() File Management open(), read(),write() Device Management ioctl(),read(),write() Information Maintenance getpid(),alarm(),sleep() Communication pipe(),shmget(),mmap()","title":"Types of system calls"},{"location":"level102/system_calls_and_signals/system_calls/#user-mode-kernel-mode-and-their-transitions","text":"Modern processor architectures typically allow the CPU to operate in at least two different modes: user mode and kernel mode . Correspondingly, areas of virtual memory can be marked as being part of user space or kernel space. When running in user mode, the CPU can access only memory that is marked as being in user space; attempts to access memory in kernel space result in a hardware exception. At any given time, a process may be executing in either user mode or kernel mode. The type of instructions that can be executed depends on the mode and this is enforced at the hardware level. CPU modes (also called processor modes, CPU states, CPU privilege levels) are operating modes for the central processing unit of some computer architectures that place restrictions on the type and scope of operations that can be performed by certain processes being run by the CPU. The kernel itself is not a process but a process manager. The kernel model assumes that processes that require a kernel service use specific programming constructs called system calls. When a program is executed in user mode, it cannot directly access the kernel data structures or the kernel programs. When an application executes in kernel mode, however, these restrictions no longer apply. A program usually executes in user mode and switches to kernel mode only when requesting a service provided by the kernel. If an application needs access to hardware resources on the system(like peripherals,memory,disks), it must issue a system call, which causes a context switch from user mode to kernel mode. This procedure is followed when reading/writing from/to files, etc. It is only the system call itself which runs in kernel mode, not the application code. When the system call is complete, the process returns to the user mode with the return value using an inverse context switch. Apart from system calls, kernel routines can be activated in the below ways as well: The CPU executing the process signals an exception , which is an unusual condition such as an invalid instruction. The kernel handles the exception on behalf of the process that caused it. A peripheral device issues an interrupt signal to the CPU to notify it of an event such as a request for attention, a status change, or the completion of an I/O operation. Each interrupt signal is dealt by a kernel program called an interrupt handler . Since peripheral devices operate asynchronously with respect to the CPU, interrupts occur at unpredictable times. A kernel thread is executed. Since it runs in kernel Mode, the corresponding program must be considered part of the kernel. In the above diagram, Process 1 in User Mode issues a system call, after which the process switches to Kernel Mode and the system call is serviced. Process 1 then resumes execution in User Mode until a timer interrupt occurs and the scheduler is activated in Kernel Mode. A process switch takes place and Process 2 starts its execution in User Mode until a hardware device raises an interrupt. As a consequence of the interrupt, Process 2 switches to Kernel Mode and services the interrupt.","title":"User mode, kernel mode and their transitions"},{"location":"level102/system_calls_and_signals/system_calls/#working-of-write-system-call","text":"The write() system call writes data to an open file. # include ssize_t write(int fd, void *buffer, size_t count); buffer is the address of the data to be written; count is the number of bytes to write from buffer; and fd is a file descriptor referring to the file to which data is to be written. write() call writes up to count bytes from buffer to the open file referred to by fd . On success, write() call returns the number of bytes actually written, which may be less than count and returns -1 on error. When performing I/O on a disk file, a successful return from write() doesn\u2019t guarantee that the data has been transferred to disk, because the kernel performs buffering of disk I/O in order to reduce disk activity and expedite write() calls. It simply copies data between a user-space buffer and a buffer in the kernel buffer cache. At some later point, the kernel writes (flushes) its buffer to the disk. If, in the interim, another process attempts to read these bytes of the file, then the kernel automatically supplies the data from the buffer cache, rather than from (the outdated contents of) the file. The aim of this design is to allow write() to be fast, since they don\u2019t need to wait on a (slow) disk operation. This design is also efficient, since it reduces the number of disk transfers that the kernel must perform.","title":"Working of write() system call"},{"location":"level102/system_calls_and_signals/system_calls/#debugging-in-linux-with-strace","text":"strace is a tool used to trace the transition between user processes and the Linux kernel. Inorder to use the tool, we need ensure that it is installed in the system by running the command: $ rpm -qa | grep -i strace strace-4.12-9.el7.x86_64 If the above command does not give any output, you can install the tool via: $ yum install strace The functions which are a part of standard C library are known as library functions. The purposes of these functions are very diverse, including such tasks as opening a file, converting a time to a human-readable format, and comparing two character strings. Some library functions are layered on top of system calls. Often, library functions are designed to provide a more caller-friendly interface than the underlying system call. For example, the printf() function provides output formatting and data buffering, whereas the write() system call just outputs a block of bytes.The most commonly used implementation of the standard C library on Linux is the GNU C library glibc . The C programming language gives printf() that lets the user write data in many different formats. So printf() as a function converts your data into a formatted sequence of bytes and that calls write() to write those bytes onto the output. Let us examine what happens when a printf() statement is executed with the use of strace command : strace printf %s \u201cHello world\u201d ~]$ strace printf %s \"Hello world\" execve(\"/usr/bin/printf\", [\"printf\", \"%s\", \"Hello world\"], [/* 47 vars */]) = 0 brk(NULL) = 0x90d000 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672f000 access(\"/etc/ld.so.preload\", R_OK) = -1 ENOENT (No such file or directory) open(\"/etc/ld.so.cache\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=98854, ...}) = 0 mmap(NULL, 98854, PROT_READ, MAP_PRIVATE, 3, 0) = 0x7f8fc6716000 close(3) = 0 open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 read(3, \"\\177ELF\\2\\1\\1\\3\\0\\0\\0\\0\\0\\0\\0\\0\\3\\0>\\0\\1\\0\\0\\0\\20&\\2\\0\\0\\0\\0\\0\"..., 832) = 832 fstat(3, {st_mode=S_IFREG|0755, st_size=2156160, ...}) = 0 mmap(NULL, 3985888, PROT_READ|PROT_EXEC, MAP_PRIVATE|MAP_DENYWRITE, 3, 0) = 0x7f8fc6141000 mprotect(0x7f8fc6304000, 2097152, PROT_NONE) = 0 mmap(0x7f8fc6504000, 24576, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_DENYWRITE, 3, 0x1c3000) = 0x7f8fc6504000 mmap(0x7f8fc650a000, 16864, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_ANONYMOUS, -1, 0) = 0x7f8fc650a000 close(3) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc6715000 mmap(NULL, 8192, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc6713000 arch_prctl(ARCH_SET_FS, 0x7f8fc6713740) = 0 mprotect(0x7f8fc6504000, 16384, PROT_READ) = 0 mprotect(0x60a000, 4096, PROT_READ) = 0 mprotect(0x7f8fc6730000, 4096, PROT_READ) = 0 munmap(0x7f8fc6716000, 98854) = 0 brk(NULL) = 0x90d000 brk(0x92e000) = 0x92e000 brk(NULL) = 0x92e000 open(\"/usr/lib/locale/locale-archive\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=106075056, ...}) = 0 mmap(NULL, 106075056, PROT_READ, MAP_PRIVATE, 3, 0) = 0x7f8fbfc17000 close(3) = 0 open(\"/usr/share/locale/locale.alias\", O_RDONLY|O_CLOEXEC) = 3 fstat(3, {st_mode=S_IFREG|0644, st_size=2502, ...}) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672e000 read(3, \"# Locale name alias data base.\\n#\"..., 4096) = 2502 read(3, \"\", 4096) = 0 close(3) = 0 munmap(0x7f8fc672e000, 4096) = 0 open(\"/usr/lib/locale/UTF-8/LC_CTYPE\", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory) fstat(1, {st_mode=S_IFCHR|0620, st_rdev=makedev(136, 1), ...}) = 0 mmap(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x7f8fc672e000 write(1, \"Hello world\", 11Hello world) = 11 close(1) = 0 munmap(0x7f8fc672e000, 4096) = 0 close(2) = 0 exit_group(0) = ? +++ exited with 0 +++ execve(\"/usr/bin/printf\", [\"printf\", \"%s\", \"Hello world\"], [/ 47 vars /]) = 0 The first system call made is execve() and does three things: The operating system (OS) stops the duplicated process (of the parent). OS loads up the new program (in this case: printf() ), and starts the new program. execve() replaces defining parts of the current process's memory stack with the new stuff loaded from the printf executable file. The first word of the line, execve, is the name of the system call being executed. The first parameter must be the path of a binary executable or a script. The second is an array of argument strings passed to the new program. By convention, the first of these strings should contain the filename associated with the file being executed. The third parameter must be an environment variable. The number after the = sign (which is 0 in this case) is a value returned by the execve system call which indicates that the call was successful. open(\"/usr/lib/locale/UTF-8/LC_CTYPE\", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory) In this line, the program tried to open() file /usr/lib/locale/UTF-8/LC_CTYPE . However the system call failed (with -1 status) with the descriptive error message No such file or directory , as the file wasn\u2019t found (ENOENT). brk(NULL) = 0x90d000 brk(0x92e000) = 0x92e000 brk(NULL) = 0x92e000 The system call brk() is used to increase or decrease the process\u2019s data segment. It returns the new address where the data segment of the process is to end. open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 read(3, \"\\177ELF\\2\\1\\1\\3\\0\\0\\0\\0\\0\\0\\0\\0\\3\\0>\\0\\1\\0\\0\\0\\20&\\2\\0\\0\\0\\0\\0\"..., 832) = 832 In the above lines of the console output, we see that a successful open() call is made, followed by read() system call. In open() , the first parameter is the path to file which you want to use and the second parameter defines the permissions. In this example, O_RDONLY which means the file is read only and O_CLOEXEC which enables the close-on-exec flag for the opened file. This is useful to avoid race conditions in multithreaded programs where one thread opens a file descriptor at the same time as another thread. 3 indicates the file descriptor used to open the file. Since fd 0, 1, 2 are already taken by stdin, stdout and stderr. So first unused file descriptor is 3 in file descriptor table. If open() In read() , the first parameter is the file descriptor which is 3(the file was opened using this file descriptor by open() . The second parameter is the buffer to read data from and the third parameter is the length of the buffer. The return value is 832 which is the number of bytes read. close(3) = 0 A close system call is used to close a file descriptor by the kernel. For most file systems, a program terminates access to a file in a filesystem using the close system call. 0 after the = sign indicates that the system call was successful. write(1, \"Hello world\", 11Hello world) = 11 In the previous section, we described the write() system call and the arguments that it takes. Whenever we see any output to the video screen, it\u2019s from the file named /dev/tty and written to stdout on screen through fd 1. The first parameter is the file descriptor , second parameter is the buffer containing the information to be written and the last parameter contains the count of characters. On success, the number of bytes written are returned (zero indicates nothing was written) which is 11 in this example. +++ exited with 0 +++ This indicates that the program exited successfully with exit code 0. An exit code of 0 generally indicates successful execution and termination in Linux programs. You don't need to memorize all the system calls or what they do, because you can refer to documentation when you need to. Ensure the following package is installed before running the man command: $ rpm -qa | grep -i man-pages man-pages-3.53-5.el7.noarch Run the following man command with the system call name to see the documentation for that system call(for eg, execve): man 2 execve Apart from system calls, strace can be used to detect the files that are being accessed by the program. In the above trace, we have a system call open(\"/lib64/libc.so.6\", O_RDONLY|O_CLOEXEC) = 3 which is opening the libc shared object /lib64/libc.so.6 which is the C implementation of various standard functions. It is the file where we see the printf() definition needed for printing Hello World . Strace can also be used to check if a program is hanging or stuck. When we have the trace, we can observe at which operation the program is stuck as well. Furthermore, as we go through the trace, we can also find errors(if there are any) to point out why the program is hung/stuck. Strace can be very helpful in finding the reason behind slow performance of a program. Alhough strace has the aforementioned uses to it, if you're running a trace in a production environment, strace is not a good choice. It introduces a substantial amount of overhead. According to a performance test conducted by Arnaldo Carvalho de Melo, a senior software engineer at Red Hat, the process traced using strace ran 173 times slower, which can be disastrous for a production environment.","title":"Debugging in Linux with strace"},{"location":"level102/system_design/conclusion/","text":"We have looked at designing a sytem from the scratch, scaling it up from a single server to multiple datacenters and hundreds of thousands of users. However, you might have (rightly!) guessed that there is a lot more to system design than what we have covered so far. This course should give you a sweeping glance at the things that are fundamental to any system design process. Specific solutions implemented, frameworks and orchestration systems used evolve rapidly. However, the guiding principles remain the same. We hope you this course helped in getting you started along the right direction and that you have fun designing systems and solving interesting problems.","title":"Conclusion"},{"location":"level102/system_design/intro/","text":"System Design Prerequisites School of SRE - System Design - Phase I What to expect from this course The aim is to empower the reader to understand the building blocks of a well-designed system, evaluate existing systems, understand the trade-offs, come up with their own design, and to explore the various tools available to implement such a system. In phase one of this module, we talked about the fundamentals of system design including concepts like scalability, availability and reliability. We continue to build on those fundamentals in this phase. Throughout the course, there are callout sections that appear like this, and talk about things that are closely related to the system design process, but don\u2019t form a part of the system itself. They also have information about some common issues that crop up in system design. Watch out for them. What is not covered under this course While this course covers many aspects of system design, it does not cover the most fundamental concepts. For such topics, it is advised to go through the prerequisites. In general, this module will not go into actually implementing the architecture - we will not talk about choosing a hosting/cloud provider or an orchestration setup or a CI/CD system. Instead, we try to focus on the fundamental considerations that need to go into system design. Course Contents Introduction Large system Design Scaling Scaling beyond the datacentre Design patterns for resiliency Conclusion Introduction We talked about building a basic photo sharing application in the previous phase of this course. Our basic requirements for the application were that It should work for a reasonably large number of users Avoid service failures/cluster crash in case of any issues In other words, we wanted to build a system that was available, scalable and fault tolerant. We will continue designing that application, and cover additional concepts in the course of doing so. The photo sharing application is a web application that will handle everything from user sign up, log in, uploads, feed generation, user interaction and interaction with uploaded content. Also a database to store this information. In the simplest design, both the web app and the database can run on the same server. Recall this initial design from Phase 1. Building on that, we will talk about performance elements in system design - setting the right performance measurement metrics and using them to drive our design decisions, improving performance using caching, Content Delivery Networks (CDNs), etc. We will also talk about how to design for resilience by looking at some system design patterns - graceful degradation, time-outs and circuit breakers. Cost System design considerations like availability, scalability cannot exist in isolation. When operating outside the lab, we have other considerations / the existing considerations take on a different hue. One such consideration is cost. Real world systems almost always have budget constraints. System design, implementation and continued operation needs to have predictable costs per unit output. The output is usually the business problem you are trying to solve. Striking a balance between the two is very important. Understanding the capabilities of your system A well designed system requires understanding the building blocks intimately in terms of their capabilities. Not all components are created equal, and understanding what a single component can do is very important - for e.g., in the photo upload application it is important to know what a single database instance is capable of, in terms of read or write transactions per second and what would be a reasonable expectation be. This helps in building systems that are appropriately weighted - and will eliminate obvious sources of bottlenecks. On a lower level, even understanding the capabilities of the underlying hardware (or a VM instance if you are on cloud) is important. For eg., all disks don\u2019t perform the same, and all disks don\u2019t perform the same per dollar. If we are planning to have an API that is expected to return a response in 100ms under normal circumstances, then it is important to know how much of it will be spent in which parts of the system. The following link will help in getting a sense of each component\u2019s performance, all the way from the CPU cache to the network link to our end user. Numbers every programmer should know","title":"Introduction"},{"location":"level102/system_design/intro/#system-design","text":"","title":"System Design"},{"location":"level102/system_design/intro/#prerequisites","text":"School of SRE - System Design - Phase I","title":"Prerequisites"},{"location":"level102/system_design/intro/#what-to-expect-from-this-course","text":"The aim is to empower the reader to understand the building blocks of a well-designed system, evaluate existing systems, understand the trade-offs, come up with their own design, and to explore the various tools available to implement such a system. In phase one of this module, we talked about the fundamentals of system design including concepts like scalability, availability and reliability. We continue to build on those fundamentals in this phase. Throughout the course, there are callout sections that appear like this, and talk about things that are closely related to the system design process, but don\u2019t form a part of the system itself. They also have information about some common issues that crop up in system design. Watch out for them.","title":"What to expect from this course"},{"location":"level102/system_design/intro/#what-is-not-covered-under-this-course","text":"While this course covers many aspects of system design, it does not cover the most fundamental concepts. For such topics, it is advised to go through the prerequisites. In general, this module will not go into actually implementing the architecture - we will not talk about choosing a hosting/cloud provider or an orchestration setup or a CI/CD system. Instead, we try to focus on the fundamental considerations that need to go into system design.","title":"What is not covered under this course"},{"location":"level102/system_design/intro/#course-contents","text":"Introduction Large system Design Scaling Scaling beyond the datacentre Design patterns for resiliency Conclusion","title":"Course Contents"},{"location":"level102/system_design/intro/#introduction","text":"We talked about building a basic photo sharing application in the previous phase of this course. Our basic requirements for the application were that It should work for a reasonably large number of users Avoid service failures/cluster crash in case of any issues In other words, we wanted to build a system that was available, scalable and fault tolerant. We will continue designing that application, and cover additional concepts in the course of doing so. The photo sharing application is a web application that will handle everything from user sign up, log in, uploads, feed generation, user interaction and interaction with uploaded content. Also a database to store this information. In the simplest design, both the web app and the database can run on the same server. Recall this initial design from Phase 1. Building on that, we will talk about performance elements in system design - setting the right performance measurement metrics and using them to drive our design decisions, improving performance using caching, Content Delivery Networks (CDNs), etc. We will also talk about how to design for resilience by looking at some system design patterns - graceful degradation, time-outs and circuit breakers.","title":"Introduction"},{"location":"level102/system_design/large-system-design/","text":"Designing a system usually starts out to be abstract - we have large functional blocks that need to work together and are abstracted away into frontend, backend and database layers. However, when it is time to implement the system, especially as an SRE we have no other choice but to think in specific terms. Servers have a fixed amount of memory, storage capacity and processing power. So we need to think about the realistic expectations from our system, assess the requirements, translate them into specific requirements from each component of the system like network, storage and compute. This is typically how almost all large scale systems are built. The folks over at Google have formalized this approach to designing systems as \u2018Non abstract large system design\u2019 (NALSD). According to the Google site reliability workbook, \u201cPractically, NALSD combines elements of capacity planning, component isolation, and graceful system degradation that are crucial to highly available production systems.\u201d We will be using an approach similar to this to build our system. Application requirements Let us define our application requirements in more concrete terms i.e., specific functions: Our photo sharing application must let the user Sign up to become a member, and login to the application Upload photographs, and optionally add a description and tag location and/or people Follow other users on the platform See a feed comprising of photos from other users that they follow View their own profile page, and manage who they follow Let us define expectations for the application\u2019s performance for a better user experience. We also need to define the health of the system. SLIs and SLOs help us do just that. SLIs and SLOs The Google SRE book defines service level indicator(SLI) as \u201ca carefully defined quantitative measure of some aspect of the level of service that is provided.\u201d For our application, we can define multiple SLIs. One indicator can be the response time for loading the feed for our photo sharing application. Picking the right set of SLIs is very important since they essentially help us define the health of the system as a whole using concrete data. SLIs for an application are defined by the owners of the service, in consultation with the SREs. Service level objective (SLO) is defined as \u201ca target value or range of values for a service level that is measured by an SLI\u201d. SLO is a way for us to anchor ourselves to an optimal user experience by defining SLI boundaries. If our application takes a long time to load the feed, users might not open it very often. As a result, an example of SLO can be that at least 99% of the users should see their feed loaded within 1 second. Now that we have defined SLIs and SLOs, let us define the application\u2019s scalability, reliability and performance characteristics in terms of specific SLI and SLO levels. Defining application requirements in terms of SLIs and SLOs The following can be some of the expectations for our application: Once the user successfully uploads the image, it should be accessible to the user and their followers 100% of the time, barring user elected deletion. At least 50000 unique visitors should be able to visit the site at any given time and view their feed. 99% of the users should be able to view their feeds in less than 1 second. Upon uploading a new image, it should show up in the feed of the user\u2019s followers within 15 minutes. Users should be able to upload potentially thousands of images. (as long as they are not abusing the service) Since our ultimate aim is to learn system design, we will arbitrarily limit the functionalities of the system. This will help us keep sight of our aim, and keep us focussed. Having defined the functionalities and expectations for our system, let us quickly sketch an initial design. As of now, all the functionalities are residing on a single server, which has endpoints for all of these functions. We will attempt to build a system that satisfies our SLOs, is able to serve 50k concurrent users, and about a million total users. In the course of this attempt, we will discuss a string of concepts, some of which we have already seen in Phase 1 of this course. Caution Note that the numbers we have picked in the following sections are completely arbitrary. They have been chosen to demonstrate thinking about system design in a non-abstract manner. They have not been benchmarked, and bear no real world resemblance. Do not use them in any real world systems that you may be designing. You should come up with your own numbers, using the guiding principles we have relied upon here. Estimating resource requirements Single Computer If we wished to run the application on a single server, we would need to perform all the above functionalities from the diagram on this server itself. Let us perform some calculations to figure out what kind of resources we will need. Before anything else, we need to store the data about users, their uploads, follower information and any other metadata. We will choose a relational DB to store this information, like MySQL. Do note that we can also choose to use a NOSQL solution here. That would require a similar approach to calculate the requirements. Let us represent the users like so: UserID(int) UserName(varchar) DisplayName(varchar) YearOfBirth(year) Email(varchar) Photos can be represented like this: PhotoID(int) PhotoHash(varchar) Uploadtime(datetime) Location(varchar) OptionalFlag(varchar) Followers can be represented like this: Follower(int) Followee(int) Let us quickly estimate the storage needed for a hundred million total users. A single user would need 4B + 32B + 32B + 4B + 32B = 104 bytes. A hundred million users would need 10.4 GB storage. A single photo would need about 4B + 20B + 4B + 32B + 4B = 64 bytes of storage to store the metadata related to the photo. Assuming a million photos uploaded in one day, we would need about 64 MB of storage per day, just for the metadata. For the photo storage itself, we will need about 300GB per day, assuming 300KB average photo size. A single visitor opening our application simply hits our /get_feed endpoint upon logging in to the application. Let us quickly calculate the resources needed to serve this request. Assuming the initial feed loads 5 images (of 300 KB size on an average) and then does lazy loading to infinitely scroll, we will need to send about 1.5 megabytes of images to the user for his initial call. With a 1000 Mbps* network link to the server, we can send only about (1000/8)/1.5 or about 83 users all loading the feed at the same time, before we saturate the network link. If we needed to serve 50k concurrent users every second, we would need 1.5*50000*8 = 600000 Mbps network throughput needed for every 5 images sent, assuming we send out all 5 images in a single second. If we are reading all of it from disk, we would likely hit disk throughput limits far before approaching anywhere near this amount of traffic. So in order to meet our application requirements, we would need a server that has ~310GB storage for the database and the images of one day, and about 600 Gbps link to serve 50k users concurrently, along with CPU required to perform all this. Clearly not the task for a single server. And do note that we have severely limited the information we are storing in the database. We would likely need an order of magnitude more information to be stored. While we clearly do not have any real world server that has the resources we calculated above, this exercise provides us some valuable data points about what the resource cost is. Armed with this information, let us work on scaling our system through system design to get us as close as possible to our goals for the application. * Modern servers even have multi-gigabit links, but it is highly unlikely that such a huge server will be serving our application alone. Modern cloud providers have VMs that also boast several gigabits of bandwidth, but they usually end up being throttled after certain limits. References: SQL vs NoSQL databases Introducing Non-Abstract Large System Design","title":"Large System Design"},{"location":"level102/system_design/large-system-design/#application-requirements","text":"Let us define our application requirements in more concrete terms i.e., specific functions: Our photo sharing application must let the user Sign up to become a member, and login to the application Upload photographs, and optionally add a description and tag location and/or people Follow other users on the platform See a feed comprising of photos from other users that they follow View their own profile page, and manage who they follow Let us define expectations for the application\u2019s performance for a better user experience. We also need to define the health of the system. SLIs and SLOs help us do just that.","title":"Application requirements"},{"location":"level102/system_design/large-system-design/#slis-and-slos","text":"The Google SRE book defines service level indicator(SLI) as \u201ca carefully defined quantitative measure of some aspect of the level of service that is provided.\u201d For our application, we can define multiple SLIs. One indicator can be the response time for loading the feed for our photo sharing application. Picking the right set of SLIs is very important since they essentially help us define the health of the system as a whole using concrete data. SLIs for an application are defined by the owners of the service, in consultation with the SREs. Service level objective (SLO) is defined as \u201ca target value or range of values for a service level that is measured by an SLI\u201d. SLO is a way for us to anchor ourselves to an optimal user experience by defining SLI boundaries. If our application takes a long time to load the feed, users might not open it very often. As a result, an example of SLO can be that at least 99% of the users should see their feed loaded within 1 second. Now that we have defined SLIs and SLOs, let us define the application\u2019s scalability, reliability and performance characteristics in terms of specific SLI and SLO levels.","title":"SLIs and SLOs"},{"location":"level102/system_design/large-system-design/#defining-application-requirements-in-terms-of-slis-and-slos","text":"The following can be some of the expectations for our application: Once the user successfully uploads the image, it should be accessible to the user and their followers 100% of the time, barring user elected deletion. At least 50000 unique visitors should be able to visit the site at any given time and view their feed. 99% of the users should be able to view their feeds in less than 1 second. Upon uploading a new image, it should show up in the feed of the user\u2019s followers within 15 minutes. Users should be able to upload potentially thousands of images. (as long as they are not abusing the service) Since our ultimate aim is to learn system design, we will arbitrarily limit the functionalities of the system. This will help us keep sight of our aim, and keep us focussed. Having defined the functionalities and expectations for our system, let us quickly sketch an initial design. As of now, all the functionalities are residing on a single server, which has endpoints for all of these functions. We will attempt to build a system that satisfies our SLOs, is able to serve 50k concurrent users, and about a million total users. In the course of this attempt, we will discuss a string of concepts, some of which we have already seen in Phase 1 of this course.","title":"Defining application requirements in terms of SLIs and SLOs"},{"location":"level102/system_design/large-system-design/#estimating-resource-requirements","text":"Single Computer If we wished to run the application on a single server, we would need to perform all the above functionalities from the diagram on this server itself. Let us perform some calculations to figure out what kind of resources we will need. Before anything else, we need to store the data about users, their uploads, follower information and any other metadata. We will choose a relational DB to store this information, like MySQL. Do note that we can also choose to use a NOSQL solution here. That would require a similar approach to calculate the requirements. Let us represent the users like so: UserID(int) UserName(varchar) DisplayName(varchar) YearOfBirth(year) Email(varchar) Photos can be represented like this: PhotoID(int) PhotoHash(varchar) Uploadtime(datetime) Location(varchar) OptionalFlag(varchar) Followers can be represented like this: Follower(int) Followee(int) Let us quickly estimate the storage needed for a hundred million total users. A single user would need 4B + 32B + 32B + 4B + 32B = 104 bytes. A hundred million users would need 10.4 GB storage. A single photo would need about 4B + 20B + 4B + 32B + 4B = 64 bytes of storage to store the metadata related to the photo. Assuming a million photos uploaded in one day, we would need about 64 MB of storage per day, just for the metadata. For the photo storage itself, we will need about 300GB per day, assuming 300KB average photo size. A single visitor opening our application simply hits our /get_feed endpoint upon logging in to the application. Let us quickly calculate the resources needed to serve this request. Assuming the initial feed loads 5 images (of 300 KB size on an average) and then does lazy loading to infinitely scroll, we will need to send about 1.5 megabytes of images to the user for his initial call. With a 1000 Mbps* network link to the server, we can send only about (1000/8)/1.5 or about 83 users all loading the feed at the same time, before we saturate the network link. If we needed to serve 50k concurrent users every second, we would need 1.5*50000*8 = 600000 Mbps network throughput needed for every 5 images sent, assuming we send out all 5 images in a single second. If we are reading all of it from disk, we would likely hit disk throughput limits far before approaching anywhere near this amount of traffic. So in order to meet our application requirements, we would need a server that has ~310GB storage for the database and the images of one day, and about 600 Gbps link to serve 50k users concurrently, along with CPU required to perform all this. Clearly not the task for a single server. And do note that we have severely limited the information we are storing in the database. We would likely need an order of magnitude more information to be stored. While we clearly do not have any real world server that has the resources we calculated above, this exercise provides us some valuable data points about what the resource cost is. Armed with this information, let us work on scaling our system through system design to get us as close as possible to our goals for the application. * Modern servers even have multi-gigabit links, but it is highly unlikely that such a huge server will be serving our application alone. Modern cloud providers have VMs that also boast several gigabits of bandwidth, but they usually end up being throttled after certain limits.","title":"Estimating resource requirements"},{"location":"level102/system_design/large-system-design/#references","text":"SQL vs NoSQL databases Introducing Non-Abstract Large System Design","title":"References:"},{"location":"level102/system_design/resiliency/","text":"A resilient system is one that can keep functioning in the face of adversity. With our application, there can be numerous failures that act as adversities. There can be network level failures that take out entire data centres, there might be issues at the rack level or at the server level, or there might be something wrong with the cloud provider. We may also run out of capacity, or there might be a wrong code push that breaks the system. We will talk about a couple of such issues, and understand how we might design a system to work around such things. In some cases, a workaround might not be possible. However it is still valuable to know potential vulnerabilities to the system stability. Resilient architectures leverage system design patterns such as graceful degradation, quotas, timeouts and circuit breakers. Let us look at some of them in this section. Quotas A system may have a component or an endpoint that is consumed by multiple components and endpoints. It is important to have something in place that will prevent one consumer or client from overwhelming such a system. Quotas are one way to do this - we simply assign a specific quota for each component - by way of specifying requests per unit time. Anyone who breaches the quota is either warned or dropped, depending on the implementation. This way, one of our own systems misbehaving cannot result in denial of service to others. Quotas also help us prevent cascading failures. Graceful Degradation When a system with multiple dependencies encounters failure in one of the dependencies, gracefully degrading to minimum viable functionality would be a lot better than grinding the entire system to a halt. For example, let us assume there is an endpoint (an URL for a service or a specific function) in our application whose responsibility is to parse the location information in an user uploaded image from the image's metadata and provide suggestions for location tagging to the user. Rather than failing the entire upload, it is much better to skip over this functionality and still give the user an option to manually tag a location. Gracefully degrading is always better compared to total failures. Timeouts We sometimes call other services or resources like databases or API endpoints in our application. When calling such a resource from our application, it is important to always have a reasonable timeout. It doesn\u2019t necessarily even have to be that the resource will fail for all requests. It just might be that a specific request falls in the high tail latency category. A reasonable time out is helpful to keep the user experience consistent - it is better to fail rather than to have frustratingly long delays, in some cases. Exponential back-offs When a service endpoint fails, retries are one way to see if it was a momentary failure. However, if the retry is also going to fail, there is no point in endlessly retrying. At large enough scale, the retries can compete with the new requests (which might very well be served as expected) and saturate the system. To avoid this, we can look at exponential back-off for retries. This essentially decreases the rate at which the clients retry, upon encountering consecutive failures on retries. Circuit breakers While exponential back off is one way to deal with retry storms, circuit breakers can be another. Circuit breakers can help failures from percolating the entire system. Else, an unmitigated failure that flows through the system may result in false alerts, worsening the mean time to detection(MTTD) and mean time to resolution(MTTR). For example, in case one of the in-memory cache nodes fails resulting in requests reaching the database post the initial timeouts for cache, it might end up overloading the database. If the initial connection between cache node failure and DB node failure is not made, then it might result in increased MTTD of the actual cause and consequently the MTTR. Self healing systems A traditionally load-balanced application with multiple instances might fail when more than a threshold of instances stop responding to requests - either because they are down, or suddenly there is a huge influx of requests, resulting in degraded performance. A self-healing system adds more instances in this scenario to replace the failed instances. Auto-scaling like this can also help when there is a sudden spike in query. If our application runs on a public cloud, it might simply be a matter of spinning up more virtual machines . If we are running on-premise out of our data center, then we will want to think about capacity planning much more carefully. Regardless of how we handle adding additional capacity - simply addition may not be enough. We should also think about additional potential failure modes that might be encountered. For example, the load balancing layer itself might need scaling up, to handle the influx of new backends. Continuous Deployment and Integration A well designed system also needs to take into account the need for a proper staging setup that can mimic the production environment as closely as possible. There should also be a way for us to replay production traffic in the staging environment to test changes to production thoroughly.","title":"Resiliency"},{"location":"level102/system_design/resiliency/#quotas","text":"A system may have a component or an endpoint that is consumed by multiple components and endpoints. It is important to have something in place that will prevent one consumer or client from overwhelming such a system. Quotas are one way to do this - we simply assign a specific quota for each component - by way of specifying requests per unit time. Anyone who breaches the quota is either warned or dropped, depending on the implementation. This way, one of our own systems misbehaving cannot result in denial of service to others. Quotas also help us prevent cascading failures.","title":"Quotas"},{"location":"level102/system_design/resiliency/#graceful-degradation","text":"When a system with multiple dependencies encounters failure in one of the dependencies, gracefully degrading to minimum viable functionality would be a lot better than grinding the entire system to a halt. For example, let us assume there is an endpoint (an URL for a service or a specific function) in our application whose responsibility is to parse the location information in an user uploaded image from the image's metadata and provide suggestions for location tagging to the user. Rather than failing the entire upload, it is much better to skip over this functionality and still give the user an option to manually tag a location. Gracefully degrading is always better compared to total failures.","title":"Graceful Degradation"},{"location":"level102/system_design/resiliency/#timeouts","text":"We sometimes call other services or resources like databases or API endpoints in our application. When calling such a resource from our application, it is important to always have a reasonable timeout. It doesn\u2019t necessarily even have to be that the resource will fail for all requests. It just might be that a specific request falls in the high tail latency category. A reasonable time out is helpful to keep the user experience consistent - it is better to fail rather than to have frustratingly long delays, in some cases.","title":"Timeouts"},{"location":"level102/system_design/resiliency/#exponential-back-offs","text":"When a service endpoint fails, retries are one way to see if it was a momentary failure. However, if the retry is also going to fail, there is no point in endlessly retrying. At large enough scale, the retries can compete with the new requests (which might very well be served as expected) and saturate the system. To avoid this, we can look at exponential back-off for retries. This essentially decreases the rate at which the clients retry, upon encountering consecutive failures on retries.","title":"Exponential back-offs"},{"location":"level102/system_design/resiliency/#circuit-breakers","text":"While exponential back off is one way to deal with retry storms, circuit breakers can be another. Circuit breakers can help failures from percolating the entire system. Else, an unmitigated failure that flows through the system may result in false alerts, worsening the mean time to detection(MTTD) and mean time to resolution(MTTR). For example, in case one of the in-memory cache nodes fails resulting in requests reaching the database post the initial timeouts for cache, it might end up overloading the database. If the initial connection between cache node failure and DB node failure is not made, then it might result in increased MTTD of the actual cause and consequently the MTTR.","title":"Circuit breakers"},{"location":"level102/system_design/resiliency/#self-healing-systems","text":"A traditionally load-balanced application with multiple instances might fail when more than a threshold of instances stop responding to requests - either because they are down, or suddenly there is a huge influx of requests, resulting in degraded performance. A self-healing system adds more instances in this scenario to replace the failed instances. Auto-scaling like this can also help when there is a sudden spike in query. If our application runs on a public cloud, it might simply be a matter of spinning up more virtual machines . If we are running on-premise out of our data center, then we will want to think about capacity planning much more carefully. Regardless of how we handle adding additional capacity - simply addition may not be enough. We should also think about additional potential failure modes that might be encountered. For example, the load balancing layer itself might need scaling up, to handle the influx of new backends.","title":"Self healing systems"},{"location":"level102/system_design/resiliency/#continuous-deployment-and-integration","text":"A well designed system also needs to take into account the need for a proper staging setup that can mimic the production environment as closely as possible. There should also be a way for us to replay production traffic in the staging environment to test changes to production thoroughly.","title":"Continuous Deployment and Integration"},{"location":"level102/system_design/scaling-beyond-the-datacenter/","text":"Caching static assets Extending the existing caching solution a bit, we arrive at Content Delivery Networks(CDNs). CDNs are the caching layer that is closest to the user. A significant chunk of resources served in a webpage, may not be changing on an hourly or even a daily basis. In those cases, we would want to cache these at the CDN level, reducing our load. CDNs not only help reduce the load on our servers by removing the burden of serving static / bandwidth intensive resources, they also let us be present closer to our users, by way of points of presence(POPs). CDNs also let us do geo-load balancing, in case we have multiple data centres around the world, and would want to serve from the closest data center (DC) possible. Taking it a step further With the addition of caching and distributing our application into simpler services, we have solved the problem of scaling to 50000 users. However, our users may be geographically distributed locations and may not be at the same distance from our data centre or our cloud region. Consistency in user experience is important, else we are excluding users who are far away from our location, potentially eliminating a significant chunk of potential users. However, it is not impractical to have data centers all over the world, or even in more than a couple of locations in the world. This is where CDNs and POPs come into picture. Points of Presence CDN POPs are geographically distributed data centers aimed at being close to users. POPs reduce the round trip time by delivering content from a location that is nearest to the user. POPs typically may not have all the content, but have caching servers that cache the static assets, and fetch the rest of the content from the origin server where the application actually resides. Their main function is to reduce round trip time by bringing the content closer to the website\u2019s visitor. POPs can also route traffic to one of the multiple origin DCs possible. This way, POPs can be leveraged to add resiliency as well as load-balancing. Now, with our image sharing application becoming more popular by the day, let us assume that we have hit 100,000 concurrent users. And we have built another data center, predicting this increase in traffic. Now we need to be able to route the service to both of these data centers in a reliable manner, while also retaining the ability to fall back to a single data center in case there is an issue with one of the two DCs. This is where sticky routing comes into play. Sticky Routing When an user sends a request, there are cases in which we might want to serve a specific user\u2019s requests from a DC if we have multiple DCs, or a specific server inside a DC. We may also wish to serve all requests from a specific POP by a single data center. Sticky routing helps us do exactly that. It might be simply pinning all users to a specific DC or pinning specific users to specific servers. This is typically done from the POP, so that as soon as the user enters reaches our servers, we can route them to the nearest DC possible. Geo DNS When a user opens the application, the user can be directed to one of the multiple globally distributed POPs. This can be done using GeoDNS , which simply put, gives out a different IP address(which are distributed geographically), depending on the location of the user making the DNS request. GeoDNS is the first step in distributing users to different locations - it is not 100% accurate, and typically makes use of IP address allotment information for guessing the location of the user. However, it works well enough for >90% of the users. After this, we can have a sticky routing service that assigns each user to a specific DC, which we can use to assign a DC to this user, and set a cookie. When the user next visits, the cookie can be read at the POP to decide which data center the user\u2019s traffic must be directed to. Having multiple DCs and leveraging sticky routing has not only scaling benefits, but also adds to the resiliency of the service, albeit at the cost of additional complexity. Let us consider another use case in which an user uploads a new profile picture for themselves. If we have multiple data centres or POPs which are not synced in real time - not all of them might have the newer picture. In such a case, it would make sense to tie that user to a specific DC/region until the update has propagated to all regions. Sticky routing would enable us to do this. References CDNs LinkedIn's TrafficShift blog talks about sticky routing","title":"Scaling Beyond the Data Center"},{"location":"level102/system_design/scaling-beyond-the-datacenter/#caching-static-assets","text":"Extending the existing caching solution a bit, we arrive at Content Delivery Networks(CDNs). CDNs are the caching layer that is closest to the user. A significant chunk of resources served in a webpage, may not be changing on an hourly or even a daily basis. In those cases, we would want to cache these at the CDN level, reducing our load. CDNs not only help reduce the load on our servers by removing the burden of serving static / bandwidth intensive resources, they also let us be present closer to our users, by way of points of presence(POPs). CDNs also let us do geo-load balancing, in case we have multiple data centres around the world, and would want to serve from the closest data center (DC) possible. Taking it a step further With the addition of caching and distributing our application into simpler services, we have solved the problem of scaling to 50000 users. However, our users may be geographically distributed locations and may not be at the same distance from our data centre or our cloud region. Consistency in user experience is important, else we are excluding users who are far away from our location, potentially eliminating a significant chunk of potential users. However, it is not impractical to have data centers all over the world, or even in more than a couple of locations in the world. This is where CDNs and POPs come into picture.","title":"Caching static assets"},{"location":"level102/system_design/scaling-beyond-the-datacenter/#points-of-presence","text":"CDN POPs are geographically distributed data centers aimed at being close to users. POPs reduce the round trip time by delivering content from a location that is nearest to the user. POPs typically may not have all the content, but have caching servers that cache the static assets, and fetch the rest of the content from the origin server where the application actually resides. Their main function is to reduce round trip time by bringing the content closer to the website\u2019s visitor. POPs can also route traffic to one of the multiple origin DCs possible. This way, POPs can be leveraged to add resiliency as well as load-balancing. Now, with our image sharing application becoming more popular by the day, let us assume that we have hit 100,000 concurrent users. And we have built another data center, predicting this increase in traffic. Now we need to be able to route the service to both of these data centers in a reliable manner, while also retaining the ability to fall back to a single data center in case there is an issue with one of the two DCs. This is where sticky routing comes into play.","title":"Points of Presence"},{"location":"level102/system_design/scaling-beyond-the-datacenter/#sticky-routing","text":"When an user sends a request, there are cases in which we might want to serve a specific user\u2019s requests from a DC if we have multiple DCs, or a specific server inside a DC. We may also wish to serve all requests from a specific POP by a single data center. Sticky routing helps us do exactly that. It might be simply pinning all users to a specific DC or pinning specific users to specific servers. This is typically done from the POP, so that as soon as the user enters reaches our servers, we can route them to the nearest DC possible.","title":"Sticky Routing"},{"location":"level102/system_design/scaling-beyond-the-datacenter/#geo-dns","text":"When a user opens the application, the user can be directed to one of the multiple globally distributed POPs. This can be done using GeoDNS , which simply put, gives out a different IP address(which are distributed geographically), depending on the location of the user making the DNS request. GeoDNS is the first step in distributing users to different locations - it is not 100% accurate, and typically makes use of IP address allotment information for guessing the location of the user. However, it works well enough for >90% of the users. After this, we can have a sticky routing service that assigns each user to a specific DC, which we can use to assign a DC to this user, and set a cookie. When the user next visits, the cookie can be read at the POP to decide which data center the user\u2019s traffic must be directed to. Having multiple DCs and leveraging sticky routing has not only scaling benefits, but also adds to the resiliency of the service, albeit at the cost of additional complexity. Let us consider another use case in which an user uploads a new profile picture for themselves. If we have multiple data centres or POPs which are not synced in real time - not all of them might have the newer picture. In such a case, it would make sense to tie that user to a specific DC/region until the update has propagated to all regions. Sticky routing would enable us to do this.","title":"Geo DNS"},{"location":"level102/system_design/scaling-beyond-the-datacenter/#references","text":"CDNs LinkedIn's TrafficShift blog talks about sticky routing","title":"References"},{"location":"level102/system_design/scaling/","text":"In the Phase 1 of this course, we had seen AKF scale cube and how it can help in segmenting services, defining microservices and scaling the overall application. We will use a similar strategy to scale our application - while using the estimates from the previous section, so that we can have a data driven design rather than arbitrarily choosing scaling patterns. Splitting the application Considering the huge volume of traffic that might be generated by our application, and the related resource requirements in terms of memory and CPU, let us split the application into smaller chunks. One of the simplest ways to do this would be to simply divide the application along the endpoints, and spin them up as separate instances. In reality, this decision would probably be a little more complicated, and you might end up having multiple endpoints running from the same instance. The images can be stored in an object store that can be scaled independently, rather than locating it on the servers where the application or the database resides. This would reduce the resource requirements for the servers. Stateful vs Stateless services A stateless process or service doesn\u2019t rely on stored data of it\u2019s past invocations. A stateful service on the other hand stores its state in a datastore, and typically uses the state on every call or transaction. In some cases, there are options for us to design services in such a way that certain components can be made stateless and this helps in multiple ways. Applications can be containerized easily if they are stateless. Containerized applications are also easier to scale. Stateful services require you to scale the datastore with the state as well. However, containerizing databases or scaling databases is out of the scope of this module. The resulting design after such distribution of workloads might look something like this. You might notice that the diagram also has multiple databases. We will see more about this in the following sharding section. Now that we have split the application into smaller services, we need to look at scaling up the capacity of each of these endpoints. The popular Pareto principle states that \u201c80% of consequences come from 20% of the causes\u201d. Modifying it slightly, we can say that 80% of the traffic will be for 20% of images. The no. of images uploaded vs the no. of images seen by the user is going to be similarly skewed. An user is much more likely to view images on a daily basis than they are to upload new ones. In our simple design, generating the feed page with initial 5 images will be a matter of choosing 5 recently uploaded images from fellow users whom this user follows. While we can dynamically fetch the images from the database and generate the page on the fly once the user logs on, we might soon overwhelm the database in case a large number of users choose to login at the same time and load their feeds. There are two things we can do here, one is caching, and the other one is ahead of time generation of user feeds. An user with a million followers can potentially lead to hundreds of thousands of calls to the DB, simply to fetch the latest photoID that the user has uploaded. This can quickly overwhelm any DB, and can potentially bring down the DB itself. Sharding One way to solve the problem of DB limitation is scaling up the DB write and reads. Sharding is one way to scale the DB writes, where the DB would be split into parts that reside in different instances of the DB running on separate machines. DB reads can be scaled up similarly by using read replicas as we had seen in Phase 1 of this module. Compared to the number of images the popular user uploads, the number of views generated would be massive. In that case, we should cache the photoIDs of the user\u2019s uploads, to be returned without having to perform a potentially expensive call to the DB. Let us consider another endpoint in our application named /get_user_details . It simply returns the page an user would see upon clicking another user\u2019s name. This endpoint will return a list of posts that the user has created. Normally, a call to that endpoint will involve the application talking to the DB, fetching a list of all the posts by the user and returning the result. If someone\u2019s profile is viewed thousands of times that means there are thousands of calls to the DB - which may result in issues like hot keys and hot partitions. As with all other systems, an increase in load may result in worsening response times, resulting in inconsistent and potentially bad user experience. A simple solution here would be a cache layer - one that would return the user\u2019s profile with posts without having to call the DB everytime. Caching A cache is used for the temporary storage of data that is likely to be accessed again, often repetitively. When the data requested is found in the cache, it is termed as a `cache hit\u2019. A \u2018cache miss\u2019 is the obvious complement. A well positioned cache can greatly reduce the query response time as well as improve the scalability of a system. Caches can be placed at multiple levels between the user and the application. In Phase 1, we saw how we could use caches / CDNs to service static resources of the application, resulting in quicker response times as well as lesser burden on the application servers. Let us look at more situations where caching can play a role. In-memory caching: In memory caching is when the information to be cached is kept in the main memory of the server, allowing it to be retrieved much faster than a DB residing on a disk. We cache arbitrary text (which can be HTML fragments or may be JSON objects) and fetch it back really fast. An in memory cache is the quickest way to add a layer of fast cache that can optionally be persisted to disk as well. While caching can aid significantly in scaling up and improving performance, there are situations where cache is suddenly not in place. It might be that the cache was accidentally wiped, leading to all the queries falling through to the DB layer, often multiple calls for the same piece of information. It is important to be aware of this potential \u2018thundering herd\u2019 problem and design your system accordingly. Caching proxies: There are cases where you may want to cache entire webpages / responses of other upstream resources that you need to respond to requests. There are also cases where you want to let your upstream tell you what to cache and how long to cache it for. In such cases, it might be a good idea to have a caching solution that understands Cache related HTTP headers. One example for our usecase can be when users search for a specific term in our application - if there is a frequent enough search for a user or a term, it might be more efficient to cache the responses for some duration rather than performing the search anew everytime. Let\u2019s recap one of the goals - Atleast 50000 unique visitors should be able to visit the site at any given time and view their feed. With the implementation of caching, we have removed one potential bottleneck - the DB. We also decomposed the monolith into smaller chunks that provide individual services. Another step closer to our goal is to simply horizontally scale the services needed for feed viewing and putting them behind a load balancer. Please recall the scaling concepts discussed in Phase 1 of this module. Cache managment While caching sounds like a simple, easy solution for a hard problem, an even harder problem is to manage the cache efficiently. Like most things in your system, the cache layer is not infinite. Effective cache management means removing things from the cache at the right time, to ensure the cache hit rate remains high. There are many strategies to invalidate cache after a certain time period or below certain usage thresholds. It is important to keep an eye on cache-hit rate and fine tune your caching strategy accordingly. References There are many object storage solutions available. Minio is one self hosted solution. There are also vendor-specific solutions for the cloud like Azure Blob storage and Amazon S3 . Microservices architecture style - Azure architecture guide There are many in-memory caching solutions. Some of the most popular ones include redis and memcached . Cloud vendors also have their managed cache solutions. Some of the most popular proxies include squid and Apache Traffic Server Thundering herd problem - how instagram tackled it .","title":"Scaling"},{"location":"level102/system_design/scaling/#splitting-the-application","text":"Considering the huge volume of traffic that might be generated by our application, and the related resource requirements in terms of memory and CPU, let us split the application into smaller chunks. One of the simplest ways to do this would be to simply divide the application along the endpoints, and spin them up as separate instances. In reality, this decision would probably be a little more complicated, and you might end up having multiple endpoints running from the same instance. The images can be stored in an object store that can be scaled independently, rather than locating it on the servers where the application or the database resides. This would reduce the resource requirements for the servers.","title":"Splitting the application"},{"location":"level102/system_design/scaling/#stateful-vs-stateless-services","text":"A stateless process or service doesn\u2019t rely on stored data of it\u2019s past invocations. A stateful service on the other hand stores its state in a datastore, and typically uses the state on every call or transaction. In some cases, there are options for us to design services in such a way that certain components can be made stateless and this helps in multiple ways. Applications can be containerized easily if they are stateless. Containerized applications are also easier to scale. Stateful services require you to scale the datastore with the state as well. However, containerizing databases or scaling databases is out of the scope of this module. The resulting design after such distribution of workloads might look something like this. You might notice that the diagram also has multiple databases. We will see more about this in the following sharding section. Now that we have split the application into smaller services, we need to look at scaling up the capacity of each of these endpoints. The popular Pareto principle states that \u201c80% of consequences come from 20% of the causes\u201d. Modifying it slightly, we can say that 80% of the traffic will be for 20% of images. The no. of images uploaded vs the no. of images seen by the user is going to be similarly skewed. An user is much more likely to view images on a daily basis than they are to upload new ones. In our simple design, generating the feed page with initial 5 images will be a matter of choosing 5 recently uploaded images from fellow users whom this user follows. While we can dynamically fetch the images from the database and generate the page on the fly once the user logs on, we might soon overwhelm the database in case a large number of users choose to login at the same time and load their feeds. There are two things we can do here, one is caching, and the other one is ahead of time generation of user feeds. An user with a million followers can potentially lead to hundreds of thousands of calls to the DB, simply to fetch the latest photoID that the user has uploaded. This can quickly overwhelm any DB, and can potentially bring down the DB itself.","title":"Stateful vs Stateless services"},{"location":"level102/system_design/scaling/#sharding","text":"One way to solve the problem of DB limitation is scaling up the DB write and reads. Sharding is one way to scale the DB writes, where the DB would be split into parts that reside in different instances of the DB running on separate machines. DB reads can be scaled up similarly by using read replicas as we had seen in Phase 1 of this module. Compared to the number of images the popular user uploads, the number of views generated would be massive. In that case, we should cache the photoIDs of the user\u2019s uploads, to be returned without having to perform a potentially expensive call to the DB. Let us consider another endpoint in our application named /get_user_details . It simply returns the page an user would see upon clicking another user\u2019s name. This endpoint will return a list of posts that the user has created. Normally, a call to that endpoint will involve the application talking to the DB, fetching a list of all the posts by the user and returning the result. If someone\u2019s profile is viewed thousands of times that means there are thousands of calls to the DB - which may result in issues like hot keys and hot partitions. As with all other systems, an increase in load may result in worsening response times, resulting in inconsistent and potentially bad user experience. A simple solution here would be a cache layer - one that would return the user\u2019s profile with posts without having to call the DB everytime.","title":"Sharding"},{"location":"level102/system_design/scaling/#caching","text":"A cache is used for the temporary storage of data that is likely to be accessed again, often repetitively. When the data requested is found in the cache, it is termed as a `cache hit\u2019. A \u2018cache miss\u2019 is the obvious complement. A well positioned cache can greatly reduce the query response time as well as improve the scalability of a system. Caches can be placed at multiple levels between the user and the application. In Phase 1, we saw how we could use caches / CDNs to service static resources of the application, resulting in quicker response times as well as lesser burden on the application servers. Let us look at more situations where caching can play a role.","title":"Caching"},{"location":"level102/system_design/scaling/#in-memory-caching","text":"In memory caching is when the information to be cached is kept in the main memory of the server, allowing it to be retrieved much faster than a DB residing on a disk. We cache arbitrary text (which can be HTML fragments or may be JSON objects) and fetch it back really fast. An in memory cache is the quickest way to add a layer of fast cache that can optionally be persisted to disk as well. While caching can aid significantly in scaling up and improving performance, there are situations where cache is suddenly not in place. It might be that the cache was accidentally wiped, leading to all the queries falling through to the DB layer, often multiple calls for the same piece of information. It is important to be aware of this potential \u2018thundering herd\u2019 problem and design your system accordingly. Caching proxies: There are cases where you may want to cache entire webpages / responses of other upstream resources that you need to respond to requests. There are also cases where you want to let your upstream tell you what to cache and how long to cache it for. In such cases, it might be a good idea to have a caching solution that understands Cache related HTTP headers. One example for our usecase can be when users search for a specific term in our application - if there is a frequent enough search for a user or a term, it might be more efficient to cache the responses for some duration rather than performing the search anew everytime. Let\u2019s recap one of the goals - Atleast 50000 unique visitors should be able to visit the site at any given time and view their feed. With the implementation of caching, we have removed one potential bottleneck - the DB. We also decomposed the monolith into smaller chunks that provide individual services. Another step closer to our goal is to simply horizontally scale the services needed for feed viewing and putting them behind a load balancer. Please recall the scaling concepts discussed in Phase 1 of this module.","title":"In-memory caching:"},{"location":"level102/system_design/scaling/#cache-managment","text":"While caching sounds like a simple, easy solution for a hard problem, an even harder problem is to manage the cache efficiently. Like most things in your system, the cache layer is not infinite. Effective cache management means removing things from the cache at the right time, to ensure the cache hit rate remains high. There are many strategies to invalidate cache after a certain time period or below certain usage thresholds. It is important to keep an eye on cache-hit rate and fine tune your caching strategy accordingly.","title":"Cache managment"},{"location":"level102/system_design/scaling/#references","text":"There are many object storage solutions available. Minio is one self hosted solution. There are also vendor-specific solutions for the cloud like Azure Blob storage and Amazon S3 . Microservices architecture style - Azure architecture guide There are many in-memory caching solutions. Some of the most popular ones include redis and memcached . Cloud vendors also have their managed cache solutions. Some of the most popular proxies include squid and Apache Traffic Server Thundering herd problem - how instagram tackled it .","title":"References"},{"location":"level102/system_troubleshooting_and_performance/conclusion/","text":"Complex systems have many factors which can go wrong. It can be a bad design & architecture, poorly managed code, poor policies around different caches, bad DB queries or architecture, improper use of resources, or bad OS version, poorly monitored system, datacenter issues, network faults, and many more, Any of these can go wrong. As an SRE, Knowing important tools/commands, best practices, profiling, benchmarking and scaling can help you with faster troubleshooting and performance improvement of the overall system. Further readings Here are some links from the LinkedIn Engineering Blog, as written by LinkedIn engineers, about firefighting they did, ensuring site up 24x7x365. Taming memory fragmentation in Venice with Jemalloc Intro: Every Day Is Monday in Operations Fixing Linux filesystem performance regressions The impact of slow NFS on data systems","title":"Conclusion"},{"location":"level102/system_troubleshooting_and_performance/conclusion/#further-readings","text":"Here are some links from the LinkedIn Engineering Blog, as written by LinkedIn engineers, about firefighting they did, ensuring site up 24x7x365. Taming memory fragmentation in Venice with Jemalloc Intro: Every Day Is Monday in Operations Fixing Linux filesystem performance regressions The impact of slow NFS on data systems","title":"Further readings"},{"location":"level102/system_troubleshooting_and_performance/important-tools/","text":"Important linux commands Having knowledge of following commands will help find issues faster. Elaborating each command in detail is out of scope, please look for man pages or online for more information and examples around the same. For logs parsing -: grep, sed, awk, cut, tail, head For network checks -: nc, netstat, traceroute/6, mtr, ping/6, route, tcpdump, ss, ip For DNS -: dig, host, nslookup For tracing system call -: strace For parallel executions over ssh -: gnu parallel, xargs + ssh. For http/s checks -: curl, wget For list of open files -: lsof For modifying attributes of the system kernel -: sysctl In case of distributed systems, some good third party tools can help to execute commands/instructions on many hosts at once, like: SSH based tools ClusterSSH : Cluster ssh can help you run a command in parallel on many hosts at once. Ansible : It allows you to write ansible playbooks which you can run on hundreds/thousands of hosts at the same time. Agent Based tools Saltstack : Is a configuration, state and remote execution framework, provides a wide variety of flexibility to users to execute modules on large numbers of hosts at once. Puppet : Is an automated administrative engine for your Linux, Unix, and Windows systems, performs administrative tasks. Log analysis tools These can help in writing SQL type queries for parsing, analysing logs and provide an easy UI interface to create dashboards which can render various types of charts based on defined queries. ELK : Elasticsearch, Logstash and Kibana, provide package of tools and services to allow, parse logs, index logs and analyse logs easily and quickly. Once logs/data is parsed/filtered through logstash and indexed in elasticsearch, one can create dynamic dashboards in Kibana in a matter of minutes. Such provides easy analysis and correlation on application errors/exceptions/warnings. Azure kusto : Azure kusto is a cloud based service similar to Elasticsearch and Kibana, it allows easy indexing of heavy logs, provides SQL type interface for writing queries, and an interface to create dynamic dashboards.","title":"Important Tools"},{"location":"level102/system_troubleshooting_and_performance/important-tools/#important-linux-commands","text":"Having knowledge of following commands will help find issues faster. Elaborating each command in detail is out of scope, please look for man pages or online for more information and examples around the same. For logs parsing -: grep, sed, awk, cut, tail, head For network checks -: nc, netstat, traceroute/6, mtr, ping/6, route, tcpdump, ss, ip For DNS -: dig, host, nslookup For tracing system call -: strace For parallel executions over ssh -: gnu parallel, xargs + ssh. For http/s checks -: curl, wget For list of open files -: lsof For modifying attributes of the system kernel -: sysctl In case of distributed systems, some good third party tools can help to execute commands/instructions on many hosts at once, like: SSH based tools ClusterSSH : Cluster ssh can help you run a command in parallel on many hosts at once. Ansible : It allows you to write ansible playbooks which you can run on hundreds/thousands of hosts at the same time. Agent Based tools Saltstack : Is a configuration, state and remote execution framework, provides a wide variety of flexibility to users to execute modules on large numbers of hosts at once. Puppet : Is an automated administrative engine for your Linux, Unix, and Windows systems, performs administrative tasks.","title":"Important linux commands"},{"location":"level102/system_troubleshooting_and_performance/important-tools/#log-analysis-tools","text":"These can help in writing SQL type queries for parsing, analysing logs and provide an easy UI interface to create dashboards which can render various types of charts based on defined queries. ELK : Elasticsearch, Logstash and Kibana, provide package of tools and services to allow, parse logs, index logs and analyse logs easily and quickly. Once logs/data is parsed/filtered through logstash and indexed in elasticsearch, one can create dynamic dashboards in Kibana in a matter of minutes. Such provides easy analysis and correlation on application errors/exceptions/warnings. Azure kusto : Azure kusto is a cloud based service similar to Elasticsearch and Kibana, it allows easy indexing of heavy logs, provides SQL type interface for writing queries, and an interface to create dynamic dashboards.","title":"Log analysis tools"},{"location":"level102/system_troubleshooting_and_performance/introduction/","text":"System troubleshooting and performance improvements Prerequisites Linux Basics System design Basic Networking Metrics and Monitoring What to expect from this course This brief course tries to provide a general introduction on how to troubleshoot system issues, like analysing api failures, resource utilization, network issues, hardware and OS issues. Course also briefs on profiling and benchmarking to measure overall system performance. What is not covered under this course This course does not cover following -: System Design and Architecture. Programming practices. Metrics and Monitoring. OS basics. Course Contents Introduction Troubleshooting Troubleshooting Flowchart General Practices General Host issues Important tools to know Important linux commands Log analysis tools Performance improvements Performance analysis commands Profiling tools Benchmarking Scaling Troubleshooting Example Conclusion Further readings Introduction Troubleshooting is an important part of operations & development. It can\u2019t be learned by just reading one article or completing a course online, Its a continuous learning process, one learns it during :- Daily operations and development. Finding & Fixing application bugs. Finding & Fixing system & network issues. Performance analysis and improvements. And more. From an SRE\u2019s perspective, It is expected that they are aware of certain topics upfront to be able to troubleshoot problems around single or distributed systems. Know your resources well, understand host specifications, liks CPU, Memory, Network, Disk etc. Understand system design and architecture. Ensure important metrics are being collected/rendered properly. There was a famous quote by HP founders - \u201cWhat gets measured gets fixed\u201d If system components and performance metrics are captured thoroughly then there is a high chance of success in troubleshooting an issue, at its earliest. Scope There is no common approach to troubleshoot different types of applications or services, the failure can occur at any layer of it. We will keep the scope of this work to a web api service type only. Note -: Linux ecosystem is wide, there are hundreds of tools and utilities which can help with system troubleshooting, each comes with its own set of benefits and functionalities. We will cover some of the known tools, either already available with Linux or are available in the open source world. Detailed explanation of mentioned tools in this doc is out of scope, please explore the internet or man pages for more examples and documentation around the same.","title":"Introduction"},{"location":"level102/system_troubleshooting_and_performance/introduction/#system-troubleshooting-and-performance-improvements","text":"","title":"System troubleshooting and performance improvements"},{"location":"level102/system_troubleshooting_and_performance/introduction/#prerequisites","text":"Linux Basics System design Basic Networking Metrics and Monitoring","title":"Prerequisites"},{"location":"level102/system_troubleshooting_and_performance/introduction/#what-to-expect-from-this-course","text":"This brief course tries to provide a general introduction on how to troubleshoot system issues, like analysing api failures, resource utilization, network issues, hardware and OS issues. Course also briefs on profiling and benchmarking to measure overall system performance.","title":"What to expect from this course"},{"location":"level102/system_troubleshooting_and_performance/introduction/#what-is-not-covered-under-this-course","text":"This course does not cover following -: System Design and Architecture. Programming practices. Metrics and Monitoring. OS basics.","title":"What is not covered under this course"},{"location":"level102/system_troubleshooting_and_performance/introduction/#course-contents","text":"Introduction Troubleshooting Troubleshooting Flowchart General Practices General Host issues Important tools to know Important linux commands Log analysis tools Performance improvements Performance analysis commands Profiling tools Benchmarking Scaling Troubleshooting Example Conclusion Further readings","title":"Course Contents"},{"location":"level102/system_troubleshooting_and_performance/introduction/#introduction","text":"Troubleshooting is an important part of operations & development. It can\u2019t be learned by just reading one article or completing a course online, Its a continuous learning process, one learns it during :- Daily operations and development. Finding & Fixing application bugs. Finding & Fixing system & network issues. Performance analysis and improvements. And more. From an SRE\u2019s perspective, It is expected that they are aware of certain topics upfront to be able to troubleshoot problems around single or distributed systems. Know your resources well, understand host specifications, liks CPU, Memory, Network, Disk etc. Understand system design and architecture. Ensure important metrics are being collected/rendered properly. There was a famous quote by HP founders - \u201cWhat gets measured gets fixed\u201d If system components and performance metrics are captured thoroughly then there is a high chance of success in troubleshooting an issue, at its earliest.","title":"Introduction"},{"location":"level102/system_troubleshooting_and_performance/introduction/#scope","text":"There is no common approach to troubleshoot different types of applications or services, the failure can occur at any layer of it. We will keep the scope of this work to a web api service type only. Note -: Linux ecosystem is wide, there are hundreds of tools and utilities which can help with system troubleshooting, each comes with its own set of benefits and functionalities. We will cover some of the known tools, either already available with Linux or are available in the open source world. Detailed explanation of mentioned tools in this doc is out of scope, please explore the internet or man pages for more examples and documentation around the same.","title":"Scope"},{"location":"level102/system_troubleshooting_and_performance/performance-improvements/","text":"Performance tools are an important part of development/operations lifecycle, Its highly important for understanding application behavior. SRE generally uses such tools to evaluate how well service will perform and make/suggest improvements accordingly. Performance analysis commands Most of these commands are a must to know for doing performance analysis of a system or service. top -: shows real-time view of running system, processes, threads etc. htop -: Similar to top command, but a bit more interactive then it. iotop -: An interactive disk I/O monitoring tool. vmstat -: Virtual memory statistics explorer. iostat -: Monitoring tool for input/output statistics for devices and partitions. free -: Tell info about physical memory and swap memory. sar -: System activity report, reports diff metrics such as cpu, disk, mem, network, etc. mpstat -: Display info about CPU utilization and performance. lsof -: Provides info about the list of open files, opened by which processes. perf -: Performance analysing tool. Profiling tools Profiling is an important part of performance analysis of the service. There are various profiler tools available, which can help figure most frequent code-paths, debugging, memory profiling, etc. These can generate the heatmap to understand the code performance when under load. FlameGraph : Flame graphs are a visualization of profiled software, allowing the most frequent code-paths to be identified quickly and accurately. Valgrind : It is a programming tool for memory debugging, memory leak detection, and profiling. Gprof : GNU profiler tool uses a hybrid of instrumentation and sampling. Instrumentation is used to collect function call information, and sampling is used to gather runtime profiling information. To know how LinkedIn performs On-Demand Profiling on its services, Read LinkedIn blog ODP: An Infrastructure for On-Demand Service Profiling Benchmarking It is a process of measuring the best performance of the service. Like how much QPS service can handle, its latency when load is increasing, host resource utilization, loadavg etc etc. The regression testing (i.e load testing) is a must before deploying the service to production. Some of known tools -: Apache Benchmark Tool, ab :, It simulate a high load on webapp and gather data for analysis Httperf : It sends requests to the web server at a specified rate and gathers stats. Increase till one finds the saturation point. Apache JMeter : It is a popular open-source tool to measure web application performance. JMeter is a java based application and not only a web server, but you can use it against PHP, Java, REST, etc. Wrk : It is another modern performance measurement tool to put a load on your web server and give you latency, request per second, transfer per second, etc. details. Locust : Easy to use, scriptable and scalable performance testing tool. Limitation -: Above tools help in synthetic load or stress testing, but such does not measure actual end user experience, It can\u2019t see how end user resources will affect application performance, it is due to lack of memory, CPU, or poor connectivity to the internet. To know how LinkedIn performs load testing across its fleet. Read : Eliminating toil with fully automated load testing And to know how LinkedIn makes use of Real Time Monitoring (RUM) data to overcome the limitations of load testing, and help improve overall experience for end users. Read : Monitor and Improve Web Performance Using RUM Data Visualization Scaling System designed optimally can perform up to a certain limit only, based on availability of resources. Continuous optimization is always needed to ensure optimum use of resources at its peak. With increasing QPS, Systems need to scale up. We can either scale vertically or horizontally. Vertical scalability has its limits as one can increase cpu, memory, disk, GPU and other specifications to certain limit only, whereas horizontal scalability can grow easily and infinitely given limitations imposed by application design and environment attributes. Scaling a web application will require some or all of the following -: Ease the server load by adding more hosts. Distributing the traffic across servers by using Load Balancers. Scale up DB by sharding the data and increasing read replicas. Here\u2019s a good read how LinkedIn scaled its application stack A Brief History of Scaling LinkedIn","title":"Performance Improvements"},{"location":"level102/system_troubleshooting_and_performance/performance-improvements/#performance-analysis-commands","text":"Most of these commands are a must to know for doing performance analysis of a system or service. top -: shows real-time view of running system, processes, threads etc. htop -: Similar to top command, but a bit more interactive then it. iotop -: An interactive disk I/O monitoring tool. vmstat -: Virtual memory statistics explorer. iostat -: Monitoring tool for input/output statistics for devices and partitions. free -: Tell info about physical memory and swap memory. sar -: System activity report, reports diff metrics such as cpu, disk, mem, network, etc. mpstat -: Display info about CPU utilization and performance. lsof -: Provides info about the list of open files, opened by which processes. perf -: Performance analysing tool.","title":"Performance analysis commands"},{"location":"level102/system_troubleshooting_and_performance/performance-improvements/#profiling-tools","text":"Profiling is an important part of performance analysis of the service. There are various profiler tools available, which can help figure most frequent code-paths, debugging, memory profiling, etc. These can generate the heatmap to understand the code performance when under load. FlameGraph : Flame graphs are a visualization of profiled software, allowing the most frequent code-paths to be identified quickly and accurately. Valgrind : It is a programming tool for memory debugging, memory leak detection, and profiling. Gprof : GNU profiler tool uses a hybrid of instrumentation and sampling. Instrumentation is used to collect function call information, and sampling is used to gather runtime profiling information. To know how LinkedIn performs On-Demand Profiling on its services, Read LinkedIn blog ODP: An Infrastructure for On-Demand Service Profiling","title":"Profiling tools"},{"location":"level102/system_troubleshooting_and_performance/performance-improvements/#benchmarking","text":"It is a process of measuring the best performance of the service. Like how much QPS service can handle, its latency when load is increasing, host resource utilization, loadavg etc etc. The regression testing (i.e load testing) is a must before deploying the service to production. Some of known tools -: Apache Benchmark Tool, ab :, It simulate a high load on webapp and gather data for analysis Httperf : It sends requests to the web server at a specified rate and gathers stats. Increase till one finds the saturation point. Apache JMeter : It is a popular open-source tool to measure web application performance. JMeter is a java based application and not only a web server, but you can use it against PHP, Java, REST, etc. Wrk : It is another modern performance measurement tool to put a load on your web server and give you latency, request per second, transfer per second, etc. details. Locust : Easy to use, scriptable and scalable performance testing tool. Limitation -: Above tools help in synthetic load or stress testing, but such does not measure actual end user experience, It can\u2019t see how end user resources will affect application performance, it is due to lack of memory, CPU, or poor connectivity to the internet. To know how LinkedIn performs load testing across its fleet. Read : Eliminating toil with fully automated load testing And to know how LinkedIn makes use of Real Time Monitoring (RUM) data to overcome the limitations of load testing, and help improve overall experience for end users. Read : Monitor and Improve Web Performance Using RUM Data Visualization","title":"Benchmarking"},{"location":"level102/system_troubleshooting_and_performance/performance-improvements/#scaling","text":"System designed optimally can perform up to a certain limit only, based on availability of resources. Continuous optimization is always needed to ensure optimum use of resources at its peak. With increasing QPS, Systems need to scale up. We can either scale vertically or horizontally. Vertical scalability has its limits as one can increase cpu, memory, disk, GPU and other specifications to certain limit only, whereas horizontal scalability can grow easily and infinitely given limitations imposed by application design and environment attributes. Scaling a web application will require some or all of the following -: Ease the server load by adding more hosts. Distributing the traffic across servers by using Load Balancers. Scale up DB by sharding the data and increasing read replicas. Here\u2019s a good read how LinkedIn scaled its application stack A Brief History of Scaling LinkedIn","title":"Scaling"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting-example/","text":"In this section we will see an example of an issue and try to troubleshoot it, and at the end a few famous troubleshooting stories are shared, which were shared by LinkedIn engineers earlier. Example - Memory leak : Often memory leak issues go unnoticed until the service becomes unresponsive after running for some time (days, week or even month) until service is restarted or bug is fixed, In such cases, service memory usage will reflect in increasing order in the metric graph, something like this graph. Memory leak is mismanagement of memory allocations by application, where unneeded memory is not released, over the period of time objects continue to pile up in memory resulting in service crash. Generally such non-released objects get sorted by garbage collector automatically, but sometimes due to a bug it fails. Debugging helps in figuring where much of the application storage memory is being applied. Then, you start tracking and filter everything based on usage. In case, you find objects that aren\u2019t in use, but are referenced, you can get rid of them by deleting them to avoid memory leaks. In the case of python applications, it comes with inbuilt features like tracemalloc . This module can help pinpoint where an object was allocated first. Almost every language comes with a set of tools/libraries (inbuilt or external) which helps find memory issues. Similarly for Java there is a famous memory leak detection tool called Java VisualVM . Let\u2019s see how a dummy flask based web app with a memory leak bug, with every request its memory usage keeps increasing, and how we can use tracemalloc to capture the leak. Assumption -: A python virtual environment is created, and flask is installed in it. A bare minimum flask code with bug, read comments for more info Starting flask app On start, Its memory usage is around 26576 kb, i.e approx 26MB Now with every subsequent GET request, We can notice that process memory usage continues to increase slowly. Now lets try 10000 requests, to see if memory usage increases heavily. To hit a high number of requests, we use an Apache benchmarking tool called \u201cab\u201d . After 10000 hits, we can notice memory usage of flask app is jumped almost 15 times, i.e from initial 26576 KB to 419316 KB, i.e from roughly 26 MB to 419 MB , That\u2019s a huge jump for such a small webapp. Lets try the python tracemalloc module to try to understand the application memory allocations. Tracemalloc takes memory snapshots at a particular point, performing various statistics on the same. Adding a bare minimum code to our app.py file, no change in fetchuserdata.py file, it will allow us to capture tracemalloc snapshots whenever we will hit /capture uri. After restart of app.py (flask run) , we will - First hit http://127.0.0.1:5000/capture - Then hit http://127.0.0.1:5000/ 10000 times, for memory leak/s to take place. - Finally hit http://127.0.0.1:5000/capture again to take a snapshot to know which line has the most allocation. In the final snapshot, we noticed the exact module and lineno where most allocation happened. I.e fetchuserdata.py, line no 6, after 10000 hits, it is holding 419 MB of memory. Summary Above example shows how a bug can lead to memory leak, and how we can use tracemalloc to understand where it is. In real world applications are way more complex than the above dummy example, you must understand that using tracemalloc might degrade application performance somebit, due to tracemalloc own overheads. Be mindful about its use in production environments. If you are interested in digging deeper into Python Object Memory Allocation Internals and debugging memory leak, have a look at an Interesting talk by Sanket Patel in PyCon India 2019, Debug Memory Leak In Python Flask | Python Object Memory Allocation Internals","title":"Troubleshooting Example"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting-example/#example-memory-leak","text":"Often memory leak issues go unnoticed until the service becomes unresponsive after running for some time (days, week or even month) until service is restarted or bug is fixed, In such cases, service memory usage will reflect in increasing order in the metric graph, something like this graph. Memory leak is mismanagement of memory allocations by application, where unneeded memory is not released, over the period of time objects continue to pile up in memory resulting in service crash. Generally such non-released objects get sorted by garbage collector automatically, but sometimes due to a bug it fails. Debugging helps in figuring where much of the application storage memory is being applied. Then, you start tracking and filter everything based on usage. In case, you find objects that aren\u2019t in use, but are referenced, you can get rid of them by deleting them to avoid memory leaks. In the case of python applications, it comes with inbuilt features like tracemalloc . This module can help pinpoint where an object was allocated first. Almost every language comes with a set of tools/libraries (inbuilt or external) which helps find memory issues. Similarly for Java there is a famous memory leak detection tool called Java VisualVM . Let\u2019s see how a dummy flask based web app with a memory leak bug, with every request its memory usage keeps increasing, and how we can use tracemalloc to capture the leak. Assumption -: A python virtual environment is created, and flask is installed in it. A bare minimum flask code with bug, read comments for more info Starting flask app On start, Its memory usage is around 26576 kb, i.e approx 26MB Now with every subsequent GET request, We can notice that process memory usage continues to increase slowly. Now lets try 10000 requests, to see if memory usage increases heavily. To hit a high number of requests, we use an Apache benchmarking tool called \u201cab\u201d . After 10000 hits, we can notice memory usage of flask app is jumped almost 15 times, i.e from initial 26576 KB to 419316 KB, i.e from roughly 26 MB to 419 MB , That\u2019s a huge jump for such a small webapp. Lets try the python tracemalloc module to try to understand the application memory allocations. Tracemalloc takes memory snapshots at a particular point, performing various statistics on the same. Adding a bare minimum code to our app.py file, no change in fetchuserdata.py file, it will allow us to capture tracemalloc snapshots whenever we will hit /capture uri. After restart of app.py (flask run) , we will - First hit http://127.0.0.1:5000/capture - Then hit http://127.0.0.1:5000/ 10000 times, for memory leak/s to take place. - Finally hit http://127.0.0.1:5000/capture again to take a snapshot to know which line has the most allocation. In the final snapshot, we noticed the exact module and lineno where most allocation happened. I.e fetchuserdata.py, line no 6, after 10000 hits, it is holding 419 MB of memory. Summary Above example shows how a bug can lead to memory leak, and how we can use tracemalloc to understand where it is. In real world applications are way more complex than the above dummy example, you must understand that using tracemalloc might degrade application performance somebit, due to tracemalloc own overheads. Be mindful about its use in production environments. If you are interested in digging deeper into Python Object Memory Allocation Internals and debugging memory leak, have a look at an Interesting talk by Sanket Patel in PyCon India 2019, Debug Memory Leak In Python Flask | Python Object Memory Allocation Internals","title":"Example - Memory leak :"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting/","text":"Troubleshooting system failures can be tricky or tedious at times. In this practice we need to examine the end-to-end flow of a service, all its downstreams, analysing logs, memory leak, CPU usage, disk IO, network failures, hosts issues, etc. Knowing certain practices and tools can help figure & mitigate failures faster. Here\u2019s the high level troubleshooting flowchart -: Troubleshooting Flowchart General Practices Different systems require different approaches for finding issues. Scope of this is limited and given a problem, there can be many more points which can be looked into. Following points will look at some high level practices towards finding webapp failures and finding fixes for the same. Reproduce problem Try the broken request to reproduce the issue, Like try Hit http/s request which fails. Check the end to end flow of request and look for return codes, mostly 3xx, 4xx or 5xx . 3xx are mostly about redirections, 4xx are about unauthorized, bad request, forbidden, etc, And 5xx is mostly about server side issues. Based on the return code you can look for the next step. Client side issues are mainly about missing or buggy static contents, like javascript issues, bad image, broken json from an async call etc, such can result in incorrect page rendering on browsers. Gather Information Look for errors/exceptions in application logs, Like \"Can\u2019t Allocate Memory\" or OutOfMemoryError, Or Something like \"disk I/O error\", Or a DNS resolution error. Check application and host metrics, Look for anomalies in service and hosts graphs. Since when CPU usage has increased, since when memory usage increased, since when disk space is reduced Or Disk I/O is increased, when load average start shooting up etc. Please read the School of SRE link for more detail around metrics and monitoring . Look for recent code or config changes which possibly are breaking the system. Understand the problem Try correlating gathered data with recent actions, like an exception showing up in logs after config/code deployment. Is it due to the QPS increase? Is it bad SQL queries? Do recent code changes demand better or more hardware? Find a solution and apply a fix Based on the above findings, look for a quick fix if possible, For example like rolling back changes if errors/exceptions correlate. Try patching or hotfixing the code, probably in staging setup if you want to fix forward. Try to scale up the system, if high QPS is the reason for system failure, then try adding resources (compute, storage, memory, etc) as necessary. Optimize SQL queries if needed. Verify complete request flow Hit requests again and ensure returns are successful (return code 2xx). Check Logs ensure no more exceptions/errors, as found earlier. Ensure metrics are back to normal. General Host issues To Know if host health is fine or not, look for any hardware failures or its performance issues, one can try following -: Dmesg -: Shows recent errors / failures thrown by kernel. This help with knowing hardware failures if any ls commands -: lspci, lsblk, lscpu, lsscsi, These commands list out pci, disk, cpu information. /var/log/messages -: Shows system app/service related errors/warnings, also shows kernel issues. Smartd -: check disk health.","title":"Troubleshooting"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting/#troubleshooting-flowchart","text":"","title":"Troubleshooting Flowchart"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting/#general-practices","text":"Different systems require different approaches for finding issues. Scope of this is limited and given a problem, there can be many more points which can be looked into. Following points will look at some high level practices towards finding webapp failures and finding fixes for the same. Reproduce problem Try the broken request to reproduce the issue, Like try Hit http/s request which fails. Check the end to end flow of request and look for return codes, mostly 3xx, 4xx or 5xx . 3xx are mostly about redirections, 4xx are about unauthorized, bad request, forbidden, etc, And 5xx is mostly about server side issues. Based on the return code you can look for the next step. Client side issues are mainly about missing or buggy static contents, like javascript issues, bad image, broken json from an async call etc, such can result in incorrect page rendering on browsers. Gather Information Look for errors/exceptions in application logs, Like \"Can\u2019t Allocate Memory\" or OutOfMemoryError, Or Something like \"disk I/O error\", Or a DNS resolution error. Check application and host metrics, Look for anomalies in service and hosts graphs. Since when CPU usage has increased, since when memory usage increased, since when disk space is reduced Or Disk I/O is increased, when load average start shooting up etc. Please read the School of SRE link for more detail around metrics and monitoring . Look for recent code or config changes which possibly are breaking the system. Understand the problem Try correlating gathered data with recent actions, like an exception showing up in logs after config/code deployment. Is it due to the QPS increase? Is it bad SQL queries? Do recent code changes demand better or more hardware? Find a solution and apply a fix Based on the above findings, look for a quick fix if possible, For example like rolling back changes if errors/exceptions correlate. Try patching or hotfixing the code, probably in staging setup if you want to fix forward. Try to scale up the system, if high QPS is the reason for system failure, then try adding resources (compute, storage, memory, etc) as necessary. Optimize SQL queries if needed. Verify complete request flow Hit requests again and ensure returns are successful (return code 2xx). Check Logs ensure no more exceptions/errors, as found earlier. Ensure metrics are back to normal.","title":"General Practices"},{"location":"level102/system_troubleshooting_and_performance/troubleshooting/#general-host-issues","text":"To Know if host health is fine or not, look for any hardware failures or its performance issues, one can try following -: Dmesg -: Shows recent errors / failures thrown by kernel. This help with knowing hardware failures if any ls commands -: lspci, lsblk, lscpu, lsscsi, These commands list out pci, disk, cpu information. /var/log/messages -: Shows system app/service related errors/warnings, also shows kernel issues. Smartd -: check disk health.","title":"General Host issues"}]} \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index 5af9880..ea4e48f 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -355,6 +355,34 @@ https://linkedin.github.io/school-of-sre/level102/system_troubleshooting_and_performance/conclusion/ 2021-08-13 daily + + https://linkedin.github.io/school-of-sre/level102/continuous_integration_and_continuous_delivery/introduction/ + 2021-08-13 + daily + + https://linkedin.github.io/school-of-sre/level102/continuous_integration_and_continuous_delivery/introduction_to_cicd/ + 2021-08-13 + daily + + https://linkedin.github.io/school-of-sre/level102/continuous_integration_and_continuous_delivery/cicd_brief_history/ + 2021-08-13 + daily + + https://linkedin.github.io/school-of-sre/level102/continuous_integration_and_continuous_delivery/continuous_integration_build_pipeline/ + 2021-08-13 + daily + + https://linkedin.github.io/school-of-sre/level102/continuous_integration_and_continuous_delivery/continuous_delivery_release_pipeline/ + 2021-08-13 + daily + + https://linkedin.github.io/school-of-sre/level102/continuous_integration_and_continuous_delivery/jenkins_cicd_pipeline_hands_on_lab/ + 2021-08-13 + daily + + https://linkedin.github.io/school-of-sre/level102/continuous_integration_and_continuous_delivery/conclusion/ + 2021-08-13 + daily https://linkedin.github.io/school-of-sre/CONTRIBUTING/ 2021-08-13 diff --git a/sitemap.xml.gz b/sitemap.xml.gz index ef9313ba8e3002e04278f7a1f6187faa7d772ee0..24fc8161fab035e7807604d155cec270686f014d 100644 GIT binary patch literal 1168 zcmV;B1aJEviwFq*Nfu!O|8r?{Wo=<_E_iKh0NtBkZ`(Eyz~A#J0>9HvvX^dfTwv`w z^rZ!cEa)(R=K!`Oij;px9glZMX8!)U_17Cn=wi5^ z+)i&M*AQ&1U0B^u9v?obca!&vt9hS10$p?EfcKMzsQYC$+itg0bOf#Ga2nHUhPL4g zob3x|H`AXdi`;f`b)Em_KH5cYjNID0um=8}>B>>lS5p^r`xw27ON9w$^I5KbXlanz zSTF8w?rzo1J9YaL-`Ha(Hgcpqh~ZAqd1p(H=g*lDJXq3Cy`+vF zX>|u_8B@#QGl(JgrV?e81oM5JEl zBPeX5?+c$qjAz(ouf2{I)cKO!+yF*xj@kFqF%H3PM_i_MT_MtW{1Tsb2#3S#1sYM?P z1Ta&>!56Vc6B)bC?!Xd4**4_JzU6Noe!Kn#4uETrfGxmU-0c?+*;GJkxrHH+;by%` z-mz+%6=?Re_>e7%EPmv9X5`P;vd~Skjoai=y35B4RQZi-Wl>iK8??!FRI(HPD!K^U z$dF_>T1)P)ahYax2V=_n?+zO=%l5I}E&>On`dAlb3-pgFTYjjnqg_LiE!o-CPONob zL1Kp#IQW-B!_Y^#vwkz8Ge4}7u5{oYMvBxnhx=P=&A}66lvQ&{GSQHtMPz9i@yQz`B8&eNB{t{?nwmz literal 1071 zcmV+~1kn2*iwFoj2Nq!h|8r?{Wo=<_E_iKh0Nt8RZ`(K!hVS_mf$#K3_R?KAF3@(n z=%ob~$yuPNkwusy70$?x_Sf%Fatzx|vB3fbI1La>qDc7}diZjN)cXB%>u&cD(FT7% zTg{iVTks}S)^G1;j}M>KyV?8A&AN{cfo{37$NO1B)cvto91e#$T7p)0I1h2VK-2IA zE{=tZ<^1>ACbiw%+@`;^3ucoVBe!y*Miw>#P@v<$nV?*n?XwSE*+IT$CEE z!G-k{gA`a3+E)9j;6ivQ6M{ZnAVl`oLRYQz7Ab0C$CcCj-nbs~Cguw1UuEwd3ABvb zv*=*{{mGRS-{0kqD#AynQRRUSA?|pp5+cH9z?DZyxP8@0!cC8m#7jmLuI-{EToIDi z4b%i*9H7iz%+64!Q8nkq>dhG ziwh#_~n6eY@nW<4Kd&3hB?4u(S1>^EW8eWV5=YqU-a?HQAoc3UL+>^ zT!D+2rdyzB4HjwVt_|K&h^IyGsy8H({y8jFOJZ%>u zX`fz<2oi$w|1#+8T(NO6?8ilA{N;R4!Lx3=ti#VY8kV!%ef;+I;qNaW9v{AZ{VPYh pPk$EQJ{L^+>G9)3et5D8v002Js6QBS9 diff --git a/sre_community/index.html b/sre_community/index.html index e2864f6..bc07243 100644 --- a/sre_community/index.html +++ b/sre_community/index.html @@ -1846,6 +1846,118 @@ + + + + + +

  • + + + + + + +
    • + + +