Filezilla extended documentaiton

This commit is contained in:
Philip Sargent
2020-06-01 21:57:07 +01:00
parent c16f65b758
commit 6c77d10400
10 changed files with 23 additions and 79 deletions

View File

@@ -1,72 +0,0 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>CUCC Expedition Handbook: Uploading files</title>
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook - FTP on Android phone</h2>
<h1>Using expo server via FTP or scp or sftp connection</h1>
<h2>Configure connection on Android phone</h2>
<p>SFTP only works if you have <a href="keyexchange.html">key-pair setup</a> set up. But
you can use FTP using this app and this method.
<ul>
<li>Get <a href="https://play.google.com/store/apps/details?id=com.cxinventor.file.explorer&hl=en">'Cx File Explorer'</a>:<br>
<img src="./tutorialimgs/cx_file_explorer.png" height="500">
</li>
<li>Press 'Network':<br>
<img src="./tutorialimgs/cx_network.png" height="500">
</li>
<li>Press 'plus' and 'remote':<br>
<img src="./tutorialimgs/cx_add.png" height="500">
</li>
<li>Press 'FTP':</li>
<li>Fill in the data:<br>
<b>Host:</b><i>expo.survex.com</i><br>
<b>Port:</b><i>21</i><br>
<b>Username:</b><i>expo</i><br>
<b>Password:</b>[contact your expedition leader for password]<br>
<img src="./tutorialimgs/cx_sftp.png" height="500">
</li>
<li>Navigate to the image you want to upload. Then long press to select and press 'copy'<br>
<img src="./tutorialimgs/cx_copy.png" height="500">
</li>
<li>Navigate to expo.survex.com/home/expo/expofiles/uploads to avoid mess ;)<br>
<img src="./tutorialimgs/cx_paste.png" height="500">
</li>
<li>Press 'Paste' to finalize upload.</li>
<li>Done!</li>
</ul>
<hr>
<h2>Configure connection on Windows</h2>
<p>scp only works if you have <a href="keyexchange.html">key-pair setup</a> set up.
<ul>
<li>Get <a href="https://winscp.net/eng/download.php">WinScp</a> application to handle uploads or similar:<br>
<img src="./tutorialimgs/winscp.jpg" width="500"></li>
<li>Click 'New site' in the popup window and fill in the data.<br>
<b>hostname:</b><i>expo.survex.com</i><br>
<b>user:</b><i>expo</i><br>
<b>password:</b>[contact your expedition leader for password]<br>
<img src="./tutorialimgs/newsite.jpg" width="500"></li>
<li>Click 'Login' to connect. You should be able to upload files now.</li>
</ul>
<hr>
<h2>Configure connection on Linux/Unix</h2>
<p>scp only works if you have <a href="keyexchange.html">key-pair setup</a> set up.
<ul>
<li>You can upload files using 'scp' command (to upload localfile.file to expofiles/uploads/remotename.file)<br>
<pre>
scp localfile.file expo@expo.survex.com:~/expofiles/uploads/remotename.file
</pre>
</li>
</ul>
</body>
</html>

View File

@@ -0,0 +1,81 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>CUCC Expedition Handbook: Uploading files/photos</title>
<link rel="stylesheet" type="text/css" href="../css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>Configuring Filezilla to upload photos etc.</h1>
<h3 id="install">Installing Filezilla</h3>
<p>This software works identically on both Windows and Linux.
<p>Filezilla is an "FTP client". This means that it connects to servers using a venerable service called "file transfer protocol" i.e. FTP. It looks a bit like copying files from one folder to another on your desktop but it works between different machines.
<p>These are instructions for installing it on your own machine. But <em>none of this will work</em> until you have also done the <a href="computing/keyexchange.html">key-pair setup</a> procedure.
<ul>
<li> Download the software from here <a href="https://filezilla-project.org/download.php?show_all=1">Filezilla Downloads</a>. ( Obviously Linux users will use their usual package management system instead of doing this download.)
<li>Now install the software following <a href="https://wiki.filezilla-project.org/Client_Installation">the instructions here</a>.
<li>Now configure it to connect to the expo server using the instructions below.
</ul>
<p>Before continuing, make sure that you have the "cavey:beery" password for the expo server. You will need it.
<p>Having installed Filezilla using the <a href="uploading.html#install">installation instructions</a>, you now need to import a configuration file to set it up to use with the public expo server.
<ul>
<li>Download the configuration file <a download href="zilla-uploads.xml">zilla-uploads.xml</a> to your default downloads folder. (Select the option to download it in the pop-up, you don't want to open it in a web browser.)
<li>Open Filezilla and start it running.
<li>Click on the "File" menu item, and select the "Import..." command, this will open a file browser on your local machine
<li>Navigate to your default downloads folder and select the <b>zilla-uploads.xml</b> file.
<li>Now select the "Bookmarks" menu item:
<ul>
<li>At the bottom of the "Bookmarks" drop-down menu you may see "Expo-uploads";
if so, click on it.
<li>If you can't see "Expo-uploads" in that menu
(because this is temporarily broken in version 3.28 of Filezilla),
click on the "File" menu item and select "Site Manager...".
This will display a tree-structured menu in a sub-window and one of the items will be "Expo-uploads". Highlight it
and then click on the "Connect" button at the bottom of the sub-window.
</ul>
<li><img class="onleft" src="pageant-icon.jpg"><strong>Now you may have a problem on a Windows machine.</strong> Even though you have set up the key-exchange process, it may not be working:
<ul>
<li>We have to check that the "Pageant" software is running, see the icon above to the left.
<br>
<li>
On a Windows machine, click in the lower QuickLaunch bar to see what's running. Can you see the Pageant icon? If you put your mouse on it you will see a popup label: "Pageant (PuTTY authentication agent)":<br>
<img display="block" src="pageant-running.jpg">
<li>If you can't see the icon, you will need to start the program from your program menu. The image of the menu below is from a standard Windows 7 menu, if you are using a default Microsoft menu from a more recent version then in won't look like this (unless you are using Classic Shell):<br>
<img display="block" src="pageant-menu.jpg">
<li>Even after you have got Pageant running, it may still need to be told to load the key. It needs to know the private-key (the counterpart to the public-key you shared with the server). Click on the icon in the QuickLaunch toolbar and select "View Keys":<br>
<img display="block" src="pageant-keymenu.jpg">
<li>Now you should see the ssh-rsa key in the list in the next popup window:<br>
<img display="block" src="pageant-keys.jpg"><br>
If this window is empty, click on the"Add key" button which will launch a file explorer, use it to find your *.ppk file. Once selected the string should appear in the Pageant Key List window as shown above.
</ul>
<li>You may now be prompted for the password for the expo server. This is the "cavey:beery" one which we never write down or write in emails. Get it verbally or by phone or secure text message from another expoer. If the key-exchange process is working you won't need the password.
<li>Now check that these Filezilla settings are set correctly:
<ul>
<li>In the "Transfer" menu, ensure that "Preserve timestamps of transferred files" is <em>ticked</em>. Yes,you want to keep the timestamps.
<li>In the "View" menu,ensure that "Synchronized browsing" is <em>NOT ticked</em>.
(This will be greyed-out if you are not actually connected to the remote fileserver.)<br>
It is vital that this is un-ticked because you don't have a complete copy of the entire server website on your laptop, and Filezilla
may try to delete things on the server which you don't have on your laptop, i.e.most of it.
This setting should be fixed automatically in <b>zilla-uploads.xml</b> but we have seen occasions where it
seems to have been re-set somehow.
</ul>
<li>Now you are in and can copy and move files anywhere. But please stick to copying files from your machine (the left window) to the server (the right window) into the /uploads/, /photos/ or /gpslogs/ folders only:<br><br>
<a href="fzexample.png" border=2><img src="fzexample.png" align=center width=65%></a><br>(Click to enlarge).
</ul>
<p>
Once you have uploaded your files, ask someone who knows to move them to the right place.
<h2>More expert use</h2>
Instead of putting everything in /expofiles/uploads/ why not do it properly? Go back to <a href="uploading.html#experienced">uploading instructions - experienced users</a> and find out.
<hr />
Back to <a href="uploading.html">Uploading instructions</a> using Filezilla.
</body>
</html>

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 729 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 10 KiB

View File

@@ -57,7 +57,7 @@ but all the recommended software here is open source (and please don't install p
<p>The list of software:
<ul>
<li><a href="https://git-scm.com/">git</a> - distributed version control system - already installed on Linux probably</li>
<li><a href="../fzconfig.html">Filezilla</a> - ftp GUI software with a configuration file to get to the expo server</li>
<li><a href="fzconfig.html">Filezilla</a> - ftp GUI software with a configuration file to get to the expo server</li>
<li><a href="https://survex.com/download.html">Survex</a>, including the Aven visualisation tool.
<li><a href="https://github.com/CaveSurveying/tunnelx">Tunnel</a>: 2.5D cave drawing program based on Survex-compatible data which can also read PocketTopo files. (Generally called 'tunnel' even though the project and executable is actually 'tunnelx'.)
<li><a href="https://therion.speleo.sk/">Therion</a> - Therion processes survey data and generates maps or 3D models of caves.
@@ -100,7 +100,7 @@ but all the recommended software here is open source (and please don't install p
<li><a href="https://gitforwindows.org/">Git for Windows</a> - not as simple to use as it looks
<li><a href="https://www.gitkraken.com/">GitKraken</a> - Very pretty GUI interface to git, also Linux version.
Times-out for our server unless you buy it but free for university people.
<li><a href="https://www.python.org/downloads/windows/">python for windows</a>. We are using python 2.7 not 3.8.
<li><a href="https://www.python.org/downloads/windows/">python for windows</a>. We are moving from python 2.7 to python 3.8 during June 2020.
<li><a href="https://winscp.net/eng/download.php">WinScp</a> can be used as an alternative to Filezilla if you like.
<li><a href="https://www.java.com/en/">java</a> - needed for GPSprune and CaveConverter. Has to be installed separately on a Windows machine.
<li><a href="https://notepad-plus-plus.org/">Notepad++</a> or any other syntax-highlighting code editor for HTML and python such as <a href="https://www.aptana.com/">Aptana Studio</a>. Configuring these to syntax-highlight .svx files has yet to be done.
@@ -141,7 +141,7 @@ to <a href="https://blog.shvetsov.com/2010/03/making-pageant-automatically-load-
<li><a href="../putty/putty.html">Installing PuTTy on Windows</a>.</li>
<li><a href="../fzconfig.html">Installing Filezilla</a>.</li>
<li><a href="fzconfig.html">Installing Filezilla</a>.</li>
</ul>
<p>When using Windows please, please be <a href="http://expo.survex.com/handbook/survey/getin.htm#filenames">excessively careful when naming files and survex names</a> and be <a href="manual.html#quickstart">exceptionally careful when using rsync</a>.