Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

22.9. Microsoft ISAPI Connector

Internet Server API(ISAPI)는 Microsoft의 인터넷 정보 서비스(IIS)와 같은 웹 서버에 대한 ODBC 서버 확장 및 필터를 작성하는 데 사용되는 API 집합입니다. isapi_redirect. offers 는 hieradata로 조정된 mod_jk 의 확장입니다. isapi_redirect.chunk 을 사용하면 SASL을 로드 밸런서로 사용하여 JBoss EAP 인스턴스를 작업자 노드로 구성할 수 있습니다.

참고

Windows Server 및 SASL의 지원되는 구성에 대한 자세한 내용은 JBoss EAP 지원 구성을 참조하십시오.

22.9.1. ISAPI 커넥터를 사용하도록 Microsoft Administrators 구성
링크 복사

Red Hat 고객 포털에서 ISAPI 커넥터를 다운로드합니다.

  1. 브라우저를 열고 Red Hat Customer Portal JBoss Software Downloads 페이지에 로그인합니다.
  2. 제품 드롭다운 메뉴에서 Web Connectors 를 선택합니다.
  3. 버전 드롭다운 메뉴에서 최신 JBoss Core Services 버전을 선택합니다.
  4. 목록에서 Red Hat JBoss Core Services ISAPI Connector 를 찾아 다운로드 링크를 클릭합니다.
  5. 아카이브를 추출하고 sbin 디렉터리의 내용을 서버의 위치에 복사합니다. 아래 명령은 콘텐츠가 C:\connectors\ 에 복사되었다고 가정합니다.

SSSD 관리자(IIS 7)를 사용하여IIS Redirector를 구성하려면 다음을 수행합니다.

  1. 시작 실행을 클릭하고 inetmgr 을 입력하여 SASL 관리자를 엽니다.
  2. 왼쪽 트리 뷰 창에서 NSX 7을 확장합니다.
  3. ISAPI 및 CGI 등록을 두 번 클릭하여 새 창에서 엽니다.
  4. 작업 창에서 추가 를 클릭합니다. ISAPI 또는 CGI 제한 추가 창이 열립니다.

  5. 다음 값을 지정합니다.

    • ISAPI 또는 CGI 경로:C:\connectors\isapi_redirect.VERSION
    • 설명:jboss
    • Enable extension path to execute: check 상자를 선택합니다.
  6. OK 를 클릭하여 ISAPI 또는 CGI Restriction 창을 닫습니다.

  7. JBoss Native 가상 디렉터리 정의

    • 기본 웹 사이트를 마우스 오른쪽 버튼으로 클릭하고 가상 디렉터리 추가를 클릭합니다. 가상 디렉터리 추가 창이 열립니다.

    • 가상 디렉터리를 추가하려면 다음 값을 지정합니다.

      • alias:jboss
      • 물리적 경로:C:\connectors\
    • 확인을 클릭하여 값을 저장하고 가상 디렉터리 추가 창을 닫습니다.

  8. JBoss Native ISAPI 리디렉션 필터 정의

    • 트리 뷰 창에서 site Default Web site를 확장합니다.
    • ISAPI 필터 를 두 번 클릭합니다. ISAPI 필터 기능 보기가 표시됩니다.
    • 작업 창에서 추가를 클릭합니다. ISAPI 필터 추가 창이 표시됩니다.

    • ISAPI 필터 추가 창에서 다음 값을 지정합니다.

      • 필터 이름:jboss
      • Executable: C:\connectors\isapi_redirect.dll
    • OK 를 클릭하여 값을 저장하고 ISAPI 필터 추가 창을 닫습니다.

  9. ISAPI- offers 처리기 활성화

    • 트리 뷰 창에서 NSX 7 항목을 두 번 클릭합니다. SASL 7 홈 기능 뷰 가 열립니다.
    • Handler Mappings 를 두 번 클릭합니다. Handler Mappings 기능 뷰 가 표시됩니다.
    • 그룹 by 콤보 상자에서 상태를 선택합니다. Handler Mappings 는 Enabled 및 Disabled Groups 에 표시됩니다.
    • ISAPI- offers를 찾습니다. Disabled 그룹에 있는 경우 마우스 오른쪽 버튼으로 클릭하고 기능 권한 편집을 선택합니다.

    • 다음 권한을 활성화합니다.

      • 읽기
      • 스크립트
      • 실행
    • 확인을 클릭하여 값을 저장하고 기능 권한 편집 창을 닫습니다.

이제 Microsoft Administrators가 ISAPI 커넥터를 사용하도록 구성되어 있습니다.

22.9.2. JBoss EAP에 클라이언트 요청을 전송하도록 ISAPI 커넥터 구성
링크 복사

이 작업은 ISAPI 커넥터의 요청을 수락하도록 JBoss EAP 서버 그룹을 구성합니다. 로드 밸런싱 또는 고가용성 장애 조치(failover)를 위한 구성은 포함되어 있지 않습니다.

이 구성은 SASL 서버에서 수행되며 외부 웹 서버의 요청을 수락 하도록 이미 JBoss EAP가 구성되어 있다고 가정합니다. 또한 Administrators 서버에 대한 전체 관리자 액세스 권한이 필요하며 ISAPI 커넥터를 사용하도록 WMCO를 구성해야 합니다.

속성 파일 생성 및 리디렉션 설정

  1. 로그, 속성 파일 및 잠금 파일을 저장할 디렉터리를 생성합니다.

    이 절차의 나머지 부분에서는 이 목적을 위해 C:\connectors\ 디렉터리를 사용한다고 가정합니다. 다른 디렉터리를 사용하는 경우 그에 따라 지침을 수정합니다.

  2. isapi_redirect.properties 파일을 생성합니다.

    C:\connectors\isapi_redirect.properties 라는 새 파일을 생성합니다. 다음 콘텐츠를 파일에 복사합니다. 

    # Configuration file for the ISAPI Connector
# Extension uri definition
extension_uri=/jboss/isapi_redirect.dll

# Full path to the log file for the ISAPI Connector
log_file=c:\connectors\isapi_redirect.log

# Log level (debug, info, warn, error or trace)
log_level=info

# Full path to the workers.properties file
worker_file=c:\connectors\workers.properties

# Full path to the uriworkermap.properties file
worker_mount_file=c:\connectors\uriworkermap.properties

#Full path to the rewrite.properties file
rewrite_rule_file=c:\connectors\rewrite.properties
    Copy to Clipboard Toggle word wrap

    rewrite.properties 파일을 사용하지 않으려면 행 시작 부분에 # 문자를 배치하여 마지막 행을 주석 처리합니다.

  3. uriworkermap.properties 파일을 생성합니다.

    uriworkermap.properties 파일에는 배포된 애플리케이션 URL과 해당 URL에 대한 요청을 처리하는 작업자 간의 매핑이 포함되어 있습니다. 다음 예제 파일은 파일의 구문을 보여줍니다. uriworkermap.properties 파일을 C:\connectors\ 에 배치합니다. 

    # images and css files for path /status are provided by worker01
/status=worker01
/images/*=worker01
/css/*=worker01

# Path /web-console is provided by worker02
# IIS (customized) error page is used for http errors with number greater or equal to 400
# css files are provided by worker01
/web-console/*=worker02;use_server_errors=400
/web-console/css/*=worker01

# Example of exclusion from mapping, logo.gif won't be displayed
# /web-console/images/logo.gif=*

# Requests to /app-01 or /app-01/something will be routed to worker01
/app-01|/*=worker01

# Requests to /app-02 or /app-02/something will be routed to worker02
/app-02|/*=worker02
    Copy to Clipboard Toggle word wrap

  4. workers.properties 파일을 생성합니다.

    workers.properties 파일에는 작업자 레이블과 서버 인스턴스 간의 매핑 정의가 포함되어 있습니다. 이 파일은 Apache mod_jk worker 속성 구성에 사용되는 것과 동일한 파일의 구문을 따릅니다.

    다음은 workers.properties 파일의 예입니다. 작업자 이름, worker01 및 worker02 는 JBoss EAP 하위 시스템에서 구성된 instance-id 와 일치해야 합니다.

    이 파일을 C:\connectors\ 디렉터리에 배치합니다. 

    # An entry that lists all the workers defined
worker.list=worker01, worker02

# Entries that define the host and port associated with these workers

# First JBoss EAP server definition, port 8009 is standard port for AJP in EAP
worker.worker01.host=127.0.0.1
worker.worker01.port=8009
worker.worker01.type=ajp13

# Second JBoss EAP server definition
worker.worker02.host=127.0.0.100
worker.worker02.port=8009
worker.worker02.type=ajp13
    Copy to Clipboard Toggle word wrap

  5. rewrite.properties 파일을 만듭니다.

    rewrite.properties 파일에는 특정 애플리케이션에 대한 간단한 URL 재작성 규칙이 포함되어 있습니다. 아래 예제와 같이 다시 작성된 경로는 이름-값 쌍을 사용하여 지정합니다. 이 파일을 C:\connectors\ 디렉터리에 배치합니다. 

    #Simple example
# Images are accessible under abc path
/app-01/abc/=/app-01/images/
    Copy to Clipboard Toggle word wrap

  6. net stop 및 net start 명령을 사용하여 SASL 서버를 다시 시작합니다. 

    C:\> net stop was /Y
C:\> net start w3svc
    Copy to Clipboard Toggle word wrap

Administrators 서버는 애플리케이션별로 구성한 특정 JBoss EAP 서버에 클라이언트 요청을 전송하도록 구성되어 있습니다.

이 구성은 지정한 JBoss EAP 서버에서 클라이언트 요청을 분산합니다. 이 구성은 SASL 서버에서 수행되며 외부 웹 서버의 요청을 수락 하도록 이미 JBoss EAP가 구성되어 있다고 가정합니다. 또한 Administrators 서버에 대한 전체 관리자 액세스 권한이 필요하며 ISAPI 커넥터를 사용하도록 WMCO를 구성해야 합니다.

여러 서버 간에 클라이언트 요청 균형 조정

  1. 로그, 속성 파일 및 잠금 파일을 저장할 디렉터리를 생성합니다.

    이 절차의 나머지 부분에서는 이 목적을 위해 C:\connectors\ 디렉터리를 사용한다고 가정합니다. 다른 디렉터리를 사용하는 경우 그에 따라 지침을 수정합니다.

  2. isapi_redirect.properties 파일을 생성합니다.

    C:\connectors\isapi_redirect.properties 라는 새 파일을 생성합니다. 다음 콘텐츠를 파일에 복사합니다. 

    # Configuration file for the ISAPI Connector
# Extension uri definition
extension_uri=/jboss/isapi_redirect.dll

# Full path to the log file for the ISAPI Connector
log_file=c:\connectors\isapi_redirect.log

# Log level (debug, info, warn, error or trace)
log_level=info

# Full path to the workers.properties file
worker_file=c:\connectors\workers.properties

# Full path to the uriworkermap.properties file
worker_mount_file=c:\connectors\uriworkermap.properties

#OPTIONAL: Full path to the rewrite.properties file
rewrite_rule_file=c:\connectors\rewrite.properties
    Copy to Clipboard Toggle word wrap

    rewrite.properties 파일을 사용하지 않으려면 행 시작 부분에 # 문자를 배치하여 마지막 행을 주석 처리합니다.

  3. uriworkermap.properties 파일을 생성합니다.

    uriworkermap.properties 파일에는 배포된 애플리케이션 URL과 해당 URL에 대한 요청을 처리하는 작업자 간의 매핑이 포함되어 있습니다. 다음 예제 파일은 부하 분산 구성이 있는 파일의 구문을 보여줍니다. 와일드카드(*) 문자는 다양한 URL 하위 디렉터리에 대한 모든 요청을 라우터라는 로드 밸런서에 전송합니다. 로드 밸런서의 구성은 다음 단계에서 다룹니다.

    uriworkermap.properties 파일을 C:\connectors\ 에 배치합니다. 

    # images, css files, path /status and /web-console will be
# provided by nodes defined in the load-balancer called "router"
/css/*=router
/images/*=router
/status=router
/web-console|/*=router

# Example of exclusion from mapping, logo.gif won't be displayed
# /web-console/images/logo.gif=*

# Requests to /app-01 and /app-02 will be routed to nodes defined
# in the load-balancer called "router"
/app-01|/*=router
/app-02|/*=router

# mapping for management console, nodes in cluster can be enabled or disabled here
/jkmanager|/*=status
    Copy to Clipboard Toggle word wrap

  4. workers.properties 파일을 생성합니다.

    workers.properties 파일에는 작업자 레이블과 서버 인스턴스 간의 매핑 정의가 포함되어 있습니다. 이 파일은 Apache mod_jk worker 속성 구성에 사용되는 것과 동일한 파일의 구문을 따릅니다.

    다음은 workers.properties 파일의 예입니다. 로드 밸런서는 worker01 및 worker02 를 구성하도록 파일 끝 부분에 구성됩니다. 이러한 작업자 이름은 JBoss EAP 하위 시스템에서 구성된 instance-id 와 일치해야 합니다.

    이 파일을 C:\connectors\ 디렉터리에 배치합니다. 

    # The advanced router LB worker
worker.list=router,status

# First EAP server definition, port 8009 is standard port for AJP in EAP
#
# lbfactor defines how much the worker will be used.
# The higher the number, the more requests are served
# lbfactor is useful when one machine is more powerful
# ping_mode=A – all possible probes will be used to determine that
# connections are still working

worker.worker01.port=8009
worker.worker01.host=127.0.0.1
worker.worker01.type=ajp13
worker.worker01.ping_mode=A
worker.worker01.socket_timeout=10
worker.worker01.lbfactor=3

# Second EAP server definition
worker.worker02.port=8009
worker.worker02.host=127.0.0.100
worker.worker02.type=ajp13
worker.worker02.ping_mode=A
worker.worker02.socket_timeout=10
worker.worker02.lbfactor=1

# Define the LB worker
worker.router.type=lb
worker.router.balance_workers=worker01,worker02

# Define the status worker for jkmanager
worker.status.type=status
    Copy to Clipboard Toggle word wrap

    ⁠

  5. rewrite.properties 파일을 만듭니다.

    rewrite.properties 파일에는 특정 애플리케이션에 대한 간단한 URL 재작성 규칙이 포함되어 있습니다. 아래 예제와 같이 다시 작성된 경로는 이름-값 쌍을 사용하여 지정합니다. 이 파일을 C:\connectors\ 디렉터리에 배치합니다. 

    #Simple example
# Images are accessible under abc path
/app-01/abc/=/app-01/images/
Restart the IIS server.

Restart your IIS server by using the net stop and net start commands.
C:\> net stop was /Y
C:\> net start w3svc
    Copy to Clipboard Toggle word wrap

NSX 서버는 workers.properties 파일에서 참조된 JBoss EAP 서버에 클라이언트 요청을 전송하여 1:3 비율로 서버에 부하를 분산하도록 구성되어 있습니다. 이 비율은 각 서버에 할당된 로드 밸런싱 요소(lbfactor)에서 파생됩니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2026 Red Hat맨 위로 이동