페이지 트리
메타 데이터의 끝으로 건너뛰기
메타 데이터의 시작으로 이동

Integrating with IIS

 

이 페이지는 IIS 가 JIRA에 질문을 전송하거나 사용자에게 답변을 보낼 때와 같은Microsoft's IIS web server와 JIRa를 환경설정하는 방법에 대해 설명합니다. serving web page를 운용하는 IIS를 이미 가지고 있는 것은 유용하고, 다른 URL과 마찬가지로 JIRA를 통합하는 것이 바람직합니다.

JIRA는 Java로 쓰여졌고 운용할 Java application Server가 필요합니다. IIS는 Java application Server의 service를 제공하지 않기 때문에 JIRA를 직접 IIS로 배치하는 것은 불가능합니다. 그러나 JIRA가 배치된 application server로 요청사항들을 대용하여 IIS를 환경설정하는 것은 가능합니다. 그러므로 IIS에서 주요 website를 운용한다면 이 website로 JIRA를 통합하는 것이 가능합니다.

IIS로 JIRA를 통합해야 한다면 JIRA는 IIS 통합 용량을 제공하는 Java Application Server로 배치되어야 합니다.  Apache tomcat은 이러한 application server 중의 하나입니다. JIRA의 standalone distribution은 Apache tomcat을 포함합니다. 만약 Standalone distribution이나 자체 Tomcat instance로 JIRA WAR을 배치하였다면 이 설명서를 따르십시오.

Standalone distritution이나 Apache Tomcat을 사용하지 않는다면  IIS로 통합하는 것이 가능한지 그것을 어떻게 실행할 수 있는지를 결정하기 위해 application server의 documentation을 참조하시기 바랍니다.

IIS로 JIRA를 통합하기 위해서는 다음을 실행해야 합니다.

1. JIRA를 환경설정하고 자체 accord상에서 작동하는지 테스트하십시오.

2. IIS로부터 대용(proxy?)된 요청사항들을 허용하기 위해 Tomcat을 환경설정 하십시오.

3. Tomcat(JIRA)에 대용요청하기 위해 IIS를 환경설정 하십시오.

Configuring JIRA

1. JIRA의 Standalone distritution을 환경설정하거나 apache tomcat으로 WAR distribution을 배치하고 설치하기 위해서는 JIRA Stsandalone 설치안내서를

    따르십시오. 필수사항은 아니지만 JIRA는 IIS와 같이 같은 컴퓨터상에서 설치될 수 있습니다.

2. JIRA web application의 context 경로를 변경하십시오.

    IIS가 JIRA에 요청을 proxy하는 것을 허용하기 위해서 JIRA web application은 Tomcat에서 context 경로로 배치되어야만 합니다. 이 context 경로는 IIS가 요청

   사항들을 proxy하여 사용할  URL에 있는 경로로 설치되어야 합니다. 예를 들어, website가 IIS에서www.example.com주소로 운용되고 있다면 JIRA가

    www.example.com/jira하에서 이용 가능하도록 만들 것입니다. Tomcat에 있는 "/jira"로 JIRA의 contest 경로를 설치해야 합니다.

   이를위해 JIRA Standalone이나 jira.xml파일 또는 JIRA의 WAR distribution을 사용하고 있다면 conf/server.xml 파일을 편집하십시오. context element 의 경로

   속성을 "/jira"로 변경하십시오.

   예를 들어 JIRA Standalone3.3과 그 이후의 버전에서 Context element는 다음과 같이 나타납니다.

 

<Context path="/jira" docBase="$

Unknown macro: {catalina.home}

/atlassian-jira"
            swallowOutput="true" reloadable="false">
 

3. context path를 변경한 후에 JIRA를 재시작 하십시오.

4. Tomcat에 web browser를 직접 지정하여 JIRA가 제대로 작동하고 있는지 테스트 하십시오. (예로 http://localhost:8080/jira)그리고 JIRA의 Setup wizard를

    실행하십시오.

    이미 Setup Wizard를 끝냈다면 이슈를 생성하거나 그것을 편집하십시오.  어떤 문제점들이 발생하지 않았는지 확인하십시오.

Configure Tomcat to accept proxied requests

IIS로부터 JIRA에 대한 요청들을 Tomcat이 받아들일 수 있도록 허용하기 위해서는 conf/server.xml 파일을 편집하고 AJP/1.3 Connector가 작동되어있는지 확인하십시오.

(i.e는 comment out 되지 않았습니다)

JIRA standalone, Tomcat5.5 또는 Tomcat5.0.x에서 AJP/1.3을 작동하기 위해서 ,conf/server.xml 파일에 있는 다음 부분 주변의 comment symbols

(<!-and->를 삭제하십시오.

 <Connector port="8009"
            enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />

conf/server.xml 파일에 있는 Tomcat 4.1xthe AJP/1.3 connector definition에서 JIRA Standalone3.2나 초기 버전 또는 JIRA를 운용하고 있다면 다음과 같이 나타납니다.

 <Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
            port="8009" minProcessors="5" maxProcessors="75"
            enableLookups="true" redirectPort="8443"
            acceptCount="10" debug="0" connectionTimeout="0"
            useURIValidationHack="false"
            protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>
 <Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
            port="8009" minProcessors="5" maxProcessors="75"
            enableLookups="true" redirectPort="8443"
            acceptCount="10" debug="0" connectionTimeout="0"
            useURIValidationHack="false"
            protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>
 <Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
            port="8009" minProcessors="5" maxProcessors="75"
            enableLookups="true" redirectPort="8443"
            acceptCount="10" debug="0" connectionTimeout="0"
            useURIValidationHack="false"
            protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>

 

위의 예시는 port 8009상에서 Proxied IIS request들에 대해 주의하기 위해 Tomcat을 환경설정합니다. 이 port가 JIRA가 작동하는 컴퓨터상에서 이미 사용되고 있다면 다른 port로 변경하십시오.

2. Tomcat을 재시작하고 logs 또는 Tomcat console에서 port 출현에 사용된 것과 관련하여 어떤 문제점이 있는지 확인하십시오.

3. AJP Connector가 지정된 port(기본값에 의해 8009)상에서 잘 작동하고 있는지 확인하십시오. 이 실행을 위한 한 가지 방법은 command window에서

   "netstat-na"명령을 사용하는 것이고 port 8009가 output에서 리스트 되었는지 보십시오.

 

그림

 

Configuring IIS

1. apache site로부터 ISAPI Redirect installer를 다운로드 하십시오. 다운로드 할 때 IIS가 운용되고 있는 Windows의 버전을 선택하십시오.(win32 또는 win 64).

    그리고 이용할 수 있는 최신 jk 버전을 선택하십시오. 다운로드할 파일은 isapi_redirect.msi로 불립니다.

2. 다운로드 파일을 실행하여 installer를 작동하십시오. 기본값에 의해 그 파일들은 "C:\Program files\Apache Software Foundation\Jakarta Isapi 

    Redirector" directory로 설치됩니다.

3. "C:\Program files\Apache Software Foundation\Jakarta Isapi Redirector" directory에서 uriworkermap.properties 와 workers.properties.minimal

    파일들을 수정해야 합니다.  workers.properties.minimal 파일들은 Tomcat이 작동하는 장소를 IIS에게 명령합니다. uriworkermap.properties 는 Tomcat이

    어떤 요청들을 proxy하는지를 IIS에 명령합니다.

    이 파일들을 편집하기 위해 다음의 과정들을 따르십시오.

         -  1. uriworkermap.properties를 편집하고 /jkmanager=jkstatus.를 제외한 모든 mapping들을 comment out 하십시오.

         -  2. 파일의 끝부분에 /jira/*=wlb 라인을 추가하여 JIRA에 mapping을 추가하십시오.

               이 파일의 마지막 라인은 다음과 같이 나타납니다.

 

        /jkmanager=jkstatus
                /jira/*=wlb

             참고: mappting은 이 설명서의 Configuring JIRA에 설명된 것처럼 Tomcat에서 JIRA가 배치되어진 context 경로와 같아야 합니다.

         - 3. workers.properties.minimal 파일을 편집하고 필요하다면 worker.ajp13w.host property를 수정하십시오. 이 property는  Tomcat이 작동하는

               컴퓨터의 IP 주소 또는 host name 에 설치되어야 합니다.

               Tomcat이 IIS와 똑같은 컴퓨터에서 작동한다면 localhost에 property set를 남길 수 있습니다. 이 property의 값으로 host name이 지정되었다면,

               IIS 컴퓨터가 적절한 IP주소에 그것을 정확하게 지정될 수 있는지 확인하십시오.

          - 4. AJP Connector가 port를 수정했다면 worker.ajp13w.port property를 수정해야 할 것입니다. AJP에 default port를 사용하고 IIS와 같이 똑같은

                컴퓨터상에서 작동하는 Tomcat과 관련된 파일들의 예시가 있습니다.

 

worker.list=wlb,jkstatus
#
# Defining a worker named ajp13w and of type ajp13
# Note that the name and the type do not have to match.
#
worker.ajp13w.type=ajp13
worker.ajp13w.host=localhost
worker.ajp13w.port=8009

#
# Definingaloadbalancer
#

worker.wlb.type=lb
worker.wlb.balance_workers=ajp13w

#
# Definestatusworker
#

worker.jkstatus.type=status

 

 

4. IIS5.0을 사용한다면 IIS를 재시작 해야합니다. IIS가 재시작 되었는지 그리고 수정한 configuration 파일들을 읽는지를 확인하는 가장 좋은 방법은 control Panel

   을 탐색하는 것입니다. (질문)그리고 관리도구를 탐색하고 Service를 여는 것입니다. "World Wide Web Publishing"이름을 가진 서비스를 탐색하고 그곳에서 오른

   쪽 클릭한 후 "Stop"를 선택하십시오. service가 멈추었을 때 오른쪽 클릭으로 재시작하고 "Start"를 선택합니다.

5. Control Panel 그리고 Administrative Tool을 열고, Internet Information Service를 여십시오.

6. IIS6.0을 사용하고 있다면 ISAPI Filter를 추가해야합니다.

    - 1. Default Web Site에서 (JIRA에서 proxying 하는 요청들에 대한 역할을 하는 Web         Site) 그리고 Property를 클릭하십시오.

    - 2. ISAPI filter tab을 클릭하십시오.

    - 3. Filter isapi_redirect.dll 파일을 지정하는 Filter가 있는지 검사하십시오, 그러면 그것은 올바르게 위치하고 있습니다. 만약 그렇지 않을 경우, Add를 클릭

        하고 새로운 것을 생성하십시오. Filter 이름으로 tomcat을 입력하고 실행을 위한 isapi_redirect.dll 파일의 위치를 입력하십시오.

7. IIS에 JIRA을 위한 virtual directory를 생성하십시오.

    - 1.  Default web Site에 오른쪽 클릭하십시오.(JIRA에 request proxying을 위한 역할을 하는 Web Site) New 그리고 Virtual Directory를 선택하십시오,

    - 2. wizard 생성으로 가십시오. Configure JIRA에 설치된 context path (slashes 없이) 의 값처럼 alias를 설치하십시오. 예시에서는 이것이 jira입니다.

    - 3. 이것은 어떠한 directory에도 지정할 수 있습니다.

    - 4. wizard를 끝내십시오.

참고: virtual directory를 생성하는 것은 trailing slash 없이 요청들이 작동될 수 있도록 하기 위해 요구되는 것입니다. 예를 들어 /" title="Visit page outside Confluence" rel="nofollow"linktype="raw" linktext="http://www.example.com/jira/">http://www.example.com/jira/

에서 virtual directory 없이 JIRA를 배치한다면  http://www.example.com.jira 의 요청들은 작동하지 않을 것입니다.

8. IIS 6.0을 사용한다면 Web Service Extension처럼 dII을 추가해야 합니다.

    -1. Web Serviece Extensions에서 오른쪽 클릭하고 add a new Web Service Extension을 선택하십시오.

    -2. Extension name에 tomcat을 입력하고 요청된 파일에 isapi_redirect.dll파일을 추가하십시오.

    -3. Set extension status to Allowed를 검사하고 OK를 클릭하십시오.

9. 실행이 끝났습니다. IIS 에 있는 web browser를 configuration point로 테스트하기 위해서 URL에 JIRA의 context path를 추가하십시오. 예를 들어 

    ." title="Visit page outside Confluence" rel="nofollow"linktype="raw" linktext="http://www.example.com.">http://www.example.com. 의 주소에서 website가

   운용되고 있다면 jira의 context path와 감께 JIRA를 배치한 것입니다. http://www.example.com.에서    browser을 지정하십시오.

  • 레이블 없음