Using PuTTY to Establish
Locker Permissions

Last updated November 15, 2004



Before you begin...
download PuTTY for free from NCSU's servers and follow the directions posted to set up PuTTY.

If you wish to save your data to files on the Web servers, then the Web servers that run inFORM must have permission to write to that AFS filespace. PuTTY allows you to set these permissions. To launch PuTTY, find the location where you saved the "putty.exe" file and double-click on it. Load the setting you initially created when you set up the software and click "Open". If this is your first time using PuTTY, a window will pop-up asking if you want to add the "server's host key" to PuTTY's cache. If you click Yes to accept, you will not receive this prompt again, but if you select No, you will be prompted each time you open the program until you select Yes.

PuTTY Security Alert


After choosing Yes or No above, the following login screen will appear. To login, use your unity id and password.

PuTTY - Login


Once logged in you will notice that the command prompt is your unity id (e.g., mjjordan> ). By default, the system places you in your personal locker space. You will need to navigate to the location where you want your data files to be saved. You should have this information if you answered the second question above completely. This is known as the AFS pathname (or savepath) for your directory. An example of a pathname is /afs/unity/lockers/project/myproject/inform/ where "myproject" is the top-level folder that has been created for your project. To get to your project's locker, you will need to type "cd" followed by your locker's pathname. Then press [Enter]. Using our example, the result should look something like this: cd /afs/unity/lockers/project/myproject/inform/ (There should be a space between "cd" and "/afs/....".) Please keep this directory information. You will need it when you register your form and when you want to download your data file(s).

PuTTY - Navigating to Your Server Space


After navigating to your project's locker space, you will want to find out who has access rights to your folder. To do this, type fs la [Enter] at the command prompt. This command will generate a list of individuals, groups, and/or Web servers that have access to your locker. This does not mean that they can make changes to your items in your locker. It depends on the access rights that have been set for them.

PuTTY - List Access Rights


If you wish for inFORM to save data files to your locker space, then you must give the Web servers permission to "write" to the locker where you want the files saved. The Web servers also need permission to "look" into any folder (directory) that may be above the folder where the data is being saved. To give the Web servers "write" permission so it can save data to your folder, type fs sa . www:servers.cgi rlidwk [Enter]. In the instance that you do have other folders above your data folder, you will need to navigate to those folders. Find out what access rights exist in those folders by typing fs la [Enter]. These folders should either have "system:anyuser l" or "www:servers.cgi l" permissions. If you have other things in the folder that you want others to see online, then give any user "look" rights by typing fs sa . system:anyuser l [Enter]. Otherwise, just give the Web servers "look" rights by typing fs sa . www:servers.cgi l [Enter]. If the Web servers do not have the appropriate permissions to "look" into your directory and to "write" into your data folder, then it will not be able to find your locker space and no data will be saved.

PuTTY - Setting Access RIghts


Now that your project folder(s) has(have) the appropriate permissions, you are ready to register your form. Type Exit [Enter] at the command prompt to logout.

 


URL: http://ced.ncsu.edu/ltrc/studio/workshops/inform3/putty.html
Page maintained by the Learning Technologies Resource Center.
Updated November 15, 2004
NC State University, College of Education. All Rights Reserved © 2004
Best if viewed with IE 5.0 or Netscape 6.0