on-hand viewer on iphone / ipod touch manual installation and configuration of an FTP server for Mac OS X to transfer data to on-hand viewer application on iphone / ipod touch table of contents 1. Introduction 02 2. Installation 03 3. Configuration 05
1. Introduction This document intents to give recommendations to users which are new in using FTP servers to transfer data. If you have already installed an FTP server it is possible to use this server to transfer data to onhand viewer. Our application is optimized for using the following components: 1. The PureFTPd server 2. The graphical interface PureFTPd Manager PureFTPd Manager is a graphical interface to handle easily the PureFTPd server without complicated configurations via console. To install please follow the steps described in this document. First of all, please download the diskimage of PureFTPd Manager 1.7 under the following link in the download-section: http://jeanmatthieu.free.fr/pureftpd/ Before you start the installation process, make sure that the Mac OS X default FTP server is not running. You can check this in your System Preferences. Select the "Sharing" button (1). The checkbox "File sharing" in the next dialog has to be deactivated (2). (1) (2) 02
2. Installation After checking this, you can start with the installation. Mount the diskimage. Double click the installation package for your system (3). Select "Continue" in the Welcome dialog (4). In the following step, you can find interesting information about the software (5). After reading, select "Continue". (3) (4) (5) 03
Find the GNU license agreement in the next dialog window (6) and agree it in the dialog box opening after selecting "Continue". Select the volume to install the software and press "Continue" (7) and "Install" in the next dialog window. Before starting the installation, the software requires the administrator password. If the installation was successfully made, there will be an information dialog about that (8). Select "Close". (6) (7) (8) 04
3. Configuration Change to the applications folder and start the PureFTPd Manager (administrator password is required on every start). On the first start automatically opens the PureFTPd Manager Setup Assistant to help you with first configurations. In step 1 of 6, you only have to press "Continue" (9). In step 2, 3 and 4 of 6, press "Continue" without changing anything (10, 11, 12). (9) (10) (11) (12) 05
In step 5 of 6, you can deactivate the checkbox "Automatically launch PureFTPd at system startup" (13) if you don't want to start PureFTPd at every system start. Don't change the other settings and press "Continue". In step 6 of 6, select "Configure" (14). After that, a dialog window opens in which you have the possiblity to donate money to the developer of PureFTPd Manager, if you want to. (13) (14) 06
The PureFTPd Manager starts with displaying your FTP server status (15). Right now, your FTP server is set up so that only a person that currently have a valid username and password on your computer can login to your system (except for anonymous connections). If you want to disable anonymous connections, go to the "Preferences" section. In the dialog window (16), you can see all preferences you are able to make. Select the "Anonymous" button. On the tab "General" (17) activate the checkbox "Disable anonymous access" and leave the dialog. After making modifications, the PureFTPd Manager asks you if you want to restart the PureFTPd daemon, select "Yes". (15) (16) (17) 07
For later logging in to your FTP server, you have three possibilities: 1. Use your own system user to log in with your device. If you do this, you can step over the following steps which explain how to create users in PureFTPD Manager. You only need to know your system users login and password. If you use your system user, you will have full access to your entire system and you will be able to browse through all files. In this case, you will have no problems with any access rights while providing data and loading them on your device. If you log in with your system user, you will start browsing on the highest level of your Mac. 2. Create a user following the next steps which explain this procedure and change his User ID to your system user. This process is described on the next page. Please keep in mind that the rights for the choosen folder could be changed. 3. Create a user following the next steps which explain this procudure and let the User ID to the default settings. In this case, you have to change the access rights for the chosen folder manually. This is explained after the user creation. In this case, you probably have to set the access rights for every single file in the chosen folder manually too. This could be time-consuming, but it is the most secure possibilty because you have the access control to every single file. To create a new user account (for possibility 2. and 3.), go to the "User Manager" section and select there the "New" button in the toolbar (18). A New User will be added to the virtual users list and automatically selected. Specify a login, a password, and a home directory for the new user (19). By default, the software suggests a path beginning with /Users/ftp/VirtualUsers/ and completes this path by the login name. If you use this suggestion, the new directory will be created. You are also able to choose a directory by pressing the "Choose" button and selecting an existing directory. In this directory, you are able to store all data you want to load to your device. (18) (19) 08
If you want to use possibility 3, you can accept the default settings, select "Save" (20) and go on with the next step which explains how to set the rights for the chosen folder manually. If you want to use possibility 2, you can change the rights for the chosen folder by changing the User ID in the dialog window (20). Set this User ID to your system user. If you created a new directory as home directory, this folder will get the access rights of your system user. If you choose an existing directory, the access rights for this folder will be changed to those of your system user. For changing the rights of a folder manually (what you need for possibility 3), please change to this directory in your Finder. Control-click the folder and choose "Get Info" (21) from the context menu. A dialog opens which shows you all information concerning the folder. The last area is called "Sharing & Permissions". There you can see the access rights too. If this section is locked, click the little lock (22) and unlock with your password. Then click the little "+" icon (22) and select your system user in the appearing dialog (25). Your system user will be added to the list. After that, change the Privileges to "Read & Write" (24) to allow yourself copying files in this particular folder. To inherit these rights to all files which are contained in these folder, you have to select "Apply to enclosed items" (23). For all files which are inserted new in the folder, you have to set the access rights manually. (20) (21) (22) (23) (24) (25) 09
For later connecting your device to your Mac FTP server, you just need to know the user and his password you just created. One last important thing to know (to tell it to your device) is the Server IP address. To get to know your IP address, it is not always possible to rely on the IP address which is given in the dialog window of the PureFTPd Manager in the right bottom corner. To be shore about the right IP adress, start your System-Profiler from your utilities folder in your applications folder (26). Select "Network" in the "Contents" window on the left side and you are able to see your active network services on the right side. On the top, they are listed all and in the column "IPv4 Adresses", you are able to see the IP adresses of the different services. Now you just have to know which service you want to use for connecting your device to your mac and to keep it in mind for later giving this information to your device. (26) 10
The last thing for you to do is to start the server, click the "Start" button at the bottom right of this window (27). Your FTP server is now running and you can start connecting your device to it, like described in the on-hand viewer manual. For connecting your device to your Mac in order to use the on-hand viewer application, the steps described above should answer this purpose. If you are interested in extensive information about configuring PureFTPd Manager, please read the related documents in the documentation section under the following link: http://jeanmatthieu.free.fr/pureftpd/ (27) 11