amigadave: reformat images, add anchor divs, wikify slightly, add links

2010-11-04T11:58:17Z

reformat images, add anchor divs, wikify slightly, add links

Show changes

amigadave: wikify slightly

2010-10-19T14:06:01Z

wikify slightly

Show changes

amigadave: categorize

2010-05-11T06:05:19Z

categorize

← Older revision		Revision as of 06:05, 11 May 2010
Line 1:		Line 1:
-
	= File Sharing =		= File Sharing =

Line 438:		Line 437:
	\| '''Note:''' Rsync protocol is also used by several backup and file synchronisation services available from the Internet.		\| '''Note:''' Rsync protocol is also used by several backup and file synchronisation services available from the Internet.
	\|}		\|}
		+
		+	[[Category:Documentation]]

dneary: 1 revision

2010-04-09T13:35:31Z

1 revision

← Older revision

Revision as of 13:35, 9 April 2010

Wikiuser: importing documentation, see Meta:Problems in the LaTeX2HTML2Wiki import process

2010-04-09T09:05:01Z

importing documentation, see Meta:Problems in the LaTeX2HTML2Wiki import process

New page

= File Sharing =

= Disk mounting =

Maemo PC Connectivity provides some tools for easily sharing files between a Maemo device and a host PC. You can can mount the file system of a Maemo device to the host PC over a network and interact with it as it is a local disk. Also, it is possible to mount a file system of a host PC to the Maemo device. For that, you have to install Maemo PC Connectivity on the Maemo device and Host PC Connectivity on the host PC (Linux, Windows and Mac OS X).

This chapter describes how to use the disk mounting tools available with Maemo PC Connectivity. To simplify the process, it is assumed that you already have a working USB network between your Maemo device and the host PC.

The recommended tools and methods to mount the file system of a Maemo device to a host PC are listed in table 6.1.

{| border="1" cellpadding="3"
|+ '''Table 6.1:''' Recommended mount tools for PC
|-
| align="CENTER" |
| align="CENTER" | Linux
| align="CENTER" | Windows
| align="CENTER" | Mac OS
|-
| align="CENTER" | SSHFS
| align="CENTER" | X
| align="CENTER" |
| align="CENTER" | X
|-
| align="CENTER" | NFS
| align="CENTER" | X
| align="CENTER" |
| align="CENTER" | X
|-
| align="CENTER" | SAMBA
| align="CENTER" | X
| align="CENTER" | X
| align="CENTER" | X
|}

The recommended tools and methods to mount the file system of a host PC to a Maemo device are listed in table 6.2.

{| border="1" cellpadding="3"
|+ '''Table 6.2:''' Recommended mount tools for Maemo device
|-
| align="CENTER" |
| align="CENTER" | Linux
| align="CENTER" | Windows
| align="CENTER" | Mac OS
|-
| align="CENTER" | SSHFS
| align="CENTER" | X
| align="CENTER" |
| align="CENTER" | X
|-
| align="CENTER" | NFS
| align="CENTER" | X
| align="CENTER" |
| align="CENTER" |
|-
| align="CENTER" | SAMBA
| align="CENTER" | X
| align="CENTER" | X
| align="CENTER" | X
|}

On the host PC, you must type the commands below in the terminal on Linux and Mac OS X and in the Cygwin command shell on Windows.

== Using SSHFS mounts ==

SSHFS (SSH File System) is a file system client based on the SSH protocol. It allows users to mount locally a remote file system via SSH. With SSHFS, you can remotely access the Maemo device file system from the host PC and vice versa.

{|
|-
| [[Image:dialog-information.png]]
| '''Note:''' SSHFS mounts do not work on Windows host PC.
|}

If you want to mount the Maemo device file system to your host PC, you can execute the following commands.

$ mkdir ~/maemo
$ sshfs user@192.168.2.15:/ ~/maemo -o rw,nonempty
user@192.168.2.15's password: <type user password here>

If you did not set the SSH password for user yet, you can use the root account. You should set up the password for the user account by following these steps:

$ ssh root@192.168.2.15
root@192.168.2.15's password: <type root password here>
Nokia-810:~# passwd user
Changing password for user
Enter the new password (minimum of 5, maximum of 8 characters)
Please use a combination of upper and lower case letters and numbers.
New password: <type new user password here>
Re-enter new password: <retype user password>
Password changed

If you want to mount the host PC file system to your Maemo device, you can execute the following commands:

$ mkdir ~/hostpc
$ sshfs <host_pc_user>@<host_pc_ip>:/ ~/hostpc -o rw,nonempty
<host_pc_user>@<host_pc_ip>'s password: <type user password here>

As SSHFS is a user mode file system, you cannot use the standard Linux mount command directly. For example, you should execute the following command to unmount the Maemo device file system from the host PC.

$ fusermount -u ~/maemo

You can configure SSH to use keys and not to ask for a password every time by exchanging the SSH keys as described in the SSH installation chapter.

== Using NFS mounts ==

With NFS (Network File System), you can share folders from your Maemo device or host PC over a network. Below are instructions on how to share a folder from a Maemo device using NFS.

=== Configuring NFS for Maemo device ===

You should follow these steps to share a folder from your Maemo device through NFS using Maemo PC Connectivity configuration widget:

* Run '''Settings - Control Panel - Connectivity - PC Connectivity Manager'''.
* Click on the '''Advanced''' button.
* Go to the '''Tool Manager''' tab.
* Select the '''NFS''' option. After that, change the options according to your needs, figure [[#fig:pc_connectivity_mpc_maemo_nm_nfs|6.1]].
* Click on the '''Exported Paths''' button. Then add the folders to be shared, figure [[#fig:pc_connectivity_mpc_maemo_nm_nfs_folders|6.2]].
* Click on the '''Allowed IPs''' button. Then add the host PC's IP addresses that are allowed to access the shared folders, figure [[#fig:pc_connectivity_mpc_maemo_nm_nfs_ips|6.3]].

{| summary="PC Connectivity Manager - NFS option"
|+ align="BOTTOM" |'''Figure 6.1:''' PC Connectivity Manager - NFS option
|-
|
[[Image:mpc_maemo_nm_nfs.png|Image mpc_maemo_nm_nfs]]
|}

{| summary="PC Connectivity Manager - Shared folders list"
|+ align="BOTTOM" |'''Figure 6.2:''' PC Connectivity Manager - Shared folders list
|-
|
[[Image:mpc_maemo_nm_nfs_folders.png|Image mpc_maemo_nm_nfs_folders]]
|}

{| summary="PC Connectivity Manager - Allowed IPs list"
|+ align="BOTTOM" |'''Figure 6.3:''' PC Connectivity Manager - Allowed IPs list
|-
|
[[Image:mpc_maemo_nm_nfs_ips.png|Image mpc_maemo_nm_nfs_ips]]
|}

If you want, you can share a folder from your Maemo device manually. The following steps describe how to share the folder (/home/user/MyDocs) from a Maemo device over a network by giving access to the host PC IP address (192.168.2.14).

Connect to the Maemo device via SSH. Edit the file /etc/exports and add the folder you want to share and set the permissions of your shares (IP addresses).

/home/user/MyDocs 192.168.2.14(rw,no_root_squash,async,no_subtree_check)

Next restart the User Mode NFS server:

$ /etc/init.d/unfs3 restart

=== Configuring NFS for host PC ===

You must follows these steps to share a folder from a host PC over a network and giving access to it for Maemo device's IP address (192.168.2.15):

{|
|-
| [[Image:dialog-information.png]]
| '''Note:''' NFS mounts do not work on Windows host PC.
|}

Edit the file /etc/exports and add the folder you want to share and set the permissions for your shares (IP addresses).

/home/<host_pc_user> 192.168.2.15(rw,no_root_squash,async,no_subtree_check)

Next restart the User Mode NFS server:

$ sudo /etc/init.d/unfs3 restart

=== Accessing NFS shares with Maemo device ===

Once you configured NFS on your Maemo device, you can access the shared folders from your host PC over the network. Below are instructions on how to access the shared NFS folders from the Linux host PC.

On the host PC, run the showmount command to check if NFS sharing is working.

$ showmount -e <device_ip>
Export list for 192.168.2.15:
/home/user/MyDocs 192.168.2.14

Next mount the exported Maemo device folder from the host PC.

$ mkdir /tmp/MyDocs
$ sudo mount -t nfs <device_ip>:/home/user/MyDocs /tmp/MyDocs

You can unmount the same folder with the following command:

$ sudo umount /tmp/MyDocs

=== Accessing NFS shares with Host PC ===

Once you have configured NFS on your host PC, you can access the shared folders from your Maemo device over a network. Below are instructions on how to access the shared NFS folders from your Maemo device.

On the Maemo device mount the shared host PC folder.

$ mkdir ~/hostpc
$ mount -t nfs <host_pc_ip>:/home/<host_pc_user> ~/hostpc

You can unmount the same folder with the following command:

$ sudo umount ~/hostpc

== Using Samba mounts ==

Samba allows file sharing between computers over the network. With Samba, you can remotely access the Maemo device file system from the host PC and vice versa. Once you have shared your file system through Samba, it is available every time you reconnect to the network.

{|
|-
| [[Image:dialog-information.png]]
| '''Note:''' Samba does not work on Maemo Fremantle devices such as N900 but works fine with Maemo Diablo devices such as N800 and N810.
|}

=== Configuring Samba for Maemo device ===

To be able to share a folder from your Maemo device, you should follow these steps.

* Run '''Settings - Control Panel - Connectivity - PC Connectivity Manager'''.
* Click on the '''Advanced''' button.
* Go to the '''Tool Manager''' tab.
* Select the '''Samba''' option. After that, change the options according to your needs (Workgroup, User and Password), figure [[#fig:pc_connectivity_mpc_maemo_nm_samba|6.4]].
* Click on the '''Exported Paths''' button. Then add the folders to be shared, figure [[#fig:pc_connectivity_mpc_maemo_nm_samba_paths|6.5]].
* Click on the '''Apply''' button.

{| summary="PC Connectivity Manager - Samba options"
|+ align="BOTTOM" |'''Figure 6.4:''' PC Connectivity Manager - Samba options
|-
|
[[Image:mpc_maemo_nm_samba.png|Image mpc_maemo_nm_samba]]
|}

{| summary="PC Connectivity Manager - Samba shared folders"
|+ align="BOTTOM" |'''Figure 6.5:''' PC Connectivity Manager - Samba shared folders
|-
|
[[Image:mpc_maemo_nm_samba_paths.png|Image mpc_maemo_nm_samba_paths]]
|}

You can access your host PC shared folders from your Maemo device.

* Open the '''Utilities - File Manager''' application.
* Click on the '''Shared folders''' option, figure [[#fig:pc_connectivity_mpc_maemo_nm_samba_access|6.6]].
* Select the desired shared folder.

{| summary="PC Connectivity Manager - Shared folders dialog"
|+ align="BOTTOM" |'''Figure 6.6:''' PC Connectivity Manager - Shared folders dialog
|-
|
[[Image:mpc_maemo_nm_samba_access.png|Image mpc_maemo_nm_samba_access]]
|}

=== Configuring Samba for Linux ===

To be able to share a folder from your Linux host PC, you should follow these steps:

* Open the File Manager ('''Nautilus''').
* Right click the folder you want to share, and select '''Sharing options'''.
* Type the '''Share name''' and check the '''Guest access''' option, figure [[#fig:pc_connectivity_mpc_linux_ubuntu_samba_share|6.7]].
* Click on the '''Create share''' button.

{| summary="Linux folder sharing"
|+ align="BOTTOM" |'''Figure 6.7:''' Linux folder sharing
|-
|
[[Image:mpc_linux_ubuntu_samba_share.png|Image mpc_linux_ubuntu_samba_share]]
|}

If Samba is not installed, Ubuntu requests the installation at this point. Otherwise, you can install Samba manually.

$ sudo apt-get install samba

To access a shared folder from the Maemo device using your Windows host PC.

* Open the File Manager (Nautilus) and type: smb://<maemo_device_ip>, figure [[#fig:pc_connectivity_mpc_linux_ubuntu_samba_access|6.8]].
* Press '''Enter'''.

{| summary="Accessing shared folder with Final Manager"
|+ align="BOTTOM" |'''Figure 6.8:''' Accessing shared folder with Final Manager
|-
|
[[Image:mpc_linux_ubuntu_samba_access.png|Image mpc_linux_ubuntu_samba_access]]
|}

=== Configuring Samba for Windows ===

To be able to share a folder from your Windows host PC, you should follow these steps.

* Open the File Manager ('''Windows Explorer''').
* Right click the appropriate folder, and then click Sharing.
* In the folder's properties, click '''Share this folder'''. Use the default name for the share.
* Click the '''Permissions''' button to change permissions according to your needs.

To access a folder shared from your Maemo device, you need to do the following on your Windows host PC:

* Click '''Start''', and then click '''Run'''.
* Type your Maemo device IP address as follows: <maemo_device_ip>.
* The shared folders of your Maemo device are shown.

=== Configuring Samba for Mac OS X ===

To be able to share a folder from your Mac OS X host PC, you should follow these steps:

* Go to '''System Preferences''' and click on the '''Sharing''' icon.
* Select the '''File Sharing''' service.
* Add a folder you want to share, and then set the permissions for it, figure [[#fig:pc_connectivity_mpc_mac_samba_share|6.9]].

{| summary="Mac OS X Sharing dialog"
|+ align="BOTTOM" |'''Figure 6.9:''' Mac OS X Sharing dialog
|-
|
[[Image:mpc_mac_samba_share.png|Image mpc_mac_samba_share]]
|}

To access a folder shared from a Maemo device you need to do following on your Mac OS X host PC.

* Go to the File Manager application ('''Finder''').
* With the '''Finder''' open, click on the '''Go''' menu and select the '''Connect to Server''' option.
* Type your Maemo device IP address as follows: smb://<maemo_device_ip>, figure [[#fig:pc_connectivity_mpc_mac_samba_access|6.10]].
* Click on the '''Connect''' button.

{| summary="Mac OS X connect to server dialog"
|+ align="BOTTOM" |'''Figure 6.10:''' Mac OS X connect to server dialog
|-
|
[[Image:mpc_mac_samba_access.png|Image mpc_mac_samba_access]]
|}

= File transfer =

You have several different ways to transfer files between a Maemo device and a host PC using tools provided by Maemo PC Connectivity. First, you have to install Maemo PC Connectivity to the Maemo device and Host PC Connectivity to the host PC (Linux, Windows and Mac OS X). Below describes how to use specific file transfer tools available from the Maemo PC Connectivity product. To simplify the process, it has been assumed that you already have a working USB network configured between the Maemo device and host PC.

On the host PC, you must type the commands below using terminal on Linux and Mac OS and using Cygwin command shell on Windows.

== Using SCP ==

With SCP (Secure Copy), you can securely transfer files between a local and a remote host or between two remote hosts, using the SSH protocol. Below describes in detail how to transfer files between the Maemo device and host PC using SCP.

You should follow the SCP command examples below to transfer files from a local to a remote host:

$ scp <source_file> <user>@<host_name>:<path>/<target_file>

For example, if you want to transfer a file called file.txt from a host PC to a Maemo device, you should use this command on the host PC:

$ scp file.txt root@192.168.2.15:/etc/file.txt

You should follow this SCP command example to transfer files from a remote to a local host:

$ scp <user>@<host_name>:<path>/<source_file> <target_file>

For example, if you want to transfer a file called file.txt from a Maemo device to a host PC, you should use this command on host PC:

$ scp root@192.168.2.15:/etc/file.txt file.txt

You can use ssh-key-exchange as described in the SSH installation chapter to avoid SSH requiring a password every time.

== Using SFTP ==

After Maemo PC Connectivity has been installed to the Maemo device, your Maemo device folders can be accessed from a host PC using the SFTP client. If you also installed Host PC Connectivity your host PC already has a GUI-based SFTP client, FileZilla, installed. Therefore to access your Maemo device folders from the host PC through SFTP, simply follow these steps.

Run the FileZilla client, figure [[#fig:pc_connectivity_mpc_sftp|6.11]].

* Linux - Ubuntu: '''Applications - Internet - FileZilla FTP Client'''.
* Windows: '''Start - Programs - FileZilla FTP Client - FileZilla'''.
* Mac OS: '''/Applications/FileZilla'''.

{| summary="FileZilla FTP Client"
|+ align="BOTTOM" |'''Figure 6.11:''' FileZilla FTP Client
|-
|
[[Image:mpc_sftp.png|Image mpc_sftp]]
|}

* Type the IP address of your Maemo device in the '''Host''' field.
* Type your '''Username''' and '''Password''' to set up the SSH connection on your Maemo device and type 22 (for SSH) in the '''Port''' field.
* Click on the '''Quickconnect''' button. Your Maemo device folders will appear in the '''Remote Site''' area.

== Using Rsync ==

As Maemo PC Connectivity and Host PC Connectivity products installs Rsync for your environment, you can incrementally transfer files and directories between a Maemo device and a host PC. You can send and receive files in such a way that only the changed bytes inside files are copied between the Maemo device and the host PC. Rsync also removes files from target folders if those files were deleted from the source folders in order to keep both folders in sync. You can find usage examples and documentation about Rsync from the [http://rsync.samba.org/ Rsync web page].

Rsync is a much more powerful tool than standard SCP, SFTP or disk mounts to back up or synchronise large files (such as music, pictures, maps and movies) between a Maemo device and a host PC.

{|
|-
| [[Image:dialog-information.png]]
| '''Note:''' Rsync protocol is also used by several backup and file synchronisation services available from the Internet.
|}

Documentation/Maemo PC Connectivity Tutorial/File Sharing - Revision history

amigadave: reformat images, add anchor divs, wikify slightly, add links

amigadave: wikify slightly

amigadave: categorize

dneary: 1 revision

Wikiuser: importing documentation, see Meta:Problems in the LaTeX2HTML2Wiki import process