O procedimento de alteração do hostname/domínio de um ambiente IBM Connections tem como passos principais a alteração de configurações do WebSphere Application Server e do IBM Connections.

Esse documento foi testado em um ambiente de IBM Connections v3.0.1 rodando em WebSphere Application Server na plataforma Linux/Intel e na plataforma Windows. Este procedimento pode ser utilizado no caso de reutilização de ambientes de testes ou demonstrações. Não foi testado em configurações onde existem integrações com outros produtos. Para ambientes de produção é recomendado considerar uma nova instalação.

Como visão geral, seguem os principais passos necessários para realizar a alteração:

1. Certifique-se de que o Dmgr, Node e Server estão ativos.
2. Executar os procedimentos pelo wsadmin
3. Parar todos os serviços Server, Node e Dmgr
4. Alterar os arquivos server.index
5. Apagar os diretórios de arquivos temporários
6. Alterar o hostname da máquina
7. Alterar a configuração HTTP server
8. Alterar o arquivo LotusConnections-config.xml
9. Iniciar o Dmgr
10. Sincronizar os Nós com o Dmgr
11. Alterar o domínio do SSO
12. Sincronizar os Nós com o Dmgr
13. Reiniciar o Dmgr
14. Iniciar o Node Agent
15. Iniciar o Servidor

Detalhamento dos Passos

Passo 1. Certifique-se de que o Dmgr, Node e Server estão ativos.

	E:\IBM\Websphere\AppServer\profiles\AppSrv01\bin\serverStatus.bat 
	-all -user <usuario> -password <senha>

Passo 2. Executar os procedimentos pelo wsadmin

Mude para o diretório onde se encontra o executável do comando wsadmin.

Exemplo:

	 cd /IBM/WebSphere/AppServer/bin

Execute o comando wsadmin.

E:\IBM\WebSphere\AppServer\bin\wsadmin.bat -user <user> -password <senha> -lang jython

Nota: Para a execução do comando, se faz necessário que o servidor esteja rodando.

Gere a lista das células do ambiente.

wsadmin > AdminConfig.list('ServerIndex')

Esse comando retornará o caminho para o serverindex.xml. Dependendo do ambiente você terá mais de um serverindex.xml.

Exemplo:

(cells/connectionsCell01/nodes/connectionsCellManager01|serverindex.xml#ServerIndex_1)
(cells/connectionsCell01/nodes/connectionsNode01|serverindex.xml#ServerIndex_1)
(cells/connectionsCell01/nodes/webserver1node|serverindex.xml#ServerIndex_1311284195602)'

Verifique o hostname em uso.

wsadmin > AdminConfig.show
('(cells/hostnameCell01/nodes/hostnameCellManager01|serverindex.xml#Serverindex_1)',
'hostName')

Esse comando retornará o hostname. Nesse caso '[hostName hostname.br.ibm.com]'

Execute o comando de modicação de hostName para os nós.

Exemplo:

Para o CellManager

wsadmin> AdminConfig.modify
('(cells/connectionsCell01/nodes/connectionsCellManager01|serverindex.xml#ServerIndex_1)',
"[[hostName novo_hostname]]")

Para o connectionsNode01

wsadmin> AdminConfig.modify
('(cells/connectionsCell01/nodes/connectionsNode01|serverindex.xml#ServerIndex_1) ',
"[[hostName novo_hostname]]")

Para o WebServer1node

wsadmin> AdminConfig.modify
('(cells/connectionsCell01/nodes/webserver1node|
serverindex.xml#ServerIndex_1311284195602) ',
"[[hostName novo_hostname]]")

Salve a configuração modificada.

wsadmin> AdminConfig.save()

Verifique se os hostnames foram setados corretamente.

Para o CellManager

wsadmin> AdminConfig.show
('(cells/connectionsCell01/nodes/connectionsCellManager01|
serverindex.xml#ServerIndex_1)', 
'hostName')

Para o connectionsNode01

wsadmin> AdminConfig.show
('(cells/connectionsCell01/nodes/connectionsNode01|serverindex.xml#ServerIndex_1)', 
'hostName')

Para o WebServer1node

wsadmin> AdminConfig.show
('(cells/connectionsCell01/nodes/webserver1node|
serverindex.xml#ServerIndex_1311284195602)', 
'hostName')

Esse comando retornará o hostname utilizado para cada node.

Saia do wsadmin

	wsadmin> exit

Passo 3. Parar todos os serviços

	\IBM\Websphere\AppServer\profiles\AppSrv01\bin\StopServer.bat
                -user <usuario> -password <senha>
	\IBM\Websphere\AppServer\profiles\AppSrv01\bin\StopNode.bat 
                -user <usuario> -password <senha>
	\IBM\Websphere\AppServer\profiles\Dmgr01\bin\StopManager.bat 

Passo 4. Alterar os arquivos server.index

Editar os arquivos server.index do Dmgr, conforme exemplo abaixo. Localizar e substituir todos os hostnames nestes arquivos (Find & replace)

E:\IBM\WebSphere\AppServer\profiles\Dmgr01\config\cells
                \connectionsCell01\nodes\connectionsCellManager01\serverindex.xml
E:\IBM\WebSphere\AppServer\profiles\Dmgr01\config\cells
                \connectionsCell01\nodes\connectionsNode01\serverindex.xml
E:\IBM\WebSphere\AppServer\profiles\Dmgr01\config\cells
                \connectionsCell01\nodes\webserver1node\serverindex.xml

Visualização maior da Figura 5.

Visualização maior da Figura 6.

Passo 6: Alterar o hostname da máquina

Alterar Hostname.

Reiniciar o servidor.

Passo 7: Alterar a configuração HTTP server

Parar o HTTP server.

Editar o arquivo httpd.conf, executar Find & Replace do hostname antigo pelo novo.

Iniciar HTTP Server.

Visualização maior da Figura 7.

Passo 8: Alterar o arquivo LotusConnections-config.xml

As alterações referentes ao IBM Connections acontecem no arquivo LotusConnections-config.xml. Nesse arquivo você alterará todas as "entradas" do hostname/domínio antigo, substituindo pelo novo hostname/domínio que você deseja.

Mude para o diretório onde se encontra o arquivo LotusConnections-config.xml:

cd /IBM/WebSphere/AppServer/profiles/Dmgr01/config
/cells/hostnamecell/LotusConnections-config/

Abra o arquivo LotusConnections-config.xml com o seu editor preferido e faça as substituições:

hostname antigo → hostname novo

Passo 9: Iniciar o Dmgr

	\IBM\Websphere\AppServer\profiles\Dmgr01\bin\StartManager.bat

Passo 10: Sincronizar os Nós com o Dmgr

A partir do diretório "bin" do NodeProfile, executar o comando de sincronização de nós:
Exemplo:

	E:\IBM\Websphere\AppServer\profiles\AppSrv01\bin\SyncNode.bat novohostname 
	-user <usuario> -password <senha>

Passo 11: Alterar o domínio do SSO

Acessar a console administrativa

https://novohostname:9043/ibm/console

Alterar dominio do SSO, conforme exemplo:

Visualização maior da Figura 8.

Passo 12: Sincronizar os Nós com o Dmgr

Realizar novamente sincronização dos nós com o Dmgr, conforme passo 10 ou através da console administrativa.

Passo 13: Reiniciar o Dmgr

	\IBM\Websphere\AppServer\profiles\Dmgr01\bin\StopManager.bat
	\IBM\Websphere\AppServer\profiles\Dmgr01\bin\StartManager.bat

Passo 14: Iniciar o Node Agent

	\IBM\Websphere\AppServer\profiles\AppSrv01\bin\StartNode.bat

Passo 15: Iniciar o Servidor

\IBM\Websphere\AppServer\profiles\AppSrv01\bin\StartServer.bat 
<servername>-user<usuario>-password <senha>

Sobre os autores

Arnaldo Vale é Especialista em sistemas de colaboração na brand Lotus na IBM Brasil. Formado em Bacharelado em Informática com especialização em redes e sistemas distribuídos. Profissional certificado em produtos Lotus, pelo PMI e IBM como gerente de projetos senior.

Thiago Patricio de Jesus é Especialista de Sistemas na brand de Lotus, na IBM Brasil, e possui 9 anos de experiência em Software Group. Ele é formado em Engenharia Elétrica com especialização em Eletrônica e pós graduado em "Tecnologia e Sistemas de Informação" pela Universidade Santa Cecília. Suas áreas de conhecimento incluem Linux e Software de Colaboração. Também é co-autor do redbook "Problem Determination for Linux on System z".

Classificar este artigo

Comentários

Voltar para parte superior

Índice

• Detalhamento dos Passos
• Sobre os autores
• Comentários

Conheça a IBM da sua cidade

A IBM está mais perto do que você imagina!

---

Saiba mais