Zmiany pomiędzy wersją początkową i wersją 1 dla AdminGuide/HylafaxInstallation

Data i czas:

10/06/09 17:47:02 (15 years temu)

Autor:

JP (IP: 213.227.67.33)

Komentarz:

--

AdminGuide/HylafaxInstallation

@@ +1 @@
+= [wiki:AdminGuide Przewodnik administratora] > Konfiguracja Hylafax na serwerze Linux =
+
+W wersji na serwerze Linux możliwa jest do skonfigurowania zintegrowana z eDokumentami usługa Serwera faksów, oparta o oprogramowanie Hylafax Server, z którym można się komunikować poprzez interfejs eDokumentów. 
+
+== Instalacja ==
+
+Generalnie instalacja samego serwera Hylafax sprowadza się do wydania kilkunastu komend. Opisane są dokładnie np. tutaj [http://www.aboutdebian.com/fax.htm].
+Poniżej znajduje się skrócona wersja:
+
+{{{
+#faxsetup (akceptujemy yes to co mówi system)
+#faxaddmodem (niżej wymienione zmieniamy, pozostałe akceptujemy)
+CountryCode:        48
+AreaCode:       32
+FAXNumber:      032 376 95 95
+LongDistancePrefix: 0
+InternationalPrefix:    00
+Protection mode for received fax - 0644
+Protection mode for session logs - 0644
+Protection mode for ttySx - 0666 
+#vim /etc/hylafax/hosts.hfaxd 
+dodajemy maskę sieci np. 192\.168\.10\.:::
+#/etc/init.d/hylafax restart
+}}}
+
+Sprawdzić poprawność wpisu w inittab, powinien wyglądać następująco:
+{{{
+S0:23:respawn:/usr/sbin/faxgetty ttyS0
+}}}
+
+Jeśli wpis jest prawidłowy wykonujemy polecenie:
+{{{
+#init q
+}}}
+
+W tym momencie Hylafax może już odbierać faksy. Można to sprawdzić wysyłając faks na numer linii do której jest podpięty modem.
+Faks powienien wylądować w recvq. Pomocna w oglądaniu aktywności faksu jest komenda faxstat z różnymi parametrami np. 
+{{{
+#faxstat 
+       -d        Display  the  status  of  all  jobs that have completed; i.e.
+                 those jobs located in  the  doneq  directory  on  the  server
+                 machine.
+       -f        Display the status of document  files  located  in  the  docq
+                 directory  on the server machine.
+       -r        Display the receive queue status for each server.
+       -s        Display  the  status  of jobs in the send queue on the server
+                 machine.
+}}}
+
+Jeżeli faxstat -r zwróci nam coś w tym stylu
+{{{
+Protect Page  Owner        Sender/TSI  Recvd@ Filename
+-rw----    1  14       +48322812806 2 Wed07AM fax000000494.tif
+-rw----    1  14           0322376477   07:51 fax000000500.tif
+}}}
+
+to znaczy że jest OK i faksy są odbierane i znajdują się w katalogu ''recvq''.
+
+
+Następnym krokiem jest sprawdzenie czy faksy są prawidłowo wysyłane. do tego użyjemy komendy
+''sendfax''.
+
+{{{
+Wysyłamy zawartość pliku /etc/hosts na numer 201
+#sendfax -vv -n -m -d 201 /etc/hosts
+
+-d destination
+-f from - adres email
+-m/-l m - fine mode, -l low resolution mode
+-n - zapobiega generowaniu CoverSheet (strony tytułowej)
+-vv - bądź gadatliwy - wyświetlaj również komendy protokołu
+}}}
+
+Sprawdzamy czy poszło...
+
+{{{
+#faxstat -d
+JID  Pri S  Owner Number       Pages Dials     TTS Status
+512  126 F   root 912155551212  0:2   1:12         Busy signal detected
+513  127 D   root 201           2:2   1:12
+}}}
+
+Przykładowy wynik oznacza że wysyłka na numer 912155551212 nie powiodła się (kolumna S = Failed),
+oraz że wysyłka na numer 280 powiodła się(S = done). Jeżeli chcemy anulować job to wykonujemy #faxrm 512
+
+== Odbieranie faksów przez eDokumenty ==
+
+Aby uzyć system eDokumenty do odbioru faksów należy wykonać kolejno czynności:
+ * skonfigurować przetwarzanie maili przez Fetchmail [wiki:Deployment/Mail Konfiguracja Emaili]
+ * skopiować odpowiednie pliki z installation:
+{{{
+cd installation
+cp conf/FaxDispatch /var/spool/hylafax/etc/
+vim /var/spool/hylafax/etc/FaxDispatch
+    FILETYPE=pdf;
+    SENDTO=archiwum@edoc.beta;
+    FROMADDR=faxserver@edoc.beta;
+}}}
+ * Restart usługi /etc/init.d/hylafax restart
+ * w eDokumentach dodać w kartotece pracownika odpowiedzialnego za odbiór faksów (np. sekretarce) mail z którego są
+ DOSTARCZANE faksy - tutaj: faxserver@edoc.beta
+
+W przypadku kiedy występuje konieczność uwierzytelniania smtp należy uzupełnić plik /var/spool/uucp/.msmtprc prawidłowymi danymi np:
+{{{
+account ips
+host ips-automation.com.pl
+from faxserver@ips-automation.com.pl
+auth login
+user faxserver@ips-automation.com.pl
+password fax123
+logfile /var/spool/uucp/msmtp.log
+
+account default : ips
+}}}
+
+W pliku /var/spool/hylafax/bin/faxrcvd należy podmienić linie 252 tak aby wyglądała następująco:
+{{{
+) 2>$ERRORSTO | msmtp --logfile=/var/spool/uucp/msmtp.log --file=/var/spool/uucp/.msmtprc $SENDTO
+}}}
+
+W przypadku gdyby wystąpiły problemy należy sprawdzić uprawnienia do pliku /dev/pts/0 ($ERRORSTO). 
+
+Od tej pory wszystkie faksy przychodzące wpadać będą na konto tej osoby w formie pliku formatu określonego w FaxDispatch (tif lub pdf). 
+
+== Wysyłanie faksów przez eDokumenty ==
+
+Aby uzyskać możliwość wysyłania faksów bezpośrednio z systemu eDokumenty. Zalecanym formatem plików do faksowania jest doc utworzony przez Worda lub pdf utworzony w !OpenOffice. Od wersji 1.9.6 formaty RTF i JPG również są wspierane. Konwersji pliku do formatu pdf można poddawać pliki doc (lub inny format) utworzone Wordem lub !OpenOffice.
+
+=== Konfiguracja ===
+konfiguracja jest prosta i wymaga edycji pliku ''/etc/sudoers'' programem ''visudo'', tak aby umożliwić
+procesowi serwera apache wykonywanie komendy sendfax poprzez mechanizm sudo.
+{{{
+User_Alias CGI=www-data
+Cmnd_Alias SENDFAX=/usr/bin/sendfax *
+CGI     ALL=NOPASSWD: SENDFAX
+}}}
+
+== Testowanie skryptu faxrcvd ==
+W celu przetestowania działania wysyłania faxów mailem:
+{{{
+./faxrcvd "../recvq/fax000000002.tif" "ttyS0" "0322482224" "msg"
+}}}
+== Wysyłanie faksów poprzez wydruk na drukarce sieciowej (dla stacji Windows) ==
+Lepszą być może i wygodniejszą opcją jest możliwość wysyłania faksów poprzez mechanizm drukarki sieciowej.
+Te możliwości stwarzają klienty serwera Hylafax:
+
+[http://winprinthylafax.sourceforge.net/] - Najprostszy w konfiguracji
+[http://whfc.uli-eckhardt.de/] - Nieco trudniejszy ale z możliwością oglądania kolejki
+
+Aby kopię doręczonego faksu przesłać na swoje konto pocztowe należy użyć opcji -f sendfaxa i odpowiedniej konfiguracji innego klienta.
+
+---
+
+== Obsługa faksu na serwerze z Windows ==
+Instalacja na serwerze Windows wymaga innego mechanizmu obsługi faksów
+Więcej o tym: [wiki:Concepts/FaxOnWindowsServer Faks i eDokumenty Windowsach]
+
+
+
+
+== UWAGI ==
+
+W ostatnich wersja serwera hylafax pojawia się problem z konwersją czcionek pojawia się błąd:
+{{{
+textfmt: No font metric information found for "Courier-Bold".
+}}}
+
+Problem jest z ścieżkami do czcionek, należy do pliku hyla.conf dopisać właściwe ścieżki do czcionek. Plik w zależności od dystrybucji powinien wyglądać tak:
+{{{
+VRes: 196
+# FontMap/FontPath added by faxsetup (wto, 17 mar 2009, 15:18:24 CET)
+FontMap:   %rom%lib/:/usr/share/ghostscript/8.63/lib:/usr/share/ghostscript/8.63/Resource:/usr/share/ghostscript/fonts:/usr/share/fonts:/usr/share/fonts/Type1:/usr/share/fonts/Type1/afm
+FontPath:  %rom%lib/:/usr/share/ghostscript/8.63/lib:/usr/share/ghostscript/8.63/Resource:/usr/share/ghostscript/fonts:/usr/share/fonts:/usr/share/fonts/Type1:/usr/share/fonts/Type1/afm
+}}}
+
+W PLD plik hyla.conf znajduje się w /usr/share/fax, w Debianie /var/spool/hylafax/etc.
+Należy również pamiętać o właściwych ścieżkach do plików map czcionek.
+
+
+Zerwowy zalocznik pdf - problem z encodowaniem. Dosinstalowac pakiet metamail(?) i poprawic linie 240:
+jest: encode
+powinno byc: mimencode
+
+
+W przypadku gdy jest brak sygnału ciągłego związane z konfiguracją centrali należy zmienić wpis w config.ttyXX z istniejącego
+{{{
+ModemResultCodesCmd:    ATQ0X4
+}}}
+
+na:
+{{{
+ModemResultCodesCmd:    ATQ0X3
+}}}
+Problem może się pojawiać dalej w przypadku modemów class 2.