SiteMinder Apache 기반 서버용 웹 에이전트 설치 안내서

Transcription

1 SiteMinder Apache 기반서버용웹에이전트설치안내서 12.51

2 포함된도움말시스템및전자적으로배포된매체를포함하는이문서 ( 이하 " 문서 ") 는정보제공의목적으로만제공되며 CA 에의해언제든변경또는취소될수있습니다. CA 의사전서면동의없이본건문서의전체혹은일부를복사, 전송, 재생, 공개, 수정또는복제할수없습니다. 이문서는 CA 의기밀및독점정보이며, 귀하는이문서를공개하거나다음에의해허용된경우를제외한다른용도로사용할수없습니다 : (i) 귀하가이문서와관련된 CA 소프트웨어를사용함에있어귀하와 CA 사이에별도동의가있는경우, 또는 (ii) 귀하와 CA 사이에별도기밀유지동의가있는경우. 상기사항에도불구하고, 본건문서에기술된라이선스가있는사용자는귀하및귀하직원들의해당소프트웨어와관련된내부적인사용을위해합당한수의문서복사본을인쇄또는제작할수있습니다. 단, 이경우각복사본에는전체 CA 저작권정보와범례가첨부되어야합니다. 본건문서의사본인쇄또는제작권한은해당소프트웨어의라이선스가전체효력을가지고유효한상태를유지하는기간으로제한됩니다. 어떤사유로인해라이선스가종료되는경우, 귀하는서면으로문서의전체또는일부복사본이 CA 에반환되거나파기되었음을입증할책임이있습니다. CA 는관련법의허용범위내에서, 상품성에대한묵시적보증, 특정목적에대한적합성또는권리위반보호를비롯하여 ( 이에제한되지않음 ) 어떤종류의보증없이본문서를 " 있는그대로 " 제공합니다. CA 는본시스템의사용으로인해발생되는직, 간접손실이나손해 ( 수익의손실, 사업중단, 영업권또는데이터손실포함 ) 에대해서는 ( 상기손실이나손해에대해사전에명시적으로통지를받은경우라하더라도 ) 귀하나제 3 자에게책임을지지않습니다. 본건문서에언급된모든소프트웨어제품의사용조건은해당라이선스계약을따르며어떠한경우에도이문서에서언급된조건에의해라이선스계약이수정되지않습니다. 본문서는 CA 에서제작되었습니다. 본시스템은 " 제한적권리 " 와함께제공됩니다. 미합중국정부에의한사용, 복제또는공개는연방조달규정 (FAR) 제 조, 제 조, 제 (c)(1) 호 - 제 (2) 호및국방연방구매규정 (DFARS) 제 (b)(3) 호또는해당하는경우후속조항에명시된제한사항을따릅니다. Copyright 2013 CA. All rights reserved. 본시스템에서언급된모든상표, 상호, 서비스표시및로고는각해당회사의소유입니다.

3 CA Technologies 제품참조 이문서는다음 CA Technologies 제품을참조합니다 : CA SiteMinder CA IdentityMinder ( 이전의 CA Identity Manager) CA SiteMinder Web Services Security( 이전의 CA SOA Security Manager) CA 에문의 기술지원팀에문의 온라인기술지원및지사목록, 기본서비스시간, 전화번호에대해서는 에서기술지원팀에문의하십시오.

4

5 목차 제 1 장 : 준비 9 Apache 기반웹서버에만적용되는절차... 9 SiteMinder 에이전트를위한하드웨어요구사항 Apache 기반웹서버를위한준비로드맵 Apache 기반서버에서웹에이전트설치를준비하는방법 플랫폼지원표찾기 Windows 운영환경을위한 Apache 기반서버준비 UNIX 운영환경에서 Apache 기반서버준비 Linux 운영환경을위한 Apache 기반서버준비 z/os 시스템에서에이전트설치및구성을준비하는방법 지원되는모든운영환경을위한 IBM HTTP 서버준비 정책서버요구사항 제 2 장 : Windows 에서 Apache 기반에이전트설치및구성 27 에이전트설치와에이전트구성비교 Windows 시스템에서에이전트를설치하는방법 설치프로그램에필요한정보수집 Windows 에서설치프로그램실행 Windows 시스템에서에이전트를구성하는방법 Windows 에서구성프로그램에필요한정보수집 Windows 에서웹에이전트구성프로그램실행 Windows 에서후속에이전트에대해무인또는자동설치및구성프로그램실행 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 37 에이전트설치와에이전트구성비교 UNIX 또는 Linux 시스템에서에이전트를설치하는방법 설치에필요한정보수집 UNIX/Linux 에서설치프로그램실행 z/os 시스템에서에이전트를설치하는방법 설치에필요한정보수집 z/os 에서 SiteMinder 에이전트설치프로그램실행 UNIX/Linux 에서에이전트를구성하는방법 UNIX/Linux 에서구성프로그램에필요한정보수집 목차 5

6 UNIX 또는 Linux 운영환경에서에이전트환경스크립트의경로수정 UNIX 또는 Linux 시스템에서라이브러리경로변수설정 UNIX/Linux 에서웹에이전트구성프로그램실행 UNIX/Linux 에서에이전트에대해무인또는자동설치및구성프로그램실행 LD_PRELOAD 변수설정 SuSE Linux 9 for zseries 의 Apache 에이전트에대한 LD_ASSUME_KERNEL 설정 Red Hat Linux 시스템에대한 CAPKIHOME 변수설정 z/os 시스템에서에이전트를구성하는방법 z/os 에서구성프로그램에필요한정보수집 z/os 에서라이브러리경로변수설정 z/os 에서 SiteMinder 에이전트구성프로그램실행 ( 선택사항 ) z/os 의 SiteMinder 에이전트에대해무인또는자동설치및구성프로그램실행 UNIX/Linux 에대한선택적에이전트설정 apachectl 스크립트를사용하는경우웹에이전트변수설정 httpd.conf 파일을변경하여서버성능향상 ( 선택사항 ) 제 4 장 : 동적정책서버클러스터 57 동적정책서버클러스터에웹에이전트연결 제 5 장 : 웹에이전트시작및중지 59 웹에이전트사용 웹에이전트사용안함 apachectl 명령을사용하여대부분의 Apache 기반에이전트시작또는중지 apachectl 명령을사용하여 IBM HTTP Server 시작 제 6 장 : 웹에이전트로업그레이드 63 에이전트업그레이드로드맵 SiteMinder 에이전트업그레이드를준비하는방법 SiteMinder r6.x 에서업그레이드 SiteMinder r12.0 에서업그레이드 SiteMinder r12.0 에서업그레이드 LD_PRELOAD 변수가기존에이전트와충돌하지않도록설정 Windows 에서설치마법사를실행하여에이전트업그레이드 UNIX/Linux 에서설치마법사를실행하여에이전트업그레이드 UNIX/Linux 에서업그레이드된에이전트를구성하기전에라이브러리경로변수설정 Windows 에서업그레이드된에이전트구성 UNIX/Linux 에서업그레이드된에이전트구성 Apache 기반서버용웹에이전트설치안내서

7 제 7 장 : 운영체제조정 77 공유메모리세그먼트조정 Solaris 10 리소스컨트롤을조정하는방법 제 8 장 : 웹에이전트제거 81 웹에이전트제거에대한참고사항 SiteMinder 에이전트를제거하기전에 PATH 변수에 JRE 설정 Windows 운영환경에서웹에이전트제거 UNIX 시스템에서웹에이전트제거 z/os 시스템에서 SiteMinder 에이전트제거 제 9 장 : 문제해결 89 Apache 서버를시작할때 shmget 오류표시 Apache 에이전트를사용할수있지만기본서버페이지또는보호된리소스에액세스할수없음 Apache 웹에이전트가작동하지않음 영어가아닌입력문자에정크문자가포함됨 부록 A: 워크시트 91 에이전트설치워크시트 에이전트구성워크시트 목차 7

8

9 제 1 장 : 준비 이섹션은다음항목을포함하고있습니다. Apache 기반웹서버에만적용되는절차 ( 페이지 9) SiteMinder 에이전트를위한하드웨어요구사항 ( 페이지 10) Apache 기반웹서버를위한준비로드맵 ( 페이지 11) Apache 기반서버에서웹에이전트설치를준비하는방법 ( 페이지 12) 정책서버요구사항 ( 페이지 23) Apache 기반웹서버에만적용되는절차 이안내서에는 Apache 기반웹서버에서 SiteMinder 에이전트를설치하거나구성하는절차만포함되어있습니다. 다른유형의웹서버또는운영환경에서 SiteMinder 에이전트를설치하거나구성하려면다음안내서를참조하십시오. Domino 용웹에이전트설치안내서 IIS 용웹에이전트설치안내서 Oracle iplanet 용웹에이전트설치안내서 제 1 장 : 준비 9

10 SiteMinder 에이전트를위한하드웨어요구사항 SiteMinder 에이전트를위한하드웨어요구사항 다음은 SiteMinder 에이전트를호스트하는컴퓨터의하드웨어요구사항입니다. Windows 운영환경요구사항 Windows 운영환경에서 SiteMinder 에이전트를사용하려면다음과같은하드웨어가필요합니다. CPU: x86 또는 x64 메모리 : 2 GB 시스템 RAM 사용가능한디스크공간 : 설치위치의사용가능한디스크공간 2 GB 임시위치의사용가능한디스크공간 0.5 GB UNIX 운영환경요구사항 UNIX 운영환경에서 SiteMinder 에이전트를사용하려면다음과같은하드웨어가필요합니다. CPU: Solaris 운영환경 : SPARC Red Hat 운영환경 : x86 또는 x64 메모리 : 2 GB 시스템 RAM 사용가능한디스크공간 : 설치위치의사용가능한디스크공간 2 GB /temp 디렉터리의사용가능한디스크공간 0.5 GB 참고 : 일상적인에이전트작업을위해서는 /tmp 디렉터리에 10 MB 의사용가능한디스크공간이필요합니다. 에이전트는 /tmp 에파일및명명된파이프를생성합니다. 이러한파일과파이프가생성되는경로는변경할수없습니다. 10 Apache 기반서버용웹에이전트설치안내서

11 Apache 기반웹서버를위한준비로드맵 Apache 기반웹서버를위한준비로드맵 다음그림에서는 SiteMinder 에이전트를설치하기전에웹서버를준비하는방법을보여줍니다. 제 1 장 : 준비 11

12 Apache 기반서버에서웹에이전트설치를준비하는방법 Apache 기반서버에서웹에이전트설치를준비하는방법 Apache 기반서버에서 SiteMinder 에이전트설치를준비하려면다음절차를수행하십시오. 1. Platform Support Matrix( 플랫폼지원표 ) 를찾습니다 ( 페이지 12). 설치할 SiteMinder 에이전트버전을웹서버에서지원하는지확인하십시오. 2. 웹서버에대해다음권한중하나가지정된계정이있는지확인합니다. 관리자권한 (Windows 운영환경의경우 ) 루트권한 (UNIX 또는 Linux 운영환경의경우 ) 3. 다음목록중하나를사용하여 SiteMinder 에이전트에필요한추가설정을구성합니다. Windows 운영환경을위한 Apache 기반서버준비 UNIX 운영환경을위한 Apache 기반서버준비 ( 페이지 14) Linux 운영환경을위한 Apache 기반서버준비 ( 페이지 15) 모든운영환경을위한 IBM HTTP 서버준비 ( 페이지 22) 4. 정책서버가설치및구성되어있는지확인합니다. 5. 웹에이전트릴리스정보에서알려진문제에대한단원을검토합니다. 플랫폼지원표찾기 운영체제및기타필수타사구성요소가지원되는지여부를확인하려면플랫폼지원표를사용하십시오. 다음단계를수행하십시오. 1. CA Support 사이트에로그인합니다. 2. "Technical Support"( 기술지원 ) 섹션을찾습니다. 3. "Product Finder"( 제품찾기 ) 필드에 "SiteMinder" 를입력합니다. SiteMinder 제품페이지가표시됩니다. 4. "Product Status"( 제품상태 ), "SiteMinder Family of Products Platform Support Matrices"(SiteMinder 제품군플랫폼지원표 ) 를차례로클릭합니다. 참고 : Oracle Developer Network 에서최신 JDK 및 JRE 버전을다운로드할수있습니다. 12 Apache 기반서버용웹에이전트설치안내서

13 Apache 기반서버에서웹에이전트설치를준비하는방법 Windows 운영환경을위한 Apache 기반서버준비 Windows 운영환경에서 Apache 기반서버를실행중인경우에는 SiteMinder 에이전트를설치하기전에다음과같은준비가필요합니다. 1. Apache 기반웹서버를모든사용자를위한서비스로설치합니다 ( 페이지 13). 2. 적절한권한이지정된 logs 하위디렉터리가있는지확인합니다 ( 페이지 13). Windows 의 Apache 웹서버를모든사용자를위한서비스로설치 단일사용자계정을사용하여 Apache 기반웹서버가설치되면에이전트구성에서 Apache 기반웹서버설치를검색할수없습니다. 이문제를해결하려면 Windows 운영환경에서 Apache 기반웹서버를설치할때다음옵션을선택하십시오. "install as a service, available for all users". Apache 기반웹에이전트에대해권한이지정된 Logs 하위디렉터리가있는지확인 Apache 기반웹서버 (IBM HTTP Server 포함 ) 용 SiteMinder 에이전트의경우해당웹서버의루트디렉터리에 logs 하위디렉터리가있어야합니다. 이하위디렉터리에는 Apache 자식프로세스를실행하는사용자아이덴티티에대한읽기및쓰기권한이필요합니다. logs 하위디렉터리가없으면필요한권한과함께새로생성해야합니다. 참고 : 이구성요구사항은 Apache 루트디렉터리외부에로그파일을작성하는모든 Apache 기반웹서버에적용됩니다. 제 1 장 : 준비 13

14 Apache 기반서버에서웹에이전트설치를준비하는방법 UNIX 운영환경에서 Apache 기반서버준비 UNIX 운영환경에서 Apache 기반서버를실행중인경우에는 SiteMinder 에이전트를설치하기전에다음과같은준비가필요합니다. 1. display 변수를설정합니다 ( 페이지 14). 2. logs 하위디렉터리가있는지확인합니다 ( 페이지 14). 3. 운영환경에맞는적절한패치가설치되어있는지확인합니다. Solaris 패치 ( 페이지 15) AIX 요구사항 ( 페이지 15) UNIX 에서 SiteMinder 에이전트설치를위해 DISPLAY 설정 Telnet 또는 Exceed 터미널과같은원격터미널에서 UNIX 시스템에 SiteMinder 에이전트를설치하는경우로컬시스템에대한 DISPLAY 변수가설정되어야합니다. 예를들어 시스템의경우다음과같이변수를설정합니다. DISPLAY= :0.0 export DISPLAY 참고 : X Window 디스플레이모드가필요없는콘솔모드설치를사용하여에이전트를설치할수도있습니다. Apache 기반 SiteMinder 에이전트에대해권한이지정된 Logs 하위디렉터리가있는지확인 Apache 기반웹서버 (IBM HTTP Server 포함 ) 용 SiteMinder 에이전트의경우해당웹서버의루트디렉터리에 logs 하위디렉터리가있어야합니다. 이하위디렉터리에는 Apache 자식프로세스를실행하는사용자아이덴티티에대한읽기및쓰기권한이필요합니다. logs 하위디렉터리가없으면필요한권한과함께새로생성해야합니다. 참고 : 이구성요구사항은 Apache 루트디렉터리외부에로그파일을작성하는모든 Apache 기반웹서버에적용됩니다. 14 Apache 기반서버용웹에이전트설치안내서

15 Apache 기반서버에서웹에이전트설치를준비하는방법 필요한 Solaris 패치 Solaris 컴퓨터에 SiteMinder 에이전트를설치하기전에다음패치를설치하십시오. Solaris 패치필요 Solaris 패치필요 루트사용자로로그인하여다음명령을실행하면설치된패치버전을확인할수있습니다. showrev -p grep patch_id Solaris 패치를찾으려면 Oracle Solution Center 에문의하십시오. AIX 요구사항 AIX 시스템에서 SiteMinder 에이전트를실행하려면다음과같은구성요소가필요합니다. AIX 시스템에서다시설계된 ( 프레임워크 ) Apache 기반 SiteMinder 에이전트를실행하려면 C/C++ 런타임환경이 버전이어야합니다. Linux 운영환경을위한 Apache 기반서버준비 Linux 운영환경에서 Apache 기반서버를실행중인경우에는 SiteMinder 에이전트를설치하기전에다음과같은준비가필요합니다. 1. 필요한패치가설치되어있는지확인합니다 ( 페이지 16). 2. 필요한라이브러리가설치되어있는지확인합니다. 3. 필요한도구가설치되어있는지확인합니다 ( 페이지 17). 4. Apache 기반웹서버를컴파일합니다 ( 페이지 18). 5. logs 하위디렉터리가있는지확인합니다 ( 페이지 18). 제 1 장 : 준비 15

16 Apache 기반서버에서웹에이전트설치를준비하는방법 필요한 Linux 패치 필요한 Linux 라이브러리 다음과같은 Linux 패치가필요합니다. 64 비트 Linux 시스템에서실행되는웹에이전트 Binutils 2.17 GCC Linux 운영환경에서작동하는에이전트의경우특정라이브러리파일이필요합니다. 올바른라이브러리를설치하지못하면다음과같은오류가발생할수있습니다. java.lang.unsatisfiedlinkerror 이구성요소의 Linux 버전을설치, 구성또는업그레이드하는경우호스트시스템에다음라이브러리가필요합니다. Red Hat 5.x compat gcc-34-c patch_version.i386 libstdc++-4.x.x-x.el5.i686.rpm 16 Apache 기반서버용웹에이전트설치안내서

17 Apache 기반서버에서웹에이전트설치를준비하는방법 Red Hat 6.x libstdc++-4.x.x-x.el6.i686.rpm 또한 Red Hat 6.x(64 비트 ) 의경우 libxau el6.i686.rpm libxcb el6.i686.rpm compat-db el6.i686.rpm compat-db el6.i686.rpm libx el6.i686.rpm libxrender el6.i686.rpm libexpat.so.1(expat el6_2.i686.rpm 에서제공 ) libfreetype.so.6(freetype el6_2.9.i686.rpm 에서제공 ) libfontconfig.so.1(fontconfig el6.i686.rpm 에서제공 ) libice el6.i686.rpm libuuid el6.i686.rpm libsm el6.i686.rpm libxext el6.i686.rpm compat-libstdc el6.i686.rpm compat-db el6.i686.rpm libxi el6.i686.rpm libxtst el6.i686.rpm libxft el6.i686.rpm libxt el6.i686.rpm libxp el6.i686.rpm 필요한 Linux 도구 Red Hat Enterprise Linux 운영환경에서실행되는 Red Hat Apache 2.2 웹서버에 SiteMinder 에이전트를설치하려면먼저 Red Hat Legacy Software Development 도구패키지에포함된항목을모두설치해야합니다. 제 1 장 : 준비 17

18 Apache 기반서버에서웹에이전트설치를준비하는방법 Linux 시스템의 Apache 웹서버컴파일 Linux 가실행되는 Apache 웹서버에서 SiteMinder 에이전트를사용하려면서버를컴파일해야합니다. 에이전트코드에는 pthreads(posix 호환스레드루틴라이브러리 ) 가사용되지만 Linux 플랫폼의 Apache 서버에는기본적으로 pthreads 가사용되지않으므로컴파일작업이필요합니다. lpthread 옵션을사용하여컴파일하지않으면 Apache 서버가시작된후중단되고요청을처리하지않습니다. Linux 의 Apache 서버는 Linux 의동적로드문제때문에 pthreads 를사용하는모듈을초기화할수없습니다. 다음단계를수행하십시오. 1. 다음을입력합니다. LIBS=-lpthread export LIBS 2. 다음을입력하여 Apache 를구성합니다. configure --enable-module=so --prefix=your_install_target_directory make make install Apache 기반 SiteMinder 에이전트에대해권한이지정된 Logs 하위디렉터리가있는지확인 Apache 기반웹서버 (IBM HTTP Server 포함 ) 용 SiteMinder 에이전트의경우해당웹서버의루트디렉터리에 logs 하위디렉터리가있어야합니다. 이하위디렉터리에는 Apache 자식프로세스를실행하는사용자아이덴티티에대한읽기및쓰기권한이필요합니다. logs 하위디렉터리가없으면필요한권한과함께새로생성해야합니다. 참고 : 이구성요구사항은 Apache 루트디렉터리외부에로그파일을작성하는모든 Apache 기반웹서버에적용됩니다. 18 Apache 기반서버용웹에이전트설치안내서

19 Apache 기반서버에서웹에이전트설치를준비하는방법 z/os 시스템에서에이전트설치및구성을준비하는방법 z/os 운영환경에서 SiteMinder 에이전트를설치및구성하기전에여기에설명된준비단계를수행하십시오. 1. SiteMinder Platform Support Matrix(SiteMinder 플랫폼지원표 ) 를찾습니다 ( 페이지 12). 2. 설치미디어를찾습니다 ( 페이지 20). 3. 지원되는 JRE 를시스템경로에추가합니다 ( 페이지 22). 4. DISPLAY 변수를설정합니다 ( 페이지 21). 5. logs 하위디렉터리가있는지확인합니다 ( 페이지 14). 제 1 장 : 준비 19

20 Apache 기반서버에서웹에이전트설치를준비하는방법 플랫폼지원표찾기 설치미디어찾기 운영체제및기타필수타사구성요소가지원되는지여부를확인하려면플랫폼지원표를사용하십시오. 다음단계를수행하십시오. 1. CA Support 사이트에로그인합니다. 2. "Technical Support"( 기술지원 ) 섹션을찾습니다. 3. "Product Finder"( 제품찾기 ) 필드에 "SiteMinder" 를입력합니다. SiteMinder 제품페이지가표시됩니다. 4. "Product Status"( 제품상태 ), "SiteMinder Family of Products Platform Support Matrices"(SiteMinder 제품군플랫폼지원표 ) 를차례로클릭합니다. 참고 : Oracle Developer Network 에서최신 JDK 및 JRE 버전을다운로드할수있습니다. 기술지원사이트에서설치미디어를가져올수있습니다. 다음단계를수행하십시오. 1. CA Support 사이트에로그인합니다. 2. "Technical Support"( 기술지원 ) 섹션을찾습니다. 3. "Download Center"( 다운로드센터 ) 를클릭합니다. 4. "Support by Product"( 제품별지원 ) 섹션을찾습니다. 5. "Select a Product Page"( 제품페이지선택 ) 필드에 SiteMinder 를입력하고 Enter 키를누릅니다. 6. "Downloads"( 다운로드 ) 를클릭합니다. "Download Center"( 다운로드센터 ) 화면이표시됩니다. 7. "Select a Product"( 제품선택 ) 필드에 SiteMinder 를입력합니다. 8. "Select a Release"( 릴리스선택 ) 드롭다운목록에서릴리스를선택합니다. 20 Apache 기반서버용웹에이전트설치안내서

21 Apache 기반서버에서웹에이전트설치를준비하는방법 9. "Select a Gen Level"(Gen Level 선택 ) 드롭다운목록에서서비스팩을선택합니다. 10. "Go"( 이동 ) 를클릭합니다. "Product Downloads"( 제품다운로드 ) 화면이표시됩니다. 여기에는 SiteMinder 설치실행파일이모두나열됩니다. z/os 에서 SiteMinder 에이전트설치를위해 DISPLAY 변수설정 원격터미널에서 z/os 시스템에 SiteMinder 에이전트를설치하는경우로컬시스템에대해 DISPLAY 변수가설정되어야합니다. 예를들어서버 IP 주소가 이면다음과같이변수를설정합니다. export DISPLAY= :0.0 참고 : X Window 디스플레이모드가필요없는콘솔모드설치를사용하여 SiteMinder 에이전트를설치할수도있습니다. Apache 기반 SiteMinder 에이전트에대해권한이지정된 Logs 하위디렉터리가있는지확인 Apache 기반웹서버 (IBM HTTP Server 포함 ) 용 SiteMinder 에이전트의경우해당웹서버의루트디렉터리에 logs 하위디렉터리가있어야합니다. 이하위디렉터리에는 Apache 자식프로세스를실행하는사용자아이덴티티에대한읽기및쓰기권한이필요합니다. logs 하위디렉터리가없으면필요한권한과함께새로생성해야합니다. 참고 : 이구성요구사항은 Apache 루트디렉터리외부에로그파일을작성하는모든 Apache 기반웹서버에적용됩니다. 제 1 장 : 준비 21

22 Apache 기반서버에서웹에이전트설치를준비하는방법 지원되는 JRE 를시스템경로에추가 z/os 시스템에서 SiteMinder 에이전트를설치하기전에지원되는 JRE 가시스템에있는지그리고 PATH 및 JAVA_HOME 시스템변수에정의되어있는지확인합니다. 다음단계를수행하십시오. 명령프롬프트에서다음명령을입력합니다. export PATH=JRE/bin:$PATH export JAVA_HOME=JRE JRE JRE 의위치를지정합니다. 예 : /sys/java64bt/v6r0m1/usr/lpp/java/jversion_number 지원되는모든운영환경을위한 IBM HTTP 서버준비 Apache 기반 IBM HTTP 서버를사용중인경우에는 SiteMinder 에이전트를설치하기전에다음과같은준비가필요합니다. 서버로그에대한쓰기권한이있는지확인합니다 ( 페이지 22). IBM HTTP Server 로그를위한쓰기권한허용 IBM HTTP Server 에 SiteMinder 에이전트를설치하는경우이웹서버는루트로설치되고그룹의일부사용자만하위디렉터리에대한쓰기권한을갖습니다. LLAWP(Low Level Agent Worker Process) 에서에이전트초기화메시지를웹서버로그에쓸수있으려면웹서버를실행하는사용자에게웹서버의로그디렉터리에대한쓰기권한이필요합니다. 이사용자에대한쓰기권한을허용하십시오. 22 Apache 기반서버용웹에이전트설치안내서

23 정책서버요구사항 정책서버요구사항 다음조건을확인하십시오. 정책서버가설치및구성되었습니다. 정책서버가에이전트를설치할컴퓨터와통신할수있습니다. 참고 : 자세한내용은정책서버설명서를참조하십시오. SiteMinder 에이전트를설치하고구성하려면정책서버에최소한다음항목이필요합니다. 트러스트된호스트등록권한이있는 SiteMinder 관리자 트러스트된호스트는하나이상의 SiteMinder 에이전트가설치되고정책서버에등록되는클라이언트컴퓨터입니다. SiteMinder 관리자는트러스트된호스트를정책서버에등록할수있는권한이있어야합니다. 트러스트된호스트를등록하면정책서버에서고유의트러스트된호스트이름개체가생성됩니다. 에이전트아이덴티티 에이전트아이덴티티는에이전트를호스트하는웹서버인스턴스의이름또는 IP 주소와정책서버간의매핑을설정합니다. 관리 UI 의 " 에이전트 " 개체에서에이전트아이덴티티를정의합니다. 여기서이름을할당하고에이전트유형을웹에이전트로지정합니다. 호스트구성개체 (HCO) 정책서버의호스트구성개체는초기연결후에이전트와정책서버간의통신을정의합니다. 초기연결에는 SmHost.conf 파일의매개변수가사용됩니다. 제 1 장 : 준비 23

24 정책서버요구사항 ACO( 에이전트구성개체 ) 이개체는에이전트구성을정의하는매개변수를포함합니다. 모든 SiteMinder 에이전트에는 ACO 에정의된다음구성매개변수가하나이상필요합니다. AgentName 웹에이전트의아이덴티티를정의합니다. 이아이덴티티는에이전트를호스트하는각웹서버인스턴스의이름과 IP 주소또는 FQDN 을연결합니다. 다음과같은이벤트가발생하면 AgentName 매개변수대신 DefaultAgentName 값이사용됩니다. AgentName 매개변수가사용되지않도록설정된경우 AgentName 매개변수의값이비어있는경우 AgentName 매개변수의값이기존에이전트개체와일치하지않는경우 참고 : 이매개변수에는값을여러개지정할수있습니다. 이매개변수를에이전트구성개체에설정하는경우다중값옵션을사용하고로컬구성파일에설정할경우에는각값을파일에서별도의행에추가합니다. 기본값 : 기본값없음 제한 : 여러값이허용되지만각 AgentName 매개변수당 4,000 자로제한됩니다. 매개변수이름에문자를추가하여필요한만큼추가 AgentName 매개변수를생성하십시오. 예 : AgentName, AgentName1, AgentName2 제한 : 범위의 7 비트 ASCII 문자를포함하고인쇄가능한문자가하나이상있어야합니다. 앰퍼샌드 (&) 와별표 (*) 는사용할수없습니다. 이값은대 / 소문자를구분하지않습니다. 예를들어 MyAgent 와 myagent 는같은이름으로처리됩니다. 예 : myagent1, (IPV4) 예 : myagent2, 2001:DB8::/32 (IPV6) 예 : myagent, 예 ( 여러 AgentName 매개변수 ): AgentName1, AgentName2, AgentName3. 각 AgentNamenumber 매개변수의값은 4,000 자로제한됩니다. 24 Apache 기반서버용웹에이전트설치안내서

25 정책서버요구사항 DefaultAgentName 요청을처리하기위해에이전트가사용하는이름을정의합니다. DefaultAgentName 의값은 AgentName 매개변수에에이전트이름값이없을경우 IP 주소또는인터페이스에대한요청에사용됩니다. 가상서버를사용하는경우 DefaultAgentName 을사용하여 SiteMinder 환경을빠르게구성할수있습니다. DefaultAgentName 을사용하면각가상서버에대해별도의에이전트를정의할필요가없습니다. 중요! DefaultAgentName 매개변수값을지정하지않으면 AgentName 매개변수의값에모든에이전트아이덴티티목록을설정해야합니다. 그렇지않으면정책서버가에이전트에정책을연결할수없습니다. 기본값 : 기본값없음 제한 : 값을여러개지정할수있습니다. 제한 : 범위의 7 비트 ASCII 문자를포함하고인쇄가능한문자가하나이상있어야합니다. 앰퍼샌드 (&) 와별표 (*) 는사용할수없습니다. 이값은대 / 소문자를구분하지않습니다. 예를들어 MyAgent 와 myagent 는같은이름으로처리됩니다. 제 1 장 : 준비 25

26

27 제 2 장 : Windows 에서 Apache 기반에이전트설치및구성 이섹션은다음항목을포함하고있습니다. 에이전트설치와에이전트구성비교 ( 페이지 27) Windows 시스템에서에이전트를설치하는방법 ( 페이지 27) Windows 시스템에서에이전트를구성하는방법 ( 페이지 29) 에이전트설치와에이전트구성비교 SiteMinder 에이전트를설명할때설치와구성은각각특정한의미를갖습니다. 설치는컴퓨터시스템에 SiteMinder 에이전트소프트웨어를설치하는것입니다. 예를들어에이전트를설치하면디렉터리가생성되고 SiteMinder 에이전트소프트웨어및기타설정이컴퓨터에복사됩니다. 구성은설치후에수행되고컴퓨터에서특정웹서버에대해 SiteMinder 에이전트소프트웨어를준비하는작업입니다. 예를들어 SiteMinder 정책서버에에이전트를등록하고, 컴퓨터에설치된웹서버에대한런타임서버인스턴스를생성하는작업이여기에포함됩니다. 첫번째웹서버에서에이전트를설치하고구성하려면마법사형식의설치및구성프로그램을사용하십시오. 마법사기반프로그램은.properties 파일을생성합니다. 추가웹서버에서자동으로에이전트를설치하거나구성하려면.properties 파일및각실행파일을사용하십시오. Windows 시스템에서에이전트를설치하는방법 Windows 운영환경에서 SiteMinder 에이전트를설치하려면몇가지절차가별도로필요합니다. 아래에서이러한절차를설명합니다. 1. 설치프로그램에필요한정보를수집합니다 ( 페이지 28). 2. 마법사기반설치프로그램을실행합니다 ( 페이지 28). 제 2 장 : Windows 에서 Apache 기반에이전트설치및구성 27

28 Windows 시스템에서에이전트를설치하는방법 설치프로그램에필요한정보수집 SiteMinder 에이전트설치프로그램을실행하기전에다음과같은웹서버정보를수집합니다. 설치디렉터리 웹서버에서 SiteMinder 에이전트바이너리파일의위치를지정합니다. 이위치는 web_agent_home 변수에설정됩니다. 제한 : SiteMinder 에서는경로의하위디렉터리이름에 "webagent" 가필요합니다. Windows 에서설치프로그램실행 SiteMinder 에이전트설치프로그램은 Windows 운영환경을사용하여한번에하나의컴퓨터에에이전트를설치합니다. 이설치프로그램은마법사또는콘솔모드에서실행될수있습니다. 또한마법사및콘솔기반설치프로그램은후속설치 / 구성작업을무인으로또는자동으로수행할수있도록동일한설정이포함된.properties 파일을생성합니다. 예를들어환경에설치되는여러에이전트에사용되는웹서버버전, 설치디렉터리, 에이전트구성개체및정책서버가같다고가정해봅니다. 첫번째에이전트를설치할때는설치마법사또는콘솔기반설치프로그램을사용합니다. 그이후에는마법사또는콘솔기반설치프로그램에서생성한.properties 파일을사용하여설치프로그램을실행하도록스크립트를작성할수있습니다. 다음단계를수행하십시오. 1. SiteMinder 웹에이전트설치실행파일을웹서버의임시디렉터리에복사합니다. 2. 다음단계중하나를수행합니다. 마법사기반설치의경우설치실행파일을마우스오른쪽단추로클릭하고 " 관리자권한으로실행 " 을선택합니다. 콘솔기반설치의경우명령줄창을열고다음과같이지정하여실행파일을실행합니다. executable_file_name.exe -i console 3. 이전에수집한정보를사용하여설치를완료합니다. 28 Apache 기반서버용웹에이전트설치안내서

29 Windows 시스템에서에이전트를구성하는방법 Windows 시스템에서에이전트를구성하는방법 에이전트구성은설치가완료된후수행됩니다. 구성작업을수행하려면아래에서설명하는몇가지절차가별도로필요합니다. 1. 구성에필요한정보를수집합니다 ( 페이지 29). 2. 마법사기반구성프로그램을실행합니다 ( 페이지 33). 3. ( 선택사항 ) 운영환경에서후속웹서버에대해무인또는자동설치및구성프로그램을실행합니다 ( 페이지 35). Windows 에서구성프로그램에필요한정보수집 SiteMinder 에이전트구성프로그램을실행하기전에다음과같은 SiteMinder 환경정보를수집합니다. 호스트등록 트러스트된호스트를등록할지여부를나타냅니다. 트러스트된호스트를등록하면 SiteMinder 정책서버의트러스트된호스트개체와웹서버의 SmHost.conf 파일이생성됩니다. 에이전트는시작할때이정보를사용하여 SiteMinder 정책서버에초기연결을설정합니다. 각에이전트인스턴스를트러스트된호스트로한번만등록하십시오. 기본값 : 예 제한 : 예, 아니요 관리자사용자이름 SiteMinder 정책서버에이미정의된관리자권한을가진 SiteMinder 사용자의이름을지정합니다. 이 SiteMinder 사용자계정에는트러스트된호스트를등록할수있는권한이필요합니다. 관리자암호 SiteMinder 정책서버에이미정의된관리자사용자이름의암호를지정합니다. 관리자암호확인 " 관리자암호 " 필드에입력한암호를다시입력합니다. 이값은 SiteMinder 정책서버에이미정의된관리자사용자이름의암호를확인합니다. 제 2 장 : Windows 에서 Apache 기반에이전트설치및구성 29

30 Windows 시스템에서에이전트를구성하는방법 트러스트된호스트개체이름 등록할트러스트된호스트의고유이름을지정합니다. 트러스트된호스트개체는 SiteMinder 정책서버에저장됩니다. 호스트구성개체 SiteMinder 정책서버에이미정의된호스트구성개체의이름을지정합니다. SmHost.conf 파일설정을사용하여에이전트를정책서버에처음연결하고이후연결할때는호스트구성개체의설정을사용합니다. 정책서버 IP 주소 에이전트가시작할때연결하는정책서버의인터넷프로토콜주소를지정합니다. 정책서버가방화벽으로보호된경우에는포트번호도지정합니다. 하드웨어부하분산장치가단일 VIP( 가상 IP 주소 ) 를통해환경에정책서버를나타내도록구성된경우에는 VIP 를입력합니다. 자세한내용은정책서버관리안내서를참조하십시오. 예 : (IPV4) 예 : (IPV4 와포트번호 ) :44443 예 : (IPV6) 2001:DB8::/32 예 : (IPV6) [2001:DB8::/32]: Apache 기반서버용웹에이전트설치안내서

31 Windows 시스템에서에이전트를구성하는방법 FIPS 모드설정 다음알고리즘중하나를지정합니다. FIPS Compatibility/AES Compatibility(FIPS 호환성 /AES 호환성 ) 이전버전의 SiteMinder 에있는알고리즘을사용하여중요한데이터를암호화하고이전버전의 SiteMinder 와호환됩니다. 조직에서 FIPS 호환알고리즘을사용할필요가없는경우이옵션을사용합니다. FIPS Migration/AES Migration(FIPS 마이그레이션 /AES 마이그레이션 ) FIPS 호환성모드에서 FIPS 전용모드로전환할수있습니다. FIPS 마이그레이션모드의 SiteMinder 환경에서는 FIPS 호환알고리즘을사용하여기존의중요한데이터를다시암호화할때기존 SiteMinder 암호화알고리즘이계속사용됩니다. FIPS Only/AES Only(FIPS 전용 /AES 전용 ) SiteMinder 환경에서중요한데이터를암호화할때 FIPS 호환알고리즘만사용합니다. 이설정은이전버전의 SiteMinder 와상호운용되지않으며호환되지도않습니다. 기본값 : FIPS Compatibility/AES Compatibility(FIPS 호환성 /AES 호환성 ) 참고 : FIPS 는 AES(Advanced Encryption Standard) 를충족하는암호화모듈을인가하는데사용되는미국정부의컴퓨터보안표준입니다. 이름 위치 중요! SiteMinder 에이전트와 SiteMinder 정책서버둘다에대해 FIPS/AES 호환성모드또는호환성모드조합을사용하십시오. 웹에이전트가 SiteMinder 정책서버에처음으로연결할때사용하는설정이포함된 SmHost.conf 파일의이름을지정합니다. 기본값 : SmHost.conf SmHost.conf 파일이저장되는디렉터리를지정합니다. 기본값 : web_agent_home\config 공유암호롤오버사용 SiteMinder 정책서버에서웹에이전트와의통신을암호화하는데사용하는공유암호를변경하려면이확인란을선택합니다. 제 2 장 : Windows 에서 Apache 기반에이전트설치및구성 31

32 Windows 시스템에서에이전트를구성하는방법 서버선택 구성프로그램이컴퓨터에서찾는웹서버인스턴스를나타냅니다. 구성할인스턴스의확인란을선택합니다. SiteMinder 보호를제거할인스턴스의경우해당확인란의선택을취소합니다. 에이전트구성개체이름 정책서버에이미정의된 ACO( 에이전트구성개체 ) 의이름을지정합니다. 기본값 : AgentObj 고급인증체계대화상자 이전에선택한웹서버인스턴스에대해고급인증체계를지정합니다. 32 Apache 기반서버용웹에이전트설치안내서

33 Windows 시스템에서에이전트를구성하는방법 Windows 에서웹에이전트구성프로그램실행 에이전트구성에필요한정보를수집한후에이전트구성프로그램을실행합니다. 이프로그램은컴퓨터에서실행중인웹서버에대한에이전트런타임인스턴스를생성합니다. 이구성프로그램은선택한옵션에따라마법사또는콘솔을기반으로실행됩니다. 마법사또는콘솔모드에서구성프로그램을실행하면속성파일이생성됩니다. 이속성파일을사용하면나중에운영환경이같은다른컴퓨터에서무인구성을실행할수있습니다. 다음단계를수행하십시오. 1. 웹서버에서다음디렉터리를엽니다. web_agent_home\install_config_info web_agent_home 웹서버에서 SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (Windows 32 비트설치만해당 ): C:\Program Files\CA\webagent 기본값 (Windows 64 비트설치만해당 ): C:\Program Files\CA\webagent\win64 기본값 (64 비트시스템에서작동하는 Windows 32 비트응용프로그램 - Wow64 모드 ): C:\Program Files (x86)\webagent\win32 2. 다음구성방법중하나를사용합니다. GUI 기반구성의경우 3 단계로이동합니다. 콘솔기반구성의경우 5 단계로이동합니다. 3. 다음실행파일을마우스오른쪽단추로클릭하고 " 관리자권한으로실행 " 을선택합니다. ca-wa-config.exe 4. 8 단계로이동합니다. 5. 관리자권한으로명령프롬프트창을엽니다. 6. 위에서설명한실행파일을탐색한후다음스위치를지정하여파일을실행합니다. -i console 7. 8 단계로이동합니다. 제 2 장 : Windows 에서 Apache 기반에이전트설치및구성 33

34 Windows 시스템에서에이전트를구성하는방법 8. 구성프로그램의지시에따릅니다. 에이전트구성워크시트를참조하여요청된값을제공합니다. 웹서버에대한에이전트런타임인스턴스가생성됩니다. 34 Apache 기반서버용웹에이전트설치안내서

35 Windows 시스템에서에이전트를구성하는방법 Windows 에서후속에이전트에대해무인또는자동설치및구성프로그램실행 무인또는자동설치옵션을사용하면설치및구성프로세스를자동화할수있습니다. 이렇게하면설정이같은에이전트를많이사용하는큰규모의 SiteMinder 환경에서시간이절약됩니다. 예를들어환경에설치되는여러에이전트에사용되는웹서버버전, 설치디렉터리, 에이전트구성개체및정책서버가같다고가정해봅니다. 첫번째에이전트를설치할때는설치마법사또는콘솔기반설치프로그램을사용합니다. 그이후에는마법사또는콘솔기반설치프로그램에서생성한.properties 파일을사용하여설치프로그램을실행하도록스크립트를작성할수있습니다. 다음단계를수행하십시오. 1. 첫번째웹서버에서다음마법사를순서대로실행합니다. a. SiteMinder 웹에이전트설치마법사 b. SiteMinder 웹에이전트구성마법사 2. 첫번째웹서버에서다음파일을찾습니다. web_agent_home\install_config_info\ca-wa-installer.properties 참고 : 공백이포함된경로는따옴표로묶습니다. web_agent_home 웹서버에서 SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (Windows 32 비트설치만해당 ): C:\Program Files\CA\webagent 기본값 (Windows 64 비트설치만해당 ): C:\Program Files\CA\webagent\win64 기본값 (64 비트시스템에서작동하는 Windows 32 비트응용프로그램 - Wow64 모드 ): C:\Program Files (x86)\webagent\win32 3. 환경의다른웹서버에대해다음각단계를수행합니다. 참고 : 이프로세스를자동화하려면시스템에서이러한파일을실행할수있는사용자지정스크립트를생성하십시오. 원하는스크립팅언어를사용할수있습니다. a. 후속웹서버에서임시디렉터리를생성합니다. 제 2 장 : Windows 에서 Apache 기반에이전트설치및구성 35

36 Windows 시스템에서에이전트를구성하는방법 b. 1 단계와 2 단계에나오는첫번째웹서버의다음파일을후속웹서버의임시디렉터리에복사합니다. SiteMinder 웹에이전트설치실행파일 SiteMinder ca-wa-installer 속성파일 c. 임시디렉터리에서관리자권한으로명령프롬프트창을엽니다. d. 다음명령을실행합니다. agent_executable -f properties_file -i silent 후속서버에서 SiteMinder 에이전트가자동으로설치및구성됩니다. e. ( 선택사항 ) 후속웹서버에서임시디렉터리를삭제합니다. 4. SiteMinder 환경에서 ca-wa-installer.properties 파일의설정에지정된구성을사용하는추가웹서버에대해각각 3 단계를반복합니다. 36 Apache 기반서버용웹에이전트설치안내서

37 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 이섹션은다음항목을포함하고있습니다. 에이전트설치와에이전트구성비교 ( 페이지 37) UNIX 또는 Linux 시스템에서에이전트를설치하는방법 ( 페이지 38) z/os 시스템에서에이전트를설치하는방법 ( 페이지 40) UNIX/Linux 에서에이전트를구성하는방법 ( 페이지 42) z/os 시스템에서에이전트를구성하는방법 ( 페이지 50) UNIX/Linux 에대한선택적에이전트설정 ( 페이지 55) 에이전트설치와에이전트구성비교 SiteMinder 에이전트를설명할때설치와구성은각각특정한의미를갖습니다. 설치는컴퓨터시스템에 SiteMinder 에이전트소프트웨어를설치하는것입니다. 예를들어에이전트를설치하면디렉터리가생성되고 SiteMinder 에이전트소프트웨어및기타설정이컴퓨터에복사됩니다. 구성은설치후에수행되고컴퓨터에서특정웹서버에대해 SiteMinder 에이전트소프트웨어를준비하는작업입니다. 예를들어 SiteMinder 정책서버에에이전트를등록하고, 컴퓨터에설치된웹서버에대한런타임서버인스턴스를생성하는작업이여기에포함됩니다. 첫번째웹서버에서에이전트를설치하고구성하려면마법사형식의설치및구성프로그램을사용하십시오. 마법사기반프로그램은.properties 파일을생성합니다. 추가웹서버에서자동으로에이전트를설치하거나구성하려면.properties 파일및각실행파일을사용하십시오. 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 37

38 UNIX 또는 Linux 시스템에서에이전트를설치하는방법 UNIX 또는 Linux 시스템에서에이전트를설치하는방법 UNIX 또는 Linux 운영환경에서 SiteMinder 에이전트를설치하려면몇가지절차가별도로필요합니다. 아래에서이러한절차를설명합니다. 1. 설치프로그램에필요한정보를수집합니다 ( 페이지 38). 2. 마법사기반설치프로그램을실행합니다 ( 페이지 39). 설치에필요한정보수집 SiteMinder 에이전트설치프로그램을실행하기전에다음과같은웹서버정보를수집합니다. 설치디렉터리 웹서버에서 SiteMinder 에이전트바이너리파일의위치를지정합니다. 이위치는 web_agent_home 변수에설정됩니다. 제한 : SiteMinder 에서는경로의하위디렉터리이름에 "webagent" 가필요합니다. 38 Apache 기반서버용웹에이전트설치안내서

39 UNIX 또는 Linux 시스템에서에이전트를설치하는방법 UNIX/Linux 에서설치프로그램실행 SiteMinder 에이전트설치프로그램은 UNIX 또는 Linux 운영환경을사용하여한번에하나의컴퓨터에에이전트를설치합니다. 이설치프로그램은마법사또는콘솔모드에서실행될수있습니다. 또한마법사및콘솔기반설치프로그램은후속설치 / 구성작업을무인으로또는자동으로수행할수있도록동일한설정이포함된.properties 파일을생성합니다. 예를들어환경에설치되는여러에이전트에사용되는웹서버버전, 설치디렉터리, 에이전트구성개체및정책서버가같다고가정해봅니다. 첫번째에이전트를설치할때는설치마법사또는콘솔기반설치프로그램을사용합니다. 그이후에는마법사또는콘솔기반설치프로그램에서생성한.properties 파일을사용하여설치프로그램을실행하도록스크립트를작성할수있습니다. 다음단계를수행하십시오. 1. SiteMinder 에이전트설치실행파일을웹서버의임시디렉터리에복사합니다. 2. 루트사용자로로그인합니다. 3. 다음단계중하나를수행합니다. 마법사기반설치의경우설치실행파일을실행합니다. 콘솔기반설치의경우명령줄창을열고다음과같이지정하여실행파일을실행합니다. executable_file_name.exe -i console 4. 에이전트설치워크시트의정보를사용하여설치프로그램을완료합니다. 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 39

40 z/os 시스템에서에이전트를설치하는방법 z/os 시스템에서에이전트를설치하는방법 z/os 운영환경에서 SiteMinder 에이전트를설치하려면다음과정을수행하십시오. 1. 설치프로그램에필요한정보를수집합니다 ( 페이지 38). 2. 설치프로그램을실행합니다 ( 페이지 40). 설치에필요한정보수집 SiteMinder 에이전트설치프로그램을실행하기전에다음과같은웹서버정보를수집합니다. 설치디렉터리 웹서버에서 SiteMinder 에이전트바이너리파일의위치를지정합니다. 이위치는 web_agent_home 변수에설정됩니다. 제한 : SiteMinder 에서는경로의하위디렉터리이름에 "webagent" 가필요합니다. z/os 에서 SiteMinder 에이전트설치프로그램실행 SiteMinder 에이전트설치프로그램은 z/os 운영환경을실행하는단일컴퓨터에에이전트를설치합니다. 이설치프로그램은마법사또는콘솔모드에서실행될수있습니다. 또한마법사및콘솔기반설치프로그램은후속설치 / 구성작업을무인으로또는자동으로수행할수있도록동일한설정이포함된.properties 파일을생성합니다. 40 Apache 기반서버용웹에이전트설치안내서

41 z/os 시스템에서에이전트를설치하는방법 예를들어환경에설치되는여러에이전트에사용되는웹서버버전, 설치디렉터리, 에이전트구성개체및정책서버가같다고가정해봅니다. 첫번째에이전트를설치할때는설치마법사또는콘솔기반설치프로그램을사용합니다. 그이후에는마법사또는콘솔기반설치프로그램에서생성한.properties 파일을사용하여설치프로그램을실행하도록스크립트를작성할수있습니다. 기술지원사이트의설치미디어를사용하여 SiteMinder 에이전트를설치합니다. 참고 : 실행권한이있는지확인하십시오. 설치미디어에대한실행권한을추가하려면다음명령을실행하십시오. chmod +x installation_media installation_media SiteMinder 에이전트설치관리자실행파일을지정합니다. 다음단계를수행하십시오. 1. 루트사용자로로그인합니다. 2. 실행중인응용프로그램을모두종료합니다. 3. 셸을열고설치미디어를탐색합니다. 4. 다음명령중하나를입력하여 GUI 또는콘솔모드에서설치프로그램을실행합니다. GUI 모드 java -jar installation_media 콘솔모드 java -jar installation_media -i console 5. 이전에수집한정보를사용하여설치프로그램을완료합니다. 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 41

42 UNIX/Linux 에서에이전트를구성하는방법 UNIX/Linux 에서에이전트를구성하는방법 에이전트구성은설치가완료된후수행됩니다. 구성작업을수행하려면아래에서설명하는몇가지절차가별도로필요합니다. 1. 구성프로그램에필요한정보를수집합니다 ( 페이지 42). 2. 에이전트환경스크립트의경로를수정합니다 ( 페이지 45). 3. UNIX 또는 Linux 시스템에서라이브러리경로변수를설정합니다 ( 페이지 46). 4. 에이전트구성프로그램을실행합니다 ( 페이지 47). 5. ( 선택사항 ) 다른에이전트에대해무인또는자동설치및구성프로그램을실행합니다 ( 페이지 48). 6. LD_PRELOAD 변수를설정합니다 ( 페이지 49). 7. (SuSE 9 zseries 만해당 ) LD_ASSUME_KERNEL 변수를설정합니다 ( 페이지 49). 8. (Red Hat Linux 만해당 ) CAPKIHOME 변수를설정합니다 ( 페이지 49). UNIX/Linux 에서구성프로그램에필요한정보수집 SiteMinder 에이전트구성프로그램을실행하기전에다음과같은 SiteMinder 환경정보를수집합니다. 호스트등록 트러스트된호스트를등록할지여부를나타냅니다. 트러스트된호스트를등록하면 SiteMinder 정책서버의트러스트된호스트개체와웹서버의 SmHost.conf 파일이생성됩니다. 에이전트는시작할때이정보를사용하여 SiteMinder 정책서버에초기연결을설정합니다. 각에이전트인스턴스를트러스트된호스트로한번만등록하십시오. 기본값 : 예 제한 : 예, 아니요 42 Apache 기반서버용웹에이전트설치안내서

43 UNIX/Linux 에서에이전트를구성하는방법 관리자사용자이름 SiteMinder 정책서버에이미정의된관리자권한을가진 SiteMinder 사용자의이름을지정합니다. 이 SiteMinder 사용자계정에는트러스트된호스트를등록할수있는권한이필요합니다. 관리자암호 SiteMinder 정책서버에이미정의된관리자사용자이름의암호를지정합니다. 관리자암호확인 " 관리자암호 " 필드에입력한암호를다시입력합니다. 이값은 SiteMinder 정책서버에이미정의된관리자사용자이름의암호를확인합니다. 트러스트된호스트개체이름 등록할트러스트된호스트의고유이름을지정합니다. 트러스트된호스트개체는 SiteMinder 정책서버에저장됩니다. 호스트구성개체 SiteMinder 정책서버에이미정의된호스트구성개체의이름을지정합니다. SmHost.conf 파일설정을사용하여에이전트를정책서버에처음연결하고이후연결할때는호스트구성개체의설정을사용합니다. 정책서버 IP 주소 에이전트가시작할때연결하는정책서버의인터넷프로토콜주소를지정합니다. 정책서버가방화벽으로보호된경우에는포트번호도지정합니다. 하드웨어부하분산장치가단일 VIP( 가상 IP 주소 ) 를통해환경에정책서버를나타내도록구성된경우에는 VIP 를입력합니다. 자세한내용은정책서버관리안내서를참조하십시오. 예 : (IPV4) 예 : (IPV4 와포트번호 ) :44443 예 : (IPV6) 2001:DB8::/32 예 : (IPV6) [2001:DB8::/32]:44443 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 43

44 UNIX/Linux 에서에이전트를구성하는방법 FIPS 모드설정 다음알고리즘중하나를지정합니다. FIPS Compatibility/AES Compatibility(FIPS 호환성 /AES 호환성 ) 이전버전의 SiteMinder 에있는알고리즘을사용하여중요한데이터를암호화하고이전버전의 SiteMinder 와호환됩니다. 조직에서 FIPS 호환알고리즘을사용할필요가없는경우이옵션을사용합니다. FIPS Migration/AES Migration(FIPS 마이그레이션 /AES 마이그레이션 ) FIPS 호환성모드에서 FIPS 전용모드로전환할수있습니다. FIPS 마이그레이션모드의 SiteMinder 환경에서는 FIPS 호환알고리즘을사용하여기존의중요한데이터를다시암호화할때기존 SiteMinder 암호화알고리즘이계속사용됩니다. FIPS Only/AES Only(FIPS 전용 /AES 전용 ) SiteMinder 환경에서중요한데이터를암호화할때 FIPS 호환알고리즘만사용합니다. 이설정은이전버전의 SiteMinder 와상호운용되지않으며호환되지도않습니다. 기본값 : FIPS Compatibility/AES Compatibility(FIPS 호환성 /AES 호환성 ) 참고 : FIPS 는 AES(Advanced Encryption Standard) 를충족하는암호화모듈을인가하는데사용되는미국정부의컴퓨터보안표준입니다. 이름 위치 중요! SiteMinder 에이전트와 SiteMinder 정책서버둘다에대해 FIPS/AES 호환성모드또는호환성모드조합을사용하십시오. 웹에이전트가 SiteMinder 정책서버에처음으로연결할때사용하는설정이포함된 SmHost.conf 파일의이름을지정합니다. 기본값 : SmHost.conf SmHost.conf 파일이저장되는디렉터리를지정합니다. 기본값 : web_agent_home\config 공유암호롤오버사용 SiteMinder 정책서버에서웹에이전트와의통신을암호화하는데사용하는공유암호를변경하려면이확인란을선택합니다. 44 Apache 기반서버용웹에이전트설치안내서

45 UNIX/Linux 에서에이전트를구성하는방법 서버선택 구성프로그램이컴퓨터에서찾는웹서버인스턴스를나타냅니다. 구성할인스턴스의확인란을선택합니다. SiteMinder 보호를제거할인스턴스의경우해당확인란의선택을취소합니다. 에이전트구성개체이름 정책서버에이미정의된 ACO( 에이전트구성개체 ) 의이름을지정합니다. 기본값 : AgentObj 고급인증체계대화상자 이전에선택한웹서버인스턴스에대해고급인증체계를지정합니다. UNIX 또는 Linux 운영환경에서에이전트환경스크립트의경로수정 에이전트설치프로그램은다음디렉터리에환경스크립트를생성합니다. web_agent_home/ca_wa_env.sh web_agent_home SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (UNIX/Linux 시스템 ): /opt/ca/webagent 다음태스크를수행한후에이스크립트의경로를수정하십시오. 에이전트구성프로그램실행 웹서버시작 참고 : 같은셸에서이전태스크를모두수행하는경우스크립트의경로를한번만수정하십시오. 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 45

46 UNIX/Linux 에서에이전트를구성하는방법 UNIX 또는 Linux 시스템에서라이브러리경로변수설정 에이전트구성프로그램을실행하기전에 UNIX 또는 Linux 시스템에서라이브러리경로변수를설정합니다. 다음표에서는다양한 UNIX 및 Linux 운영환경의라이브러리경로변수를보여줍니다. 운영체제 AIX Linux Solaris 라이브러리경로변수이름 LIBPATH LD_LIBRARY_PATH LD_LIBRARY_PATH 라이브러리경로변수의값을 web_agent_home/bin 디렉터리로설정합니다. web_agent_home SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (UNIX/Linux 시스템 ): /opt/ca/webagent 46 Apache 기반서버용웹에이전트설치안내서

47 UNIX/Linux 에서에이전트를구성하는방법 UNIX/Linux 에서웹에이전트구성프로그램실행 에이전트구성에필요한정보를수집한후에이전트구성프로그램을실행합니다. 이프로그램은컴퓨터에서실행중인웹서버에대한에이전트런타임인스턴스를생성합니다. 이구성프로그램은선택한옵션에따라마법사또는콘솔을기반으로실행됩니다. 마법사또는콘솔모드에서구성프로그램을실행하면속성파일이생성됩니다. 이속성파일을사용하면나중에운영환경이같은다른컴퓨터에서무인구성을실행할수있습니다. 다음단계를수행하십시오. 1. 웹서버에서다음디렉터리를엽니다. web_agent_home/install_config_info web_agent_home SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (UNIX/Linux 시스템 ): /opt/ca/webagent 2. 다음구성방법중하나를사용합니다. GUI 기반구성의경우 3 단계로이동합니다. 콘솔기반구성의경우 5 단계로이동합니다. 3. 다음실행파일을실행합니다. ca-wa-config.bin 4. 8 단계로이동합니다. 5. 루트권한으로명령프롬프트창을엽니다. 6. 위에서설명한실행파일을탐색한후다음스위치를지정하여파일을실행합니다. -i console 7. 8 단계로이동합니다. 8. 구성프로그램의지시에따릅니다. 에이전트구성워크시트를참조하여요청된값을제공합니다. 웹서버에대한에이전트런타임인스턴스가생성됩니다. 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 47

48 UNIX/Linux 에서에이전트를구성하는방법 UNIX/Linux 에서에이전트에대해무인또는자동설치및구성프로그램실행 무인또는자동설치옵션을사용하면설치및구성프로세스를자동화할수있습니다. 이렇게하면설정이같은에이전트를많이사용하는큰규모의 SiteMinder 환경에서시간이절약됩니다. 예를들어환경에설치되는여러에이전트에사용되는웹서버버전, 설치디렉터리, 에이전트구성개체및정책서버가같다고가정해봅니다. 첫번째에이전트를설치할때는설치마법사또는콘솔기반설치프로그램을사용합니다. 그이후에는마법사또는콘솔기반설치프로그램에서생성한.properties 파일을사용하여설치프로그램을실행하도록스크립트를작성할수있습니다. 다음단계를수행하십시오. 1. 첫번째웹서버에서다음마법사를순서대로실행합니다. a. SiteMinder 웹에이전트설치마법사 b. SiteMinder 웹에이전트구성마법사 2. 첫번째웹서버에서다음파일을찾습니다. web_agent_home/install_config_info/ca-wa-installer.properties 참고 : 공백이포함된경로는따옴표로묶습니다. web_agent_home SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (UNIX/Linux 시스템 ): /opt/ca/webagent 3. 후속웹서버에대해다음각단계를수행합니다. 참고 : 이프로세스를자동화하려면시스템에서이러한파일을실행할수있는사용자지정스크립트를생성하십시오. 원하는스크립팅언어를사용할수있습니다. a. 후속웹서버에서임시디렉터리를생성합니다. b. 1 단계와 2 단계에서마법사를실행한웹서버의다음파일을후속웹서버의임시디렉터리에복사합니다. SiteMinder 웹에이전트설치실행파일 SiteMinder ca-wa-installer 속성파일 c. 임시디렉터리에서루트권한으로명령프롬프트창을엽니다. d. 다음명령을실행합니다. 48 Apache 기반서버용웹에이전트설치안내서

49 UNIX/Linux 에서에이전트를구성하는방법 agent_executable.bin -f properties_file -i silent 웹서버에서 SiteMinder 에이전트가자동으로설치및구성됩니다. e. ( 선택사항 ) 웹서버에서임시디렉터리를삭제합니다. 4. SiteMinder 환경에서 ca-wa-installer.properties 파일의설정에지정된구성을사용하는추가웹서버에대해각각 3 단계를반복합니다. LD_PRELOAD 변수설정 Apache 기반 SiteMinder 에이전트의 LD_PRELOAD 변수는다음값으로설정되어야합니다. LD_PRELOAD=web_agent_home/bin/libbtunicode.so SuSE Linux 9 for zseries 의 Apache 에이전트에대한 LD_ASSUME_KERNEL 설정 SuSE Linux 9 for zseries 를실행하는 Apache 웹서버에웹에이전트를설치한후다음과같이 LD_ASSUME_KERNEL 환경변수를설정합니다. LD_ASSUME_KERNEL= export LD_ASSUME_KERNEL 중요! 이변수는웹에이전트라이브러리가빌드된커널릴리스를나타내는 로설정해야합니다. 이설정이없으면다음과같은문제가발생합니다. Apache 웹서버가제대로시작되지않습니다. 호스트를등록할때코어덤프가발생합니다. Red Hat Linux 시스템에대한 CAPKIHOME 변수설정 Red Hat Linux 시스템에서 Apache 기반웹에이전트를실행하려면다음명령을입력하여 CAPKIHOME 환경변수를설정합니다. CAPKIHOME="/usr/local/CA/webagent/CAPKI" export CAPKIHOME 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 49

50 z/os 시스템에서에이전트를구성하는방법 z/os 시스템에서에이전트를구성하는방법 설치후다음프로세스에설명된절차를수행하여 SiteMinder 에이전트를구성합니다. 1. 구성프로그램에필요한정보를수집합니다 ( 페이지 50). 2. 라이브러리경로변수를설정합니다 ( 페이지 52). 3. 에이전트구성프로그램을실행합니다 ( 페이지 53). 4. ( 선택사항 ) 다른 z/os 시스템의에이전트에대해무인또는자동설치및구성프로그램을실행합니다 ( 페이지 54). z/os 에서구성프로그램에필요한정보수집 SiteMinder 에이전트구성프로그램을실행하기전에다음과같은 SiteMinder 환경정보를수집합니다. 호스트등록 트러스트된호스트를등록할지여부를나타냅니다. 트러스트된호스트를등록하면 SiteMinder 정책서버의트러스트된호스트개체와웹서버의 SmHost.conf 파일이생성됩니다. 에이전트는시작할때이정보를사용하여 SiteMinder 정책서버에초기연결을설정합니다. 각에이전트인스턴스를트러스트된호스트로한번만등록하십시오. 기본값 : 예 제한 : 예, 아니요 50 Apache 기반서버용웹에이전트설치안내서

51 z/os 시스템에서에이전트를구성하는방법 관리자사용자이름 SiteMinder 정책서버에이미정의된관리자권한을가진 SiteMinder 사용자의이름을지정합니다. 이 SiteMinder 사용자계정에는트러스트된호스트를등록할수있는권한이필요합니다. 관리자암호 SiteMinder 정책서버에이미정의된관리자사용자이름의암호를지정합니다. 관리자암호확인 " 관리자암호 " 필드에입력한암호를다시입력합니다. 이값은 SiteMinder 정책서버에이미정의된관리자사용자이름의암호를확인합니다. 공유암호롤오버사용 SiteMinder 정책서버에서웹에이전트와의통신을암호화하는데사용하는공유암호를변경하려면이확인란을선택합니다. 트러스트된호스트개체이름 등록할트러스트된호스트의고유이름을지정합니다. 트러스트된호스트개체는 SiteMinder 정책서버에저장됩니다. 호스트구성개체 SiteMinder 정책서버에이미정의된호스트구성개체의이름을지정합니다. SmHost.conf 파일설정을사용하여에이전트를정책서버에처음연결하고이후연결할때는호스트구성개체의설정을사용합니다. 정책서버 IP 주소 에이전트가시작할때연결하는정책서버의인터넷프로토콜주소를지정합니다. 정책서버가방화벽으로보호된경우에는포트번호도지정합니다. 하드웨어부하분산장치가단일 VIP( 가상 IP 주소 ) 를통해환경에정책서버를나타내도록구성된경우에는 VIP 를입력합니다. 자세한내용은정책서버관리안내서를참조하십시오. 예 : (IPV4) 예 : (IPV4 와포트번호 ) :44443 예 : (IPV6) 2001:DB8::/32 예 : (IPV6) [2001:DB8::/32]:44443 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 51

52 z/os 시스템에서에이전트를구성하는방법 이름 위치 웹에이전트가 SiteMinder 정책서버에처음으로연결할때사용하는설정이포함된 SmHost.conf 파일의이름을지정합니다. 기본값 : SmHost.conf SmHost.conf 파일이저장되는디렉터리를지정합니다. 기본값 : web_agent_home/config 서버선택 구성프로그램이컴퓨터에서찾는웹서버인스턴스를나타냅니다. 구성할인스턴스의확인란을선택합니다. SiteMinder 보호를제거할인스턴스의경우해당확인란의선택을취소합니다. IBM HTTP Server for z/os 경로 IBM HTTP Server httpd.conf 구성파일의경로를지정합니다. 기본값 : 구성마법사를실행하는데사용되는계정의홈디렉터리 에이전트구성개체이름 정책서버에이미정의된 ACO( 에이전트구성개체 ) 의이름을지정합니다. 기본값 : AgentObj 고급인증체계대화상자 이전에선택한웹서버인스턴스에대해고급인증체계를지정합니다. z/os 에서라이브러리경로변수설정 에이전트구성프로그램을실행하기전에 z/os 시스템에서라이브러리경로변수를설정합니다. export LIBPATH=web_agent_home/bin web_agent_home SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 : /opt/ca/webagent 52 Apache 기반서버용웹에이전트설치안내서

53 z/os 시스템에서에이전트를구성하는방법 z/os 에서 SiteMinder 에이전트구성프로그램실행 에이전트구성에필요한정보를수집한후에이전트구성프로그램을실행합니다. 이프로그램은컴퓨터에서실행중인웹서버에대한에이전트런타임인스턴스를생성합니다. 이구성프로그램은선택한옵션에따라마법사또는콘솔을기반으로실행됩니다. 마법사또는콘솔모드에서구성프로그램을실행하면속성파일이생성됩니다. 이속성파일을사용하면나중에다른 z/os 시스템에서무인구성을실행할수있습니다. 참고 : 실행권한이있는지확인하십시오. 설치미디어에대한실행권한을추가하려면다음명령을실행하십시오. chmod +x installation_media installation_media SiteMinder 에이전트설치관리자실행파일을지정합니다. 다음단계를수행하십시오. 1. 루트사용자로로그인합니다. 2. 실행중인응용프로그램을모두종료합니다. 3. 셸을열고다음디렉터리로이동합니다. web_agent_home/install_config_info web_agent_home SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (UNIX/Linux 시스템 ): /opt/ca/webagent 4. 다음명령중하나를입력하여 GUI 또는콘솔모드에서구성프로그램을실행합니다. GUI 모드 ca-wa-config.sh 콘솔모드 ca-wa-config.sh -i console 5. 구성프로그램의지시에따릅니다. 에이전트구성워크시트를참조하여요청된값을제공합니다. 웹서버에대한에이전트런타임인스턴스가생성됩니다. 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 53

54 z/os 시스템에서에이전트를구성하는방법 ( 선택사항 ) z/os 의 SiteMinder 에이전트에대해무인또는자동설치및구성프로그램실행 무인또는자동설치옵션을사용하면설치및구성프로세스를자동화할수있습니다. 이렇게하면설정이같은에이전트를많이사용하는큰규모의 SiteMinder 환경에서시간이절약됩니다. 예를들어환경에설치되는여러에이전트에사용되는웹서버버전, 설치디렉터리, 에이전트구성개체및정책서버가같다고가정해봅니다. 첫번째에이전트를설치할때는설치마법사또는콘솔기반설치프로그램을사용합니다. 그이후에는마법사또는콘솔기반설치프로그램에서생성한.properties 파일을사용하여설치프로그램을실행하도록스크립트를작성할수있습니다. 다음단계를수행하십시오. 1. 첫번째웹서버에서다음마법사를순서대로실행합니다. a. SiteMinder 에이전트설치마법사 b. SiteMinder 에이전트구성마법사 2. 첫번째웹서버에서다음파일을찾습니다. web_agent_home/install_config_info/ca-wa-installer.properties 참고 : 공백이포함된경로는따옴표로묶습니다. web_agent_home SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (UNIX/Linux 시스템 ): /opt/ca/webagent 3. 후속웹서버에대해다음각단계를수행합니다. 참고 : 이프로세스를자동화하려면시스템에서이러한파일을실행할수있는사용자지정스크립트를생성하십시오. 원하는스크립팅언어를사용할수있습니다. a. 후속웹서버에서임시디렉터리를생성합니다. b. 1 단계와 2 단계에서마법사를실행한웹서버의다음파일을후속웹서버의임시디렉터리에복사합니다. SiteMinder 에이전트설치실행파일 ca-wa-installer 속성파일 54 Apache 기반서버용웹에이전트설치안내서

55 UNIX/Linux 에대한선택적에이전트설정 c. 임시디렉터리에서루트권한으로명령프롬프트창을엽니다. d. 다음명령을실행합니다. java -jar installation_media -f ca-installer.properties -i silent installation_media SiteMinder 에이전트설치관리자실행파일을지정합니다. 웹서버에서 SiteMinder 에이전트가자동으로설치및구성됩니다. e. ( 선택사항 ) 웹서버에서임시디렉터리를삭제합니다. 4. SiteMinder 환경에서 ca-wa-installer.properties 파일의설정에지정된구성을사용하는추가웹서버에대해각각 3 단계를반복합니다. UNIX/Linux 에대한선택적에이전트설정 Apache 기반서버의 SiteMinder 에이전트는다음과같은선택적설정을제공합니다. apachectl 스크립트를사용하는경우스크립트에에이전트변수를설정합니다 ( 페이지 55). httpd.conf 파일을변경하여서버성능을향상시킵니다 ( 선택사항 ) ( 페이지 56). apachectl 스크립트를사용하는경우웹에이전트변수설정 apachectl 스크립트를사용하여 Apache 서버를실행합니다. POSIX 에서 Apache 웹서버를실행하는경우를예로들수있습니다. apachectl 스크립트에행을추가하면에이전트의환경변수가설정됩니다. 다음단계를수행하십시오. 1. 다음예와비슷한행을찾습니다. # Source /etc/sysconfig/httpd for $HTTPD setting, etc 2. 위에서찾은행뒤에다음행을추가합니다. sh /web_agent_home/ca_wa_env.sh web_agent_home SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (UNIX/Linux 시스템 ): /opt/ca/webagent 제 3 장 : UNIX/Linux 에서 Apache 기반에이전트설치및구성 55

56 UNIX/Linux 에대한선택적에이전트설정 httpd.conf 파일을변경하여서버성능향상 ( 선택사항 ) httpd.conf 파일의기본구성설정을수정하여서버성능을향상시킬수있지만이러한변경은선택사항입니다. 다음단계를수행하십시오. 1. Apache 기반서버의경우웹서버의다른인증또는액세스모듈보다높은우선순위수준을 Apache20WebAgent.dll 파일에할당합니다. 2. 트래픽이낮은웹사이트의경우다음지시문을정의합니다. Set MaxRequestsPerChild>1000 또는 Set MaxRequestsPerChild=0 MinSpareServers >5 MaxSpareServers>10 StartServers=MinSpareServers>5 3. 트래픽이높은웹사이트의경우다음지시문을정의합니다. Set MaxRequestsPerChild>3000 또는 Set MaxRequestsPerChild=0 MinSpareServers >10 MaxSpareServers>15 StartServers=MinSpareServers>10 참고 : 사용자의특정환경에맞게성능조정이필요한경우 CA Services 에문의하여지원을받을수있습니다. 56 Apache 기반서버용웹에이전트설치안내서

57 제 4 장 : 동적정책서버클러스터 이전버전의 SiteMinder 에이전트는클러스터에서정책서버가추가또는제거될때이를자동으로감지하지못했습니다. 에이전트는해당웹서버가다시시작된후에만변경내용을인식했습니다. SiteMinder 에서는동적정책서버클러스터를지원합니다. 동적정책서버클러스터가사용되도록설정된경우에이전트는기존클러스터에서추가또는제거된정책서버를자동으로감지합니다. 예를들어에이전트가다음과같은정책서버의클러스터에연결된다고가정합니다 이제운영체제를업그레이드하기위해 서버를제거하려고합니다. 이런경우동적정책서버클러스터가사용되도록설정하면에이전트는다시시작하지않고도클러스터의구성원자격이변경되었음을인식할수있습니다. 다음과같은태스크를수행하는경우웹서버를다시시작하십시오. 구성마법사를사용하여기존정책서버의구성변경 정책서버클러스터생성 정책서버클러스터삭제 다음과같은정책서버설정의값변경 EnableFailOver MaxSocketsPerPort MinSocketsPerPort NewSocketStep RequestTimeout 제 4 장 : 동적정책서버클러스터 57

58 동적정책서버클러스터에웹에이전트연결 동적정책서버클러스터에웹에이전트연결 웹서버의 SmHost.conf 파일을수정하여웹에이전트를하나이상의동적정책서버클러스터에연결할수있습니다. 다음단계를수행하십시오. 1. 텍스트편집기에서다음파일을엽니다. web_agent_home\config\smhost.conf web_agent_home 웹서버에서 SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (Windows 32 비트설치만해당 ): C:\Program Files\CA\webagent 기본값 (Windows 64 비트설치만해당 ): C:\Program Files\CA\webagent\win64 기본값 (64 비트시스템에서작동하는 Windows 32 비트응용프로그램 - Wow64 모드 ): C:\Program Files (x86)\webagent\win32 2. 다음태스크중하나를수행합니다. 이전에이웹에이전트를정책서버의동적클러스터에연결한적이없으면파일에서원하는위치에다음텍스트가포함된행을생성합니다. enabledynamichco="yes" 이웹에이전트를이미정책서버의동적클러스터에연결한경우에는기존 enabledynamichco 매개변수의값을 "NO" 에서 "YES" 로변경합니다. 1. SmHost.conf 파일을저장하고텍스트편집기를닫습니다. 2. 웹서버를다시시작합니다. 웹에이전트가동적정책서버클러스터에연결됩니다. 58 Apache 기반서버용웹에이전트설치안내서

59 제 5 장 : 웹에이전트시작및중지 이섹션은다음항목을포함하고있습니다. 웹에이전트사용 ( 페이지 59) 웹에이전트사용안함 ( 페이지 60) apachectl 명령을사용하여대부분의 Apache 기반에이전트시작또는중지 ( 페이지 60) apachectl 명령을사용하여 IBM HTTP Server 시작 ( 페이지 61) 웹에이전트사용 에이전트매개변수를구성한후에이전트에서웹서버의리소스를보호할수있도록설정합니다. 참고 : 리소스를보호하려면 SiteMinder 정책서버에도정책을정의해야합니다. 다음단계를수행하십시오. 1. 텍스트편집기에서 WebAgent.conf 파일을엽니다. 2. EnableWebAgent 매개변수의값을 yes 로변경합니다. 3. WebAgent.conf 파일을저장한후닫습니다. 4. 웹서버를다시시작합니다. 웹서버가실행되는컴퓨터가아니라웹서버자체를다시시작해야합니다. 웹에이전트를사용할수있습니다. 제 5 장 : 웹에이전트시작및중지 59

60 웹에이전트사용안함 웹에이전트사용안함 웹에이전트가더이상웹서버의리소스를보호하지않게하려면해당웹에이전트가사용되지않도록설정합니다. 다음단계를수행하십시오. 1. 텍스트편집기에서 WebAgent.conf 파일을엽니다. 2. EnableWebAgent 매개변수의값을 no 로변경합니다. 3. WebAgent.conf 파일을저장한후닫습니다. 4. 웹서버를다시시작합니다. 웹서버가실행되는컴퓨터가아니라웹서버자체를다시시작해야합니다. 웹에이전트를사용할수없습니다. apachectl 명령을사용하여대부분의 Apache 기반에이전트시작또는중지 UNIX 또는 Linux 운영환경에서 apachectl 명령을사용하여대부분의 Apache 기반에이전트를시작하거나중지하려면먼저제품에대한환경변수를설정해야합니다. 참고 : Apache 기반에이전트는 apachectl -restart 옵션을지원하지않습니다. 이절차는 Apche 기반 IBM HTTP 서버에적용되지않습니다. 대신이절차 ( 페이지 61) 를사용하십시오. 다음단계를수행하십시오. 1. UNIX/Linux 운영환경의경우다음스크립트를실행하여환경변수를설정합니다../ca_wa_env.sh 2. 다음명령중하나를사용합니다. apachectl -stop apachectl -start 60 Apache 기반서버용웹에이전트설치안내서

61 apachectl 명령을사용하여 IBM HTTP Server 시작 apachectl 명령을사용하여 IBM HTTP Server 시작 apachectl 명령을사용하여 IBM HTTP 서버에서 Apache 기반에이전트를시작하거나중지하려면추가구성단계가필요합니다. UNIX 또는 Linux 운영환경에서 apachectl 명령을실행하기전에다음태스크를수행하십시오. 환경변수스크립트의경로를수정합니다. 다음목록에서해당운영환경에대한변수를내보냅니다. LD_LIBRARY_PATH(32 비트운영환경 ) LD_LIBRARY_PATH_64 다음단계를수행하십시오. 1. UNIX/Linux 운영환경의경우다음스크립트를실행하여환경변수를설정합니다../ca_wa_env.sh 2. 다음태스크중하나를수행합니다. 32 비트운영환경의경우 LD_LIBRARY_PATH 변수를 IBM HTTP 웹서버의 lib 디렉터리위치로설정합니다. 다음예를참조하십시오. export LD_LIBRARY_PATH=/opt/IBM/HTTPServer/lib:$LD_LIBRARY_PATH 64 비트운영환경의경우 LD_LIBRARY_PATH_64 변수를 IBM HTTP 웹서버의 lib 디렉터리위치로설정합니다. 다음예를참조하십시오. export LD_LIBRARY_PATH_64=/opt/IBM/HTTPServer/lib:$LD_LIBRARY_PATH_64 3. 다음과같이 apachectl 명령을실행합니다. apachectl -start 참고 : Apache 기반에이전트는 apachectl -restart 옵션을지원하지않습니다. 대신 -stop 및 -start 명령을사용하십시오. 제 5 장 : 웹에이전트시작및중지 61

62

63 제 6 장 : 웹에이전트로업그레이드 이섹션은다음항목을포함하고있습니다. 에이전트업그레이드로드맵 ( 페이지 64) SiteMinder 에이전트업그레이드를준비하는방법 ( 페이지 66) 제 6 장 : 웹에이전트로업그레이드 63

64 에이전트업그레이드로드맵 에이전트업그레이드로드맵 다음그림에서는 SiteMinder 에이전트를 r12.5 버전으로업그레이드하는방법을보여줍니다. 64 Apache 기반서버용웹에이전트설치안내서

65 에이전트업그레이드로드맵 제 6 장 : 웹에이전트로업그레이드 65

66 SiteMinder 에이전트업그레이드를준비하는방법 SiteMinder 에이전트업그레이드를준비하는방법 SiteMinder 에이전트를업그레이드하려면몇가지절차가별도로필요합니다. 에이전트업그레이드를준비하려면다음단계를수행하십시오. 1. 다음그림중하나를사용하여 SiteMinder 에이전트업그레이드프로세스의올바른단계에있는지확인합니다. r6.x 에서업그레이드 r12.0 에서업그레이드 ( 페이지 69) 2. 웹서버에서사용자지정된 SiteMinder 파일의백업복사본을생성합니다. 예를들어에이전트를설치하거나구성한후다음과같은파일을사용자지정했을수있습니다. LocalConfig.conf WebAgent.conf 3. 다음 SiteMinder 프로그램에필요한정보를수집합니다. 에이전트설치마법사 에이전트구성마법사 4. UNIX/Linux 운영환경에서에이전트를업그레이드하는경우 LD_PRELOAD 변수를삭제합니다 ( 페이지 70). 그렇지않은경우다음단계를계속합니다. 5. 다음절차중하나를사용하여에이전트를업그레이드합니다. Windows 운영환경에서설치마법사실행 ( 페이지 70) UNIX/Linux 운영환경에서설치마법사실행 ( 페이지 71) 6. UNIX/Linux 운영환경에서에이전트를업그레이드하는경우 LD_LIBRARYPATH 변수를설정합니다 ( 페이지 72). 그렇지않은경우다음단계를계속합니다. 7. 다음절차중하나를사용하여업그레이드된에이전트를구성합니다. Windows 운영환경에서업그레이드된에이전트구성 ( 페이지 73) UNIX/Linux 운영환경에서업그레이드된에이전트구성 ( 페이지 75) 66 Apache 기반서버용웹에이전트설치안내서

67 SiteMinder 에이전트업그레이드를준비하는방법 SiteMinder r6.x 에서업그레이드 다음그림과같이 r6.x 에서 로의에이전트업그레이드는 SiteMinder 업그레이드프로세스의세번째단계에서수행됩니다. 그림 1: r6 SP5 마이그레이션. 1~3 단계 참고 : SiteMinder 업그레이드프로세스에대한자세한내용은업그레이드안내서를참조하십시오. 제 6 장 : 웹에이전트로업그레이드 67

68 SiteMinder 에이전트업그레이드를준비하는방법 SiteMinder r12.0 에서업그레이드 다음그림과같이 r12.0 에서 로의에이전트업그레이드는 SiteMinder 업그레이드프로세스의두번째단계에서수행됩니다. 그림 2: r12.x 마이그레이션개요. 참고 : SiteMinder 업그레이드프로세스에대한자세한내용은업그레이드안내서를참조하십시오. 68 Apache 기반서버용웹에이전트설치안내서

69 SiteMinder 에이전트업그레이드를준비하는방법 SiteMinder r12.0 에서업그레이드 다음그림과같이 r12.0 에서 로의에이전트업그레이드는 SiteMinder 업그레이드프로세스의두번째단계에서수행됩니다. 그림 3: r12.x 마이그레이션개요. 참고 : SiteMinder 업그레이드프로세스에대한자세한내용은업그레이드안내서를참조하십시오. 제 6 장 : 웹에이전트로업그레이드 69

70 SiteMinder 에이전트업그레이드를준비하는방법 LD_PRELOAD 변수가기존에이전트와충돌하지않도록설정 Linux 시스템에서웹에이전트를업그레이드하거나다시설치하는경우셸에서 LD_PRELOAD 변수가기존웹에이전트설치디렉터리내의다른위치를가리키도록설정해야합니다. 예를들어기존 LD_PRELOAD 항목이다음과같이설정되어있으면 LD_PRELOAD=web_agent_home/bin/libbtunicode.so 다시설치또는업그레이드하기전에다음과같이변수를설정합니다. export LD_PRELOAD= 이항목은변수를빈값으로설정합니다. Windows 에서설치마법사를실행하여에이전트업그레이드 SiteMinder 에이전트설치프로그램은 Windows 운영환경을사용하여한번에하나의컴퓨터에에이전트를설치합니다. 이설치프로그램은마법사또는콘솔모드에서실행될수있습니다. 또한마법사및콘솔기반설치프로그램은후속설치 / 구성작업을무인으로또는자동으로수행할수있도록동일한설정이포함된.properties 파일을생성합니다. 예를들어환경에설치되는여러에이전트에사용되는웹서버버전, 설치디렉터리, 에이전트구성개체및정책서버가같다고가정해봅니다. 첫번째에이전트를설치할때는설치마법사또는콘솔기반설치프로그램을사용합니다. 그이후에는마법사또는콘솔기반설치프로그램에서생성한.properties 파일을사용하여설치프로그램을실행하도록스크립트를작성할수있습니다. 다음단계를수행하십시오. 1. SiteMinder 웹에이전트설치실행파일을웹서버의임시디렉터리에복사합니다. 2. 다음단계중하나를수행합니다. 마법사기반설치의경우설치실행파일을마우스오른쪽단추로클릭하고 " 관리자권한으로실행 " 을선택합니다. 콘솔기반설치의경우명령줄창을열고다음과같이지정하여실행파일을실행합니다. executable_file_name.exe -i console 3. 이전에수집한정보를사용하여설치를완료합니다. 70 Apache 기반서버용웹에이전트설치안내서

71 SiteMinder 에이전트업그레이드를준비하는방법 UNIX/Linux 에서설치마법사를실행하여에이전트업그레이드 SiteMinder 에이전트설치프로그램은 UNIX 또는 Linux 운영환경을사용하여한번에하나의컴퓨터에에이전트를설치합니다. 이설치프로그램은마법사또는콘솔모드에서실행될수있습니다. 또한마법사및콘솔기반설치프로그램은후속설치 / 구성작업을무인으로또는자동으로수행할수있도록동일한설정이포함된.properties 파일을생성합니다. 예를들어환경에설치되는여러에이전트에사용되는웹서버버전, 설치디렉터리, 에이전트구성개체및정책서버가같다고가정해봅니다. 첫번째에이전트를설치할때는설치마법사또는콘솔기반설치프로그램을사용합니다. 그이후에는마법사또는콘솔기반설치프로그램에서생성한.properties 파일을사용하여설치프로그램을실행하도록스크립트를작성할수있습니다. 다음단계를수행하십시오. 1. SiteMinder 에이전트설치실행파일을웹서버의임시디렉터리에복사합니다. 2. 루트사용자로로그인합니다. 3. 다음단계중하나를수행합니다. 마법사기반설치의경우설치실행파일을실행합니다. 콘솔기반설치의경우명령줄창을열고다음과같이지정하여실행파일을실행합니다. executable_file_name.exe -i console 4. 에이전트설치워크시트의정보를사용하여설치프로그램을완료합니다. 제 6 장 : 웹에이전트로업그레이드 71

72 SiteMinder 에이전트업그레이드를준비하는방법 UNIX/Linux 에서업그레이드된에이전트를구성하기전에라이브러리경로변수설정 에이전트구성프로그램을실행하기전에 UNIX 또는 Linux 시스템에서라이브러리경로변수를설정합니다. 다음표에서는다양한 UNIX 및 Linux 운영환경의라이브러리경로변수를보여줍니다. 운영체제 AIX Linux Solaris 라이브러리경로변수이름 LIBPATH LD_LIBRARY_PATH LD_LIBRARY_PATH 라이브러리경로변수의값을 web_agent_home/bin 디렉터리로설정합니다. web_agent_home SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (UNIX/Linux 시스템 ): /opt/ca/webagent 72 Apache 기반서버용웹에이전트설치안내서

73 SiteMinder 에이전트업그레이드를준비하는방법 Windows 에서업그레이드된에이전트구성 에이전트구성에필요한정보를수집한후에이전트구성프로그램을실행합니다. 이프로그램은컴퓨터에서실행중인웹서버에대한에이전트런타임인스턴스를생성합니다. 이구성프로그램은선택한옵션에따라마법사또는콘솔을기반으로실행됩니다. 마법사또는콘솔모드에서구성프로그램을실행하면속성파일이생성됩니다. 이속성파일을사용하면나중에운영환경이같은다른컴퓨터에서무인구성을실행할수있습니다. 다음단계를수행하십시오. 1. 웹서버에서다음디렉터리를엽니다. web_agent_home\install_config_info web_agent_home 웹서버에서 SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (Windows 32 비트설치만해당 ): C:\Program Files\CA\webagent 기본값 (Windows 64 비트설치만해당 ): C:\Program Files\CA\webagent\win64 기본값 (64 비트시스템에서작동하는 Windows 32 비트응용프로그램 - Wow64 모드 ): C:\Program Files (x86)\webagent\win32 2. 다음구성방법중하나를사용합니다. GUI 기반구성의경우 3 단계로이동합니다. 콘솔기반구성의경우 5 단계로이동합니다. 3. 다음실행파일을마우스오른쪽단추로클릭하고 " 관리자권한으로실행 " 을선택합니다. ca-wa-config.exe 4. 8 단계로이동합니다. 5. 관리자권한으로명령프롬프트창을엽니다. 6. 위에서설명한실행파일을탐색한후다음스위치를지정하여파일을실행합니다. -i console 7. 8 단계로이동합니다. 제 6 장 : 웹에이전트로업그레이드 73

74 SiteMinder 에이전트업그레이드를준비하는방법 8. 구성프로그램의지시에따릅니다. 에이전트구성워크시트를참조하여요청된값을제공합니다. 웹서버에대한에이전트런타임인스턴스가생성됩니다. 74 Apache 기반서버용웹에이전트설치안내서

75 SiteMinder 에이전트업그레이드를준비하는방법 UNIX/Linux 에서업그레이드된에이전트구성 에이전트구성에필요한정보를수집한후에이전트구성프로그램을실행합니다. 이프로그램은컴퓨터에서실행중인웹서버에대한에이전트런타임인스턴스를생성합니다. 이구성프로그램은선택한옵션에따라마법사또는콘솔을기반으로실행됩니다. 마법사또는콘솔모드에서구성프로그램을실행하면속성파일이생성됩니다. 이속성파일을사용하면나중에운영환경이같은다른컴퓨터에서무인구성을실행할수있습니다. 다음단계를수행하십시오. 1. 웹서버에서다음디렉터리를엽니다. web_agent_home/install_config_info web_agent_home SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (UNIX/Linux 시스템 ): /opt/ca/webagent 2. 다음구성방법중하나를사용합니다. GUI 기반구성의경우 3 단계로이동합니다. 콘솔기반구성의경우 5 단계로이동합니다. 3. 다음실행파일을실행합니다. ca-wa-config.bin 4. 8 단계로이동합니다. 5. 루트권한으로명령프롬프트창을엽니다. 6. 위에서설명한실행파일을탐색한후다음스위치를지정하여파일을실행합니다. -i console 7. 8 단계로이동합니다. 8. 구성프로그램의지시에따릅니다. 에이전트구성워크시트를참조하여요청된값을제공합니다. 웹서버에대한에이전트런타임인스턴스가생성됩니다. 제 6 장 : 웹에이전트로업그레이드 75

76

77 제 7 장 : 운영체제조정 이섹션은다음항목을포함하고있습니다. 공유메모리세그먼트조정 ( 페이지 78) Solaris 10 리소스컨트롤을조정하는방법 ( 페이지 80) 제 7 장 : 운영체제조정 77

78 공유메모리세그먼트조정 공유메모리세그먼트조정 Solaris 시스템에 Apache 기반에이전트를설치하는경우에이전트가올바로작동하려면운영환경의공유메모리설정을조정해야합니다. 운영환경의공유메모리세그먼트를늘리면에이전트성능이향상됩니다. 공유메모리세그먼트를제어하는변수는운영환경의사양파일에정의됩니다. AIX 운영환경의경우 Apache 기반서버를시작하기전에다음명령을실행하십시오. export EXTSHM=ON 참고 : Linux 운영환경에서공유메모리세그먼트를조정해야할경우가있습니다. 공유메모리세그먼트에대한내용및이러한세그먼트를조정하는방법을보려면해당운영환경의설명서를참조하십시오. 다음단계를수행하십시오. 1. 운영환경에맞는절차를따릅니다. Solaris: 선택한편집기를사용하여 /etc/system 파일을엽니다. 2. 다음방법중하나를사용하여공유메모리변수를수정합니다. Solaris: 아래목록에나오는변수를추가하고예제의권장설정을사용하여변수를구성합니다. 다음구문을사용하십시오. set shmsys:shminfo_shmmax= shmsys:shminfo_shmmax 최대공유메모리세그먼트크기를지정합니다. 이값은에이전트리소스및세션캐시의최대크기를제어합니다. 참고 : 필요한메모리세그먼트의크기를계산하려면각캐시의항목당 4 KB 를할당하거나 OneView 모니터에서캐시사용통계를확인해야합니다. OneView 모니터사용에대한자세한내용은웹에이전트구성안내서를참조하십시오. 예 : (32 MB) - 사용량이많아큰캐시가필요한사이트의경우 shmsys:shminfo_shmmin (Solaris 의경우필요하지않음 ) 최소공유메모리세그먼트크기입니다. 에이전트리소스및세션캐시의최소크기를제어합니다. 78 Apache 기반서버용웹에이전트설치안내서

79 공유메모리세그먼트조정 shmsys:shminfo_shmmni 시스템전체에서동시에존재할수있는최대공유메모리세그먼트의수를지정합니다. 예 : (Solaris 9 제외 ) 해당없음 예 : (Solaris 9) 200 shmsys:shminfo_shmseg (Solaris 9 의경우필요하지않음 ) 각프로세스에대해최대공유메모리세그먼트수를지정합니다. 예 : 24 semsys:seminfo_semmni 세마포식별자수를지정합니다. 시스템에서실행하는에이전트의모든인스턴스에대해 11 을사용합니다. 예 : (Solaris 9 제외 ) 100 예 : (Solaris 9) 200 semsys:seminfo_semmns 시스템의세마포수를지정합니다. 시스템에서실행하는에이전트의모든인스턴스에대해 10 을사용합니다. 예 : (Solaris 9) 100 예 : (Solaris 9) 400 semsys:seminfo_semmnu undo 기능을사용하는프로세스의수를지정합니다. 최적의성능을위해서는 semmnu 값을시스템에서한번에실행되는 Apache 자식프로세스의수보다큰값으로설정합니다. Apache 기반서버의경우 maxclients 설정보다 200 이상큰값을사용하십시오. 예 : (Solaris 9) 변경내용을저장하고파일또는유틸리티를종료합니다. 4. 시스템을재부팅합니다. 5. 다음명령을입력하여변경내용을확인합니다. $ sysdef -i 제 7 장 : 운영체제조정 79

80 Solaris 10 리소스컨트롤을조정하는방법 Solaris 10 리소스컨트롤을조정하는방법 프로젝트수준에서리소스컨트롤을조정하여에이전트성능을향상시킬수있습니다. 참고 : 자세한내용은 Solaris 설명서를참조하십시오. Solaris 10 에서리소스컨트롤을조정하려면다음을수행하십시오. 1. 웹에이전트를실행하는사용자계정과연결된프로젝트를확인합니다. 2. 해당프로젝트에대해다음리소스컨트롤의설정을늘립니다. project.max-shm-ids 프로젝트의최대공유메모리 ID 수를지정합니다. project.max-sem-ids 프로젝트의최대세마포 ID 수를지정합니다. project.max-msg-ids 프로젝트의최대메시지큐 ID 수를지정합니다. project.max-shm-memory 프로젝트에허용되는전체공유메모리의크기를지정합니다. process.max-sem-nsems 각세마포집합에허용되는최대세마포수를지정합니다. process.max-sem-ops 각 semop 에허용되는최대세마포작업수를지정합니다. process.max-msg-messages 메시지큐의최대메시지수를지정합니다. process.max-msg-qbytes 메시지큐의최대메시지바이트수를지정합니다. 80 Apache 기반서버용웹에이전트설치안내서

81 제 8 장 : 웹에이전트제거 이섹션은다음항목을포함하고있습니다. 웹에이전트제거에대한참고사항 ( 페이지 81) SiteMinder 에이전트를제거하기전에 PATH 변수에 JRE 설정 ( 페이지 82) Windows 운영환경에서웹에이전트제거 ( 페이지 83) UNIX 시스템에서웹에이전트제거 ( 페이지 85) z/os 시스템에서 SiteMinder 에이전트제거 ( 페이지 86) 웹에이전트제거에대한참고사항 다음내용을참고하십시오. 설치된웹서버의모든웹에이전트가제거됩니다. 암호서비스및양식디렉터리 (pw_default, jpw_default, samples_default) 가제거됩니다. 그러나이러한디렉터리의비기본복제디렉터리 (pw, jpw, samples) 는사용자지정된파일을포함하므로제거되지않습니다. 제거에필요한 JRE 가웹에이전트시스템에설치되어있는지확인합니다. 지원되는버전을보려면기술지원사이트의 "SiteMinder Platform Support Matrix"(SiteMinder 플랫폼지원표 ) 를참조하십시오. 제 8 장 : 웹에이전트제거 81

82 SiteMinder 에이전트를제거하기전에 PATH 변수에 JRE 설정 SiteMinder 에이전트를제거하기전에 PATH 변수에 JRE 설정 Windows 및 UNIX 시스템에서 SiteMinder 에이전트를제거하는경우 JRE 가 PATH 변수에있는지확인하십시오. 이변수가없으면제거프로그램이중지되고다음오류메시지중하나가나타납니다. "Could not find a valid Java virtual machine to load. You need to reinstall a supported Java virtual machine." ( 로드할유효한 Java Virtual Machine 을찾을수없습니다. 지원되는 Java Virtual Machine 을다시설치해야합니다.) "No Java virtual machine could be found from your PATH environment variable. You must install a VM prior to running this program." (PATH 환경변수에서 Java Virtual Machine 을찾을수없습니다. 이프로그램을실행하기전에 VM 을설치해야합니다.) 다음단계를수행하십시오. Windows 1. 제어판으로이동합니다. 2. " 시스템 " 을두번클릭합니다. 3. " 환경변수 " 대화상자에서 PATH 시스템변수에 JRE 의위치를추가합니다. 예 : C:\j2sdkversion_number\jre\bin UNIX 의경우 다음명령을실행합니다. 1. PATH=$PATH:JRE/bin JRE JRE 의위치를지정합니다. 예 : /usr/bin/j2sdkversion_number/jre 2. export PATH 82 Apache 기반서버용웹에이전트설치안내서

83 Windows 운영환경에서웹에이전트제거 Windows 운영환경에서웹에이전트제거 Windows 운영환경에서 SiteMinder 웹에이전트를제거하기전에레지스트리설정및웹에이전트구성설정의백업복사본을만들어두는것이좋습니다. 다음단계를수행하십시오. 1. 웹서버를중지합니다. 2. 다음절차중하나를선택하십시오. 마법사를사용하여웹에이전트를제거하려면 3 단계로이동합니다. 콘솔기반프로그램을사용하여웹에이전트를제거하려면 8 단계로이동합니다. 3. " 시작 ", " 제어판 ", " 프로그램및기능 " 을차례로클릭합니다. 설치된프로그램목록이나타납니다. 4. "CA SiteMinder 웹에이전트 version_number" 를클릭합니다. 5. " 제거 / 변경 " 을클릭합니다. 제거마법사가나타납니다. 6. "SiteMinder 웹에이전트제거 " 대화상자의내용을검토한후 " 제거 " 를클릭합니다. 웹에이전트가제거됩니다. 7. 마법사가끝나면 12 단계로이동합니다. 8. 명령줄창을엽니다. 9. 다음디렉터리로이동합니다. web_agent_home web_agent_home 웹서버에서 SiteMinder 에이전트가설치된디렉터리를나타냅니다. 기본값 (Windows 32 비트의 SiteMinder IIS 웹에이전트설치만해당 ): C:\Program Files\CA\webagent 기본값 (Windows 64 비트의 SiteMinder IIS 웹에이전트설치만해당 ): C:\Program Files\CA\webagent\win64 제 8 장 : 웹에이전트제거 83

84 Windows 운영환경에서웹에이전트제거 기본값 (64 비트시스템에서작동하는 Windows 32 비트응용프로그램 - Wow64 모드의 IIS 용 SiteMinder 웹에이전트만해당 ): C:\Program Files (x86)\webagent\win 다음명령을실행합니다. ca-wa-uninstall.cmd -i console 11. 제거프로그램이끝나면 12 단계로이동합니다. 12. 웹서버를시작합니다. 중요! 웹에이전트를제거한후 C:\Program Files\ZeroG Registry\com.zerog.registry.xml 위치에서 ZeroG 레지스트리파일을삭제하십시오. 84 Apache 기반서버용웹에이전트설치안내서

85 UNIX 시스템에서웹에이전트제거 UNIX 시스템에서웹에이전트제거 여기에나오는지침은 GUI 모드및콘솔모드에서제거할때적용됩니다. 참고 : 64 비트 SuSE Linux 10 시스템에서웹에이전트를제거하려면추가준비작업이필요합니다. 두모드에대해같은단계가수행되지만다음내용은콘솔모드에만해당됩니다. 해당번호를입력하여원하는옵션을선택합니다. 다음절차에명시된대로각단계가끝나면 "Next"( 다음 ) 를클릭하는대신 Enter 키를눌러계속진행합니다. 참고 : 제거하기전에에이전트구성설정의백업복사본을만드는것이좋습니다. 1. 웹서버를중지합니다. 2. UNIX 시스템에로그인합니다. 3. PATH 환경변수에 JRE 를지정하여웹에이전트를제거합니다. Java Virtual Machine 을찾을수없다는오류메시지가나타나면다음과같이 PATH 변수에 JRE 를추가합니다. PATH=/jre_home/bin:${PATH} export PATH jre_home 은 JRE 의위치입니다. 4. 웹에이전트가설치된디렉터리를탐색합니다. web_agent_home/install_config_info/ca-wa-uninstall 5. 필요한경우 chmod +x uninstall 을입력하여제거프로그램에대해실행권한이있는지확인합니다. 6. 콘솔창에서다음명령중하나를입력합니다. GUI 모드 :./uninstall 콘솔모드 :./uninstall -i console 제거프로그램이시작됩니다. 7. 웹에이전트제거를확인하는대화상자의내용을검토한후 "Uninstall"( 제거 ) 을클릭합니다. 그러면웹에이전트가시스템에서제거됩니다. 제 8 장 : 웹에이전트제거 85

86 z/os 시스템에서 SiteMinder 에이전트제거 8. "Done"( 완료 ) 을클릭하여제거프로그램을종료합니다. 9. ( 선택사항 ) Apache 기반에이전트의경우구성마법사가추가한행을 httpd.conf 파일에서제거합니다. 10. 홈디렉터리로변경합니다 ( 현재디렉터리는삭제됨 ). 11. 웹서버를다시시작합니다. z/os 시스템에서 SiteMinder 에이전트제거 여기에나오는지침은 GUI 모드및콘솔모드에서제거할때적용됩니다. 두모드에대해같은단계가수행되지만다음내용은콘솔모드에만해당됩니다. 해당번호를입력하여원하는옵션을선택합니다. 다음절차에명시된대로각단계가끝나면 "Next"( 다음 ) 를클릭하는대신 Enter 키를눌러계속진행합니다. 참고 : 제거하기전에에이전트구성설정의백업복사본을만드는것이좋습니다. 다음단계를수행하십시오. 1. 루트사용자로로그인합니다. 2. 웹서버를중지합니다. 3. 셸을열고 SiteMinder 에이전트가설치된디렉터리를탐색합니다. web_agent_home/install_config_info/ca-wa-uninstall 4. 필요한경우다음명령을입력하여제거프로그램에대해실행권한이있는지확인합니다. chmod +x installation_media installation_media 정책서버설치관리자실행파일을지정합니다. 86 Apache 기반서버용웹에이전트설치안내서