You are on page 1of 40

EMC GeoDrive for Windows

Version 1.0 SP4

QuickStart
P/N 300-012-497 REV A04

EMC Corporation Corporate Headquarters: Hopkinton, MA 01748-9103


1-508-435-1000 www.EMC.com

Copyright 2011-2012 EMC Corporation. All rights reserved. Published March, 2012 EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up-to-date regulatory document for your product line, go to the Technical Documentation and Advisories section on EMC Powerlink. For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. All other trademarks used herein are the property of their respective owners.

EMC GeoDrive for Windows Quick Start Guide

Contents

Preface
Introduction ......................................................................................... 6

Chapter 1

Getting Started with EMC GeoDrive


Prerequisites....................................................................................... Step 1: Downloading and installing GeoDrive software ............ Step 2: Configuring the GeoDrive folder....................................... Step 3: Configuring the Atmos cloud storage system ................. Step 4: Testing your configuration.................................................. Step 5: Using GeoDrive .................................................................... Troubleshooting your GeoDrive..................................................... Upgrading GeoDrive........................................................................ Uninstalling GeoDrive ..................................................................... File Recovery ..................................................................................... Configuring SSL certificates ............................................................ 10 12 16 21 27 29 30 33 34 36 37

EMC GeoDrive for Windows Quick Start Guide

Contents

EMC GeoDrive for Windows Quick Start Guide

Preface

As part of an effort to improve and enhance the performance and capabilities of its product lines, EMC periodically releases revisions of its hardware and software. Therefore, some functions described in this document may not be supported by all versions of the software or hardware currently in use. If a product does not function properly or does not function as described in this document, please contact your EMC representative. This document was accurate as of the time of publication. However, as information is added, new versions of this document may be released to the EMC Powerlink website. Check the Powerlink website to ensure that you are using the latest version of this document.

EMC GeoDrive for Windows Quick Start Guide

Preface

Introduction
Audience This guide is a reference for users installing and configuring GeoDrive software on their Windows computer for access to the Atmos cloud.

Related documentation
The EMC GeoDrive documentation set consists of the following EMC publications:

EMC GeoDrive for Windows Release Notes EMC GeoDrive for Windows Quick Start Guide

Conventions used in this document EMC uses the following conventions for special notices:
Note: A note presents information that is important, but not hazard-related.

A caution contains information essential to avoid data loss or damage to the system or equipment. IMPORTANT An important notice contains information essential to software or hardware operation.

EMC GeoDrive for Windows Quick Start Guide

Preface

Typographical conventions EMC uses the following type style conventions in this document. Normal
Used in running (nonprocedural) text for: Names of interface elements (such as names of windows, dialog boxes, buttons, fields, and menus) Names of resources, attributes, pools, Boolean expressions, buttons, DQL statements, keywords, clauses, environment variables, functions, utilities URLs, pathnames, filenames, directory names, computer names, filenames, links, groups, service keys, file systems, notifications Used in running (nonprocedural) text for: Names of commands, daemons, options, programs, processes, services, applications, utilities, kernels, notifications, system calls, man pages Used in procedures for: Names of interface elements (such as names of windows, dialog boxes, buttons, fields, and menus) What user specifically selects, clicks, presses, or types

Bold

Italic

Used in all text (including procedures) for: Full titles of publications referenced in text Emphasis (for example a new term) Variables Used for: System output, such as an error message or script URLs, complete paths, filenames, prompts, and syntax when shown outside of running text Used for: Specific user input (such as commands) Used in procedures for: Variables on command line User input variables Angle brackets enclose parameter or variable values supplied by the user Square brackets enclose optional values Vertical bar indicates alternate selections - the bar means or Braces indicate content that you must specify (that is, x or y or z) Ellipses indicate nonessential information omitted from the example

Courier

Courier bold Courier italic

<> [] | {} ...

EMC GeoDrive for Windows Quick Start Guide

Preface

Where to get help EMC support, product, and licensing information can be obtained as follows. Product information For documentation, release notes, software updates, or for information about EMC products, licensing, and service, go to the EMC Powerlink website (registration required) at:
http://Powerlink.EMC.com

Technical support For technical support, go to Powerlink and choose Support. On the Support page, you will see several options, including one for making a service request. Note that to open a service request, you must have a valid support agreement. Please contact your EMC sales representative for details about obtaining a valid support agreement or with questions about your account. Your comments Your suggestions will help us continue to improve the accuracy, organization, and overall quality of the user publications. Please send your opinions of this document to:
techpubcomments@emc.com

EMC GeoDrive for Windows Quick Start Guide

1
Getting Started with EMC GeoDrive

EMC GeoDrive provides a local file system interface through which you can store and retrieve files on an EMC Atmos Cloud server. This lets you quickly and easily store and retrieve files (such as, pictures, movies, documents, and so on) in the cloud using the same applications and tools you use today. Follow the steps in this document to install and configure GeoDrive software on your Windows computer:

Prerequisites........................................................................................ Step 1: Downloading and installing GeoDrive software.............. Step 2: Configuring the GeoDrive folder........................................ Step 3: Configuring the Atmos cloud storage system .................. Step 4: Testing your configuration................................................... Step 5: Using GeoDrive ..................................................................... Troubleshooting your GeoDrive ...................................................... Upgrading GeoDrive......................................................................... Uninstalling GeoDrive ...................................................................... File Recovery ...................................................................................... Configuring SSL certificates .............................................................

10 12 16 21 27 29 30 33 34 36 37

Getting Started with EMC GeoDrive

Getting Started with EMC GeoDrive

Prerequisites
Before you install GeoDrive, make sure that your computer meets these minimum requirements:

Your Windows computer is running one of these operating systems: Windows XP SP3 (32 bit only) Windows Server 2003 SP2 or later (x64 and x86) Windows Vista SP1 or later (x64 and x86) Windows Server 2008 (x64 and x86) Windows 7 (x64 and x86) Windows Server 2008 R2 (x64)

Note: Double-click the My Computer icon on your desktop and select Help->About Windows to display the operating system and service pack (SP) of your computer if you are unsure about which version of Windows your computer is running.

You have the correct version of GeoDrive software (either 32-bit or 64-bit) based on your computer operating system: GeoDrive.1.0.SP4.exe (32-bit) GeoDrive.1.0.SP4_x64.exe (64-bit)

You have administrative privileges on the Windows computer where you want to install GeoDrive. Your Service Provider gives you with the following information: An Atmos subtenant ID, UID, and shared secret. One or more IP addresses or resolvable hostnames for the Atmos system you will access. The proxy server IP address and port, and a username and password if you are required to use a proxy server by your Service Provider.

10

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

Best Practices
This section provides recommendations for using GeoDrive in your home or office environment.

GeoDrive is optimized for sending small to medium size files (of less than 4 Gigabytes) to the cloud. Placing large files in the cloud may require very long upload and download times based on your network speed. GeoDrive can be installed on multiple systems using the same credentials. This means that the files you upload to the cloud can be viewed (and edited or deleted) on any system with the same GeoDrive credentials. As a best practice, manage your cloud environment so that users are not accessing the same files at the same time. This reduces the risk of one user overwriting another user's changes. Exclude GeoDrive from your Windows backups. Attempting to run applications such as .exe (executable) files from within the GeoDrive is not supported. Pointing a database/SQL application to a GeoDrive is not supported. Do not enable the Windows Indexing Service on a GeoDrive folder.

Prerequisites

11

Getting Started with EMC GeoDrive

Step 1: Downloading and installing GeoDrive software


1. Contact your Service Provider to obtain the correct version of GeoDrive software to install. 2. Download and save the GeoDrive software to a folder on your Windows computer. 3. Using Windows explorer, navigate to the location of the GeoDrive executable, then double-click it to start the GeoDrive setup wizard. 4. GeoDrive prepares the setup wizard.

5. Click Next. You are asked to accept the license agreement.

12

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

6. To continue the GeoDrive setup, choose I accept the terms of the license agreement, then click Next. The setup wizard exits if you do not accept the license agreement. GeoDrive requires two folders on your computer.

Step 1: Downloading and installing GeoDrive software

13

Getting Started with EMC GeoDrive

7. Accept the defaults or fill in the fields as follows, then click Next:
Table 1

GeoDrive folder descriptions Field Install EMC Atmos GeoDrive to: What to enter The path to the local Windows folder where you install the GeoDrive software. Click Change to select a different location. The path to the local Windows folder that contains file used internally by GeoDrive and also used as the default directory for data copied to and from Atmos. Click Change to select a different location.

Data Directory:

The Installation screen appears.

8. Click Install. The wizard begins installation of GeoDrive. This may take several minutes. The Setup Wizard Completed screen appears. 9. Click Finish.

14

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

10. A GeoDrive Console (and the GeoDrive Parameters dialog) should open, if not, click Start > Programs > EMC Atmos GeoDrive to open the Console on your desktop. Proceed to Step 2: Configuring the GeoDrive folder.

Step 1: Downloading and installing GeoDrive software

15

Getting Started with EMC GeoDrive

Step 2: Configuring the GeoDrive folder


The next step in setting up GeoDrive is to establish a connection between GeoDrive and the Atmos cloud storage system by mapping a drive on your computer. GeoDrive uses a mapped drive so that a cloud connection is established whenever the computer is turned on. 1. The GeoDrive Parameters dialog should be open on your desktop, if not, click Add GeoDrive from the GeoDrive Console (Start > Programs > EMC Atmos GeoDrive). This screen allows you to select an unused drive letter to assign to GeoDrive, and provides an advanced options section that allows you to fine tune the GeoDrive settings for better performance. A description of the available options is provided in Table 2 on page 17.
Note: Use the default GeoDrive parameter settings unless your Service Provider recommends otherwise.

2. Click Next to accept the default GeoDrive parameters and then skip to Step 6 on page 18 or proceed to step 3 to customize the parameters for your system if required.

16

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

3. Fill in the fields as follows based on recommendations from your Service Provider:
Table 2

GeoDrive parameter options Field GeoDrive Description What to do. . . Select any available Windows drive letter from the dropdown window to use as the GeoDrive. Enter a description that will help you remember this drives use (Cloud_Drive for example).

Local Storage Options Mirror Mode GeoDrive can operate in either Mirror Mode or push-to-cloud (stub) mode. Selecting this box causes GeoDrive to operate in Mirror Mode. Mirror Mode: The files are stored on both the local system and the Atmos cloud. This mode requires that the local file system have more available space. Push-to-cloud mode: This is the default mode. When Mirror Mode is not selected, the files you placed on the GeoDrive are pushed to the Atmos cloud after a period of inactivity and replaced with a shortcut (called a stub) on the local machine that knows how to retrieve the data from the cloud. This mode does not require as much space on the local file system, but it might mean that there is a delay when accessing files, or that some files might be temporarily unavailable if the network connection to the cloud is lost.

Push-to-Cloud (Stub) Mode

4. Click Next. 5. The Settings dialog appears. Proceed to step 6 on page 18 to configure the cloud host for this GeoDrive.

Step 2: Configuring the GeoDrive folder

17

Getting Started with EMC GeoDrive

6. Complete the fields as follows:


Table 3

Host settings description What to supply. . . Displays the drive that you mapped in the previous steps. Select the cloud host to which to map this GeoDrive. The dropdown menu displays the hosts that you configure in Step 3: Configuring the Atmos cloud storage system. By default this is populated with the User ID (UID) from your Service Provider that you entered when you configured the cloud host. If you have multiple systems using GeoDrive, all writing data to the same Atmos system under the same UID, you might want to customize this name to differentiate between your computers (laptop or workstation, for example) Check this box if you intend to encrypt your files. You will need to provide a passphrase in the Encryption Passphrase field (see below).

Field GeoDrive Host Remote Root Directory

Encrypt Files

18

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

Table 3

Host settings description (continued) What to supply. . . Leave this field blank unless you intend to encrypt your files. If you choose to encrypt your files, the passphrase must be between 3 and 64 characters and cannot contain spaces. Note: This phrase cannot be modified once created and must be the same on each system accessing the cloud with the same user ID (UID). Write this phrase down and place it in a secure location for use if you ever need to add GeoDrive to another system. You will not be able to access your files without it. Use the slide bar to control the amount of compression. File compression may save space but it may also increase the processing time per file. If encryption is also selected, the compression is performed before the data is encrypted. By default, the compression level is set to 1, on a scale of 0 (no compression) to 8 (maximum compression).

Field Encryption Passphrase

Compress Files

7. In some situations your Service Provider may suggest that you modify GeoDrive settings that control the frequency and speed at which files are transferred to the cloud. If you do not need to modify the advanced settings, click Next and proceed to step 6 on page 18. If you do need to check or modify these settings, click Advanced. The Advanced Options dialog displays.

Step 2: Configuring the GeoDrive folder

19

Getting Started with EMC GeoDrive

Your Service Provider can provide guidance on changing these values as required. The following table describes each field and its use:
Table 4

Advanced settings description Field Description

Local Cache Location Specifies the location on the local machine where the local files are stored. This folder is synchronized with the cloud. If the GeoDrive is configured for Mirror Mode this location requires enough space to support the set of files you want to store in the Atmos cloud. The default location for this folder varies based on your Windows operating system. Modify Wait Time Delay after file is closed before uploading it to the cloud. Default = 1 minute. Specifies the amount of time that GeoDrive waits after you modify a local file before it updates the cloud with your changes. Access Wait Time How long to wait before replacing local file with a stub (not used in Mirror Mode). Default = 1 day. Specifies the amount of time after a file is last accessed before it is replaced with a stub on the local file system. Access Wait TIme must be greater than Modify Wait Time. This setting is ignored if the GeoDrive is in Mirror Mode. Update Wait Time How long to wait before checking the cloud for updated content. Default = 1 day. Specifies the amount of time that the GeoDrive waits to check if a file or directory was updated on the cloud via another source. If a change or addition is found in Atmos that does not exist locally, the local information is updated. Modifying this setting may be useful if you are accessing Atmos via different systems or access methods, but is not applicable to a single user using a single computer to access their data. Open Wait Time Maximum time to wait for a file to close before uploading a copy to the cloud. Default = 1 hour. Specifies the maximum time to wait for a file to close before GeoDrive uploads a copy of the file to the cloud. If the file does not close within this time period, the open file is uploaded to the cloud.

8. If you are accepting the defaults, click Cancel to exit the dialog without making changes or click OK after making changes and then click Next. 9. Click Finish and proceed to Step 3: Configuring the Atmos cloud storage system.
20

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

Step 3: Configuring the Atmos cloud storage system


1. Launch GeoDrive from the Windows Start Menu: Start > Programs > EMC Atmos GeoDrive

2. Begin configuring the connection to the cloud by clicking Atmos Hosts.

Step 3: Configuring the Atmos cloud storage system

21

Getting Started with EMC GeoDrive

An empty Atmos Hosts dialog displays:

3. Click Add to access the Server Details dialog.

22

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

4. Fill in the fields as follows:


Table 5

Server details description Field Atmos Server Name Description Subtenant ID User ID Shared Secret Enable Throttling What to do. . . Enter a descriptive name to help you identify which cloud host this configuration represents. Enter an optional description of the cloud host. Enter the 32 character Subtenant ID supplied by your Service Provider. Enter the User ID (UID) supplied by your Service Provider. Enter the 29 character shared secret supplied by your Service Provider. (Optional) Throttling limits the speed at which data is sent to and from the cloud. If throttling is disabled, data is sent and received as quickly as possible. You may want to enable throttling if GeoDrive is using all available bandwidth and Internet access for other applications becomes too slow. If you enabled throttling, enter an upper limit to the download speed in kilobytes per second. If you enabled throttling, enter an upper limit to the upload speed in kilobytes per second. Choose either HTTPS or HTTP from the dropdown. Your Service Provider will tell you which one to select. (Optional) Allows you to configure which ports are used for HTTP / HTTPS instead of utilizing the default settings (HTTP = 80; HTTPS = 443). Typically, this field remains blank. If your Service Provider supplied you with proxy server information, click this button to configure GeoDrive to communicate with the cloud through a proxy server. The proxy server IP address and port, and the username and password that you use to access the network are required. If you currently are using a proxy server, click Import to import the proxy server address and port information from your system. You will still need to provide your username and password.

Download Throttle (Kbytes/sec) Upload Throttle (Kbytes/sec) Use HTTPS or HTTP Port Override

Configure Proxy Server

Step 3: Configuring the Atmos cloud storage system

23

Getting Started with EMC GeoDrive

Table 5

Server details description Field Host Name/IP What to do. . . Enter one or more IP addresses or resolvable host names of the target Atmos system. If HTTPS is selected this field must contain a host name, not an IP address. This information is supplied by your Service Provider. Click <<Add. Use the Test button to test the connection between the GeoDrive host and the cloud. In the case of HTTPS, if the Atmos certificate is not signed by a well-known Certificate Authority, clicking Test presents the certificate details to the user and gives the user the option of installing that certificate into the Trusted Certificate Authority store. After installing the certificate, clicking Test again should succeed. The user should click Install only if the certificate indicates it is the correct server. If you get an error message, proceed to Troubleshooting your GeoDrive on page 30.

Test

Your server details dialog should look similar to the figure below (except that it will show the values you supplied):

24

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

5. Click OK. The entry you just completed now displays in the Atmos Hosts dialog.

6. Verify that the values are accurate, highlight the entry and then click Select. 7. The Settings dialog reappears. Use the dropdown menu to select the correct host.

Step 3: Configuring the Atmos cloud storage system

25

Getting Started with EMC GeoDrive

Repeat this procedure for each cloud host that your Service Provider instructed you to set up. For example, if you have multiple accounts with your cloud storage provider, you may have to create more than one cloud host definition for the same set of servers, each with a different UID and Shared Secret. If so, this information is provided by your Service Provider. 8. Optionally you can add a shortcut to your desktop for the GeoDrive folder. This is the location where you place and retrieve the files you send to the cloud. Add a shortcut as follows: 1. From your desktop or Start menu, click My Computer, right-click on the drive you assigned as your GeoDrive, and select Create Shortcut. 2. A dialog opens that asks if you want to place the shortcut on your desktop, click Yes. You can now click on the desktop shortcut to open the drive folder where you place the files you send to the cloud. 9. Proceed to Step 4: Testing your configuration on page 27 to test the connection between GeoDrive and the cloud.

26

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

Step 4: Testing your configuration


GeoDrive should now be configured and connected to the cloud. The final step in the setup process is to test the configuration to ensure that it is functioning correctly. Open your GeoDrive application by selecting Start > Programs > EMC Atmos GeoDrive. GeoDrive has an active connection to the cloud host if the icon to the left of the cloud host description is green. If the icon is red there is an issue with the connection between your GeoDrive and the cloud host. The Troubleshooting your GeoDrive section at the end of this document will help you determine the cause of the problem. Switch to the Status tab on your GeoDrive Console and select the Info and Activity Window checkboxes. These allow you to monitor the status and performance of GeoDrive during your initial tests.

Step 4: Testing your configuration

27

Getting Started with EMC GeoDrive

Complete the following simple tests to verify your configuration: 1. Open your GeoDrive (from My Computer or click the GeoDrive shortcut on your desktop if you created a shortcut to the drive). 2. Copy several files into the folder. Based on your settings and connection speed you should see a blue bar in the Bytes Sent graph in the GeoDrive Activity window and eventually the files you placed in the GeoDrive folder should appear in the GeoDrive Console Message window as uploaded to the cloud.

3. If the upload was successful, the GeoDrive is functioning correctly. If the upload was unsuccessful, proceed to Troubleshooting your GeoDrive on page 30.

28

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

Step 5: Using GeoDrive


GeoDrive is extremely easy to use on a day-to-day basis. Use the following steps to send files to the cloud: 1. At the beginning of your session (for example when you start or reboot your computer), open your GeoDrive Console (Start > Programs > EMC Atmos GeoDrive). 2. Check to make sure the host icon is green, signifying that GeoDrive has a connection to the cloud. 3. Double-click on your cloud drive desktop shortcut icon to open the GeoDrive folder containing files you are sending to the cloud. 4. Copy files into this folder to send to the cloud just as with any other location. Based on your GeoDrive settings, you should see the files appear as uploaded in the message pane of the GeoDrive Console. This may take an extended period of time if you set your GeoDrive to only update the cloud infrequently (refer to Table 4 on page 20). 5. You can send files to the cloud, modify, and rename files, and have files you sent to the cloud from another computer (but with the same user ID) appear in your GeoDrive folder.

Step 5: Using GeoDrive

29

Getting Started with EMC GeoDrive

Troubleshooting your GeoDrive


If you are experiencing issues with installing GeoDrive or with transferring data to and from the cloud, use this section to resolve common problems experienced by GeoDrive users before contacting your Service Provider. Check the status and performance of your cloud connection by opening the GeoDrive application at Start > Programs > EMC Atmos GeoDrive. You should see a green icon and status messages that detail the startup of GeoDrive when you started your computer, recent file transfers to the cloud, etc. If the Atmos Host icon is red, it means that GeoDrive is not able to establish a connection to the cloud host. Select the entry by clicking on it. You will see an error code, time of disconnect and a reason in the pane to the right. You can also double-click on the error message in the lower pane to get more details.

30

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

Table 6 details common GeoDrive issues and their possible resolution.


Table 6

GeoDrive issues and their resolution Cause Possible Resolution Check the cloud host settings (subtenant ID, user ID, IP address, and shared secret) to make sure they are correct (see Step 3: Configuring the Atmos cloud storage system on page 21)

GeoDrive Issue

Clicking the TEST button Incorrect server configuration during server configuration settings generates an error message.

Incorrect proxy server settings. If your Service Provider required you to use a proxy server, verify the proxy server settings (refer to Table 5 on page 23 for a description of the settings). You are using HTTPS and GeoDrive and the Atmos host do not share a valid SSL certificate. Red Icon No network connection. Missing or incorrect GeoDrive configuration settings. Refer to Configuring SSL certificates on page 37.

GeoDrive does not have a connection to the cloud. Check your network connectivity (is your browser working?). Check the cloud host settings (subtenant ID, user ID, IP address, and shared secret) to make sure they are correct (see Step 3: Configuring the Atmos cloud storage system on page 21). For example, check for an extra space after the subtenant ID or shared secret. If your computer has the incorrect time, it will not be able to synchronize with the cloud host. Contact your Service Provider to resolve this issue. GeoDrive will continue to attempt to upload the file on the Atmos host. If it is unable to complete the upload, eventually a File cannot be uploaded to cloud server. Upload retries are exhausted message displays (refer to the following row in this table for details). This may be a temporary cloud host issue. Restart the Atmos GeoDrive Service (Control Panel > Admin Tools > Services, right click Atmos GeoDrive Service, and select Restart). If GeoDrive again generates this error, contact your Service Provider to resolve this issue. Close the GeoDrive folder and reopen it. Check the advanced settings (refer toTable 4 on page 20). The how long to wait before checking the cloud for updated content setting may need to be set to a lower time period (by default it is 1 day).

The computer does not have the correct time. GeoDrive status pane displays error creating file in Atmos server. There may be a temporary issue with the GeoDrive connection to the Atmos host or with the Atmos host itself. GeoDrives repeated attempts to upload files to the cloud failed.

GeoDrive status pane displays File cannot be uploaded to cloud server. Upload retries are exhausted. You do not see files in your GeoDrive that were uploaded to the Cloud via another GeoDrive, even after waiting an extended time period.

The GeoDrive folder has not refreshed. The default update time is set too high.

Troubleshooting your GeoDrive

31

Getting Started with EMC GeoDrive

Table 6

GeoDrive issues and their resolution (continued) Cause Your cloud host does not support unicode characters in folder or file names. Delay after file is closed before uploading to the cloud setting is too high a value. You created an empty folder and never placed a file in it. The F5 command refreshes files in folders on your local drive, but does not refresh the GeoDrive files stored in the cloud. A file originally saved as a stub in the GeoDrive folder will not appear as a local copy until the file is accessed again. GeoDrive displays the original size of the files, even after they are compressed, encrypted, and stubbed. The GeoDrive service may have failed to start or is stopped. Possible Resolution Check with your service provider to ensure that your cloud host supports unicode characters. If not, use only standard Latin characters in your folder and filenames. Refer to the EMC GeoDrive Release Notes for supported platforms. Check the advanced settings (refer to Table 4 on page 20). The delay after file is closed before uploading to the cloud setting may be set higher than you desire. GeoDrive discards empty folders after a period of time. Placing a file inside a folder ensures that the folder will be updated to the Atmos cloud and not deleted. Close and reopen the GeoDrive folder to refresh the view.

GeoDrive Issue Files in GeoDrive are not updating to the cloud.

Files placed on your GeoDrive are not on your Atmos server. Folders created in GeoDrive disappear. You clicked F5 (refresh) but your GeoDrive view did not refresh.

You changed your configuration setting to Mirror mode but the files are still showing as stubs. Files sizes displayed in GeoDrive stay the same even if you compress the files. Your GeoDrive Console is running, but you don't see your GeoDrive listed and none of the icons are active.

After enabling mirror mode on the GeoDrive folder, pre-existing files that were stubbed will not be mirrored until they are accessed again. You can access a file by double-clicking on the stub to open it. The file is now saved in mirror mode. This is normal behavior for GeoDrive. You always see the original size of the file, even if it was compressed, or if a stub replaced the file in the GeoDrive folder (refer to Table 2 on page 17). Restart the Atmos GeoDrive Service (Control Panel > Admin Tools > Services, right click Atmos GeoDrive Service, and select Restart).

32

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

Upgrading GeoDrive
Use the following procedure to upgrade GeoDrive. 1. Ensure that the GeoDrive console and the GeoDrive Activity Monitor are closed on the computer being upgraded and that all open files in the GeoDrive are closed.
Note: A reboot of the system may be required if GeoDrive is not closed before running the upgrade wizard.

2. Save the new GeoDrive executable file (.exe) to your computer. 3. Double-click the GeoDrive executable file. The upgrade wizard starts. 4. Follow the prompts to complete the upgrade. 5. Windows may require a reboot after the upgrade completes. Once the upgrade completes, your cloud access is restored with the same configuration settings as your previous GeoDrive version.

Upgrading GeoDrive

33

Getting Started with EMC GeoDrive

Uninstalling GeoDrive
Before uninstalling GeoDrive, you must ensure that any files sent to the cloud are properly saved so you can access them after the application is uninstalled. These files can be saved either locally or in the cloud if you have an alternate method for accessing them (from another computer running GeoDrive for example).

Saving files to the cloud before uninstalling GeoDrive


If you are uninstalling GeoDrive but still want to maintain your files in the cloud (and you have an alternative way to access them), you must ensure that all files in the GeoDrive are updated to the cloud before uninstalling the application. 1. Open your GeoDrive Console (Start > Programs > EMC Atmos GeoDrive). 2. From the GeoDrive Console, right-click the first drive in the Configuration window and select Delete. GeoDrive checks to make sure that all files on that drive are written to the cloud before deleting it. 3. Complete this process for each drive listed in the window. 4. Proceed to the Uninstalling GeoDrive section to remove GeoDrive from your computer.

Saving files to a local system before uninstalling GeoDrive


If you choose to uninstall GeoDrive and will not have access to the cloud after the uninstall, you must first ensure that all files you placed in the Atmos cloud are safely stored on a local drive. Open each GeoDrive folder and copy the files to a location on your system (you can simply drag and drop the files from the GeoDrive folder to a new folder on your system). This may take a considerable time if you have a large number of files saved to the cloud.

34

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

Uninstalling GeoDrive
Once you have saved your files, complete the following steps to uninstall GeoDrive: 1. Open Add/Remove Programs (Start > Settings > Control Panel> Add or Remove Programs). 2. Select EMC Atmos GeoDrive and click Remove. The program is removed from your computer. 3. Close Add or Remove Programs and the Control Panel. 4. Delete the shortcut to the GeoDrive folder from your desktop (if you created one) by dragging it to your Recycle folder. 5. Windows may require a reboot after the uninstall completes.

Uninstalling GeoDrive

35

Getting Started with EMC GeoDrive

File Recovery
This section provides steps for recovering the files you placed in the cloud if your computer fails and you can no longer access your GeoDrive. If your computer fails you can easily recover your files by re-installing GeoDrive on another system using exactly the same credentials you used in the initial installation. Those credentials were provided by your Service Provider and include:

SubtenantID Host User ID (UID) Shared Secret Atmos root directory (by default the Host User ID (UID) is used as the name of the directory) Host names or IP address(es) The exact passphrase you created if you implemented encryption when you installed GeoDrive The Atmos root directory if you changed it from the default setting that used the host UID as the name of the directory.

In addition you need the following:

Proceed with the new GeoDrive installation starting with Prerequisites on page 10. Once you complete the installation, you will have full access to the files you placed in the cloud.

36

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

Configuring SSL certificates


In some situations, your service provider may require you to enable GeoDrive to use SSL (HTTPS) to communicate with your Atmos server using a self-created (non-authoritative) certificate. During server configuration you configured GeoDrive to communicate with the host using SSL by selecting HTTPS and entering the host name (not IP address) supplied by your Service Provider. If the server details are entered correctly, you should be able to click Test and receive a success message which means that GeoDrive and the Atmos server are communicating with each other. If not, verify your configuration settings and retry Test.

Configuring SSL certificates

37

Getting Started with EMC GeoDrive

If you receive a 12175 error - A security error has occurred, use Table 7 to determine the resolution associated with the specific error message.
Table 7

GeoDrive 12175 security error messages Resolution Re-try the Test, and if it fails, contact your Service Provider. Contact your Service Provider. Contact your Service Provider. Use the procedure outlined in Install the Atmos certificate below. Verify the host name you entered in the host/IP field.

Error message Certification revocation checking has been enabled, but the revocation check failed to verify whether a certificate has been revoked. The server used to check for revocation might be unreachable. SSL certificate is invalid. SSL certificate was revoked. The function is unfamiliar with the Certificate Authority that generated the server's certificate. SSL certificate common name (host name field) is incorrect, for example, if you entered www.microsoft.com and the common name on the certificate says www.msn.com. SSL certificate date that was received from the server is bad. The certificate is expired. The application experienced an internal error loading the SSL libraries.

Contact your Service Provider. Restart GeoDrive.

Install the Atmos certificate


If you receive a 12175 security error message that states: The function is unfamiliar with the Certificate Authority that generated the server's certificate, you need to install the Atmos certificate on your GeoDrive host as follows: 1. After you click Test, GeoDrive displays a security error message that also provides the certificate details.

38

EMC GeoDrive for Windows Quick Start Guide

Getting Started with EMC GeoDrive

2. Verify that the host name is the same as the name supplied by your Service Provider and that you entered in the host/IP field during server configuration (refer to Table 5 on page 23). If not, confirm the correct name with your Service Provider before continuing. If necessary, delete the incorrect host name, enter the correct name in the Host/IP field, click Add, and then click Test. 3. If a success dialog appears, you have completed this procedure and you should now have connectivity with the cloud (a green icon on the GeoDrive main page). 4. If you receive the same error message again, click Install. GeoDrive installs the SSL certificate on your local system and a success message displays.

5. Click OK; you should now have a secure connection with the Atmos host signified by a green icon on the GeoDrive main page.

Configuring SSL certificates

39

Getting Started with EMC GeoDrive

40

EMC GeoDrive for Windows Quick Start Guide