3
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
7
<html xmlns="http://www.w3.org/1999/xhtml">
9
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11
<title>ARC Storage Explorer — ARC Graphical Clients 0.4 documentation</title>
13
<link rel="stylesheet" href="_static/default.css" type="text/css" />
14
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
16
<script type="text/javascript">
17
var DOCUMENTATION_OPTIONS = {
20
COLLAPSE_INDEX: false,
25
<script type="text/javascript" src="_static/jquery.js"></script>
26
<script type="text/javascript" src="_static/underscore.js"></script>
27
<script type="text/javascript" src="_static/doctools.js"></script>
28
<link rel="top" title="ARC Graphical Clients 0.4 documentation" href="index.html" />
29
<link rel="prev" title="Introduction" href="introduction.html" />
35
<li class="right" style="margin-right: 10px">
36
<a href="genindex.html" title="General Index"
37
accesskey="I">index</a></li>
39
<a href="introduction.html" title="Introduction"
40
accesskey="P">previous</a> |</li>
41
<li><a href="index.html">ARC Graphical Clients 0.4 documentation</a> »</li>
45
<div class="document">
46
<div class="documentwrapper">
47
<div class="bodywrapper">
50
<div class="section" id="arc-storage-explorer">
51
<h1>ARC Storage Explorer<a class="headerlink" href="#arc-storage-explorer" title="Permalink to this headline">¶</a></h1>
52
<p>The ARC Storage Explorer is a graphical client for access grid storage resources. The client builds on the ARC middlware to support most grid storage protocols. The basic design of the application is a multi-window file browser. Copying between resources are accomplished by drag and drop between file browser windows. To limit and optimise the bandwidth for transferring files, the application implements a file transfer list which can be configured with a maximum number of simultaneous transfers. Most operations in the application are also implemented using threads, to prevent locking up the user interface. However, since many file operations can take a long time to complete some user interface operations disable interaction while operations are ongoing. As the ARC Storage application is a multi-window application, work on different storage resource can be continued by opening an additional storage window.</p>
53
<div class="section" id="starting-arc-storage-explorer">
54
<h2>Starting ARC Storage Explorer<a class="headerlink" href="#starting-arc-storage-explorer" title="Permalink to this headline">¶</a></h2>
55
<p>ARC Storage explorer is started by selecting “Application/Internet/ARC Storage Explorer” in the applications menu in most Linux distributions. The following image shows the start menu in Scientific Linux 6.</p>
56
<img alt="_images/arcstorage-starting-1.png" src="_images/arcstorage-starting-1.png" />
57
<p>When ARC Storage Explorer starts it will check for a valid proxy certificate. If not found it will show a dialog with options for creating a proxy certificate.</p>
59
<div class="section" id="proxy-generation">
60
<h2>Proxy generation<a class="headerlink" href="#proxy-generation" title="Permalink to this headline">¶</a></h2>
61
<p>In the proxy dialog, settings for creating different kind of proxy certificates can be selected. In the first tab “Standard” options for the proxy lifetime and proxy type can be set.</p>
62
<img alt="_images/arcstorage-proxy-1.png" src="_images/arcstorage-proxy-1.png" />
63
<p>By selecting the “Not valid after” shows a calender in which a life time of the proxy can be set. In the “Type” dropdown, the type of proxy can be selected. The default is the option of generating a RFC 3820 proxy. The other option is the generation of a standard GSI proxy.</p>
64
<p>A non-VOMS proxy can be generated at this point by clicking on the “Generate” button in the lower part of the proxy dialog. This brings up a input box asking for the private key passphrase. Enter the passphrase and click OK to generate the proxy certificate.</p>
65
<img alt="_images/arcstorage-proxy-6.png" src="_images/arcstorage-proxy-6.png" />
66
<p>When the proxy has been generated succesfully, a message box is shown confirming this. If proxy generation fails the application exits. A valid proxy certificate is needed for the application to work.</p>
67
<img alt="_images/arcstorage-proxy-7.png" src="_images/arcstorage-proxy-7.png" />
69
<div class="section" id="user-interface">
70
<h2>User interface<a class="headerlink" href="#user-interface" title="Permalink to this headline">¶</a></h2>
71
<p>The user interface of ARC Storage Explorer is designed as a standard file browser. The main window is shown in the following illustration:</p>
72
<img alt="_images/arcstorage-mainwindow-2.png" src="_images/arcstorage-mainwindow-2.png" />
73
<p>The top part of the window contains the menubar, toolbar and URL bar. In the URL-bar a URL can be entered of the the resource to be opened. beneath the toolbar and URL-bar is the path access bar. This toolbar presents the current URL as a set of buttons representing parts of the URL. By clicking on these buttons changes the current working directory to this part of the URL. This enables quick switching of paths without going forward and backwords in the path.</p>
74
<p>Below the access bar, the directory- and file views can be found. The directory view shows a directory representation of the current working directory. This view enables quick navigation in the directory tree. Clicking on a directory in the view will also update the file view.</p>
75
<p>The file view represents a listing of the current working directory. This is also the main view for file operations such as copying, deleting and viewing files and directories.</p>
76
<p>In the lower part of the main window contains a log view. In this view log messages from the lower level middleware (ARC) will be presented. The verbosity of the logging can be changed in the configuration options.</p>
78
<div class="section" id="opening-a-url">
79
<h2>Opening a URL<a class="headerlink" href="#opening-a-url" title="Permalink to this headline">¶</a></h2>
80
<p>To open a URL in the current window, click on the URL-bar and type the desired URL, then click [Enter] to open the selected URL, as shown in the following figure:</p>
81
<img alt="_images/arcstorage-opening-url-2.png" src="_images/arcstorage-opening-url-2.png" />
83
<div class="section" id="open-a-new-browser-window">
84
<h2>Open a new browser window<a class="headerlink" href="#open-a-new-browser-window" title="Permalink to this headline">¶</a></h2>
85
<p>ARC Storage Explorer is a multi-window application. To copy files between different URL:s requires 2 windows to drag between. There are two ways of opening a new browser window:</p>
86
<ol class="arabic simple">
87
<li>Creating a new window with the same URL as the current window.</li>
88
<li>Opening a URL in a new window.</li>
90
<p>Select <strong>File/New window</strong> in the main menu or use the <strong>Ctrl+N</strong> keyboard shortcut, to create a new window with the same URL as the current window.</p>
91
<img alt="_images/arcstorage-new-window-1.png" src="_images/arcstorage-new-window-1.png" />
92
<p>The newly opened window behaves as a separate independent instance of the main window, except that it does not contain a log view. Also, closing the main window will close all opened child windows. ARC Storage Explorer will store the positions of child windows when closing the main window. When the application is opened again the child windows will also be re-opened.</p>
93
<p>The second option of opening a new window is to use the <strong>File/Open new location</strong> menu item or using the <strong>Ctrl-O</strong> keyboard shortcut. This brings up a window asking for a URL for the new window.</p>
94
<img alt="_images/arcstorage-new-window-2.png" src="_images/arcstorage-new-window-2.png" />
96
<div class="section" id="browsing-files">
97
<h2>Browsing files<a class="headerlink" href="#browsing-files" title="Permalink to this headline">¶</a></h2>
98
<p>There are many ways of browsing the file tree in ARC Storage Explorer. The most used way is to use the file list view together with the <strong>Up</strong> button in the menu and toolbar. Double-clicking on a directory in the file view will change current working directory to the selected directory.</p>
99
<img alt="_images/arcstorage-browsing-5.png" src="_images/arcstorage-browsing-5.png" />
100
<p>Using the <strong>Up</strong> button will change the current directory to the parent directory.</p>
101
<p>Another way of navigating the directory hierarchy is to use the folder view in the left side of the window. Here the directory tree can be explored by either clicking on the folders or using the folder expansion arrows to open any underlying folders. The following images shows how to expand folders in the folder view.</p>
103
<img alt="_images/arcstorage-browsing-3.png" src="_images/arcstorage-browsing-3.png" />
104
<p class="caption">Selecting the folder expansion icon.</p>
106
<div class="line-block">
107
<div class="line"><br /></div>
110
<img alt="_images/arcstorage-browsing-4.png" src="_images/arcstorage-browsing-4.png" />
111
<p class="caption">Expanded folder.</p>
114
<div class="section" id="displaying-file-directory-properties">
115
<h2>Displaying file/directory properties<a class="headerlink" href="#displaying-file-directory-properties" title="Permalink to this headline">¶</a></h2>
116
<p>Detailed information on the file can be queried by selecting the file or directory and clicking on the right mouse button and selecting <strong>Properties</strong> in the context menu. This action brings up a property window, displaying the properties (metadata) of the selected file or directory.</p>
118
<img alt="_images/arcstorage-metadata-2.png" src="_images/arcstorage-metadata-2.png" />
119
<p class="caption">Context menu for selected file.</p>
122
<img alt="_images/arcstorage-metadata-1.png" src="_images/arcstorage-metadata-1.png" />
123
<p class="caption">Metadata property window.</p>
126
<div class="section" id="uploading-files">
127
<h2>Uploading files<a class="headerlink" href="#uploading-files" title="Permalink to this headline">¶</a></h2>
128
<p>Uploading files to the current directory is accomplished using the <strong>Transfer/Upload files</strong> menu or using the <strong>Ctrl-U</strong> shortcut. This opens a file selection dialog in which files that should be uploaded can be selected, as shown in the following figure:</p>
130
<img alt="_images/arcstorage-upload-files-1.png" src="_images/arcstorage-upload-files-1.png" />
131
<p class="caption">Upload files selection dialog.</p>
133
<p>The file transfer is started when the <strong>Open</strong> button in chosen in the file selection dialog. The file transfer dialog is shown during the active file transfer. From this dialog all transfers can be monitored and controlled.</p>
135
<div class="section" id="uploading-directories">
136
<h2>Uploading directories<a class="headerlink" href="#uploading-directories" title="Permalink to this headline">¶</a></h2>
137
<p>Uploading directories to the current directory is accomplished using the <strong>Transfer/Upload directory</strong> menu. This opens a directory selection dialog in which directories to be uploaded can be selected.</p>
139
<img alt="_images/arcstorage-upload-directory-1.png" src="_images/arcstorage-upload-directory-1.png" />
140
<p class="caption">Upload directory selection dialog.</p>
142
<div class="admonition note">
143
<p class="first admonition-title">Note</p>
144
<p class="last">It is not efficient to store thousands of small files in a directory structure. To archive and upload a larger directory structure please see the next section on how this can be accomplished.</p>
147
<div class="section" id="upload-directory-as-archive">
148
<h2>Upload directory as archive<a class="headerlink" href="#upload-directory-as-archive" title="Permalink to this headline">¶</a></h2>
149
<p>To be able to upload large directory structures, ARC Storage Explorer, provides a special function for automatically uploading an archived version of a directory. To upload a directory as an archive, select <strong>Transfer/Upload directory as archive</strong>. This will display a directory selection dialog.</p>
151
<img alt="_images/arcstorage-upload-directory-1.png" src="_images/arcstorage-upload-directory-1.png" />
152
<p class="caption">Upload directory as archive selection dialog.</p>
154
<p>When the directory has been selected using the <strong>Open</strong> button, ARC Storage Explorer, will create a compressed tar-archive with the same filename as the selected directory followed by a time stamp.</p>
156
<div class="section" id="download-files-and-directories">
157
<h2>Download files and directories<a class="headerlink" href="#download-files-and-directories" title="Permalink to this headline">¶</a></h2>
158
<p>Files can be downloaded to the local file system using the <strong>Transfer/Download</strong> menu or <strong>Ctrl-D</strong> shortcut. Selecting <strong>Open</strong>, will start the download.</p>
160
<img alt="_images/arcstorage-download-files-1.png" src="_images/arcstorage-download-files-1.png" />
161
<p class="caption">Upload directory as archive selection dialog.</p>
163
<p>The file transfer dialog is shown during the active file transfer. From this dialog all transfers can be monitored and controlled.</p>
165
<div class="section" id="copying-url-links">
166
<h2>Copying URL links<a class="headerlink" href="#copying-url-links" title="Permalink to this headline">¶</a></h2>
167
<p>Sometimes you need to communicate a URL of a specific file. This can be done using the context menu of the file list view. Select a file in the file list and use the right mouse button to show the context menu for the selected file. Select the <strong>Copy URL</strong> item in the menu.</p>
169
<img alt="_images/arcstorage-copy-url-1.png" src="_images/arcstorage-copy-url-1.png" />
170
<p class="caption">Copy full URL of selected file.</p>
172
<p>The URL is now available from the clipboard and can be pasted into other applications.</p>
174
<div class="section" id="creating-directories">
175
<h2>Creating directories<a class="headerlink" href="#creating-directories" title="Permalink to this headline">¶</a></h2>
176
<p>Directories are created in the current directory either by using the toolbar button or the menu option in the file list context menu as shown in the following figures.</p>
178
<img alt="_images/arcstorage-create-dir-1.png" src="_images/arcstorage-create-dir-1.png" />
179
<p class="caption">Creating a directory using the toolbar.</p>
182
<img alt="_images/arcstorage-create-dir-2.png" src="_images/arcstorage-create-dir-2.png" />
183
<p class="caption">Creating a directory using the file view context menu.</p>
185
<p>Next, a dialog is shown asking for the directory name. Enter a name of the new directory and click <strong>Ok</strong> to create it.</p>
187
<img alt="_images/arcstorage-create-dir-3.png" src="_images/arcstorage-create-dir-3.png" />
188
<p class="caption">Dialog for chosing a name for the new directory.</p>
191
<div class="section" id="deleting-files">
192
<h2>Deleting files<a class="headerlink" href="#deleting-files" title="Permalink to this headline">¶</a></h2>
193
<p>Files can be delected by selecting them in the file view and selecting <strong>Edit/Delete</strong> in the menu or using the shortcut <strong>Del</strong>. There is also a option of deleting files from the file view context menu.</p>
194
<div class="admonition note">
195
<p class="first admonition-title">Note</p>
196
<p class="last">Currently, ARC Storage Explorer does not support recursive delete operations. Also, directories must be empty before they can be deleted. The next version of the application will support recursive delete operations.</p>
198
<p>A confirmation dialog is shown before any file or directory will be deleted.</p>
200
<div class="section" id="copying-files">
201
<h2>Copying files<a class="headerlink" href="#copying-files" title="Permalink to this headline">¶</a></h2>
209
<div class="sphinxsidebar">
210
<div class="sphinxsidebarwrapper">
211
<h3><a href="index.html">Table Of Contents</a></h3>
213
<li><a class="reference internal" href="#">ARC Storage Explorer</a><ul>
214
<li><a class="reference internal" href="#starting-arc-storage-explorer">Starting ARC Storage Explorer</a></li>
215
<li><a class="reference internal" href="#proxy-generation">Proxy generation</a></li>
216
<li><a class="reference internal" href="#user-interface">User interface</a></li>
217
<li><a class="reference internal" href="#opening-a-url">Opening a URL</a></li>
218
<li><a class="reference internal" href="#open-a-new-browser-window">Open a new browser window</a></li>
219
<li><a class="reference internal" href="#browsing-files">Browsing files</a></li>
220
<li><a class="reference internal" href="#displaying-file-directory-properties">Displaying file/directory properties</a></li>
221
<li><a class="reference internal" href="#uploading-files">Uploading files</a></li>
222
<li><a class="reference internal" href="#uploading-directories">Uploading directories</a></li>
223
<li><a class="reference internal" href="#upload-directory-as-archive">Upload directory as archive</a></li>
224
<li><a class="reference internal" href="#download-files-and-directories">Download files and directories</a></li>
225
<li><a class="reference internal" href="#copying-url-links">Copying URL links</a></li>
226
<li><a class="reference internal" href="#creating-directories">Creating directories</a></li>
227
<li><a class="reference internal" href="#deleting-files">Deleting files</a></li>
228
<li><a class="reference internal" href="#copying-files">Copying files</a></li>
233
<h4>Previous topic</h4>
234
<p class="topless"><a href="introduction.html"
235
title="previous chapter">Introduction</a></p>
237
<ul class="this-page-menu">
238
<li><a href="_sources/arcstorage-ui.txt"
239
rel="nofollow">Show Source</a></li>
241
<div id="searchbox" style="display: none">
242
<h3>Quick search</h3>
243
<form class="search" action="search.html" method="get">
244
<input type="text" name="q" />
245
<input type="submit" value="Go" />
246
<input type="hidden" name="check_keywords" value="yes" />
247
<input type="hidden" name="area" value="default" />
249
<p class="searchtip" style="font-size: 90%">
250
Enter search terms or a module, class or function name.
253
<script type="text/javascript">$('#searchbox').show(0);</script>
256
<div class="clearer"></div>
258
<div class="related">
261
<li class="right" style="margin-right: 10px">
262
<a href="genindex.html" title="General Index"
265
<a href="introduction.html" title="Introduction"
267
<li><a href="index.html">ARC Graphical Clients 0.4 documentation</a> »</li>
271
© Copyright 2013, Jonas Lindemann.
272
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
b'\\ No newline at end of file'
added
removed
docs/users_guide/build/html/arcstorage-ui.html
