5. What to do with your brand new Ip-dev account.

This is where the "magic" and "smoke and mirrors" stuff starts ...

You have been provided you with your own Ip-dev account on the server. This account gives you access to the UNIX server through telnet and you can use FTP to transfer files in and out of your account. You have been given your own "username" and password for this account. Your account comes as a "bare bones" version and you will need to customize it a bit. This area is where we store our work in progress, so it can be easily shared among the developers. You might want to think of this account area as a "workshop" or work area.

5.1 Customizing your account

One of the first things you will need to do is load some basic Ip-dev documents into your account so that you can use them when you are writing FAQ's and HowTo's. You will need to load the file that contains the copyright notice and the files that contain the images of those little arrows that direct you forward and backward through the sections of documents. Here is a list of instructions to follow: Note: In these instructions, do NOT type the quotation marks as part of the command. They are in the instructions to make the commands easier to read.

1. Get connected to the internet in whatever way you normally do. Note that you will not actually be going onto the internet, you just need to have the connection open.
2. Login to the server with telnet. Use the user name and password that you were given. See logging on to the server for more guidance on how to do this.
3. Once in telnet, you will need to create a "howto" directory for your account. At the prompt (it says: "ns2") you should type the following: "cd public_html" and hit enter. Be sure to leave a space between cd and public.
4. Now type "mkdir howto" and hit enter. This creates a howto directory in your account.
5. Now you should change directories to the one which contains the copyright notice and the *.gif files (the little arrows). Type "cd /home/sgml/public_html/lib" and hit enter. Type "ls" to get a list of the contents of this directory. Copy the files to your howto directory by typing the following commands: (Substitute your username in the appropriate area. Be sure to include the spaces after "cp" and before "/home".)

   cp copyright.notice /home/yourusername/public_html/howto (hit enter)
   
   cp *.gif /home/yourusername/public_html/howto (hit enter)
   

6. At this point you can logoff from telnet.

5.2 Creating your own copyright notice.

The copyright notice is a generic version and you will need to customize it by adding your name and email address. We strongly suggest that you download this into your word-processor and make the appropriate changes there. You can save it as a text file and then it can be easily inserted at the end of all your FAQ's and HowTo's without retyping it each time. Here are the steps you need to follow: Note - Don't type the quotation marks which appear in the instructions below, they are included to "set aside" the exact letters to type.

With a "standard" FTP client...

1. For Windows 95 or NT users, go to a DOS prompt, type "ftp" (hit enter). This will start your FTP client.
2. At the ftp> prompt, type "open home.bzs.org" (hit enter)
3. Enter your user name when prompted (hit enter)
4. Enter your password when prompted (hit enter)
5. At the ftp> prompt, type "cd public_html/howto" (hit enter). You are now in your "personal" howto directory.
6. If you type "ls" (hit enter) you should see a list of the files in your directory.
7. At the ftp> prompt, type "get" (hit enter)
8. When prompted for the remote filename, type "copyright.notice" (all lower case letters) (hit enter)
9. When prompted for the local filename, type the full path to the destination for this file, including the filename. (hit enter). This will probably be the default storage directory for your word processing documents. NOTE: Your local file system (DOS, Windows, etc) may not recognize the full filename and extension as it exists on the remote server. You might want to save the file locally with a different name and a .txt extension to make this easier to work with. You can rename it when you transfer it back to the remote server.
10. You will get a confirmation message telling you about the throughput of the file transfer, then you will be returned to the ftp> prompt when the transfer is complete.
11. At the ftp> prompt, type "bye" (hit enter). This will log you off the remote system.
12. Open the copyright.notice in your word-processor and edit it by inserting your name and email address in the appropriate areas. There are some instructive comments in the file on how to do this. Save the edited version so that you can merge it into your FAQ's and HowTos.

Now, transfer the file back to the server, so you can include it in your web page documents:

1. For Windows 95 or NT users, go to a DOS prompt, type "ftp" (hit enter)
2. At the ftp> prompt, type "open home.bzs.org" (hit enter)
3. Type your user name (hit enter)
4. Type your password (hit enter)
5. At the ftp> prompt, type /"cd public_html/howto" (hit enter). You are now in your "personal" howto directory and can transfer the file from your local machine back to the server.
6. At the ftp> prompt, type "put" (hit enter)
7. When prompted for the local filename, type the full path name for this file, including the filename and extension. (hit enter)
8. When prompted for the remote filename, type "copyright.notice" (all lower case letters, be sure to include the period between copyright and notice) (hit enter) The ftp transfer will proceed. You will see a message telling you about the file throughput as it is transferred. When the transfer is complete, you will be returned to the ftp> prompt.
9. You can type "bye" (hit enter) to log off, or continue working on the remote system.

For America Online users...

America Online offers a graphically interfaced FTP client. You can navigate by clicking on icons instead of typing commands. (You will not be able to "read" from other members' directories with this client but it is convenient for getting things in and out of your directory.)

1. Sign on to AOL and click on the internet connection icon on the "Welcome Screen". Click on the icon that says "internet extras". Then click on "FTP".
2. Click on "Go to FTP" and then on "other site".
3. Type "home.bzs.org" in the box and check the box that says to ask for login name and password. Click on "connect". Use the same username and password that you used to get into the server with telnet.
4. Highlight the line that says "public_html" and click on "open".
5. Highlight the line that says "howto" and click on "open". A list of all the files that are in your "howto" directory should appear.
6. Highlight the file named "copyright.notice" and click on "Download Now".
7. Direct the download manager to put it in your word-processor's files so that you can edit it. Click on OK.
8. Now you can close all the FTP windows and sign off of AOL.
9. Open the copyright.notice in your word-processor and edit it by inserting your name and email address in the appropriate areas. There are some instructive comments in the file on how to do this. Save the edited version so that you can merge it into your FAQ's and HowTos.