Requirements Information for TPM Software
Release Version 3.x
September 20, 2004
========================================================================================

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

========================================================================================
Requirements expected at the installation site
========================================================================================
        
========================================================================================
Hardware: TPM  Linux Box, with the following  minimum configuration
========================================================================================
        
		PC Intel P4 or better, with 512+ Mb RAM, 
        80+ Gb HD, CPU 800+ Mhz,  1Gb Ethernet Card (compatible with RH Linux)
        
========================================================================================
Software: RH Linux 9.0/Enterprize  - Full Workstation Software Installation .
========================================================================================

	A Full Installation guarentees that you will install all the packages
        you need for operation and that the assumed directories and files
		will exist. 

	If a partial installation is done  make sure you have at least the following
		(you will be resposible to  inspect the TPM log file for errors if problems occur	
		should you decide not to install the Full Workstation Software package).  
				
		Editor Package
			gedit, vi...
		Graphical Internet Package
			Mozilla etc..
		Web Server Package
			Apache httpd Version  2.0.x
		Windows File Server Package
			Samba
		Sound and Video Package
		Graphics Package
		MySQL Package
		ImageMagick utilities  
		curl
		wget
		Development Tools Package
			Perl 5.x with Perl CGI.pm
			gcc & associated libraries 
                        Legacy Software Development Package 
			this is essential if you are performing only a partial software installation
			
			These packages include:
			compat-glibc- Compatibility C library
			compat-libstdc++  Standard C++ libraries for RH backward compatibility
			compat-gcc  The GNU Compiler Collection for RH backward compatibility
			compat-libstdc++ Header files and libraries for RH backward compatibility
			compat-gcc-c++ support for RH backward compatibility
                        		
                        
                        
========================================================================================
Firewall : Open Ports Required: 80, 443, 8900, 22 all other ports may be shutdown
========================================================================================
                
  
========================================================================================
Additional Commodity Off The Shelf - Hardware and/or Software to be purchased by the Site
========================================================================================
        
	Any number of  Axis Internet Appliance (Standalone Video Servers see below)
	Any number of Video Cameras, 
		Note: more than 10 camera's per server on a high traffic site is not recommended
		However this software has been tested with 20+ cameras on a low traffic site
                Any number of  Telerobotic cameras (Sony EVI-D31/Canon VCC4)
        
	Axis Internet Appliances  must be installed and running using Version 2.34 or better
	of the Axis Firmware. Information on Upgrading AXIS Firmware is found at the following
	URL 
                
                http://www.axis.com/techsup/cam_servers/
                
	Sites should follow instructions and upgrade their units to the correctFirmware version. 
                
	=========================
	Compatible AXIS Devices
	=========================

	 The following Axis internet appliances have been fully tested and are compatible with 
	 the TPM system. 
 
  		Axis 2400 Video Server
 		Axis 2401 Video Server
 		Axis 2400+ Video Server
 		Axis 2401+ Video Server 
		Axis 205  IP Camera
		Axis 241S Video Server --- recommended (at least 1 each)
		Axis 241Q Video Server --- recommended  (at least 1 each)
  
		Canon VCC4 Pan Zoom Tilt (PZT) Camera.
		Axis 2130 Pan Zoom Tilt (PZT) Camera.
		Sony EVI/D31 Pan Zoom Tilt (PZT) Camera. --- recommended (at least 1 each)
  
		Additional NTSC Video cameras can be plugged into the Axis 241Q Internet Appliance
                
              
                
========================================================================================
Pre-Installation Information needed by the Installation  Site
========================================================================================
        
	URL/IP address for the TPM Server
	URL/IP address for the NEESPop Server
	URL/IP addresses for each of the Axis devices
	URL/IP address of LView DAQ computer... 
	License key for BroadWare IMS Proxy Server 

	As part of the of the TPM package,  the SI team has negotiated
	a NEES wide license  for the BroadWare IMS Commodity streaming server used as one of the
	streaming video components in the  TPM Server.  The procurement for this upgrade has
	been completed and all original 16 NSF NEESgrid Equipment sites are eligible to receive
	this license under the blanket (pre-paid) contract.

	This NEES wide license provides  all ES capabilities with a proxy server which 
	is licensed for  10 input video 	streams and 500 output streams. 

	In order to receive your  upgrade and/or initial installation licence please
	provide to zaluzec@aaem.amc.anl.gov  the following information by Email:

	1.) Equipment Site Name:
	2.) Contact Person:
	3.) Email Address of Contact Person:
	4.) Phone Number of Contact Person:
	5.) TPM Server URL (or IP Address):
	6.) Mac Address of the above TPM Server:
	7.) Existing  license key (upgraded EA sites only):

	Some equipment sites  have installed multiple TPM servers,  for those of you to whom this
	applies please submit a seperate request for each TPM server individually.

	This license upgrade completely compatible with all TPM release versions.

                	
	If you are NOT an original NEES Equipment Site these licenses can be purchased from 
                        Broadware Technologies
                        attn:Jeremy Silver
                        408 891 4134
                        Email:jeremy@broadware.com

                        Part Number:    P-PSL-NGPEDU
                        Product:        IMS 2.0 for RH  Linux  
                        Price:          $2,000

	Note: the Broadware license is NOT required to install the TPM server software
	you can install a basic operating package without this license  which will operate
	for testing purposes, and which will still server Video stream. It will however be
	insecure and performance limited.  	You can install a TPM server without a Broadware
	license and at a future date add the license to bring your site into the correct
	operating mode.  
                                
                
========================================================================================
Installation Notes:
========================================================================================

	Installation requires a ROOT User who is familiar with RHLinux Software Installation.
        
	Installation on RH 7.3, 8.0, 9.0, Enterprize OSs have all been
	tested and have been installed without problems using the 
	supplied installation script, for TPM Version through 2.2

	Installation of TPM Version 3.x has only been tested on RH 9/Enterprize.
	Note: RH 9/Enterprize is the RECOMMENDED OS. 
                
	=============================
	Installation Options:
	=============================

	
	There are NO default paths and/or answers to any of the questions in the installation
	scripts you must type in a full text answer to each question.

	The installation scripts will ask you which version of RH you are running
	you must reply properly for the correct libraries and functions to be installed.
	RH 9/Enterprize is recommended for TPM V 3.x         

	During installation the installer will be required to provide a BroadWare Video Proxy
	server license key (see requirements). If not yet available, the TPM installation script
	can install a basic operating package without this license which is suitable for testing
	purposes, and which will still serve Video streams. It will however be insecure and 
	performance limited.   At a future date you can add the license to bring your site 
	into the recommended operating mode.  

	During installation the user will be queried if a camera is public and/or private.
	It is STRONGLY recommended that the first camera is a public camera, all the
	rest may be private.  Private cameras are password protected from access by the
	general public. The Administrator is provided a Tool to configure user authorization
	for private access. 

	A  Log File is created during the installation and which documents the installation
	steps. If installation fails (see Installation Verification) the user should  
	reference this file and look for installation errors. Failure is indicated by 
	the inability to perform the Unit Test procedures. 
                
	The TPM Software should NOT be installed on the NEESPop Server.
	The design of this software requires for it to be installed on a seperate Linux Server.
                

========================================================================================
Installation Verification:
========================================================================================

	To verify installation, download the TPM and ENotebook Unit Test
	documents. If all the steps in these documents can be replicated then the
	installation is considered successful.