[우분투, 민트] hylafax를 위한 avantFAX 웹 클라이언트 설치로 어디서나 편하게 팩스 이용하기

fax를 웹서비스로 구현하면 인터넷이 되고 웹브라우져만 있으면 어느곳에서나 팩스를 볼수 있고 프린트 할수 있다는 장점이 있다. 게다가 팩스의 송수신 날짜, 시간, 그리고 관리가 더욱 편해진다는 장점이 있다. 불필요한 인쇄도 줄이게 되고 여러모로 장점이 많다. 실제로 avantFAX를 설치하고 사용하면서 가장 큰 장점은 다량 송신시 편리해졌다는 점이다. 예전 수동식 팩스에서는 여러곳에 일일이 전화를 걸어 팩스를 보냈던 반면 avantFAX에서는 전화번호 목록을 입력하고 송신을 걸어두면 알아서 팩스를 차례로 보내줬다.

avantFAX는 PHP로 만들어졌고, PEAR 모듈들과 smarty라는 강력한 템플릿엔진으로 구성되어 만들어졌다. 디자인이 미려하지는 않지만 꼭 필요한 기능들은 제대로 다 구현이 되어 있기 때문에 운용상의 불편함은 전혀 없다. 가장 큰 단점은 2010년 이후 업데이트가 없다는 것 정도이다. avantFAX.com 홈페이지에서는 apache를 기본으로한 웹서버에 설치하는 인스톨 과정을 설명하고 있지만, nginX로 운영하고 있는 서버에 설치했는데 아무 문제없이 잘 돌아가고 있다. 기본적으로 웹서버는 설치되어 있다고 생각하고 진행하도록 하겠다. (웹서버에 관한 설치나 설정은 인터넷에 자료가 많으니 먼저 웹서버를 설치한후에 이 자료를 읽어주시길 부탁드린다.)

앞서 선행작업을 하지 못하신 분들은 다음의 글을 참조하세요.
1. 3Bon-USB56K USB 팩스모뎀 사용기
2. [우분투, 민트] USB56K 팩스모뎀과 hylafax로 팩스서버 구축하기

그럼 이제 avantFAX를 설치해보도록 하자.

내 설치환경
Linux Mint 17 Mate
hylafax-server, client
php5-fpm
nginX

우분투 14.04에서도 디렉토리 구성이 거의 동일하기 때문에 Mint 17과 똑같이 잘 작동할 것이라고 생각한다.

1. 필수패키지 설치

avantFAX는 다음의 패키지들이 꼭 필요하다. apt-get 혹은 시냅틱 패키지 관리자를 이용해서 아래의 패키지들을 설치해주면 되겠다.
imagemagick, libtiff-dev, netpbm, libnetpbm10-dev
libungif-bin -> giflib-tools (최근버전에서는 패키지명이 바뀌었다. 설치하지 않아도 무방했지만 일단 설치하도록 하자)
php-mail, php-mail-mime, php-file, php-db
psutils, wdiff, rsync
postfix (hylafax 설치시 설치되서 설치하지 않아도 무방하다)

imagemagick을 설치하지 않으면 thumnail 이미지가 제대로 보이지 않고, 이미지파일을 회전시켰을때 제대로 작동하지 않고 파일이 깨지게 된다. 물론 pdf 파일이 생성되기 때문에 imagemagick 패키지가 없더라도 정상작동하는데 큰 문제는 없다. ^-^; 몇몇 패키지들도 마찬가지였지만 혹시나 모를 상황이 될 수 있기 때문에 부속 패키지를 설치하도록 한다.

2. PEAR 설치

PHP용 라이브러리 모듈인 PEAR를 설치해야한다.

$ pear channel-update pear.php.net
$ pear upgrade-all
$ pear install Mail Net_SMTP Mail_mime MDB2_driver_mysql

위와 같은 명령어를 입력해도 에러메세지를 출력하면서 보안문제로 설치가 안될수 있다. 우분투나 민트 공히 동일한 증상이 나타날 가능성이 높다. pear 설치 에러메세지가 다음과 같다면 아래의 방법을 적용해 보자.
에러메세지 : Download of “pear/File_Util” succeeded, but it is not a valid package archive

# First run pear to download the packages. It will probably put the packages into
# /build/buildd/php5-5.5.9+dfsg/pear-build-download/
# but it can't install them.
$ pear upgrade

# Un-Gzip the downloaded packages.
$ sudo gunzip /build/buildd/php5-5.5.9+dfsg/pear-build-download/*.tgz

# Now pear should be able to work with the pure tar-files.
$ sudo pear upgrade /build/buildd/php5-5.5.9+dfsg/pear-build-download/*.tar

3. avantFAX 설치

먼저 소스포지에서 avantFAX 최신버전인 3.3.3을 받아오도록 한다.
http://sourceforge.net/projects/avantfax/?source=directory
다운 받은 avantfax-3.3.3.tgz 파일을 /opt 디렉토리에 넣어준다.

$ sudo tar -xvzf avantfax-3.3.3.tgz 
$ cd avantfax-3.3.3 <- 설치된 avantfax 디렉토리로 들어간다.
$ sudo mv avantfax ~계정이름/www/ <- avantfax를 설치하고 싶은 디렉토리를 지정해준다. 
공용디렉토리인 /var/www/ 로 설정해도 무방하다. 어짜피 웹서버로 가상호스팅서버를 지정해주면 되기 때문에 자신이 편한곳에 설치하도록 한다.
앞으로 설명은 /var/www/ 에 avantFAX를 설치했다는 가정하에 설명하도록 하겠다.

웹서버에서 제대로 작동하도록 소유권과 관리권한을 변경해 주도록 한다.
$ sudo chown -R www-data.www-data /var/www/avantfax
$ sudo chmod -R 0770 /var/www/avantfax/tmp /var/www/avantfax/faxes
$ sudo chown -R www-data.uucp /var/www/avantfax/tmp /var/www/avantfax/faxes

4. smarty 설정

PHP용 템플릿 엔진인 smarty의 디렉토리 권한 변경 설정을 해준다.

chmod 0770 
/var/www/avantfax/includes/templates/admin_theme/templates_c/ 
/var/www/avantfax/includes/templates/admin_theme/cache/ 
/var/www/avantfax/includes/templates/main_theme/templates_c/ 
/var/www/avantfax/includes/templates/main_theme/cache/

chown www-data.www-data
/var/www/avantfax/includes/templates/admin_theme/templates_c/ 
/var/www/avantfax/includes/templates/admin_theme/cache/ 
/var/www/avantfax/includes/templates/main_theme/templates_c/ 
/var/www/avantfax/includes/templates/main_theme/cache/

4-1. 그외 권한 변경

chmod 0755 
/var/www/avantfax/includes/faxcover.php 
/var/www/avantfax/includes/faxrcvd.php 
/var/www/avantfax/includes/notify.php 
/var/www/avantfax/tools/update_contacts.php 
/var/www/avantfax/tools/faxcover.php 
/var/www/avantfax/includes/avantfaxcron.php 
/var/www/avantfax/includes/dynconf.php

5. 환경 파일들을 설정한다.

이제 각종 설정파일들을 설정해준다.

5-1. 환경파일 생성 및 수정

example 파일을 복사해서 실제 설정파일을 만든다.
$ sudo cp avantfax/includes/local_config-example.php avantfax/includes/local_config.php

$ sudo vi /var/www/avantfax/includes/local_config.php

다음 내용을 찾아서 바꿔준다.
find
$WWWUSER = “apache”
and change to
$WWWUSER = “www-data”

파일들을 편집기로 생성하거나 파일이 이미 존재할때는 파일의 맨 끝에 추가 수정한다.

5-2. /etc/hylafax/sendfax.conf 설정

CoverCmd:         /var/www/avantfax/includes/faxcover.php

5-3. /etc/hylafax/hyla.conf 설정

#
## JobFmt for AvantFAX
#
JobFmt: "%-3j %3i %1a %15o %40M %-12.12e %5P %5D %7z %.25s"

6. mysql DB 설정

maria DB도 똑같이 설정된다.

$ cd /opt/avantfax-3.3.3
$ mysql -uroot -p < create_user.sql
$ mysql -uavantfax -pd58fe49 avantfax < create_tables.sql

7. 심볼릭링크 설정

ln -s /var/www/avantfax/includes/faxrcvd.php /var/spool/hylafax/bin/faxrcvd.php
ln -s /var/www/avantfax/includes/dynconf.php /var/spool/hylafax/bin/dynconf.php
ln -s /var/www/avantfax/includes/notify.php  /var/spool/hylafax/bin/notify.php

다음은 보통 설정되어 있는데 /usr/share/misc 디렉토리를 확인해보고 설정이 되어 있지 않으면 설정을 해줘야 한다.
ln -s /usr/share/file/magic* /usr/share/misc/

8. 백업만들기

만약을 대비해서 hylafax의 기본 설정 파일들을 백업해둔다.

mkdir /etc/hylafax/abackup
cp /etc/hylafax/config* /etc/hylafax/abackup/

9. hylafax와 연동시키기 위한 설정들

/etc/hylafax/config.ttyACM0 파일 하단에 다음을 추가
#
## AvantFAX
#
FaxRcvdCmd:     bin/faxrcvd.php
DynamicConfig:  bin/dynconf.php
UseJobTSI:      true


/etc/hylafax/config 파일 하단에 다음을 추가
#
## AvantFAX
#
NotifyCmd:      bin/notify.php

이제 마지막으로 반드시 꼭 필요한 심볼릭 링크를 생성해줘야 한다.
$ cd /var/spool/hylafax/bin
$ sudo mv faxrcvd faxrcvd.old
$ sudo mv notify notify.old
$ sudo ln -s /var/www/avantfax/includes/faxrcvd.php /var/spool/hylafax/bin/faxrcvd
$ sudo ln -s /var/www/avantfax/includes/notify.php /var/spool/hylafax/bin/notify
$ sudo mv /usr/bin/faxcover /usr/bin/faxcover.old
$ sudo ln -s /var/www/avantfax/includes/faxcover.php /usr/bin/faxcover

이제 서버상에서의 설정은 모두 끝났다. 나머지는 avantFAX를 웹상에서 실행해주면 된다.
본인의 경우는 fax.도메인.co.kr 을 이용해서 가상호스트를 할당해줬기 때문에 http://fax.도메인.co.kr 로 접속했다.

▲ 위와 같은 화면이 뜬다면 일단은 성공한것이다.

10. avantFAX에서 추가설정

ID : admin
Password : password
를 입력해서 접속한다.

▲ ①번을 눌러서 패스워드를 변경할수 있다. 일단 avantFAX에서도 모뎀 설정이 필요하기 때문에 ②번을 누른다. 슈퍼맨 모양 옆의 모니터 모양 아이콘이다. 이거 찾느라 고생을 꽤 했다 T-T;

▲ 위와 같은 화면이 나오면 왼쪽의 select box를 선택해서 Modem 을 선택한다. 지금 스샷화면은 직접 한글화를 시켜놓은 화면이 한글로 나오고 실제 설치된 화면은 영문으로 나오는 것이 기본이다.

▲ device : ttyACM0, alias : ttyACM0 를 입력하고 저장을 눌러준다. 다른 메뉴로 이동할때는 마찬가지로 왼쪽상단의 select box(-- 메뉴 --)를 선택하고 Inbox 등을 선택해서 이동하면 된다.

자! 이제 드디어 모든 설정이 다 끝났다. 설정이 꽤 많아서 혼란스러울수도 있지만, 차근히 따라하면 크게 어렵지는 않다.
기존에 hylafax를 통해 들어와 recvq에 있는 팩스들은 들어오지 않는다. avantFAX가 설치된 이후에 들어오는 팩스들만 pdf로 변환되어 들어오게 된다.

11. 삭제 아이콘 사용하기

자 이쯤에서 눈썰미가 좋으신 분들은 두번째 스샷에 보면 분명히 휴지통(삭제) 아이콘이 있는데 왜 제 화면에는 보이지 않나요 ? 라는 질문을 하시는 분들이 있을것이다. 이걸 찾느라 삼일을 소비한것 같다. 아무나 삭제 하면 문제가 발생할수 있기 때문에 이 삭제아이콘은 생성되는 아이디별로 다르게 권한을 줄수가 있고, admin 아이디 조차 default가 삭제 아이콘이 뜨지 않도록 되어 있다.
권장하고 싶은 방법은 admin에는 삭제 아이콘을 활성화 시키고, 삭제 권한이 없는 다른 아이디를 하나 더 만들어서 사원들이 아이디를 공유할수 있도록 하는 것이다.

이 옵션은 DB의 UserAccount 테이블의 can_del 값을 1로 바꿔줌으로써 활성화 시킬수 있다.
PhpMyAdmin 등의 DB 관리 프로그램을 사용하면 손쉽게 바꿀수 있다.
위의 프로그램을 사용하지 않는 분들은 다음의 수작업을 통해 해결하자.

 $ cd /opt/avantfax-3.3.3
 $ sudo vi create_user.sql <- 이 파일을 보고 패스워드를 기억해둔다.
 $ mysql -uavantfax -p
Enter Password: <- 위에서 본 패스워드를 입력

MariaDB [(none)]> use avantfax;
MariaDB [(none)]> update UserAccount set can_del = 1 where username = "admin";
Query OK, 1 row affected (0.02 sec)
Rows matched: 1  Changed: 1  Warnings: 0

MariaDB [(none)]> quit
bye

자 이제 모든 설정이 완벽히 끝났다. avantFAX에 다시 접속해보면 삭제 버튼이 활성화되어 있을 것이다.
다른 아이디를 생성하는 것은 프로그램을 설치하신 분들 각자의 몫으로 남겨두도록 하자.

PS 1. 한글화 작업에 대해서

사실 한글화 작업을 대충 해뒀고 해서 한글화 파일을 공개하려고 했으나 굳이 한글화를 할 필요가 없는 부분들이 많아서 한글화를 하는 방법만 설명하려고 한다.

$ cd /var/www/avantfax/includes/langs
$ sudo cp en.php ko.php

편집기로 ko.php를 열어서 "영문" 으로 된 부분을 "한글" 로 번역해서 바꿔주시면 된다.

$ sudo chown -R www-data.www-data ko.php

① 번 버튼을 눌렀던 Setting 을 눌러서 언어를 선택해주면 완전히 설정이 완료가 된다.

PS 1. 한국형 날짜포맷 맞추기

날짜 포맷이 미국식으로 "일.월.년 시:분"으로 맞춰져 있어서 눈에 확들어 오지 않아서 상당히 불편하다. 이럴땐 PHP소스를 수정해주면 바로 적용된다.

/var/www/avantfax/includes/local_config.php 파일을 열어서 "%d.%m.%Y %H:%M" 부분을 아래와 같이 년도와 일자 위치를 바꿔서 수정해준다.

//
//      Date format settings
//
define('FAXCOVER_DATE_FORMAT',  "%Y.%m.%d %H:%M");      // strftime format for faxcover. Example: "%m/%d/%Y %H:%M"
define('EMAIL_DATE_FORMAT',             "%Y.%m.%d %H:%M");      // strftime format for notify/faxrcvd subject email dates. Example: "%m/%d/%Y %H:%M"
define('ARCHIVE_DATE_FORMAT',   "'%Y.%m.%d %H:%i'");// SQL format for Inbox & Archive Dates.  Example: "'%m/%d/%Y %H:%i'" or "GET_FORMAT(DATETIME, 'USA')"

많은 시행착오를 겪으면서 알게 된 내용들을 모두 넣고 싶어서 최대한 넣으려고 했지만 전달력의 부족으로 여러분께 충분한 정보 전달이 되지 않을수도 있는점은 너그러운 양해를 부탁드린다.