sdk-persistent-disk-etc manual

critical

Image Types:
basesdk-amd64 / sdk-amd64
Image Deployment:
APT
Type:
compatibility

Description

Tests that persistent disk can be used when upgrading the SDK.


Pre Conditions

  1. Download the virtual machine image for the latest SDK release from:
  2. https://images.apertis.org/

  3. Make a note of release version (e.g v2020dev0)
  4. Instructions on how to use the SDK persistent workspace on VirtualBox:
  5. https://developer.apertis.org/latest/sdk-usage.html#persistent-workspace

  6. Clone the apertis-tests repository:
  7. $ git clone https://gitlab.apertis.org/pkg/apertis-tests.git

Execution Steps

  1. Execute the psdk-test script from the apertis-tests repository, passing the image release, the path to the Apertis SDK VDI image and with test type 'etc', for example:
  2. $ cd apertis-tests/psdk-test
    $ ./psdk-test etc <image_release> <apertis_sdk_image>.vdi
  3. The psdk-test command will open an interactive session that can be used to execute the test through different stages. The prompt should look like:
  4. $ psdk-test>
  5. Execute the first stage of the test entering 'r':
  6. $ psdk-test> r
  7. The stage1 command will setup the test environment (create and clone VMs) and also will execute any necessary step for the initialization of the test. After execution of stage1, there should be a virtual machine running named apertis-psdk-test-old-sdk, proceed to the next step.
  8. Use psdk to initialize the empty disk and to configure the SDK to use it:
  9. https://developer.apertis.org/latest/sdk-usage.html#preparing-the-persistent-disk-on-the-old-sdk

  10. The SDK will reboot when the configuration is completed. After the reboot click on psdk icon again to confirm that the persistent disk is in use.
  11. Continue executing the second stage of the test:
  12. $ psdk-test> r
  13. After the execution of stage2, there should be a virtual machine running named apertis-psdk-test-new-sdk, proceed to the next step.
  14. Use psdk to configure the SDK to use the persistent disk:
  15. https://developer.apertis.org/latest/sdk-usage.html#using-the-persistent-disk-on-the-new-sdk

  16. The SDK will reboot when the configuration is completed. After the reboot click on psdk icon again to confirm that the persistent disk is in use.
  17. Execute the final stage:
  18. $ psdk-test> r
  19. This will complete the execution of the test, please check that the expected result is obtained.

Expected

1) Changes made in the /etc folder should get reflected in the new sdk.

Notes

  • The psdk-test script will ask for the Apertis image SSH password in order to access the virtual machine during some stages.
  • Sometimes the SSH connection might show the error "Connection reset by peer", in such a case, please start again the test.
  • The psdk-test script starts and powers off the virtual machine several times, if something goes wrong during booting or shutdown of a VM, please manually close and restart the virtual machine and continue executing the test.