GNU Health/The Live-CD

From Wikibooks, open books for an open world
< GNU Health
Jump to: navigation, search

The Live-CD[edit]

The GNU Health Demo Database is available as Live-CD. This gives interested users the option to run GNU Health on their own PC, and, if desired, install the GNU Health demo database directly from the CD.
Similar as the demo database, the live-CD is an ongoing project and it will be adapting to the each new GNU Health version. The clinical history will also grow with time.

Download the Live-CD[edit]

The Live-CD was built on SUSEStudio, and is currently available with the following flavours:

Please note: The user name and password necessary to access the GNU Health server on the Live-CD can be found on that download page as well.

Unlike the full version of openSUSE, the Live-CD contains only packages that are required to run GNU Health. Feel free to add required programs later on from the openSUSE repositories

Install the Live-CD[edit]

In order to use the Live-CD, you have to install it on a CD or a USB stick.

USB-Stick / Hard Disk Image[edit]

The hard disk image comes as packed raw format. After download, first unpack the *.tar.gz file

  • On Linux/Mac-OS, use your favorite archiving program, or use 'tar -xvzf *tar.gz' from the command line
  • On Windows, use an advanced packer like 7-Zip

After unpacking, you have to install the RAW-file to a stick. See instructions. (Create a Live USB stick using Windows)

Note: When booting the first time from the USB-Stick, the boot process takes a bit longer, as the stick is being optimized (data and swap space creation). Second boot will be much quicker.

ISO-Image / CD[edit]

If you have downloaded the ISO image to burn a CD, you can find the relevant instructions here.

Install the Live-CD to your hard drive[edit]

The Live-CD offers the option to install the system and the GNU Health Demo-DB to your hard drive. The relevant program can be found in the 'My Computer' Section of the start menu (the little green button on the lower left corner of the screen).

Virtual Machine Images[edit]

The live-CD is available in various container formats that allow easy integration into a virtual environment. Currently the following formats are published:

  • Xen Guest (.img)
  • OVF Virtual Machine / ESXI (.ovf)
  • VMware Workstation / VirtualBox (.vmdk)
  • SUSE Cloud / OpenStack / KVM (.qcow2)
  • Hyper-V Virtual Hard Disk (.vhd)

Running the Virtual Machine as Server[edit]

Several times the question came up 'How can I access my Live-CD from another desktop'? This should not be too difficult if you consider some points. The following example bases on Virtualbox, but should be similar on other virtual environments:

  • When setting up the network, make sure you select 'Bridged Network'. In this case the virtual box will receive the IP-Address from your DHCP-Server, not from the host-machine
  • Make sure the network-name of your virtual box is updated to your DDNS-Server. Even better, you may assign a fix network address to your virtual box, say 192.168.2.100
  • Try to ping the box from an external client on the network: open a console and type: ping 192.168.2.100
  • If this works, and your GNUHealth server is running, check if you can access the server from outside: telnet 192.168.2.100 8000
    If this works, everything is good.
    If not, its time to check the firewall settings of your box. From the Start Menu, select System -> Administration -> YaST. Enter the password for 'root': tryton , and go to 'firewall Settings'. Check the external zone (right interface name?) or even add an exception for the 192.168.2.100/24 network

Adjustmends[edit]

  • You may want to change the language and keyboard to your preferred setting. From the Start Menu, select System -> Administration -> YaST. Enter the password for 'root': tryton . You have reached the administration settings. From the 'System' Section select 'Language' to change the primary language.
  • You may want to run an online update. From the Start Menu, select System -> Administration -> YaST. Enter the password for 'root': tryton . You have reached the administration settings. From the 'Software' Section select 'Online-Update'.
  • You may want to install additional software. From the Start Menu, select System -> Administration -> YaST. Enter the password for 'root': tryton . You have reached the administration settings. From the 'Software' Section select 'Software Management'.