Minor updates to hackerbook chapters (#20)

Author: sudo87

1-user.md

@@ -115,7 +115,7 @@ and all other packages:
 
     mkdir -p /etc/apt/keyrings
     wget -O- http://packages.shapeblue.com/release.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cloudstack.gpg > /dev/null
-    echo deb [signed-by=/etc/apt/keyrings/cloudstack.gpg] http://packages.shapeblue.com/cloudstack/upstream/debian/4.18 / > /etc/apt/sources.list.d/cloudstack.list
+    echo deb [signed-by=/etc/apt/keyrings/cloudstack.gpg] http://packages.shapeblue.com/cloudstack/upstream/debian/4.20 / > /etc/apt/sources.list.d/cloudstack.list
     apt-get update -y
     apt-get install cloudstack-management cloudstack-usage cloudstack-agent mysql-server nfs-kernel-server quota qemu-kvm
 

2-dev.md

@@ -80,7 +80,7 @@ Old videos:
 Video: https://s3-eu-west-1.amazonaws.com/shapeblue-engineering-videos/hackerbook/2-dev/2-dev-chapter.mp4
 
 The recommended development environment is Linux based, in this course Ubuntu
-Linux 20.04+ is preferred. Run the following to install packages required for
+Linux 24.04+ is preferred. Run the following to install packages required for
 CloudStack development on Ubuntu: (see first chapter on software installation)
 
     $ sudo apt-get install openjdk-11-jdk maven mysql-server mysql-client bzip2 nfs-common uuid-runtime python3-setuptools ipmitool genisoimage nfs-kernel-server quota
@@ -203,9 +203,9 @@ when required.
 
 The following is one way to seed a systemvmtemplate, for example for the 4.15:
 
-    wget http://packages.shapeblue.com/systemvmtemplate/4.15/systemvmtemplate-4.15.0-kvm.qcow2.bz2
+    wget http://packages.shapeblue.com.s3-eu-west-1.amazonaws.com/systemvmtemplate/4.20/systemvmtemplate-4.20.0-x86_64-kvm.qcow2.bz2
     ./scripts/storage/secondary/cloud-install-sys-tmplt \
-          -m /export/testing/secondary -f systemvmtemplate-4.15.0-kvm.qcow2.bz2 \
+          -m /export/testing/secondary -f systemvmtemplate-4.20.0-x86_64-kvm.qcow2.bz2 \
           -h kvm -o localhost -r cloud -d cloud
 
 Notes:
@@ -268,6 +268,10 @@ Example of how to run a marvin based integration test: (change parameters suitab
 
     $ nosetests --with-xunit --xunit-file=results.xml --with-marvin --marvin-config=/path/to/config.cfg -s -a tags=advanced --hypervisor=KVM test/integration/smoke/test_vm_life_cycle.py
 
+Note: Python version 3.10 may require you to install pynose
+
+    $ pip install pynose
+
 When needed, the usage server can be started using:
 
     $ mvn -P usage -Drun -Dpid=$$ -pl usage
@@ -583,7 +587,7 @@ For feature submission the typical process is as follows:
 
 **Case Study**: Dynamic Roles feature
 - Functional specification: https://cwiki.apache.org/confluence/display/CLOUDSTACK/Dynamic+Role+Based+API+Access+Checker+for+CloudStack
-- Mailing list: https://markmail.org/message/kkn5ihttg65i76kl
+- Mailing list: https://lists.apache.org/thread/610q6b96vkvqddltxco1dl6b0kxszm8s
 - Jira/bug ticket: https://issues.apache.org/jira/browse/CLOUDSTACK-8562
 - Pull request and reviews: https://github.com/apache/cloudstack/pull/1489
 - Documentation PR: https://github.com/apache/cloudstack-docs-admin/pull/37

hack/automation.md

@@ -49,7 +49,7 @@ more about it here: https://www.ansible.com/resources/get-started
 
 Recommended reading:
 http://docs.cloudstack.apache.org/projects/archived-cloudstack-getting-started/en/latest/ansible.html
-https://docs.ansible.com/ansible/2.6/scenario_guides/guide_cloudstack.html
+https://docs.ansible.com/ansible/2.9/scenario_guides/guide_cloudstack.html
 
 Example projects using Ansible for CloudStack automation:
 - Trillian, ACS environment automation: https://github.com/shapeblue/trillian

hack/com.md

@@ -52,7 +52,7 @@ we can the async-callback method to brew coffee using the configured
 
 ```java
     // Note: callback method should be `protected Void` for `Enhancer` to work
-    protected Void BrewCoffeeAsyncCallback(AsyncCallbackDispatcher<CoffeeManagerImpl, Coffee> callback, CreateCoffeeContext<Coffee> context) {
+    protected Void brewCoffeeAsyncCallback(AsyncCallbackDispatcher<CoffeeManagerImpl, Coffee> callback, CreateCoffeeContext<Coffee> context) {
         Coffee coffee = callback.getResult();
         context.getCoffeeMachine().brew(coffee);
         stateTransitTo(coffee, Coffee.Event.OrderReady);

hack/db.md

@@ -79,10 +79,10 @@ represents a row in the table. The VO typically implements the resource
 interface (contract), however for purpose of any subsystem consuming a resource
 object, the resource interface should be used/passed around than a VO instance.
 
-The VO class exports and use several annotations for its table/db fields and
+The VO class exports and uses several annotations for its table/db fields and
 `@Table` to define the name of the table that the VO represents. Most CloudStack
 tables have an internal (bigint) ID or database `id`, but the resources are
-queries by users based on an external string based `uuid`.
+queried by users based on an external string based `uuid`.
 
 Define the `VO` and make it implement the feature/resource interface. For
 example:
@@ -243,7 +243,7 @@ list/add/remove/save details.
 A Finite State Machine or
 [FSM](https://en.wikipedia.org/wiki/Finite-state_machine) defines a transition
 table that takes in a state and an event to transition to a new state. In
-CloudStack FSM is used to implement state machine and restrict how state of a
+CloudStack, FSM is used to implement state machine and restrict how state of a
 resource such as a VM, volume, network etc. transition given an event occurs.
 The resource state and events are both defined as `enum`, usually in the
 resource interface. The resource interface need to extend the `StateObject<S>`

hack/packaging.md

@@ -1,7 +1,7 @@
 # Packaging
 
 RPM packaging references:
-- https://fedoraproject.org/wiki/How_to_create_a_GNU_Hello_RPM_package
+- https://docs.fedoraproject.org/en-US/package-maintainers/Packaging_Tutorial_2_GNU_Hello/
 - https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html-single/rpm_packaging_guide/index
 - https://rpm-guide.readthedocs.io/en/latest/rpm-guide.html
 

hack/usage.md

@@ -30,9 +30,9 @@ resource, `Coffee`. First define the usage type for the new resource in
 `UsageTypes` and confirm it in the `listUsageTypes` response:
 
 ```java
-    public static final int COFFEE = 30;
+    public static final int COFFEE = 40;
     // .. code redacted ..
-    responseList.add(new UsageTypeResponse(COFFEE, "Coffee usage"));
+    responseList.add(new UsageTypeResponse(COFFEE, "COFFEE", "Coffee usage"));
 ```
 
 Ensure that usage events are emitted by your service layer code when (for