diff options
Diffstat (limited to 'doc/en/remote-connections.docbook')
| -rw-r--r-- | doc/en/remote-connections.docbook | 267 |
1 files changed, 267 insertions, 0 deletions
diff --git a/doc/en/remote-connections.docbook b/doc/en/remote-connections.docbook new file mode 100644 index 0000000..5feb168 --- /dev/null +++ b/doc/en/remote-connections.docbook @@ -0,0 +1,267 @@ +<sect1 id="remote-connections"> + <title>Remote Connections</title> + <indexterm> + <primary>Remote Connections</primary> + </indexterm> + <para>Remote connections are easily made by typing the + &URL; in the + <link linkend="list_panel">Location Toolbar</link>; these are + actually &kioslaves1-url;. Please note that the + &krusader; panel does not support all + &kioslaves2-url; ⪚ + <command>http://</command> will not work in the panel, but will + work in the + <link linkend="krviewer">viewer</link>. Some examples:</para> + <itemizedlist> + <listitem> + <para> + <userinput> + <command>ftp://</command><replaceable>public.ftpserver.org/directory/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>fish://</command><replaceable>username@hostname/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>sftp://</command><replaceable>username:password@sftp.foo.org/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>ftp://</command><replaceable>username@my.server.org:21/directory/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>smb://</command><replaceable>username:password@server/share</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>ftp://</command><replaceable>username@proxyusername:password@proxipassword@hostname/directory</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>nfs://</command><replaceable><host>:<port><url-path></replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>webdav://</command><replaceable>www.server.com/path/</replaceable> + </userinput> + </para> + </listitem> + </itemizedlist> + <para>You can bookmark these &URL;'s, however, please + read the + <link linkend="bookman">Bookman</link> section regarding + <emphasis>securely save passwords</emphasis>. For connecting to + multiple locations, bookmark these &URL;'s and open + them one by one, or open them all together by using + &panel-profiles-lnk;. To switch from one to another + location, just open a &foldertabs-lnk; for + each.</para> + <para>There are three ways to start a remote connection: + <itemizedlist> + <listitem> + <para>Type the &URL; in the + <link linkend="list_panel">Location Toolbar</link></para> + </listitem> + <listitem> + <para>Select + <emphasis role="bold"> + <menuchoice> + <guimenu>Commands</guimenu> + <guimenuitem>New Net Connection</guimenuitem> + </menuchoice> + </emphasis>which will pop-up a dialog that will ask for the + remote site details. This dialog is handy if you are not used + to type remote &URL;'s in the Location Toolbar. + Leaving the password and user name fields empty will log you + in as anonymous. NOTE: we are planning to rewrite this dialog + window.</para> + </listitem> + <listitem> + <para>You can bookmark a directory on a remote host and + return to this directory from the bookmark button on the top + corner of your panel just like in a web browser.</para> + </listitem> + </itemizedlist></para> + <para>After you log on to a remote server you can browse it just + like your local hard drive with the following exceptions: + <itemizedlist> + <listitem> + <para>You cannot execute files on remote servers.</para> + </listitem> + <listitem> + <para>Permissions cannot always be calculated on remote + servers (depends on server and access method) so you might + get a "?" on the permissions columns for some files.</para> + </listitem> + <listitem> + <para>Disk usage information is not available for most remote + filesystems.</para> + </listitem> + </itemizedlist></para> + <para>To change the charset of the remote host use + <emphasis role="bold"> + <menuchoice> + <guimenu>Commands</guimenu> + <guimenuitem>Select Remote Charset</guimenuitem> + </menuchoice> + </emphasis>.</para> + <para>You can + <emphasis role="bold">close the current Active Remote + Connection</emphasis> by two separate methods: + <itemizedlist> + <!-- + <listitem> + <para>Manually: <emphasis role="bold"><menuchoice><guimenu>Commands</guimenu> + <guimenuitem>Disconnect From Net</guimenuitem></menuchoice></emphasis></para> + </listitem> + --> + <listitem> + <para>Manually: Add the disconnect button to the + &main-toolbar-lnk; and click on it.</para> + </listitem> + <listitem> + <para>Automatically: Change the &URL; in the + &location-toolbar-lnk; .</para> + </listitem> + </itemizedlist></para> + <note> + <para>&krusader; is a file manager that supports + remote connections via &kioslaves1-url;, but if you + are looking for even more advanced remote connections features, + ⪚ an advanced &FTP;-client we + recommend you to use ⪚ + &kasablanca-url; or + &kftpgrabber-url;.</para> + </note> + +<sect2 id="remote-connections-lan-fish"> + <title>LAN connections via fish:/ protocol (zeroconf)</title> + <indexterm> + <primary>Remote LAN Connections (zeroconf)</primary> + </indexterm> + +<para>This section is contributed by + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1912">Andrew Svet (z-vet)</ulink>, + feedback about this chapter is appriciated. Thanks!</para> + + <note> + <para>This works on a &debian; system, so it will work on &debian; and derivatives (&kubuntu; &etc;), though + it should work on other Linuxes as well. + We assume that you have <link linkend="gloss-ssh">SSH</link> installed, configured and working on + every machine on LAN you want to connect to/from. + There are plenty of very good tutorials about <link linkend="gloss-ssh">SSH</link> on the net, ⪚ + at <ulink url="http://www.linuxhomenetworking.com/wiki/index.php/Quick_HOWTO_:_Ch17_:_Secure_Remote_Logins_and_File_Copying">linuxhomenetworking.com</ulink> + or just google for it. We use the default <link linkend="gloss-ssh">SSH</link> port (22) for this chapter. + Remember to change it if you use different one. All modifications, editing &etc; must be done as root. + </para> + </note> + +<para> +Let's start with installing all the packages we need: +<screen> +<prompt>#</prompt> <userinput><command>apt-get install</command> <option>avahi-daemon libnss-mdns kdnssd</option></userinput> +</screen> + +Everything is installed, now let's do some configuration. First, we need our services to be announced on LAN. +That's why we installed avahi-daemon: it represents your machine on local network and allows other applications +to publish services they provide. Avahi-daemon comes with example <filename>ssh.service</filename> configuration +file found in <filename>/usr/share/doc/avahi-daemon/examples</filename> . In order to get the service to be +announced on LAN we need to copy this file to <filename>/etc/avahi/services</filename> directory: +<screen> +<prompt>#</prompt> <userinput><command>cp</command> <option>/usr/share/doc/avahi-daemon/examples/ssh.service /etc/avahi/services</option></userinput> +</screen> + +Now we need fish:/ protocol to be announced too, so we use an ssh.service file as a template for fish.service: +<screen> +<prompt>#</prompt> <userinput><command>cp</command> <option>/etc/avahi/services/ssh.service /etc/avahi/services/fish.service</option></userinput> +</screen> + +This file is just a copy of ssh.service, Edit the <filename>fish.service</filename> file and replace +"Remote Terminal on %h" with "Fish to %h" and "_ssh._tcp" with "_fish._tcp". + +Here's how it looks after edit: +<programlisting> +<?xml version="1.0" standalone='no'?><!--*-nxml-*--> +<!DOCTYPE service-group SYSTEM "avahi-service.dtd"> + +<!-- $Id: remote-connections.docbook,v 1.6 2007/05/02 18:07:28 codeknight Exp $ --> + +<!-- + This file is part of avahi. + + avahi is free software; you can redistribute it and/or modify it + under the terms of the GNU Lesser General Public License as + published by the Free Software Foundation; either version 2 of the + License, or (at your option) any later version. + + avahi is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR + +<!-- See avahi.service(5) for more information about this configuration file --> + +<service-group> + + <name replace-wildcards="yes">FISH to %h</name> + + <service> + <type>_fish._tcp</type> + <port>22</port> + </service> + +</service-group> +</programlisting> +Save the modified file. + +Now we need to create a new file <filename>_fish._tcp</filename>, open a text editor and add the next lines: +<programlisting> +Name=FISH Protocol (ssh) +Type=_fish._tcp +UserEntry=u +PathEntry=path +PasswordEntry=p +</programlisting> +And save the file <filename>/usr/share/apps/zeroconf/_fish._tcp</filename> + +Do the same on each machine on your LAN, then restart avahi-daemon: +<screen> +<prompt># /etc/init.d/</prompt> <userinput><command>avahi-daemon</command> <option>restart</option></userinput> +</screen> + +Than open &krusader; and type in location-toolbar-lnk: <filename>zeroconf:/</filename> to open the +<link linkend="gloss-zeroconf">zeroconf</link> connection. +Enter the <guilabel>Fish Protocol</guilabel> directory. Inside you'll find the links to each machine that +announced <filename>fish:/</filename> on your LAN, the location-toolbar-lnk: will point to +<filename>zeroconf:/_fish._tcp</filename> Double clicking on any of these machines, +them will bring up the password prompt, asking you for yor ssh key passphrase (if password was set). +Enter your passphrase. Congratulations: you connected to remote machine using &krusader;! +</para> + +</sect2> + +</sect1> + + |