|
|
| (7 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| == QA Overview ==
| | This page is no longer maintained. |
| Hgwdev has Virtualbox installed and one virtual machine (VMs) added called "browserbox". It is the "master" image of the Gbib and used by QA.
| |
|
| |
|
| qateam has aliases to start and stop the VMs: boxStart / boxStop
| | http://genomewiki.ucsc.edu/genecats/index.php/Gbib_release |
| | |
| Once started, browserbox listens at port 1234 for web requests and at 1235 for ssh
| |
| | |
| == SSH into the box from hgwdev ==
| |
| From hgwdev, as qateam, you can do "ssh box" to connect to the box (this is configured in .ssh/config).
| |
| | |
| There is no password, because the qateam ssh key was added to the box.
| |
| | |
| == Box release overview ==
| |
| | |
| * during beta testing time
| |
| ** The script "boxPrep beta" on hgwdev packs up a set of htdocs + CGIs for the boxes used by QA.
| |
| ** On the boxes used by QA, the command "updateBrowser beta" is used pull in the beta CGIs that were compiled by the buildmeister
| |
| * at public release time, the box in this beta state is cleaned and zipped. This zip can be (optionally) tested on Windows or OSX. This can then be pushed to hgdownload.
| |
| | |
| For development see [[Gbib development]].
| |
| | |
| == Setup http access for testing the box ==
| |
| | |
| To test the browserbox, one has to connect with http to it. Browserbox accepts only connections from hgwdev, not from outside. You cannot connect from your desktop machine directly. So ssh on your desktop has to be told to forward at least one port to hgwdev. To make this happen, add this to your file ~/.ssh/config (create it if necessary) on your own OSX or linux machine:
| |
| | |
| Host hgwdevtunnel
| |
| Hostname hgwdev.sdsc.edu
| |
| User <YOURHGWDEVUSER e.g. rhead>
| |
| #http
| |
| #using 4321 to avoid clashing with your locally running gbib
| |
| LocalForward 127.0.0.1:4321 127.0.0.1:1234
| |
| # RDP for box administrator
| |
| # LocalForward 127.0.0.1:3389 127.0.0.1:3389
| |
| # the following line is only needed for developers
| |
| # LocalForward 127.0.0.1:1236 127.0.0.1:1236
| |
| # the following line is only needed for intensive cleaning of the box
| |
| # LocalForward 127.0.0.1:3390 127.0.0.1:3390
| |
| | |
| You can then do a "ssh devtunnel" to get connected to hgwdev and have the port 1234 on your machine 1234 forwarded to the box. Port 1234 is a http port, so you can then test the browserbox by pointing your internet browser on your desktop to http://127.0.0.1:1234
| |
| | |
| == Beta testing the box runningn on hgwdev ==
| |
| | |
| As qateam on hgwdev, prepare the cgi-bin-beta binaries, htdocs and additional "push" files for the box:
| |
| boxPrepare beta
| |
| | |
| Then pull the cgi-bin-beta binaries into the box:
| |
| | |
| ssh box updateBrowser beta
| |
| | |
| Setup the tunnel from your desktop to hgwdev:
| |
| ssh hgwdevtunnel
| |
| | |
| Now you can test the box via http://127.0.0.1:4321.
| |
| | |
| == Alpha testing ==
| |
| | |
| Testing during development time should usually not be needed, just like hgwdev tests.
| |
| | |
| There are two alpha versions: one is the normal alpha version, the CGIs on hgwdev. The other are the CGIs on the devbox. They are normally on alpha state, too, but might include a special bugfix or testing code.
| |
| | |
| To test alpha versions, the developer will prepare a package by running, as qateam:
| |
| | |
| boxPrep alpha
| |
| or
| |
| boxPrep devbox
| |
| | |
| Then, on the box, the developer or QA can pull these special CGIs by running:
| |
|
| |
| updateBrowser alpha
| |
| or
| |
| updateBrowser devbox
| |
| | |
| == Release ==
| |
| | |
| To prepare the box in its current state on hgwdev for download, run this as qateam on hgwdev:
| |
| boxRelease.csh
| |
| | |
| This will ssh into the box, clean it (remove temp files, sessions, etc), stop it, zip it and place it onto hgwdev on http://hgwdev.soe.ucsc.edu/gbib/gbib.zip
| |
| | |
| The zipfile can be downloaded to OSX or Windows and possibly tested there again, with the slowNet command (necessary?).
| |
| | |
| At the end of the testing week (Friday?), the zipfile can be pushed to hgdownload.
| |
| | |
| At the next update of hgdownload, all boxes with activated auto-updates should update themselves automatically, see [[Gbib_auto_updates]].
| |
| | |
| == intensive box cleaning (optional) ==
| |
| | |
| Each time a new file is created on the box, the virtual disk file gets filled with the data, even if the file is deleted. The browserbox zipfile will therefore grow. If the zipfile is getting very big, it might be good to overwrite the empty space on the virtual disk with zeros.
| |
| | |
| To do this, install an RDP client on your OSX machine (Microsoft RDP client for OSX, in the app store, free), uncomment the RDP 3389 port forward in your .ssh/config and do an "ssh hgwdevtunnel" your desktop.
| |
| | |
| Start your RDP client, connect to localhost. You should see the console of the browserbox. Type:
| |
| | |
| sudo reboot
| |
| | |
| * Keep shift pressed while the box is rebooting.
| |
| * Select the Recovery mode, type "enter".
| |
| * Type "r" to select "root". Type "enter".
| |
| * Password is "browser".
| |
| * Run the script "./zeroVm.sh". run "sudo reboot".
| |
