Installation Procedure TPM Software
Release Version 3.0.1
August 30, 2004
========================================================================================

Nestor J. Zaluzec
Argonne National Lab
zaluzec@aaem.amc.anl.gov
630-252-5075

========================================================================================

Outline/Summary of Steps to install TPM software  


0.) 	Read the requirements documentation first.               


                 
1)      Download the Installation Software (5 files)
                NJZTPM-V3.0.tar
                TPMInstallationScript-V3.0
                TPMInstallDocumentation-V3.01.txt (this file)
				UnitTest-TPM.doc
				UnitTest-ENotebook.doc



2) Login as root and create installation directory 

		su 

        mkdir /tmp1 (if it does not exist) 

        cd /tmp1
        
3)      copy the distribution software to this directory
        
        Copy NJZTPM-V3.0.tar -> /tmp1
        Copy TPMInstallationScript-V3.0 ->/tmp1
        Copy TPMInsallDocs-V3.0.txt -> /tmp1
        
4)      Make the Script executable and run it
        
                chmod +x /tmp1/TPMInstallationScript-V3.0
               
        
        Execute the installation script
                
                "/tmp1/TPMInstallationScript-3.0"
        
5) Follow the on-screen directions/requests as the script above executes


6) Reboot server after installation and test 

        Login via a Netscape Browser to: http://<tpmhosturl>
        
        
7.) Final Sites Specific Tasks - This must be done manually the the SysOp

If desired Create a lcoal logo GIF image for the NEES Banner.
	The Image Dimensions should be  < 625 x 60
	Upload both image to /var/www/htdocs/Images

	Make links to default file names. 
        
                ln -s /var/www/htdocs/Images/YourBannerLogo.gif /var/www/htdocs/Images/TPMBannerLogo.gif
                logo size  < W=625  H=60
        
  

8.) The installation username/password for the Admin Page is "neestpm" "neestpm"
	you should login and change the password as soon as possible. This is done
	using the user_manage tool accessible from the Admin Page. 

	Login to the TPMSite
	Select "Admin Button" (enter default administrative username/password = neestpm/neestpm)
	Select "User Manager" function (you may need to re-enter your admin username/password)
	Select "User=neestpm" 
	Select "Add/Edit" button
	A new page appears on the Far Right Hand Side "Set New Password" 
	Select "Set Values" button. 
	


9.) To test functionality of the TPM Installation, you should run the
	following Unit tests:

	TPM UNIT Test
	ENotebook Unit Test
	
Copies of these tests are downloadable from  the TPM Installation Site.                




---------------------------------------------------------------------------------------

The text below is an outline of the steps that are occuring as the Script executes
it is not intended to be a step-by-step listing, but only an outline to give
the installer an idea of what is happening. Not all possible scenerios are
outlined below only the most general one. 

A log file of the installation is automatically created so that installation
problems can be studied should the site not match the installation requirements. 

---------------------------------------------------------------------------------------


Untar the software distribution files
         
        tar xvf NJZTPM.tar
        
/tmp1 now contains the following

        
-rwxr-xr-x   1 zaluzec  admin       41269  1 Jul 15:09 BWhttpd.conf
-rwxr-xr-x   1 zaluzec  admin        1631  1 Jul 15:09 BWsystem.cfg
-rw-r--r--   1 zaluzec  admin      205056  1 Jul 15:09 CGI.pm.tar.gz
-rw-r--r--   1 zaluzec  admin     2536668  1 Jul 15:09 ImageMagick-5.4.7-10.i386.rpm
-rw-r--r--   1 zaluzec  admin         199  1 Jul 15:09 TPM.htaccess
-rw-r--r--   1 zaluzec  admin       51329  1 Jul 15:09 TPMApache1.3x.httpd.conf
-rw-r--r--   1 zaluzec  admin       35467  1 Jul 15:09 TPMApache2.x.httpd.conf
-rw-r--r--   1 zaluzec  admin     4935680 13 Jul 15:01 TPMhtdocs.tar
-rw-r--r--   1 zaluzec  unknown     20480 13 Jul 15:02 TPMsecurity.tar
-rw-r--r--   1 zaluzec  admin    11345920  1 Jul 15:09 bw_ims-linux.tar
-rw-r--r--   1 zaluzec  admin     3610179  1 Jul 15:09 compat-db-4.0.14-5.i386.rpm
-rw-r--r--   1 zaluzec  admin     2438483  1 Jul 15:09 compat-gcc-7.3-2.96.122.i386.rpm
-rw-r--r--   1 zaluzec  admin     1848405  1 Jul 15:09 compat-gcc-c++-7.3-2.96.118.i386.rpm
-rw-r--r--   1 zaluzec  admin     1849421  1 Jul 15:09 compat-gcc-c++-7.3-2.96.122.i386.rpm
-rw-r--r--   1 zaluzec  admin     1422293  1 Jul 15:09 compat-glibc-7.x-2.2.4.32.5.i386.rpm
-rw-r--r--   1 zaluzec  admin     1055026  1 Jul 15:09 compat-libstdc++-7.3-2.96.122.i386.rpm
-rw-r--r--   1 zaluzec  admin      361775  1 Jul 15:09 compat-libstdc++-devel-7.3-2.96.122.i386.rpm
-rw-r--r--   1 zaluzec  admin    20080640  1 Jul 15:09 ffmpeg-0.4.6-Sept2002.tar
-rw-r--r--   1 zaluzec  admin    25146816  1 Jul 15:09 j2sdk-1_3_1_04-linux-i586-rpm.bin
-rw-r--r--   1 zaluzec  admin         334  1 Jul 15:09 jvm.cfg
-rw-r--r--   1 zaluzec  admin        1792 30 Jun 17:36 perl.conf
-rw-r--r--   1 zaluzec  admin         958  1 Jul 15:09 realms.conf
-rw-r--r--   1 zaluzec  admin      113916  1 Jul 15:09 user_manage.tar.gz



	BWhttpd.conf					part of  IMS V 2.0
	BWsystem.cfg					part of  IMS V 2.0
	CGI.pm.tar.gz					Perl Software
	ImageMagick-5.4.7-10.i386.rpm	Image Handling routinges
	TPM.htaccess					TPMConfiguration File
	TPMApache1.3x.httpd.conf		TPMConfiguration File
	TPMApache2.x.httpd.conf			TPMConfiguration File
	TPMhtdocs.tar					TPM Source tree
	TPMsecurity.tar					TPMConfiguration File
	bw_ims-linux.tar				IMS V 2.0
	compat-db-4.0.14-5.i386.rpm		Linux Compatibility rpms
	compat-gcc-7.3-2.96.122.i386.rpm	Linux Compatibility rpms
	compat-gcc-c++-7.3-2.96.118.i386.rpm	Linux Compatibility rpms
	compat-gcc-c++-7.3-2.96.122.i386.rpm	Linux Compatibility rpms
	compat-glibc-7.x-2.2.4.32.5.i386.rpm	Linux Compatibility rpms
	compat-libstdc++-7.3-2.96.122.i386.rpm	Linux Compatibility rpms
	compat-libstdc++-devel-7.3-2.96.122.i386.rpm	Linux Compatibility rpms
	ffmpeg-0.4.6-Sept2002.tar			FFMPEG software for capturing streams
	j2sdk-1_3_1_04-linux-i586-rpm.bin	Java
	jvm.cfg								Java Config
	perl.conf							Perl Config
	realms.conf							Realms Config
	user_manage.tar.gz					Perl Software



Execute the (long and involved) installation Script

        /tmp1/TPMInstallation-Script-V3.0       
        
        
The script does the following steps (this is a summary not a step by step outline
see the installation script for details if you want them)
        
        
        
        Creates a log file to record the installation process
        Logs some CPU info
        Untars the distribution package
        Untars and Installs Broadware package
        Installs compatiblity RPM's for the different versions of RH & Apache
        	that are needed. All necesary RPM's should be included in the
        	Installation TARBALL.
        Modifies Configuration Files for Apache, BW and installs Perl PM's.
        Restarts the Various WWW servers used 
        Installs a compatible version of  FFMPEG
       	Creates TPM Configuration Files by asking Installer about Cameras etc...
	   	Creates all the Associated files once TPMConfiguration Data is collected
	   	
        
        

Note the following  Ports are should be open for the TPM Site: 80, 443, 8900, 22


Problems contact Nestor Zaluzec @ ANL (info @ top of this file).