Software User Guide
Total Page:16
File Type:pdf, Size:1020Kb
Cycle Host User's Guide This guide is an evolving document. If you find sections that are unclear, or missing information, please let us know ([email protected]). Please check our website (www.wetlabs.com) periodically for updates. WET Labs, Inc. PO Box 518 Philomath, OR 97370 541-929-5650 fax: 541-929-5277 www.wetlabs.com 28 January 2010 Cycle Host User's Guide Revision 1.04 1/59 Cycle Host Installation The following sub-sections detail the steps necessary to install and run the Cycle Host program (also referred to as "the host") for the first time on a new computer. System Requirements Below are the recommended minimum requirements for a computer to be used to run the host program. Although Windows is currently the only supported operating system, future releases are planned to support Linux and MAC OS as well. Please let us know of your interest in these platforms via [email protected]. Feature Requirements Operating System Windows XP/Vista/2000/2003 (32 and 64 bit versions) Memory 128 Megabytes Disk Space 125 Megabytes (excludes data file storage) Data Port Serial port or USB to Serial adapter supporting 19200 baud Input Devices Keyboard (minimum) Mouse or other pointing device (recommended) Monitor Color, 1024 x 768 (minimum recommended) Table 1: Host Computer System Requirements The Java Runtime Environment The Cycle Host program is written in the JavaTM language developed by Sun Microsystems Inc. For this reason, execution of the host requires the installation of the Java Runtime Environment, or JRE. At the time of this release the current JRE is Version 6 Update 16. The host should run with any of the version 6 JREs, but it is recommended that the current version be used. 28 January 2010 Cycle Host User's Guide Revision 1.04 2/59 Figure 1: Java About Window Verifying the JRE version To verify the currently installed version of the JRE, select the Java icon in the Windows TM Control Panel. Then select the About... button on the General tab. You should see a window similar to Figure 1. If there is no Java icon visible within the Control Panel options, it is likely that there is no JRE installed. Another method for verifying the existence and version of the JRE is to visit the URL www.java.com within a web browser and look for the link "Do I have Java?". Browsing to that link should inform you which version of the JRE is currently installed. Installing the JRE If your host computer is not connected to the internet, the executable installation file for Windows XP/Vista/2000/2003/2008 is available in the JREDistribution directory on the distribution CD included with the instrument. If your host computer is connected to the Internet, it is recommended that you visit the URL www.java.com and follow the links, on screen prompts and directions provided there to install the most current JRE. NOTICE: If you are installing the JRE on a computer with the Windows Vista operating system, be sure to follow the steps detailed in the Note To Windows Vista Users section once you have installed the JRE. 28 January 2010 Cycle Host User's Guide Revision 1.04 3/59 Figure 2: Java Update Window Updating the JRE Figure 3: Up To Date JRE Message To verify the currently installed version of the JRE, select the Java icon in the Windows TM Control Panel. Then select the Update tab. You should see a window similar to Figure 2. Selecting the Update Now button will perform an immediate check to ensure that the JRE is up to date. It is recommended that automatic updates be enabled to detect future releases as they become available. If your JRE is up to date, you will see a pop-up window similar to Figure 3. If your JRE is not current, a pop-up window similar to Figure 4 will appear. 28 January 2010 Cycle Host User's Guide Revision 1.04 4/59 Figure 4: Java Update Available Figure 5: Java Setup Welcome Select the Install button and a new window similar to Figure 5 will appear. 28 January 2010 Cycle Host User's Guide Revision 1.04 5/59 You may choose to view the license agreement if you wish, but the Accept button must be selected for the JRE to be installed. It is highly recommended that the Change destination folder check box (shown highlighted in red) remain deselected. Figure 6: Yahoo Toolbar Option You may see a pop-up window similar to Figure 6. You may chose to install the Yahoo Toolbar at your discretion. It is not required for the Cycle Host installation. Click the Next button when you have made your selection. After the Next button has been selected, the JRE installation will begin. You will see a progress window similar to Figure 7 during the installation process. 28 January 2010 Cycle Host User's Guide Revision 1.04 6/59 Figure 7: Java Setup In Progress Once the JRE update is complete, you should see a window similar to Figure 8. Click the Finish button to complete the update. 28 January 2010 Cycle Host User's Guide Revision 1.04 7/59 Figure 8: JRE Update Complete Note To Windows Vista Users The host program will automatically copy several required files into the JRE directories. For this operation to succeed on Vista machines, write access permissions need to be enabled for JRE directory and its subdirectories for any user who will be running the host program. To also ensure access to future JRE installations, it is recommended that the write permissions be set for the c:\program files\Java directory and all of its subdirectories. To change the folder permissions, follow the steps below: 1. Run the Windows Explorer program, browse to the c:\program files\Java directory. 2. Right click on the c:\program files\Java directory and select the Properties option from the pop-up menu. 3. Click on the Security tab from the window that appears. 4. Click the Advanced button. 5. In the Advanced Security Settings window that pops up, click on the Owner tab. 6. Click the Edit button on the Owner tab. 7. Click the Other users or groups button on the new Advanced Security Settings 28 January 2010 Cycle Host User's Guide Revision 1.04 8/59 window that pops up. 8. Click the Advanced button in the lower left corner of the Select User or Group window that pops up. 9. Click the Find Now button from the new Select User or Group window that pops up. 10.Scroll through the Search Results list at the bottom of the window for your current user account and double-click on it. The window will disappear, returning you to the previous Select User or Group window. 11. Your user account should now appear in the text box under Enter the object name to select ( examples ):. Click the OK button on the Select User or Group window. 12.Click the OK button on the Advanced Security Settings for Java window. A Windows Security pop-up window will issue a message about ownership of the object. Click on its OK button. 13.Click the OK button on the next Advanced Security Settings for Java window. 14.When the Java Properties window reappears, select your user account from the list up top and click Edit. 15.Select your user account from the list beneath Group or user names: and then click the Edit button. 16.A new Permissions for Java window will appear. Select your user account from the list beneath Group or user names: again. In the lowest pane labeled Permissions for your user in the, click the box to the right of Full control in the Allow column. It should now have a check mark in the box. 17.Click the OK button. You may see a pop-up window that shows Setting security information on: file names while the files are updated. 18.If You get a security warning, click Yes. 19.Finally, click the OK button on the remaining Permissions for Java window. Installing Cycle Host All the necessary files for the host are in the CycleHost.zip file included on the distribution CD or available at the WET Labs web site. The recommended directory structure (C:\program files\WETLabs\CycleHost) is included within the zip file structure, so simply extract the zip file into the c:\ directory. Any decompression utility that supports the zip file format will be adequate. If upgrading, you may be queried to replace existing files. Click Yes or Yes to All. Starting Cycle Host For most systems, simply navigate to the installation directory (c:\program 28 January 2010 Cycle Host User's Guide Revision 1.04 9/59 files\WETLabs\CycleHost) using the Windows file explorer (Start | All Programs|Accessories| Windows Explorer). Double clicking on the main program file, SAFCycleHost.jar will start the program. The initial splash screen should appear soon thereafter. If it does not, an alternate method is to use the supplied CycleHost.bat batch file in the same directory. The CycleHost.bat file is named CycleHostdotbat within the ZIP file. It must be renamed to CycleHost.bat before it can be used to launch the host program. The batch file will only also work without modification as long as it remains in the same directory as the SAFCycleHost.jar file. Creating Shortcuts Figure 9: Shortcut Option In addition to running the host from the installation directory, shortcuts can be created by right clicking on the SAFCycleHost.jar file, dragging it to the desired location (directory, desktop or taskbar) releasing the right mouse button, and selecting the "Create Shortcuts Here" option (see Figure 9).