Go Back

Download Emulation Assistant

Click here to download Emulation Assistant

About Emulation Assistant

Emulation Assistant provides automated access to the legacy executables present on the file systems. A detailed analysis on creating the legacy executables is mentioned in the document Tutorial to create and test automation scripts. The approach focuses on improving user navigation of and access to programs located within a networked collection of CD-ROM ISO images presented as a single filesystem and accessible through a web interface (http://www.cs.indiana.edu/svp/). When a user clicks on a link to a virtual disk image for which an installation script is available, a Java applet executes a helper application on the user's workstation taking the form of a wizard that informs the user and provides the option of mounting the ISO image within a guest Windows XP image.


Figure 1: Client Request for Networked Resource

Getting Started:

You will need the following: 1) Latest VMware Workstation/Server on Windows Machine hosting a Windows XP Professional Virtual machine. The details about where to find and how to download the Virtual Machine and the Workstation/Server is provided in ÒTutorial to create and test automation scriptsÓ document. 2) VMware VIX API 3) MIT Kerberos for Windows 4) OpenAFS client for Windows. You will need to be added to AFS group to login to the AFS client. Please contact Dr. Geoffrey Brown to do this. The instructions on installing Kerberos and OpenAFS can be found on IU Knowledge Base. 5) Latest Microsoft Visual Studio.
====================================================================================
 VIRTUAL MACHINE DETAILS
====================================================================================
  - SERVICE PROVIDER: VMware Server Console
  - VIRTUAL MACHINE: Windows XP Professional
  - USERNAME: iucs
  - PASSWORD: vmware
  - LOCATION ON MY COMPUTER: C:\Virtual Machines\Windows XP Pro\Windows XP Professional.vmx
  - LOCATION OF VM DESKTOP: C:\Documents and Settings\iucs\Desktop (This is where the install script is copied)
 -> AFSBrowser was written on Microsoft Windows Vista Home Premium, Service Pack 2
 -> IMPORTANT: Auto Log-in MUST be enabled or else installScript will not finish. 
- See: http://www.microsoft.com/windowsxp/using/setup/learnmore/tips/knox2.mspx
  -> IMPORTANT: Make sure to read the snapshot details or else AFSBrowser may not funtion 100% properly!
=====================================================================================
 IMPORTANT DETAILS ABOUT SNAPSHOT
=====================================================================================
	-> AFSBrowser works using a snapshot of a virtual machine.	
!	-> CRUCIAL: The STATE of this virtual machine IS CRITICAL in order for AFSBrower to function properly!!
!	-> CRUCIAL: The snapshot MUST MUST MUST be of a virtual machine whose state is POWERED OFF!!!
	   To do this, take a snapshot of the machine BEFORE you turn it on.
		- If the machine is already powered on, turn it off, and then take a snapshot.
!			--> The snapshot CANNOT be of a virtual machine that is logged in.
					- If the snapshot is of a VM that is logged in, AFSBrowser will
					  not be able to mount the .ISO as the CD-DRIVE. As a result,
					  the install script will not find the .ISO image it needs and
					  will not work.					  
!			--> The snapshot CANNOT be of a virtual machine that is at the log-in screen.




=====================================================================================
 REFERENCES  
=====================================================================================
->	In this project, I had to add a reference to VixCOM in order for VixWrapper.cs to work.
	 To do this, I went to the 'Solution Explorer', right-clicked 'References', then clicked 
	 'Add Reference' and found VixCom.	 
->	This should never be an issue, however if you get a "VixCOM not found error" 
	 (or something to that extent) first check that the reference is still there. Like I said,
	 this should never be an issue.

=======================================================================
Build Install
======================================================================= 
1. Open the solution (.sln) file in Mircrosoft Visual Studio.
2. Click on Build, then Build Solution.
3. Now go to Install directory and you can find the .EXE in ...\Install\bin\Debug\
4. If you leave the .EXE in this location, you can run it and it should work. If you want to move 
     Install.exe to another location you must also move the Interop.VixCOM.dll file AND 
     AFSBrowser.exe to the same new location. In short, all three of these files must be in the 
     same directory for the program to work successfully.

=======================================================================
 Build Legacy Emulation Assistant
=======================================================================
1. Open the solution (.sln) file in Mircrosoft Visual Studio.
        - This should be either AFSBrowser.sln or possibly Legacy Emulation Assistant.sln
2. Click on Build, then Build Solution.
3. Now go to AFSBrowser directory and you can find the .EXE in ...\AFSBrowser\bin\Debug\
4. If you leave the .EXE in this location, you can run it and it should work. If you want to move 
     AFSBrowser.exe to another location you must also move the Interop.VixCOM.dll file to the 
     same new location. In short, AFSBrowser.exe and Interop.VixCOM.dll must be in the same
     directory for the program to work.

=======================================================================
How to create Certificate to Sign Script
=======================================================================
-  yourkey can be changed to whatever you want your key to be named
-  yourcert.crt can be changed to whatever you want it to be named, but must have .crt extension
-  RunExecutable.java and RunExecutable.class should be the name of whichever java file you
   want to sign. In this case, we want RunExecutable.java to be signed.

Click here to download Emulation Assistant

© Copyright - 2012