IBM Connections hostname change 호스트 변경

IBM Connections 솔루션 도메인 변경에 대한 자료입니다.

이 솔루션은 현재 6.0 이상의 버젼으로 버젼업이 되서 이 내용이 조금은 다를 수도 있습니다.

다만, 이 내용은 버젼 5.0 까지 적용됐던 사항으로 아마도 6.0까지는 적용이 될것이라고 생각하고 있습니다.

(테스트는 못해봤네요 ㅎㅎㅎ)

흔히, 서버에 솔루션을 설치하고 구성하고 서비스까지 진행했는데 내부 문제와 여러가지 문제로 인해 도메인이 변경되는 경우가 있습니다.

그중에서 서버의 hostname이 변경되는 경우도 있으며, 서비스되는 웹 url domain이 변경되는 경우도 있습니다.

아래의 내용은 이러한 변경사항이 발생했을때, 어떻게 변경할수 있는지에 대한 가이드입니다.

왜냐하면, IBM Connections란 솔루션은 처음 설치시에 기본적인 도메인 정보를 입력하게 되어 있으며, 이때 입력한 도메인 정보는 제품 설치 디렉토리 내부에 xml 데이터 형태로 가지고 있게 됩니다.

아래의 방법으로 xml 구성 정보를 변경할수 있으며, 변경후에는 전체 시스템 재부팅이 필요합니다. 

물론, 여기서 재부팅은 서비스 재부팅을 말하며 OS 단의 재부팅이 아닙니다.

단, OS 재부팅이 필요한 경우가 있는데 이 경우는 OS 도메인 변경후 한번도 재부팅을 하지 않은 경우 입니다.

일반적인 윈도우 OS의 경우 도메인 변경후에는 필히 OS 재부팅을 해주는것이 좋습니다.

리눅스의 경우 도메인 변경후 강제 적용과정을 통해 재부팅이 없도록 할수는 있으나 깔끔하게 작업을 하길 원한다면 

가능한 재부팅을 추천 합니다.

예전에 재부팅이 없이 작업할 경우 인지는 하지만, 어디선가 꼬여서 결국 다시 설치한 경우가 있었습니다.

자.. 그럼 이제 아래의 도메인 변경 작업을 참고하시기 바랍니다.

아.. 참고사항입니다.

IBM Connectiosn 란 솔루션은 기본적으로 IBM WebSphere 기반에서 동작을 하고 있습니다.

IBM WebSphere는 Tomcat, weblogic 등과 같은 일반적인 web application server의 한종류 입니다.

websphere에 대해서는 추후 다시 내용을 다뤄볼 생각입니다.

그럼 즐거운 하루 되세요..

===============================================

IBM Connections 서비스 도메인 변경

IBM Connections(IC) 를 처음 설치하고 정의된 도메인으로 서비스를 하다가 도메인을 변경할일이 있을수 있다. 이런 경우 가이드다.

* 참고로 아래의 방법은 공식적인 절차라기 보다는 서비스 도메인만 바꾸는 방법이다.
다시한번 적지만 이런 방식으로 바꾸는 것은 H/W의 호스트명이 변경됐을때의 WAS에서 하는 작업등 몇가지를 모두 건너뛰고 서비스 도메인만을 바꾸기 위한 방법이다. 정식으로 하기 위해서는 WAS 도메인 변경에 대한 문서를 찾아서 바꾸기를 바란다.

1. 새로운 변경 도메인을 H/W에서 인지하기 위한 hosts 변경 ( /etc/hosts )

이부분은 크게 설명이 필요 없다. 기존에 서비스하고 있던 도메인이 connections.demo.com 이며 신규로 변경하고자 하는 도메인이 connections.service.com 이라면 추가되는 도메인만 hosts 파일에 추가하자

기존에 서비스되고 있던 내부 서비스 (예를 들어 ldap)과 같은 곳에서 기존 도메인을 필요로 할지 모르니 기존 도메인을 지우지 말고 추가만 하자

2. IC 의 각 메뉴들(블로그, 프로파일, 위키, 포럼....)에서 상단 메뉴 URL 지정을 위한 IBM Connections url mapping xml 변경 ( LotusConnections-config.xml )

IC에서 상단위 메뉴는 LotusConnections-config.xml 파일을 통해 제어가 된다. 그리고 제품을 설치하면 위의 설정 파일은 서버당 1개의 파일이 생성된다.

이제 우리가 할일은 서비스 URL의 변경이기 때문에 서비스 중인 모든 서버에서 위의 파일을 찾아서 변경해야 한다.

서버 재시작과 동기화등의 과정이 귀찮은 관계로 직접 config를 수정한다면 아래 위치로 파일을 찾아가서 수정하면 된다.

<WAS Home>\AppServer\profiles\<ServerProfile>\config\cells\<yourCellname>\LotusConnections-config\LotusConnections-config.xml

위의 파일을 열면 아래와 같이 서비스 도메인이 정의된 곳이 있다. 수정되는 도메인에 맞도록 변경하면 된다.

<sloc:href>
            <sloc:hrefPathPrefix>/activities</sloc:hrefPathPrefix>
            <sloc:static href="http://myics.ics.com" ssl_href="https://myics.ics.com"/>
            <sloc:interService href="https://myics.ics.com"/>
</sloc:href>

3. 웹 서버에서 신규 도메인을 서비스하기 위한 도메인명 변경

 웹서버에서는 기존의 변경전 도메인으로 서비스중이므로 새로 변경된 도메인에 대해서는 모르고 있다. 변경해보자

우선 웹서버 설치 경로의 config 폴더를 찾아가서 httpd.conf 파일을 열자
그리고 현재 servername과 같이 이미 정의된 도메인에 대해서 찾고 변경하자

예시 : ServerName myics.ics.com:80

그리고 일반적으로 httpd.conf 제일 마지막에 plugin-cfg.xml파일에 대한 경로가 설정되어 있다. 경로에 맞는 파일을 찾아가서 열자

예시 : WebSpherePluginConfig "C:/IBM/WebSphere/Plugins/config/webserver1/plugin-cfg.xml"

파일을 열만 일반적인 플러그인 설정에 따라 아래와 같이 virtualHost, Transport HostName 과 같은 부분에 기존 서비스 도메인이 적혀있는 곳이 있다. 전부다 새로 변경되는 도메인으로 바꾸자

  예시: <VirtualHost Name="mydocs.ics.com:9443"/>
         .............
             <Transport Hostname="myics.ics.com" Port="9080" Protocol="http"/>
             <Transport Hostname="myics.ics.com" Port="9443" Protocol="https">
              ...........

물로 모든 과정을 마치고 웹서버는 재시작을 해주는게 좋다 ( plugin-cfg.xml 파일은 자동 리로딩 기능이 적용되어 있어서 웹서버를 재시작하지 않아도 된다. 그러나 깔끔하게 재시작하자)

 

4. SSO 도메인 변경

1) SSO 도메인 변경을 위해 WAS console로 로그인

2) 보안 -> 글로벌 보안 ->Authentication -> Web and SIP security -> Single sign-on 항목으로 이동

3) 화면 가운데 부분의 Domain Name 영역에 변경되는 도메인으로 변경

5. WAS 서버 재시작

위에 과정을 모두 마치고 WAS를 재시작하자 그러면 끝....