Adding A New Site

This document will show you how to add new school and administrative sites to the Common Knowledge: Pittsburgh routing tables. It is not neccesary to go through these steps if you are only adding computers to an already existing CK:P site.

Also, it is a requirement that you have a valid IP address assigned to your site before you start this process. Valid addresses must be obtained from Bob Taylor.

Lastly, this document is not intended for site administrators. Adding a new site to the network should only be done by the authorized network administrators.

Important

Before you begin this process you should make sure that the server at the site has been installed and is phsyically connected to the newtork. This will greatly facilitate the debugging process.

From your home directory on oberon type cvs checkout hosts
cd hosts
Type mkdir $newsite where $newsite is the name of the new location you are adding. Eg. ftpitt.
Then cp -r $oldsite/* $newsite where $oldsite is the name of any other functioning site that exists in the host directory.
cd $newsite
Rename the files
1. mv ${oldsite}.nic ${newsite}.nic
2. mv ${oldsite}.param ${newsite}.param
3. mv ${oldsite}.serial ${newsite}.serial

You now need to edit the *.nic *.param *.serial files to include the proper information.

An example .nic file might look like the following

# Pioneer Hostfile

# Router at ISN026
HOST : 192.204.229.1 : GATE.ISN026.PPS.PGH.PA.US:::::
# BSDI DEC server
HOST : 192.204.229.10 : OEDASRV01.ISN026.PPS.PGH.PA.US,WWW.ISN026.PPS.PGH.PA.US:
 BSDI ::::
HOST : 127.0.0.1 : LOCALHOST.ISN026.PPS.PGH.PA.US : BSDI ::::
# The rest of the site machines go here...

In the .param file you should only have to change the domain_name and net_number. Following is an example .param file

domain_name isn026.pps.pgh.pa.us
net_number 192.204.229
primary oberon.pps.pgh.pa.us
secondary titania.pps.pgh.pa.us
secondary charon.psc.edu
contact ckp-tech-staff.pps.pgh.pa.us

The .serial file is a two line file. The value on the line that starts with serial should be increased by one.

Now move to the empty directory cd ../empty
Edit the empty.param file and comment out the line that corresponds to the network address you assigned to the new site. If you do not do this you will get errors.
Edit the empty.serial file and increase the serail value by one.
Move back up to the hosts directory and type ./bind-generate to add your changes to the host name tables.
Copy the resuting tarfiles to oberon using scp oberon hosts/B.oberon/oberon.named.data.tar ~username/tmp
And to titania as well with scp titania hosts/B.titania/titania/named.data.tar ~username/tmp
Extract the tarfiles on oberon and titania using sudo tar -xvf [filename]
Find the PID of the named process and issue a sudo kill -HUP [PID]
Use ping, dig and traceroute to check for errors.
Go back to the hosts directory in which you were editing the file and commit the changes to CVS by doing the following.
1. cvs add $newsite
2. cd $newsite
3. cvs add $newsite.nic $newsite.param $newsite.serial
4. cd ../..
5. cvs commit hosts

This should successfully add a new site to the necessary routing tables. If there are problems reaching the site please contact their site administrator and make sure the server is on-line and functioning properly. If there are still problems try contacti ng a network administrator. For more information on using CVS look here.

Return to Server Information

Adding A New Site

Important

Revision 1.05:Jan 17, 1997: CJR