#!html
<h1 style="text-align: center; color: blue"> Installing and Configuring UMUI on Accessdev </h1>

PageOutline

This documentation outlines the installation and configuration of UMUI on the NCI virtual machine accessdev.

The installation of UMUI on Accessdev is done via puppet scripts. The puppet module for the UMUI is located in puppet/modules/umui/.

1. Notify users and other admins of upcoming upgrade of software.

2. New systems admins will need to have access to the NCI git repository and have read through the NCI Virtual Lab Developer's Guide before updating Accessdev. See https://docs.google.com/document/d/1ndDa505VPr4dXLRoojUh9nRBp7gzDsPAkD2c4h8EsFE

3. Puppet modules for accessdev.nci.org.au are edited on cloudlogin.nci.org.au machine. Before editing the puppet scripts please ensure you have the latest repository. This can be done by logging onto cloudlogin and pulling down the NCI git repository.

ssh cloudlogin.nci.org.au
cd puppet
git pull
git checkout master

4. Modify/Add the revision numbers with the following lines in puppet/hieradata/project.yaml

# Umui SVN revision
umui::umuirevision: 961
umui::ghuirevision: 530

5. Push changes back into the repository

git commit -a # you will be asked to enter a log message (-a for all files)
git push

6. Update Accessdev with the latest puppet changes

ssh accessdev.nci.org.au
sudo /usr/local/sbin/puppet-update

This UMUI module consists of two components, namely the Application and the GUI components. The current runtime resources and their Tcl/Tk codes are kept in the repositories:

https://access-svn.nci.org.au/svn/umui/branches/umui2.0_local, and

https://access-svn.nci.org.au/svn/ghui/branches/ghui3.0

respectively. These two repositories are regularly enhanced and upgraded by various individuals. Consequently, the administrative installing and upgrading of the UMUI module into the virtual machine mostly require specifying the desired Subversion revision number into the 'projects.yaml' file mentioned earlier.

The UMUI module on Accessdev is configured by the puppet script 'init.pp'. To see how the application and GUI interface components are translate/loaded into the virtual machine, please view the initialisation file in puppet/modules/umui/manifests/init.pp.

The rest of the files found in the umui/templates/ghui_config, i.e. these four files: the files 'config', 'link', 'umuix.def' and 'user', are the configuration file of UMUI. Briefly:

umui/templates/ghui_config/conf: This file controls the UMUI's server address, port number, and database location.

umui/templates/ghui_config/link: This file specifies other UMUI's servers, beside the one native to the virtual machine stated in 'conf' above.

umui/templates/ghui_config/umuix.def: This file control the Unified Model's version.

umui/templates/ghui_config/user: This file grant privilege to specific users, mainly for administrative purposes.

See UMUI Move' for information on setting up multiple databases (as used for the transfer of the accesscollab and cherax UMUI DBs).