eGranary Personal Edition ManualeGranary Digital LibraryPersonal EditionInstallation ManualThis manual is for users of the...
eGranary Personal Edition Manual       The eGranary runs on multiple versions of the Windows operating system (OS). This d...
eGranary Personal Edition Manual1 Check System Requirements1.1 eGranary equipmentYou should have:      The eGranary hard d...
eGranary Personal Edition Manual2 Installing the eGranary Personal Edition       If your computer is on a network and you ...
eGranary Personal Edition Manual   8. Install eGranary Browser pop-up - Click Yes.   9. Completing the Setup Wizard window...
eGranary Personal Edition Manual3 Troubleshooting the eGranary PE3.1 Basic TroubleshootingMany issues that arise in the in...
eGranary Personal Edition ManualBy PhonePhone: 1-319-335-2600Fax: 1-319-335-5374 (notify beforehand)By MailThe WiderNet Pr...
eGranary Personal Edition Manual4 eGranary MaintenanceFor instructions in maintaining and using the eGranary covered here,...
eGranary Personal Edition Manual4.5 Uninstalling the Personal Information Engine (PIE) Services   1. Open the Start Menu. ...
eGranary Personal Edition Manual   4. Click About eGranary. A window will open that contains the version information.   5....
eGranary Personal Edition Manual5 Appendix A - Alternate Browsers5.1 Changing Browser Proxy SettingsTo configure a web bro...
eGranary Personal Edition Manual  5. Under Address, enter the IP address of the eGranary Digital Library Server and under ...
eGranary Personal Edition Manual4. Under HTTP Proxy, enter the IP address of the eGranary Digital Library Server and under...
Upcoming SlideShare
Loading in …5
×

E granarype installation manual

809 views

Published on

Published in: Education, Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
809
On SlideShare
0
From Embeds
0
Number of Embeds
4
Actions
Shares
0
Downloads
31
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

E granarype installation manual

  1. 1. eGranary Personal Edition ManualeGranary Digital LibraryPersonal EditionInstallation ManualThis manual is for users of the eGranary Personal Edition. It contains information about installing, using,troubleshooting and maintaining the eGranary Digital Library system on a stand-alone workstation. Publisher: The WiderNet Project Editor: Amy Kersten Versions : Personal Information Engine 2.0.x Date: Apr 5, 2012 2:12 PM URL: https://www.widernet.org/confluence/display/EGMANPUB/eGranary+Personal+Edition+Manual Page 1 of 13
  2. 2. eGranary Personal Edition Manual The eGranary runs on multiple versions of the Windows operating system (OS). This document describes installation under Windows 7. References to specific Windows constructs may look slightly different or be labeled differently under other versions of the OS. All documentation refers to OS components using standard terminology whenever possible.Welcome to the eGranary Personal Edition (eG PE), a portable version of the eGranary Digital Library youcan install on your personal computer. This manual guides you through the step-by-step process of installingthe eG PE on your computer. There are also sections on troubleshooting and maintaining the installation.You can find contact information for Widernet Project technical support in the troubleshooting section, shouldyou need help .Table of Contents1 Check System Requirements __________________________________________________________ 3 1.1 eGranary equipment _____________________________________________________________ 3 1.2 Computer and software ___________________________________________________________ 32 Installing the eGranary Personal Edition __________________________________________________ 4 2.1 Connect the eGranary hard drive to your computer _____________________________________ 4 2.2 AutoPlay Window _______________________________________________________________ 4 2.3 Run the installer ________________________________________________________________ 4 2.4 eGranary Homepage _____________________________________________________________ 5 2.5 Testing the Installation ___________________________________________________________ 53 Troubleshooting the eGranary PE _______________________________________________________ 6 3.1 Basic Troubleshooting ____________________________________________________________ 6 3.2 Obtaining Troubleshooting Logs ____________________________________________________ 6 3.3 Contacting WiderNet Technical Support ______________________________________________ 64 eGranary Maintenance _______________________________________________________________ 8 4.1 Installing the eGranary on a Different Computer ________________________________________ 8 4.2 Changes to the eGranary Drive Letter _______________________________________________ 8 4.3 Stopping the Personal Information Engine (PIE) Services ________________________________ 8 4.4 Starting the Personal Information Engine (PIE) Services _________________________________ 8 4.5 Uninstalling the Personal Information Engine (PIE) Services ______________________________ 8 4.6 Ejecting the eGranary Hard Drive ___________________________________________________ 9 4.7 Using the eGranary and the Internet _________________________________________________ 9 4.8 Obtaining Version Information ______________________________________________________ 9 4.9 Obtaining Maintenance Logs ______________________________________________________ 10 4.10 Restoring the Personal Information Engine (PIE) Services _______________________________ 105 Appendix A - Alternate Browsers ______________________________________________________ 11 5.1 Changing Browser Proxy Settings __________________________________________________ 11 5.2 Setting up Internet Explorer _______________________________________________________ 11 5.3 Setting up Mozilla Firefox or eGranaryBrowser ________________________________________ 12 Page 2 of 13
  3. 3. eGranary Personal Edition Manual1 Check System Requirements1.1 eGranary equipmentYou should have: The eGranary hard drive A large black or silver box. A power cord with a transformer One end plugs into a power outlet, and the circular plug on the other end connects to the eGranary console. For some hard drives this is two cords that you connect together in the middle. A USB cord A small plug on one end connects to the side of the eGranary hard drive and a larger, rectangular plug on the other end connects to your computer. Both ends should have a symbol on them that looks like the image below.1.2 Computer and softwareYou should have: Operating System Windows 2000, 2003, XP, Vista, 7 or 2008. The eGranary hard drive will not work under Windows 95, 98 or ME. Administrator Access You must have administrator privileges on the computer in order to install the eGranary. High-speed USB The eGranary requires a high-speed 2.0 USB port. (USB ports are commonly used to connect keyboards, printers, and flash drives to computers.) Virus Protection Update the virus protection on the computer before you plug in the eGranary. Page 3 of 13
  4. 4. eGranary Personal Edition Manual2 Installing the eGranary Personal Edition If your computer is on a network and you need to be able to share the eGranary with other users, please refer to Setting up an eGranary External Drive-Windows2.1 Connect the eGranary hard drive to your computer 1. If your eGranary hard drive has a power switch, turn it to the off position. (The switch may be labeled "On" and "Off" or it may use a vertical line "|" for on and an open circle "O" for off.) 2. Connect the power cord to the eGranary hard drive and then to a power source. We highly recommend use of an uninterruptible power supply throughout installation and use of a surge protector at all times. 3. Connect the USB cord to the eGranary hard drive and to the USB 2.0 port on your computer. (USB ports are commonly used to connect keyboards, printers, and flash drives to computers.) 1. If your eGranary hard drive has a power switch, turn it to the on position.2.2 AutoPlay WindowIf a window labeled "AutoPlay" opens, click the Cancel or Close button.2.3 Run the installerWe recommend that you read this entire section of instructions prior to installation to familiarize yourself withthe steps and any options you might choose. If you see a pop up during installation that says "Windows Security Alert." Click Unblock to continue. 1. Under the Start menu, go to Computer. 2. Double-click the eGranary and then double-click the folder pie. 3. Double-click the application file pie-2.0-windows-installer. If you are prompted to allow the program to run, click Yes. 4. A pre-installation check for previously installed silos will finish on its own. 5. Setup window - Click Next to begin. 6. Personal or Server Edition window - Choose the Personal Edition and click Next to continue. 7. Ready to Install window - Click Next to continue. A pop-up showing the progress of the installation will appear. Page 4 of 13
  5. 5. eGranary Personal Edition Manual 8. Install eGranary Browser pop-up - Click Yes. 9. Completing the Setup Wizard window - Click Finish. 10. eGranary Browser Window - Installation of the eGranary browser runs. When the installation completes, click Close.2.4 eGranary HomepageAfter installation of the eGranary browser completes, the browser launches. If prompted, choose Dontimport anything and then click Next. The browser will open the eGranary homepage at http://egranary.2.5 Testing the InstallationTo ensure that all components of the eGranary are working properly, you can perform some simple tests. 1. In your browser, type http://egranary in the address bar. (If you are using the eGBrowser, you can just click the home button). You should see the eGranary home page. Click through several links in the eGranary Digital Catalog section to verify that the catalog is working. 2. From the eGranary home page, enter a simple query such as "computer" or "water" into the Full Text Search box and click Find. Browse through the result clicking on a few links. If you successfully complete these tests, congratulations, you are ready to use the eGranary.Optionally, you can also test content added to the eGranary that runs straight off the server that we call"Shared Content" 1. From the eGranary Home Page, click on the Software button (the mouse icon in the Easy Find Buttons above the Catalog Search box). 2. Click on the Software (Execute) link in the Narrow Search box on the right 3. Click on several of the links in this list and follow any instructions to run the applications. It is normal to see a dialog box pop up to confirm that you want to run the application.If you have trouble with these tests, refer to the Troubleshooting Section (see page 6) Page 5 of 13
  6. 6. eGranary Personal Edition Manual3 Troubleshooting the eGranary PE3.1 Basic TroubleshootingMany issues that arise in the installation and use of the eGranary can be corrected by completing one ormore of the following steps. These steps are listed in the order you should do them, and you should test tosee if you corrected the issue before trying the next step. See the eGranary Maintenance (see page 8)section for the specific instructions to complete each step. 1. Stop PIE services (see page 8) and Restart PIE services (see page 8) 2. Uninstall (see page 8) and reinstall (see page 4) the PIE services. 3. Restore PIE services (see page 10).Should these steps fail to correct the issue, please contact WiderNet technical support. If possible, obtain thePIE Troubleshooting logs and send them to technical support as described next.3.2 Obtaining Troubleshooting LogsWhen an issue arises that you are unable to resolve without assistance, please send the troubleshooting logto WiderNet Technical Support. If you need assistance, contact WiderNet technical support (see page 6). 1. Open the Start menu. 2. Select Computer. 3. Double-click the eGranary. 4. Double-click the folder pie. 5. Double-click the folder data. 6. Double-click the folder logs. 7. E-mail the adminlog file with the current date as an attachment to support@widernet.org ( mailto:support@widernet.org). If the file is very large, you may need to compress it using your favorite zip tool.3.3 Contacting WiderNet Technical SupportWhen an issue arises, please provide as much of the following information as possible when contactingtechnical support: eGranary drive number Operating system version PIE version Detailed description of issue, including any error messages or unexpected behavior Troubleshooting log (see above) Your contact information, including preferred method of communicationBy Emailsupport@widernet.org Page 6 of 13
  7. 7. eGranary Personal Edition ManualBy PhonePhone: 1-319-335-2600Fax: 1-319-335-5374 (notify beforehand)By MailThe WiderNet Project201 Communications CenterThe University of Iowa, SLIS116 South Madison StreetIowa City, IA 52242 USA Page 7 of 13
  8. 8. eGranary Personal Edition Manual4 eGranary MaintenanceFor instructions in maintaining and using the eGranary covered here, the general sequence of steps is listedfirst. Detailed instructions for completing each step follow below.4.1 Installing the eGranary on a Different ComputerTo move the eGranary to another computer, follow these steps: 1. Uninstall the PIE services (see page 8). 2. Eject the eGranary hard drive or turn off the computer. 3. Disconnect the eGranary hard drive cable from the computer.See Installing the eGranary Personal Edition (see page 4) to install the eGranary on the other computer.4.2 Changes to the eGranary Drive LetterThe drive letter of the eGranary hard drive could change, for example, if you plug in another USB device. Ifthe drive letter of the eGranary hard drive changes after installation, follow these steps to reset the pathsstored in the eGranary hard drive: 1. Uninstall the PIE services (see page 8). 2. See Installing the eGranary Personal Edition (see page 4) to reinstall the PIE services. This will reset the silo paths.4.3 Stopping the Personal Information Engine (PIE) Services 1. Open the Start Menu. 2. Select All Programs. 3. Select WiderNet eGranary Personal Information Engine. 4. Select Stop PIE Services. 5. A Stop PIE Services window will appear which will show you the progress of stopping the services. When prompted, hit any key to close the window.4.4 Starting the Personal Information Engine (PIE) Services 1. Open the Start Menu. 2. Select All Programs. 3. Select WiderNet eGranary Personal Information Engine. 4. Select Start PIE Services. 5. A Start PIE Services window will appear which will show you the progress of starting the services. When prompted, hit any key to close the window. Page 8 of 13
  9. 9. eGranary Personal Edition Manual4.5 Uninstalling the Personal Information Engine (PIE) Services 1. Open the Start Menu. 2. Select All Programs. 3. Select WiderNet eGranary Personal Information Engine. 4. Select Uninstall PIE. 5. In the Confirm Uninstallation of WiderNet eGranary window click Next. 6. In the Ready to Uninstall window click Next. A progress window will open. It will close when the uninstall finishes. 7. In the Completing the Setup Wizard window click Finish.4.6 Ejecting the eGranary Hard Drive 1. Click the Safely Remove Hardware icon. On the Windows Task Bar across from the Start menu is a Systems tray that displays the time - usually found in the bottom right corner of the screen. In front of the time are small icons. If the Safely Remove Hardware icon is not visible, click the arrow at the edge of the Systems tray to expand it. 2. A list of USB devices including the eGranary hard drive will pop up. Select the eGranary hard drive. 3. If the Stop a hardware device window appears, click OK. 4. If you receive a message that says "The device cannot be stopped right now...", wait a few minutes and try again. 5. If you get a message that says "You may now safely remove...", you have safely ejected the eGranary hard drive. 6. If your eGranary hard drive has a power switch, turn it to the off position. (The switch may be labeled "On" and "Off" or it may use a vertical line "|" for on and an open circle "O" for off.)4.7 Using the eGranary and the InternetYou can browse the eGranary and the Internet at the same time using two different Internet browsers. Werecommend that you use the eGranary Browser for the eGranary and continue to use your favorite Internetbrowser for the Internet.You can connect to the eGranary with any browser. For example, you could use Internet Explorer to accessthe eGranary and Firefox to access the Internet. The browser in use with the eGranary must be configuredspecifically to access the eGranary. The eGranary browser is automatically configured at installation. Youmust manually change the browser proxy settings for other browsers. To configure another web browser towork with the eGranary, see Appendix A - Alternate Browsers (see page 11).4.8 Obtaining Version InformationYou may be asked by technical support for the version of the PIE software you are using. To determine theversion number: 1. Open the Start Menu. 2. Select All Programs. 3. Select WiderNet eGranary Personal Information Engine. Page 9 of 13
  10. 10. eGranary Personal Edition Manual 4. Click About eGranary. A window will open that contains the version information. 5. Click OK to close the window.4.9 Obtaining Maintenance LogsYou should periodically archive and send log files to The WiderNet Project. We recommend every 6 months.If you need assistance, contact WiderNet technical support (see page 6). 1. Stop the PIE services (see page 8). 2. Open the Start menu. 3. Select Computer. 4. Double-click the eGranary. 5. Double-click the folder pie. 6. Double-click the folder data. 7. Double-click the folder logs. 8. Double-click the folder apache. 9. Rename the text file apacheAccess to include the current date (example: apacheAccess10292011) by right-clicking apacheAccess and selecting Rename. 10. E-mail the apacheAccess file with the current date as an attachment to support@widernet.org ( mailto:support@widernet.org). If the file is very large, you may need to compress it using your favorite zip tool. 11. Start the PIE Services (see page 8).4.10 Restoring the Personal Information Engine (PIE) ServicesYou may need to restore the Personal Information Engine to its original configuration at some point. If you have added users to the Community Information Platform and wish to preserve them, contact WiderNet technical support (see page 6). 1. Navigate to the root of the eGranary drive. 2. Rename the folder pie to pie_old. 3. Locate the zipped version of the software in the root directory. The file name will follow the format PIE-2.xx.zip. 4. Unzip PIE-2.xx.zip using your favorite zipping tool. (We recommend 7-Zip.) After you unzip the file, a new folder named pie will be at the root of the drive. 5. Reinstall the PIE following the directions in Installing the eGranary Personal Edition (see page 4). 6. After testing that the new installation functions properly, you can delete the folder pie_old. Page 10 of 13
  11. 11. eGranary Personal Edition Manual5 Appendix A - Alternate Browsers5.1 Changing Browser Proxy SettingsTo configure a web browser to work with the eGranary, you must change proxy server settings. Indicate that you want to use a proxy server. Enter the IP address of the eGranary Digital Library Server for the address. For eGranary PE, this is 127.0.0.1. Enter 9980 for the port.To use the browser to access the internet again, undo the indication that you want to use a proxy server.Because a variety of web browsers are in use, the specific instructions for changing the proxy server settingsmay vary. Below are instructions for changing these settings in versions of Internet Explorer and FireFox,both for Windows. If you are using a different browser or version, check the Help menu for specific detailsregarding setting the proxy server settings.5.2 Setting up Internet Explorer 1. Open Internet Explorer, go to the Tools toolbar and click on Internet Options. 2. Open the Connections tab of the Internet Options window. 3. Click on the LAN Settings button on the bottom of the screen. 4. Under the Proxy Server section of the LAN Settings window, check Use a Proxy Server for your LAN. Page 11 of 13
  12. 12. eGranary Personal Edition Manual 5. Under Address, enter the IP address of the eGranary Digital Library Server and under Port, enter 9980.5.3 Setting up Mozilla Firefox or eGranaryBrowser 1. Open Firefox. For Windows: Click on Options in the Tools menu. For Linux: Click on Preferences in the Edit menu. 2. Under the Advanced tab, select the Network tab and click on Settings... 3. Select the radio button labeled Manual proxy configuration Page 12 of 13
  13. 13. eGranary Personal Edition Manual4. Under HTTP Proxy, enter the IP address of the eGranary Digital Library Server and under Port, enter 9980. Page 13 of 13

×