Difference between revisions of "HZW Documentation"

From hzw wiki
Jump to navigation Jump to search
m
m
Line 98: Line 98:
 
[[File:Partitions.png|frameless]]
 
[[File:Partitions.png|frameless]]
  
==== Network ====
+
====Network====
 
<blockquote>The interfaceconfig of the server is written in netplan.
 
<blockquote>The interfaceconfig of the server is written in netplan.
  
/etc/netplan/01-netcfg.yaml <!-- # This file describes the network interfaces available on your system
+
/etc/netplan/01-netcfg.yaml  
# For more information, see netplan(5).
 
network:
 
    version: 2
 
    renderer: networkd
 
    ethernets:
 
        eth0:
 
            dhcp4: no
 
            dhcp6: no
 
            addresses:
 
            - 85.214.44.226/32
 
            - 85.214.67.116/32
 
            - 2a01:238:43b2:8400:5b42:ab65:a28d:873d/128
 
            - 2a01:238:43b2:8400::1/128
 
            - 2a01:238:43b2:8400::2/128
 
            - 2a01:238:43b2:8400::3/128
 
            - 2a01:238:43b2:8400::4/128
 
            - 2a01:238:43b2:8400::5/128
 
            - 2a01:238:43b2:8400::6/128
 
            - 2a01:238:43b2:8400::7/128
 
            - 2a01:238:43b2:8400::8/128
 
            - 2a01:238:43b2:8400::9/128
 
            - 2a01:238:43b2:8400::10/128
 
            - 2a01:238:43b2:8400::bee:9ee5:0001/128
 
            - 2a01:238:43b2:8400::/56
 
            gateway4: 85.214.44.1
 
            gateway6: fe80::1
 
            nameservers:
 
            addresses: [8.8.8.8,8.8.4.4]
 
            routes:
 
            - to: 0.0.0.0/0
 
              via: 85.214.44. -->
 
  
 
+
</blockquote>Virtual Machines - Do's and dont's for VMs running at HZW
 
 
# This file describes the network interfaces available on your system
 
 
 
# For more information, see netplan(5).
 
 
 
network:
 
 
 
   version: 2
 
 
 
   renderer: networkd
 
 
 
   ethernets:
 
 
 
       eth0:
 
 
 
           dhcp4: no
 
 
 
           dhcp6: no
 
 
 
           addresses:
 
 
 
            - 85.214.44.226/32
 
 
 
            - 85.214.67.116/32
 
 
 
            - 2a01:238:43b2:8400:5b42:ab65:a28d:873d/128
 
 
 
            - 2a01:238:43b2:8400::1/128
 
 
 
            - 2a01:238:43b2:8400::2/128
 
 
 
            - 2a01:238:43b2:8400::3/128
 
 
 
            - 2a01:238:43b2:8400::4/128
 
 
 
            - 2a01:238:43b2:8400::5/128
 
 
 
            - 2a01:238:43b2:8400::6/128
 
 
 
            - 2a01:238:43b2:8400::7/128
 
 
 
            - 2a01:238:43b2:8400::8/128
 
 
 
            - 2a01:238:43b2:8400::9/128
 
 
 
            - 2a01:238:43b2:8400::10/128
 
 
 
            - 2a01:238:43b2:8400::bee:9ee5:0001/128
 
 
 
            - 2a01:238:43b2:8400::/56
 
 
 
           gateway4: 85.214.44.1
 
 
 
           gateway6: fe80::1
 
 
 
           nameservers:
 
 
 
            addresses: [8.8.8.8,8.8.4.4]
 
 
 
           routes:
 
 
 
           - to: 0.0.0.0/0
 
 
 
             via: 85.214.44.
 
<br /></blockquote>Virtual Machines - Do's and dont's for VMs running at HZW
 
 
<br />
 
<br />
  

Revision as of 15:14, 14 May 2020

Documentation. Lots of documentation.

The documentation of all things HZW has the following philosophy:

  1. General information, processes, methods and how-to's get documented in this Wiki
  2. Physical and Logical Resources like Servers, IPs, Networks, Services, VLANs etc. get documented in Netbox
  3. Projects and changes get tracked using Kanboard


Organizational Documentation

Chat

Our primary tool for communication and coordination is matrix.

To join our matrix server matrix.kabelsalat.it you need a matrix client like riot.

On this Matrix server, there is the "hzw admins" channel.


Plase report there and ask if it's ok If you make changes that have an impact.

Example:

"Hey guys, did $Something at the Database server. Can I reboot it to test it's reboot persistency?"

Answer: "No! $Important-thingy does $important-thing and cannot be disrupted right now! Wait one more hour please!"


Video Conferences

For means of faster communication and collaborative working we use our video conferencing solutions, if needed.

There are no regular hzw meetings. We get together when the need arises.


Coordinate projects

We use kanboard to plan, coordinate and track almost all of our activities.


Kanboard.png


Please open a ticket in our Kanban Board "team_hzw" if you want to:

  • report a bug
  • request a change
  • think I would be cool to have $thing (even if you don't want to spend time implementing it or don't know how to do it)


Technical Documentation

Our Root Server

We are unsing a Root Server hosted at Strato.

Technical Details

Server CPU Cores / Frequency Hard Drives RAM
Root Server

Linux C6-62

Intel® Xeon® E5-1650v3

Haswell

6 x 3,5 GHz

(max. Turbo: 3,8 GHz)

2 x 2.000 GB &

2 x 240 GB SSD

128 GB

DDR 4 ECC


Installed Software

There is only KVM and Ansible installed on the server.

We do NOT want to have stuff running on the Server besides KVM and Ansible.

If you want to do something in the HZW environment, create a VM for it.


Disks and Partitions

There are 2x  ~200GB SSDs (sda/sdb) and 2 ~2TB HDDs running in RAID 1.

The Mountpoint "/boot" is on partition md0, that consists of sda1 and sdb1 (SSD).

The Mountpoint "/" is on partition md1, that consists of sda3 and sdb3 (SSD).

SPAP Space is on sda2 and sdb2.

The Mountpoint "/data" is on partition md2, that consists of sdc1 and sdd1 (HDD).

Partitions.png

Network

The interfaceconfig of the server is written in netplan.

/etc/netplan/01-netcfg.yaml

Virtual Machines - Do's and dont's for VMs running at HZW


Guides

Guide to documenting with Mediawiki

Guide to documenting with Kanboard

Guide to documenting with Netbox