Ifx installatie-handleiding (Faxpakket)
Voorbereiding door Saldata:
1. Controleer dat de tape het goede formaat heeft en leesbaar is.
2. Log daarvoor in als ifxadmin en tik in:
cd /usr/ifxadmin/temp
rm *
tar -xvf /dev/rst4
Mee te nemen:
1. De IFX-tape voor de klant.
2. De IFX handleiding voor de klant. Controleer of een license-number en activation key
aanwezig zijn.
3. Een kopie van de handleiding "Systeembeheer IFX Fax Software" voor de klant.
4. Een kopie van de basta-handleiding "Fax-module t.b.v. I(F)x-Net" van Hans Wels.
5. Eventuele verdere dokumentatie benodigd voor het faxen van dokumenten (orderbeves-
tigingen, facturen, inkooporders) vanuit een Saldata-pakket (basta, meuta, kavta).
6. Eventueel modem en aansluitsnoeren.
7. Deze handleiding.
8. Kopie IFX-tape voor de klant.
9. Onze eigen Saldata IFX-tapes + handleiding.
Installatie:
Log in als root.
Maak een nieuwe user aan:
User name: ifxadmin
Groep: staff
Password: ifxadmin
Home directory: /usr/ifxadmin
Dit kan op een grafisch console met: Application manager => system administrator
=> admintool
of op een character-based console met:
useradd -d /usr/ifxadmin -m -g staff ifxadmin
passwd ifxadmin
Maak een tijdelijke directory /usr/temp (let op de "e"!) aan voor het inlezen
van de tape:
mkdir /usr/temp
Lees nu de tape in:
cd /usr/temp
tar -xvf /dev/rstn
De "n" van "rstn" staat voor een waarde 0-9, die afhankelijk is van de confi-
guratie bij de desbetreffende klant. Overtuig je ervan dat je het goede formaat
tape hebt voordat je naar de klant gaat. Indien nodig van te voren overzetten
op een ander type tape.
Op de tape staan de volgende bestanden:
.options version, ifxnet installeren y/n
FILELIST permissions, required files & directories
INSTALL installation script
README info, tips, wijzigingen
gfs261.tar.Z ghost script etc.: dataconversieprogramma's
ifx.tar.Z eigenlijke programma
pbmplums.tar.Z source codes van conversieprogramma's ascii <=>
portable bitmap <=> fax. Meegeleverd wegens
licentierechten 3d party software.
Start nu het installatiescript op:
sh ./INSTALL
Het script vraagt in welke directories hij programma's en bestanden moet
neerzetten:
master configuration (installation files in de juiste directories):
default /etc aanhouden
IFX user programs:
default: /var/ifx wijzigen in: /usr/ifxadmin/bin
create : y
lib programs:
default aanhouden
create : y
spool:
default aanhouden
create : y
recv:
default aanhouden
create : y
ifxnet:
default aanhouden
create : y
ifxnetd (client daemon):
add to /etc/services: y
Vervolgens vraagt het script om het license nummer en de activation key. Deze zijn
met de tape meegeleverd; toets ze in. Het script meldt dan:
branding i(F)x
met het aantal UNIX-users, het aantal ifxnet-users, en het aantal faxlijnen.
Daarna vraagt het script of je de volgende zaken wilt installeren:
WP Het gaat hier om WP op de UNIX-machine in combinatie met
Ifx. Alleen "Y" ingeven indien WP werkelijk aanwezig is
en ook bekend is onder welk path dit staat. Meestal dus
"N".
postscript [Y]
update .profile [Y]
man pages [Y] IFX manual pages toevoegen aan de UNIX
on-line help.
nroff sources [Y] UNIX document opmaak
preformatted man pages [Y] t.b.v. snellere oproepbaarheid manual pages
Configuratie:
Log in als ifxadmin.
Pas nu de configuratiefile aan:
vi lib/ifx.config
De configuratiefile bevat ondermeer de volgende gegevens (verdere toelichting
staat in de file zelf; de entries die hieronder niet vermeld staan hoeven
in principe niet te worden aangepast):
language Voorlopig zijn alleen Engels en Nederlands beschikbaar
(Frans en Duits niet).
device Regel voor "modem" dupliceren, hekje weghalen; even-
tueel UNIX devicenaam aanpassen, bijvoorbeeld: device
/dev/ttyb modem.0 class2 tx,rx
Gegarandeerde modems zijn: Zyxel, Tron, Multitech,
Anchor Datacom; andere modems kunnen problemen geven.
maxage Verwijderingstermijn fax status data
maxtry Aantal pogingen dat gedaan wordt om een fax te ver-
sturen. Na dit aantal wordt de fax weggegooid! (Zie
ook "holdafter"). Een goede waarde voor deze variabele
is 10.
loglevel Bij waarden >3 worden de logfiles erg snel groter, o.a.
met het loggen van de modem polling.
maxpagetry Deze variabelen gebruiken als er regelmatig faxen van
veel pagina's worden verstuurd. Met faxen van 1 of 2
pagina's is het net zo makkelijk om de hele fax opnieuw
te versturen.
holdafter Geeft de gelegenheid om te controleren waarom er geen
verbinding kan worden gemaakt voordat het maximale
aantal pogingen is bereikt en de fax wordt weggegooid.
Een goede waarde is 8.
owncountry Landcode. Voor Nederland: 31.
areaprefix Dit is de "0" van het netnummer.
ownprefix Dit is het netnummer van het bedrijf zelf minus de
eerste "0".
accesscode Wat je moet kiezen om een buitenlijn te krijgen. Mees-
tal een 0.
localid Eigen gegevens voor persoonlijk kenmerk bovenaan de
faxpagina (waar ook datum + tijd staat). Sterk aanbevo-
len om hoofdletters te gebruiken, want sommige (oude)
faxen kunnen hier geen kleine letters aan.
Na aanpassing van de ifx.config file nog de volgende zaken controleren (als root):
Modem: enable service moet uit staan (met admintool doen) om te voorkomen
dat inbellende faxapparaten een UNIX aanlogprompt krijgen voorgeschoteld.
Het modem device moet permissie 666 hebben. Volg de links vanuit /dev/ttyb
(of zo) naar een zs*.b file en geef het commando: chmod 666 zs*.b
zodat het modem device zowel uitgelezen als beschreven kan worden.
Omdat het modem device is aangepast moet het ifxadmin shared memory worden
verwijderd. Kijk met ipcs welke ID's het ifxadmin shared memory heeft en
verwijder het met ipcrm -m ID
UNIX scripts:
Als het installatiescript klaar is, moet voor het automatisch opstarten het
bestand /etc/rc2.d/S95ifx worden aangemaakt met vi. Dit bestand moet de
volgende inhoud hebben:
# S95ifx automatisch opstarten IFX faxsoftware
IFXRC=/etc/ifx.rc; export IFXRC
. /etc/ifx.rc
su - ifxadmin -c /usr/ifxadmin/lib/runsched
Daarna executable maken met de opdracht: chmod +x /etc/rc2.d/S95ifx
Omdat er bij automatisch opstarten geen logname bekend is, moet de volgende
beveiliging in /usr/ifxadmin/lib/runsched worden gedeaktiveerd:
# Only the i(F)x administrator should execute this script!
if [ `logname` != "ifxadmin" ] ; then
#
# Must be logged-in as ifxadmin to startup the scheduler.
# Otherwise the lp command issued by ifxroute called by:
# runsched->ifxsched->ifxdaemon->ifxroute->lp (routetbl)
# won't work!
#
ifxlogmsg -q -p"$pgm" "Failed `logname`, `id`"
ifxmessage runsched_noperm $pgm
exit 1
fi
Dat kan bijvoorbeeld gebeuren door met vi voor alle 12 regels een (extra)
hekje # te plaatsen of eventueel door ze te verwijderen.
Let op: als IFX automatisch wordt opgestart zal de netwerkdemon niet gaan
draaien! De oorzaak hiervan is vooralsnog onbekend. Tot slot moet de pro-
cedure /usr/proc/ifxweg worden aangemaakt en in de crontab worden opgeno-
men. Deze procedure zorgt voor het regelmatig verwijderen van oude bestan-
den en ziet er als volgt uit:
# ifxweg: verwijderen van oude IFX-gerelateerde bestanden
# Faxfiles t.b.v. IFX in /usr/bbx/tmp na 7 dagen weggooien
find /usr/bbx/tmp/ifx* -mtime +7 -exec rm {} \; 2>/dev/null
# Logfiles van IFX na 7 dagen verwijderen
find /usr/ifxadmin/lib/.logfiles/* -mtime +7 -exec rm {} \; 2>/dev/null
# Cancel IFX-jobs ouder dan 7 dagen
cd /usr/ifxadmin/spool
for I in `find * -mtime +7 -print | sed 's/.[0-9G]$//' | sort -u`
do
/usr/ifxadmin/bin/ifxcancel -j$I -q 2>/dev/null
done 2>/dev/null
# Verwijder IFX statusfiles ouder dan 7 dagen
ifxcleanup -m 7
Om de procedure op te nemen in de crontab moet je ingelogd zijn als root.
Tik in achter de UNIX-prompt:
EDITOR=vedit
export EDITOR
crontab -e
De crontab verschijnt dan in vi, zodat je (bijvoorbeeld) de volgende regel
kunt toevoegen:
30 1 * * 2-6 /usr/proc/ifxweg
Testen:
Start de scheduler op met de opdracht runsched
controleer met ps -ef|grep ifx of de volgende processen lopen:
ifxsched de scheduler
ifxnetd de ifx client daemon
dmnclass2 -sr modem.0 de daemon die het modem pollt
ifxmon -q 5 de monitor
Kijk in het bestand lib/IFX.LOG of ifx het modem device heeft geopend en de
boodschap "now listening" heeft gelogd.
Kijk nu of je een fax kunt versturen met het commando:
ifx -Ttelefoonnummer filenaam
Probeer of het automatische opstartscript handmatig te draaien is:
/etc/rc2.d/S95ifx
Daarna, indien de bedrijfsactiviteiten van de klant dit toelaten, een echte
boottest uitvoeren en nogmaals controleren of alles loopt.
Terugkeren naar hoofdmenu