@device(imprint10)
@style(spacing 1, font computermodernroman11, indent 0)
@pageheading(left "@b(Project Athena)", center "@value(page)",
right "@b(December 7, 1984)")
@begin(majorheading, flushright)
Student Accounts at End of Term
@end(majorheading)

@begin(heading,flushright)
L. B. Merims
Project Athena
December 7, 1984
Revision B 
@end(heading)

Project Athena created about 850 accounts this Fall term for students
taking courses that used Athena equipment.  As the end of the term nears,
you have probably begun to wonder
what's going to happen to your Athena account when classes are over.
This writeup explains what will happen and what you have to do about it. 

Athena has recently opened a large new cluster in
the Student Center Library.  All student accounts that were
set up as part of Fall courses will be moved to machines at this new
W20 Student Center cluster. 

Who will be affected?  Student accounts established for the following
Athena-supported courses will be affected:  1.00, 1.04, 2.10, 2.671,
2.672, 3.11, 5.33, 6.013, 6.014, 6.022j, 13.00, 13.902, and 16.62x.
If your course already
uses machines in W20 (courses 1.50 and 6.021j) your accounts will just stay
where they are, but their file quotas will be lowered to the same
limits everyone else has on January 18, 1985.

Who will not be affected?
Students who got Athena accounts because they were
working for an Athena curriculum development project will not be affected.
Students taking courses 3.55, 13.10j, 17.803, and 18.440 will not be
affected.  These courses did not have personal student accounts, only
"generic" accounts that will not be moved.

The process will begin in early December.  On November 27, 1984 Athena
took a snapshot of all student accounts and passwords (but not the
files) that were associated with the Athena-supported courses listed
above.  We have made new, duplicate accounts for 
for each of these users
on one of the five machines located in the Student Center facility.
These accounts should have become available on December 5, 1984. 

There will be a six week period between the time these new accounts are
created and the time the old accounts are deleted on January 18,
1985.  During this period we expect students to transfer any files
that they wish to keep from their old machines and accounts to their new
machines and accounts.  On January 18, 1985, all old student accounts
will be deleted and their files will be destroyed.


@begin(heading,flushleft)
Your New Account
@end(heading)

Your new account should be available on December 5, 1984.  Your new 
account will be assigned to one of the W20 "Ringworld" cluster machines
according to the first letter of your last name, as follows:
@example{
  Last Name Begins with           Machine

        A-C                       louiswu
        D-H                       nessus
        I-L                       prill
        M-R                       speaker
        S-Z                       teela
}    

What will your password be on your new account?  If you currently have
an account on only one Athena machine then we will be using the password
that was valid for that account on November 27, 1984.  If you currently
have an account on more than one Athena machine then your Student
Center account will be the password that was in use on November 27,
1984, on the machine that comes first alphabetically.  For example, if
you have accounts on both @i(atlas) and @i(ares), we will use the
password from @i(ares).

Your new account will be a new "vanilla-flavor" Athena account.  It will
have the "owner-only" file protection permissions typical of all
new Athena accounts.  It will
be different from your old account in several ways:
@itemize[
The new
account will have more limited disk space for file storage:  500KB
blocks instead of 2500KB blocks.  KB stands for "thousand byte."
For those who know what it means, more precisely, the old
limits were 2500 KB blocks "soft" limit and 3000 KB blocks "hard" limit.
The new limits will be 500 KB blocks soft limit and 1000 KB blocks hard
limit.  In any event, you will have much less space for storing files
online.

The total number of files you can have will be smaller.
The old limits varied somewhat. 
The new soft limit will be 250 and the hard limit 400.

@b(Your new account will not have any of your
personal files from your old account), only the few vanilla
"start up" files that come with all accounts.
It will be your responsibility to decide what files
from your old account you want to keep and to move them to your new
Student Center account by January 18, 1985.
]

@begin(heading,flushleft)
Moving Your Files
@end(heading)

Your main concern in this process will be moving any files you wish to
save from your old account to your new account.  @b(Athena will not do this
for you.)  Moving your files should be easy.  But, just in case you encounter
difficulty,
Athena consultants will be available at the Student Center cluster
from December 5 through December 20, and January 12 through January 18,
on Monday, Tuesday, Wednesday, Thursday, and Sunday nights
from 7-9 p.m. to help.
We strongly advise you to move files at the 
Student Center during these hours.  (There will be a new system release
in progress between January 2 and 10, and the systems may be down or
unstable during that period.)

Here is the recommended procedure.
@begin(enumerate)
Go to the Student Center Library--fifth floor, W20.

Login to your OLD machine and account first.  (Yes, you will be able
to login to your old machine from W20.)

@multiple[
Once you are logged in type:   @B(quota)

You will see something like the following:
@begin(example, indent 0)
Disc quotas for dkfritz (uid 7094):
Filsys current quota  limit #warns   files quota  limit #warns
  /mit     725  2500   3000             84   300    350        
@end(example)]

If the number shown under the column "current" is less than 500
@p(and) the number under column "files" is less than 250 then you should have
no trouble moving files to your new account; everything will
fit.  Any housekeeping you wish to do on your 
files before you move them is optional.  You can skip down to step 6.

@begin(multiple)
If either of these numbers is greater however, your current set of
files will not fit onto your new Student Center account.  Something has
got to go.
  
You can do two things with your excess files:  
@enumerate{
delete them forever, or

copy some of them onto a floppy disk first, then delete them from
the old machine.  If you elect this option see a Student Consultant for help.
}

If you choose to delete your excess files, you will next have to
decide which to remove.  If your problem is just too many files,
then list out your filenames with the @i(ls) command.  Pick your victims
and get rid of them using the Unix
@i(rm) (remove) and @i(rmdir) (remove directory) commands.  (The free
Athena document @i(Essential Unix) explains how to use these
commands in its "Files" and "Directories" sections.)

If your problem is too much @i(filespace), you may have slightly
different criteria for picking candidates.  To determine how much
space each file	takes up type:
@example{
 ls -Rsa | more 
}
The "R" @i(must) be capitalized.  This will show you, one file per line,
directory by directory,	how many KB (thousand byte) blocks each file takes up.

Decide which files can be deleted and then use @i(rm) and @i(rmdir)
to get rid of the excess.  Periodically type the @i(quota) command
to determine how you're doing.  When you have successfully
brought your "current"	number down under 500 you are done.
@end(multiple)

Logout from your old account.  Login to your new account.

@begin(multiple)
We are now going to copy all of your old files over to your new account,
en masse.  Be aware that @B(if you have already created files on your
new account that have the same name as the "incoming" files on
your old account, these new files will be overwritten).

Now, @i(on your new machine) type: @b( moveme)

You will see something like:
@example{You are logged into louiswu.  I assume that is where to copy TO.
Is this the case? (Answer y or n)  y
Enter the name of the machine you want to copy FROM:
}

Type the name of your old machine and carriage return.  @i(Moveme) will
give you a running chronicle of the steps it is taking to transfer
your files.  Essentially, it is doing what we told you to do above:
checking to see that there's room on the new machine's disk packs
for files, checking to see that you won't exceed your quotas on
your new machine, trying to make sure you're doing the copy in
the right direction, etc.

Don't interrupt the process mid-stream.
If you do happen to interrupt @i(moveme) with CTRL-C before it has
completed, it is better to just @i(moveme) all over again from
the beginning than to try to piece things together.  Remember,
@i(moveme) is just a copy operation.  All your files on your
old machine are untouched.
 
If you do not have enough space on your new account for your old files,
the @i(moveme) program will abort with an explanatory message.  Go back
to step 2.   Do not pass GO.  Do not collect $200.
@end(multiple)

After @i(moveme) completes the transfer of your files to your new account,
    you should do a spot check of your files to make sure that the move
    went smoothly.
Note that @i(moveme) preserves your original directory structure.
@end(enumerate)

@i(Moveme) copies all your files, wholesale.
If over the course of the rest of the term you
create other files on your @B(old) account that you wish to preserve, you
can transfer them to your new account one-by-one using the Unix
@i(rcp) ("remote copy") command.  Again,
first make sure that you have enough space on your new account.  It is
best when using @i(rcp) to be logged into your W20 "destination"
account and bring files @i(to) you, rather than the other way around.

The general form of the @i(rcp) command is:
@display[
rcp '@i(remotehost:completefilename)'    @i(tofile)
]
For example:
@display[
rcp  'demeter:~myusername/finalscores'  finalscores
]
copies the file @i(finalscores) in @i(myusername)'s home directory
on the machine @i(demeter) into a file called @i(finalscores) in
my current directory on my current machine.  You enclose the remote
machine file specification in single @b(forward)--righthand (')
@i(not) lefthand (`)--quotes because you want to pass
that string to the remote machine intact; you don't want the local
machine's shell trying to expand, say, the * or ~ character.

This is the simplest form of @i(rcp) copy, the single file.  If you
want to copy more than one file at a time, we suggest that you
talk to a consultant first, since @i(rcp) is a bit trickier to use
than it might appear at first glance.

@begin(heading,flushleft)
Problems
@end(heading)

What are some of the problems you may encounter during this process?

@b(You have trouble logging in to your new account.)  Check first to make
sure that you are trying to login to the correct machine at the Student
Center.  There are five possible machines there; check
the assignment list above.  Also, are you using
the right password?  If you cannot successfully login to your new
Student Center account you should talk to the student consultant
on duty.  If no consultant is available, call your new all-students
Account Administrator at 3-1548.

@b(You get the message "Network unreachable." when you try to login
to your old account from the Student Center.)
This means that there is a temporary
problem with the network link between W20 and your old machine.  Try again
later. 

@b(You try the @p(moveme) command and get the message "Permission denied".)
This could be several things, each of which would be rather
difficult to diagnose.  It is best to see a Student Consultant.

The rest of @i(moveme)'s error messages are pretty self explanatory.
Most have to do with trivial errors like typing the host machine
name wrong or quota problems.  The only messages that would be
perplexing are "Tar finished with an indication that something went
wrong,"  or a list of filenames followed by "These files were on
@i(from machine), but are not on @i(new machine).  The move must
have failed.  Try again."

In any event, the best thing to do is to see a Student Consultant
for help during the hours noted at the beginning of the "Moving Your
Files" section.
@begin(heading,flushleft)
Final Words
@end(heading)

Welcome to the Ringworld cluster!.  
Remember, your old account will go away as of January 18, 1984.
You must
move any files you wish to save before that date as both they and your
old account will be deleted.  If you
were in 1.50 or 6.021j, the courses already using W20, then your
account won't go away, but its file quotas will be lowered to
the limits described under "Your New Account."

If you have friends who send you mail, let them know what your
new Athena mail address is.  (username@@mit-machine)

Your new account is there for you to use as you please.