expo/expoweb
1
0
Fork 0
mirror of https://expo.survex.com/repositories/expoweb/.git/ synced 2025-03-21 01:31:56 +00:00
Code Issues Packages Projects Releases Wiki Activity

Filezilla instructions

Browse Source
This commit is contained in:
Philip Sargent 2018-06-23 01:37:10 +01:00
parent 949bc09f50
commit f30505d053
2 changed files with 51 additions and 76 deletions

18
handbook/fzconfig.html Normal file

@ -0,0 +1,18 @@
<html>
<head>
<title>CUCC Expedition Handbook: Configuring Filezilla</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>
coming soon..
but it's easy, just connect to ftp://expo.survex.com and type in the usual password when a popup asks you. Go to the folder /expofiles/uploads and dump your stuff there. Then ask someone who knows to move it to the right place.
<h2>More expert use</h2>
Instead of putting everything in /expofiles/uploads/ why not do it properly? Go back to the "Uploading Photos" page and find out.
<hr />
</body>
</html>

109
handbook/uploading.html

@ -9,81 +9,53 @@
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>Uploading photos, GPS tracks and files</h1>
<p>The expo website has a big section under 'expofiles' that is not part of the version control repositories. This section describes how to move files into that area. It supports 2 basic methods of upload:
<h2>Simple instructions</h2>
<ol>
<li>Uploading directly to the file store using scp/sftp/rsync</li>
<li>Uploading to a special 'uploads' directory using Webdav</li>
<li>Download and install <b>Filezilla</b>.
</ol>
</p>
<p>In both cases you need to know the expo password.</p>
<p>That's it. There used to be other ways of doing it using browser extensions but these either don't work anymore or the instructions to install them properly have become too complicated.
<p>You do need to know the expo password.</p>
<p>In the former case nothing else needs doing. In the second case an
admin has to move the files to the correct final location, so remember
to tell someone you've done it.</p>
<h3>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.
<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 <a href="fzconfig.html">on this expo handbook page</a>
</ul>
<p>Note that uploading photos does not automatically update the view
at <a href="http://expo.survex.com/photos/">http://expo.survex.com/photos/</a>. An
update script needs to be run. This should run once/day around
midnight UTC, but may be broken. Prod a web admin if nothing is
updated by the next morning..</p>
<h2>Using Filezilla initially</h2>
<p>The expo website has a big section under 'home/expo/expofiles/' that is <b>not under version control</b>. This is dangerous as there is no backup. If you overwrite some important files with your holiday snaps then we are in big trouble. This is where we store big files that we don't want to keep multiple versions of.
<p>On Linux, scp/sftp and rsync are command line tools, but WIndows users may find it much easier to use Filezilla, an FTP client which also works with the sftp protocol. See <a href="https://filezilla-project.org/">Filezilla Project</a>.
<p>So beginners should always put all their files into the folder /home/expo/expofiles/uploads/ and ask an admin to move them to the right place. To make his or her life easier, create your own folder in /expofiles/uploads/ with your name like this: /home/expo/expofiles/uploads/ClarkKent/ and put your files into that folder.
<h2>Installing FireFTP</h2>
<p>Works on Windows, Mac, Linux, Android. This is a firefox browser plugin that enables FTP/SFTP uploads using just your browser.</p>
<ol>
<li>Install the firefox web browser. You can download it and find
instructions here: <a href="http://www.mozilla.org/en-US/">http://www.mozilla.org/en-US/</a></li>
<li>Install the FireFTP addon. You can download this from <a href="https://addons.mozilla.org/en-US/firefox/addon/fireftp/">addons.mozilla.org</a>
</li>
<li>Restart firefox</li>
<li>Start FireFTP (its hidden in the tools menu under 'web developer'.</li>
<li>FireFTP will open in a new tab. You should have 2 largish squares
of files, one showing what should look like very familiar files and
folders from your computer on the left and one which is completely greyed
out on the right.</li>
<li>Select 'create an account' in the top left hand corner, a box full
of fields requiring information should appear.</li>
<li>Under the main tab you can set the account name to be whatever you
like, I suggest expo. Set the host to be: "expo.survex.com".
The login is expo and the password is the usual password (email me if you
cant remember). Under the connection tab you need to set the security to
be sftp. Everything else should be left alone.</li>
<li>Press connect and the expo websites files should magically appear in
the right hand side of the screen.</li>
<li>Upload your desired files to somewhere sensible using the green arrows
on the centre of the screen.</li>
</ol>
<h2>Using scp</h2>
<p>Works on Windows (using winscp), Linux (using scp), and no doubt
mac and android with other tools. If you have Windows 10 and <a href="https://msdn.microsoft.com/en-gb/commandline/wsl/about">have installed bash</a>, then you can use scp.</p>
<p>The above FireFTP is just one example of a tool that does this job</p>
<h2>Experienced users</h2>
<p>OK the person you have been asking to move the files is getting fed up and now wants you to put the uploaded photos in the right place yourself. This is where they go:
<pre>
directory: /home/expo/expofiles/photos/2017/YourName
server: expo.survex.com
user: expo
with the usual expo password
protocol: sftp or scp
directory: /home/expo/expofiles/photos/2018/YourName/
</pre>
Or for GPS tracks, do
<pre>
directory: /home/expo/expofiles/gpslogs/2017/YourName
server: expo.survex.com
user: expo
with the usual expo password
protocol: sftp or scp
directory: /home/expo/expofiles/gpslogs/2018/YourName/
</pre>
<p>Obviously replace 'YourName' with your actual name (no spaces!)</p>
<p>Obviously replace 'YourName' with your actual name (no spaces!). It is important that you get this right as this specific way of writing your name is standardised across the website. Use the year that the photo was taken or the GPStrack logged.</p>
<p>Note that uploading photos does not automatically update the view
at <a href="http://expo.survex.com/photos/">http://expo.survex.com/photos/</a> immediately. An update script needs to be run. This should run automatically once/day around midnight UTC (2017 and earlier) or a couple of minutes after you do the upload to the right place (2018 if Wookey gets this sorted out in time) but may be broken. Prod a web admin if nothing is updated by the next morning..</p>
<h2>Experts only</h2>
<p>If you have been using FTP since the last century or are particularly keen on doing everything using the command-line, read on.
<h3>Using scp</h3>
<p>Works on Windows (using winscp), Linux (using scp), and no doubt
mac and android with other tools. If you have Windows 10 and <a href="https://msdn.microsoft.com/en-gb/commandline/wsl/about">have installed bash</a>, then you can use scp.</p>
<p>If you don't have winscp installed you can get it from here:
http://winscp.net/eng/index.php</p>
<a href="http://winscp.net/eng/index.php">http://winscp.net/eng/</a>.</p>
<p>quick start guide:
http://winscp.net/eng/docs/getting_started</p>
@ -91,21 +63,6 @@ http://winscp.net/eng/docs/getting_started</p>
<p>screenshots:
http://winscp.net/eng/docs/screenshots</p>
<h2>Using Webdav</h2>
<p>This method can only upload to one special 'uploads'
directory. Ask someone to move your uploaded files to the final
location. But you may not need any extra software.</p>
<p> This is the upload dir: <tt><a href="/expofiles/uploads/">http://expo.survex.com/expofiles/uploads/</a></tt>
<p>You can use 'open as webfolder' on IE, or install this:
https://addons.mozilla.org/en-US/firefox/addon/open-as-webfolder/ on
firefox, you will get a pop-up box asking for authenticaion for
'expo-uploads'. The user is 'expo', the password is the usual
one. Once done you can just copy files in.</p>
<p>Make a directory like photos/2015/YourName so we know what's
been uploaded.
<p>Command-line people can use the 'cadaver' client which is even
available for windows too:
@ -113,6 +70,6 @@ http://www.phtagr.org/2009/04/01/cadaver-for-windows/</p>
<p>They both give you an 'explorer-like' interface (although winscp can
give you a norton-commander-style 2-pane UI as well).</p>
<hr />
</body>
</html>