WCE Triage software installer

Recipes

This is how-to about creating own installer from the disk image.

Creating your own installer installer

Here is the steps to create your own installer.

Ingredients

  • Computer with Windows 10 + USB3 interface
  • Passmark ImageUSB
  • 2 x USB3 disks
    You can use USB sticks but it makes the process very very slow. So use USB3 disks. USB based docking station is fine but you’d need two slot docks. USB2 is okay but it would take 3x slower.
  • Installer image

Recipe

  1. Download ImageUSB if you don’t have it already.
  2. Download Installer image “inst_amd64.img.zip”
  3. Unzip inst_amd64.img.zip and make inst_amd64.img.
  4. Plug in a USB disk. Let’s call this Baby Disk.
  5. Bake Baby Disk
    Start ImageUSB, choose Baby Disk on step 1, step 2 is left as si, step 3 – choose image source “inst_amd64.img/inst_amd64.img” (Browse/Save), then step 4 “Write”. The process takes about 5 minutes depending on the disk speed.
  6. Unplug Baby disk and let it cool
  7. Plug in second USB disk. Let’s call this Mom Disk.
  8. Bake Mom Disk – steps are identical to Bake Baby Disk
  9. Restart computer, and boot from Mom Disk in update mode
    When it boots, you have 10 seconds to make a selection change from boot screen. You need to choose “Software Update” which is the third option of boot menu. First menu is the default but for Mom Disk to have a baby image, you need to boot in update mode.
  10. Wait for WCE Triage web page to show up.
    Very often, you have to hit “ALT-F4” to restart the browser. (I will fix this at some point)
  11. Create an installer image from Baby Disk
    Plug in the Baby Disk. Choose “Create Disk Image” tab. Hit “Reset” button so the Baby Disk shows up.
    Click the left check box to select the Baby Disk.
    On the top “Triage 64bit USB flash”.
    Then, click “Save”.
    Once it’s complete, the Mom Disk contains the disk image of Baby Disk which is the installer itself.
  12. Shutdown computer and unplug Baby Disk

Tasting

  1. Boot from Mom Disk again, but this time choose the first menu option.
  2. Once the web page shows up for Triage, plug in the Baby Disk again.
  3. Go into “Load Disk Image”, choose the disk image of Baby Disk you just created, and load the disk image to the Baby Disk
    This is so that the freshly created partition on the disk is expanded to fill entire disk instead of the disk image file which is only 3.5GB.

Creating your own content loading disk

Ingredients

  • Powerful computer
  • Existing Ubuntu computer with WCE contents, or a disk that contains the WCE contents
  • Baby Disk

Recipe

  1. If necessary, clean up the Ubuntu, such as vacuuming file system journals, truncating log files, and most of all, empty trash. apt’s package cache is also large, and recommended to remove them all.
  2. Boot from Baby Disk in Update mode
  3. Go to “Create Disk Image”
  4. Choose the Ubuntu disk, Choose “WCE Ubuntu 18.04LTS”, and “Save”
    Unlike small installer image, Ubuntu 18.04LTS with WCE contents requires 45GB disk space, and thus a lot of CPU power to compress the disk image.
    Once done, now the Baby Disk contains the master Ubuntu 18.04LTS with WCE contents!
    Once the disk image is created, you don’t need to do the same time consuming compression. You can just copy the disk image file to other installers.

Making USB stick installer

This is also “Triage”. When there is no payload on the usb stick, all it does is to gather up the info of computer and display.

Ingredients

  • Mom Disk
  • USB stick
  • A computer

Recipe

  1. Boot from Mom Disk with first menu option
  2. After it boots up, go to “Load Disk Image”, choose USB stick, and “Load”

Copying Disk image from one installer to other

Unfortunately, there is no user interface to copy the disk image. You need to do this on Ubuntu computer for now. It’s probably better to copy the disk image file to the computer first, and then copy to other USB sticks. Writing to USB stick is VERY VERY VERY slow. I have tried a few different ways to make this process faster but so far, the fastest possible way requires making a disk image, which isn’t automated yet.

WCE Triage Update

WCE Triage softawre update

This describes the steps to update the network server, USB stick and the installation laptops. Some of steps are the same.

Network server update

Updating requires an internet connection. If the machine has a wifi, it’s probably easier to use the wifi. By default, the wifi network tries wcetriage/thepasswordiswcetriage. You can use any wifi SSID/Password but it involves editing /etc/netplan/ files. It would be easier to temporary create a guest wifi network and use it. For the machine with more than 4 ethernet port, one of port is left for DHCP. For example, papa bear has 1 on-board ethernet and 4 ethernet on PCI-E card. On-board ehternet can be connected to LAN for internet connection. For baby bear, if you have a USB-to-Ethenet adapter, it would be easier, but then again, it would require to edit a netplan file.
1. Power up
2. Login as “triage”
3. Start terminal
4. make update
5. python3 -m wce_triage.setup.update_share
6. python3 -m wce_triage.setup.update_triage_ui
7. python3 -m wce_triage.setup.update_client

make update

In /home/triage, there is a Makefile. “make update” runs the “update” section of Makefile, which runs pip3 command to download the wce_triage package from test.pypi.org.

update_share

This syncs the latest disk image metadata (aka .disk_image_types.json) files in the “wce_triage” package to the wce’s directory under /usr/local/share as well as the nfs mounts for netboot clients.

update_triage_ui

This downloads the latest triage UI (React.JS app) from WCE’s google drive and deployes in the WCE’s triage-ui directory.

update_client

This copies “/usr/local/lib/python3.6/dist-packages” directory to the netboot clients.

Triage/USB stick update

Updating requires an internet connection. It is definitely easier to use a laptop with wifi, and the wifi is “wcetriage”.
1. Boot from the USB stick and choose “Update” option in the boot menu which is the 3rd option of boot entry.
2. If you fail to chose “update” mode, the machine boots and mounts USB stick with read-only so you cannot update.
3. Wait for the triage screen to show up
4. Hit ctrl-alt-F1 to switch to terminal
5. Login as “triage”
6. make update
7. python3 -m wce_triage.setup.update_share
8. python3 -m wce_triage.setup.update_triage_ui
Unlike installation server, no need for “update_client” as there is no netboot client.