S.u.S.E. Dochost

고객지원 지식기반 (ray_dochost)

Full-text search and the central documentation server

S.u.S.E.-Linux 5.2 두 개의 새로운 패키지로 시작 :

함께 사용하면, S.u.S.E.-Linux의 도큐멘테이션은 도큐멘테이션 서버의 중앙에 설치되어질 수 있다. 그러면 그것은 확장된 탐색 시설을 사용해서 넷에서 원하는 호스트로부터 접근되 어질 수 있다. 도큐멘테이션은 온라인 매뉴얼, HOWTO 뿐만 아니라 완전한 S.u.S.E. 도움 시스템을 포함한다.

클라이언트가 로컬 장소에 도큐멘테이션을 저장할 필요가 없다. 그래서 적은 디스크 저장소 가 필요하다.

더욱이 ht://Dig는 전체의 도큐멘테이션내의 편리한 풀-텍스트 검색 접근을 제공한다.

네트워킹 시설을 가지지 않은 환경에서도 ht://Dig는 도큐멘테이션 내의 플-텍스트 탐색에 사용되어질 수 있다.

Preconditions on the documentation server

다음의 패키지들은 반드시 설치되어야 한다. :

클라이언트 없이 도큐멘테이션 서버를 실행하는 것이 가능하다. 그러면 로컬 컴퓨터에서 풀 -텍스트 탐색을 할 수 있다.

Preconditions on the client machine

Installation dochost 패키지는 세 개의 새로운 변수를 /etc/rc.config 내에 정의한다. :

       DOC_HOST
       DOC_SERVER
       DOC_ALLOW
이것들은 구성뿐만이 아니라 도큐멘테이션 서버의 접근을 조정한다.

Client installation : 단순히 DOC_HOST가 도큐멘테이션 서버를 가지키도록 하라. /usr/bin/help를 호출한 뒤에 Web-browser는 단순히 로컬 도큐멘테이션을 읽는 것 대신에 도큐멘테이션 서버로부터 읽 는다. E.g.

       DOC_HOST="doku.domain.top"
DOC_SERVER의 값은 "no"가 되어야 한다.

Server installation :

어떠한 완전한 넷 접근도 서버 설치에 필요하지 않다. 만약 풀-텍스트 검색을 위해서 ht://Dig 만을 지역적으로 사용하고자 한다면 그것은 또한 사용되어질 수 있다.

다음의 변수들을 /etc/rc.config 내에 설정하라. (YaST에 있는 System administration -> Change configuration file 메뉴를 사용하라.)

       START_HTTPD="yes"
는 설정되어야만 한다. 왜냐하면 서버로써의 사용을 위한 선행조건이 Web-server를 실행하 고 있기 때문이다.
       DOC_SERVER="yes"
이것은 도큐멘테이션 서버로서 도큐멘테이션을 활성화시킨다. 그러면 S.u.S.E. 도움시스템 의 모든 로컬 참조는 서버로 변경된다. 그러면 웹 서버를 통한 접근이 가능하다.
       DOC_ALLOW="LOCAL .yourdomain.top"
DOC_ALLOW내에서는 모든 컴퓨터/도메인들이 저장되어지고 http-rman을 통한 도큐멘테이 션 서버의 로컬 맨 페이지의 접근 권한을 가져야만 한다. 이러한 엔트리는 /etc/hosts.allow 에 접근을 허용하기 위해서 기록되어진다. 로컬 도메인이나 접근 권한을 가져야 하는 컴퓨 터들의 목록은 그곳에 입력되어야 한다.

만약 추가적으로 풀-텍스트 검색을 이용하고자 한다면, ht://Dig 내의 데이터베이스가 반드 시 먼저 초기화되어져야 한다. dohost 패키지는 자동적으로 그것을 위한 적절한 구성을 생 성한다. 현재 풀-텍스트 인덱스는 70MB의 크기를 가진다. 이와 같이 적어도 이러한 양이 공간이 /opt/www/htdig 아래에 가능해야 한다.

이제 초기화하기 위해서 다음의 명령어를 실행하라.:

       /usr/sbin/suserundig
일반적으로 초기화는 더 이상 1시간 이상 걸리지 않는다...

이제 풀-텍스트 검색은 완전히 기능적이다.

Have fun!


키워드: HELP, DOC, DOCU, DOCUMENTATION

SDB-ray_dochost, Copyright SuSE Linux AG, Nrnberg, Germany - 버전: 09. Mr 2001
SuSE Linux AG - 최근에 만들어진 : 09. Mr 2001 에 의해 kmyoo (sdb_gen 1.40.0)