Appendix F: Using the Project Demonstration Files

This appendix is included for completeness. However, only query.html is included because of licensing issues and the size of the files involved.

The USB drive included with this document contains the following items:

The first step in using these files is the installation of VMware Player and the Mercury Z39.50 Client. This is accomplished using the normal Windows software installation process. The setup files are located in the Software folder of the USB drive.

The next stage is copying the virtual machine files to the local hard drive. Because of file size limitation, the virtual machine cannot be run from the USB drive. The entire centos52 folder should be copied to the hard drive.

Opening the virtual machine is accomplished similarly to opening any file. Open the VMware Player application (Start » VMware » VMware Player). If this is the first time the software has been run, the user must accept the license agreement. Select Browse for available virtual machines in the program interface. The CentOS 5.2 file should be selected from the location it was saved earlier. A warning message will appear indicating the machine files have been moved or copied. Select "I copied it" and continue. The screen will display the startup sequence for the image. Depending on local security settings, a warning may be displayed regarding the VMware NAT service attempting to connect to the network. This service must be allowed network access for the demonstration server to work as it must access the University of Alberta Z39.50 server.

The VMware Player creates unique private subnets when it is installed on individual computers. Unfortunately, that means that the configuration information for the Mercury Z39.50 Client will have to reflect the IP address of the running system, and the form action tags in the query.html file must be updated to reflect the correct address. The virtual machine has been configured to display the IP address and URL of the SRU service on start up. The query.html file contains comments that mark where the file must be updated with the correct URL.

In addition, the virtual machine may be accessed in the VMware Player console or by using an ssh or sftp client. The username and password for the machine are root and ctuser. The YAZ proxy files are located in the /usr/local/share/yazproxy/ directory.

The Mercury Z39.50 Client may also be used to connect to the SRU server. The configuration screen is accessed by selecting File » Search, then navigating to the Databases section. The Add button creates a new entry. An example of the configuration settings is shown in Appendix C. The field label Z39.50 URL is misleading - entering the URL including the protocol will cause the program to interpret it as an SRU target. Again, the URL to be used will be displayed in the VMware Player window.

The SRU server may be accessed by other programs running on the local computer. Because of the nature of networking used in this virtual machine, it is not possible to access the SRU server from a remote computer.

Shutting down the virtual machine gracefully may be accomplished by logging in to the machine either at the VMware Player window or using ssh and issuing the command shutdown -h now.

Previous: YAZ Proxy Configuration