Installing Fip Admin using Apache and Perl

version 000 18jun98 chris

Installation Notes and Other Points

Permissions

Apache conf file httpd.conf sets the GROUP for permissions. So any area of Fip (or any other bit) MUST be readable (and if using DataFormatting - writable too)

ipvi v ipbalance v NT mounted drives.

ipvi only works on Unix/liunux - need version 10 or above for quite transfers.

On NT mount /fip/tables of other fip as drive 'T' and copy to it.

NT - remember no spaces between flag and parameter for input switches

OK : ipdelque -q/fip/x -kFORM -m1 NOT OK : ipdelque -q /fip/x -k FORM -m 1

Installing Apache

UNIX - also need gzip if you downloaded the '.gz' version

where ?

(chris has reasonable versions for Solaris and NT and Dec OSF)

Web site is http://www.apache.org (NOT com)

Look for 'download' then 'binaries' for precompiled versions

If not there, take the sources and recompile (if poss)

mkdir /apache

or on UNIX, mkdir on the right volume and ln -s /grodduls/data/apache /apache

or on NT, stick it on the same drive as FIP

On NT

This is a self-extracting program

Put under /apache on the correct drive NOT c:/program files etc

unzip fippie bits into same areas

On Unix

cd /apache
gzip -d < apache.xxx.gz > apa.tar
tar xvf apa.tar
move directory 'conf' out of the way as the tar-of-fip blats it
tar xvf tapa which is the Fip stuff

conf

in /apache/conf

access.conf, httpd.conf and srm.conf from Fip bit

• Modify Group number in httpd.conf for the default group for 'nobody' (see /etc/group) unless Fip is running in its own group - DONT USE SYSADM or any root group!!!
• modify ServerAdmin in httpd.conf for correct email address
• modify DirectoryIndex to fip_logon.pl if you are using the logon bit
• modify/create /apache/htdocs/index.html as title page if NOT using fip logons

---

Diffs for our settings and the disstribution ones----------- diff access.conf access.conf-dist

15,16c15
< < ##
---
> 42,43c41
< < ##
---
> 
diff httpd.conf httpd.conf-dist
37,38c37
< #Group #-1< Group #60001---> Group #-1
43,44c42
< ServerAdmin dot@fingerpost.co.uk< ##ServerAdmin you@your.address---> ServerAdmin you@your.address
49c47
< ServerRoot /apache/---> ServerRoot @@ServerRoot@@

root@archie[59]: diff srm.conf srm.conf-dist
15,16c15
< ##DocumentRoot @@ServerRoot@@/htdocs< DocumentRoot /apache/htdocs---> DocumentRoot @@ServerRoot@@/htdocs
26,27c25
< ##DirectoryIndex index.html< DirectoryIndex /cgi-bin/fip_logon.pl---> DirectoryIndex index.html
141d138
< Alias /icons/ /apache/icons/147d143< ScriptAlias /cgi-bin/ /apache/cgi-bin/

startup

look in /apache/local for startups for :

• Sol2 : copy S97apache to /etc/rc3.d (and check rnnable)
• AIX/OSF : add a line in /etc/inittab for the start_httpd script (and check runnable)
• SunOs : add lines at the end of /etc/rc.local for the start_httpd script (and check runnable)
• NT : dos screen, cd /apache, apache -i (to install), then use controlPanel/services to start and make automatic on startup

Start the first one up manually

• Unix - /apache/local/start_httpd has the thing to run you may want to modify paths to get the right bin and the right pram file
• NT - controlPanel/service/start

maintenance - none

permissions on UNIX

• make sure all of /apache is owned by same GROUP as in httpd

or if 'nobody', chmod -R 777 /apache

• make sure all files in /apache/cgi-bin are 'x'

• make sure all test queue /apache/htdocs/form is 777

Startup/Testing

If it doesn't work - look in (ApacheHome)/log/error_log for the reason why

Perl

UNIX - also need gzip if you downloaded the '.gz' version

where ?

There are some precompiled perls

• chris has reasonable versions for Solaris and NT
• http://www.bull.de/FreeOrShareware/Smittables for AIX (also has gzip and gcc) (also http://www.bull.fr and http://www.bull.se)
• NT http://www.activeware.com has the latest NT build

The normal thing is to download the Perl sources and rebuild (usually with gcc).

Web site is http://www.perl.com then dowload 'latest.tar.gz'

mkdir /perl and /perl/bin

On NT get the drive right again

* All the scripts expect perl to be in /perl/bin

On NT

This is a self-extracting program

Put under /perl on the correct drive NOT c:/program files etc

Eveything else - like man/help pages - i dont thnk we need.

On UNIX

All we want is the program 'perl' and copy it to /perl/bin. Eveything else - like man/help pages - i dont thnk we need. check permissions - 777 on /perl/bin/perl

Wires - W4

Link/mkdir

On UNIX, need a link :

   ln -s /fip/spool/w4data /apache/htdocs/wires/w4data

general fippie bits

• ROUTE
• USERS
• XCHG

in /apache/tables

• edsys copy W4 to /fip/tables/edsys and use it in USERS
• xchg copy * to /fip/tables/xchg and use it in USERS
• formtext copy * to /fip/tables/form/text

maintenance

in /apache/local - copy zapw4data to /fip/local and add line(s) to zapfiplog (On NT - need to convert these to Perl !!)

DataFormats

data areas

mkdir /fip/spool/dftest

and check permissions - DF usies this as the raw data queue Either check the DFCOPY button works on W4 to copy raw data to 'dftest' and/or put a new destination in USERS for resending to 'dftest' with no xchg

general fippie bits

ROUTE & USERS - route all tabular copy to spool/form EVEN if not used yet as editorial do not have access to USERS etc

SYSTEM - ipformd -Q for quiet - no messages if no matching JOB

in /apache/tables

• edsys: copy W4 to /fip/tables/edsys and use it in USERS
• xchg: copy * to /fip/tables/xchg and use it in USERS
• formtext: copy * to /fip/tables/form/text for TEMPLATES

maintenance

in zapfiplog/zapfiplog.cmd,add delques for

• zapping old x/TMP ipdelque -q/fip/x -kTMP -m1
• zapping old x/FORM ipdelque -q/fip/x -kFORM -m1
• zapping old formtest ipdelque -q/fip/spool/formtest

Admin

Logon