Como mudar o nome de um servidor SharePoint

Mudar o nome a um servidor de SharePoint pode ser uma tarefa tediosa. Vou descrever alguns dos passos necessários para o fazer.

1. Mudar o nome da máquina no Windows

  • Abram as propriedades do sistema em Start > Control Panel > System
  • Vão à tab Computer Name
  • Carreguem no botão Change
  • Escrevam o novo nome da máquina
  • Reiniciem o computador

2. Mudar o nome do servidor para o SharePoint

  • Vão a
    %COMMONPROGRAMFILES%\Microsoft shared\Web server extensions\12\Bin
  • Usem o seguinte comando para alterar o nome do servidor:
    • stsadm -o renameserver -oldservername <current name of the server> -newservername <new name for the server>
  • Não se esqueçam de fazer isto para todos os servidores (front-ends, base de dados, etc.)
  • Façam um IIS reset:
    • iisreset /noforce

3. Actualizar o ficheiro hosts

  • Abram o ficheiro hosts em
    %WINDIR%\system32\drivers\etc\hosts
  • Actualizem todas as referências para o nome antigo do servidor
  • Se usam um servidor de DNS também vão precisar de o actualizar

4. Actualizar os URLs dos web sites no IIS

  • Abram o IIS Manager em Start > Administrative Tools > Internet Information Services (IIS) Manager
  • Expandam o servidor e escolham Web Sites
  • Abram as propriedades do site e vão à tab Web Site
  • Carreguem em Advanced… e actualizem todas as entradas que se referem ao nome anterior do servidor
  • Repitam os passos para todos os sites

5. Actualizar a conta da Application Pool

  • Abram o IIS Manager em Start > Administrative Tools > Internet Information Services (IIS) Manager
  • Expandam o servidor e escolham Application Pools
  • Abram as propriedades da application pool e vão à tab Identity
  • Certifiquem-se que a conta ainda é válida
  • Repitam para todas as application pools

6. Actualizar os Alternate Access Mappings

  • Comecem por actualizar os mappings da Central Administration:
    • Vão a
      %COMMONPROGRAMFILES%\Microsoft shared\Web server extensions\12\Bin
    • Adicionem o novo URL usando o seguinte comando:
      • stsadm -o addalternatedomain -url <valid URL> -incomingurl <incoming URL> -urlzone {Default | Internet | Extranet | Custom} -resourcename <non-Web application resource name>
    • Removam o URL antigo escrevendo:
      • stsadm -o deletealternatedomain -url <valid URL> -incomingurl <incoming URL>
  • Depois de terem a Central Administration a trabalhar, os outros mappings podem ser alterados directamente na Central Administration:
    • Abram a Central Administration
    • Vão à página Operations
    • Carreguem em Alternate Access Mappings em Global Configuration
    • Actualizem todos os mappings referentes ao servidor antigo

7. Actualizar as Search Content Sources

  • Para cada Shared Service Provider:
    • Vão a Search settings
    • Escolham Content sources and crawl schedules
    • Editem cada content source:
      • Certifiquem-se que os URLs reflectem o novo nome do servidor

8. Actualizar referências no conteúdo

  • Idealmente, não terão nenhumas, mas caso as tenham lembrem-se de actualizar todas as referências no conteúdo que apontam para o servidor antigo. Obviamente, isto é específico a cada aplicação.

Problemas que podem encontrar

1. Não conseguem fazer IIS reset

  • Sintomas:
    • Impossível de fazer IIS reset, porque a operação falha
    • Mensagem de erro:
      • Attempting stop...
        Internet services successfully stopped
        Attempting start...
        Restart attempt failed.
        The service did not respond to the start or control request in a timely fashion. (2147943453, 8007041d)
  • Solução:
    • No meu caso, tive de reiniciar o IIS Admin Service:
      • Vão a Start > Administrative Tools > Services
      • Encontrem o IIS Admin Service e reiniciem-no

2. O site não inicia no IIS

  • Sintomas:
    • O site está parado e não inicia
    • Mensagem de erro:
      • The process cannot access the file because it is being used by another process
  • Solução:
    • No meu caso, foi resolvido reiniciando o servidor e depois iniciando o site
    • Há várias causas para este erro, vejam KB 890015

3. Não conseguem aceder à SharePoint Central Administration

  • Sintomas:
    • A Central Administration não abre
    • Error message:
      • Cannot display web page
  • Causa:
    • Pode ser causado pela alteração do nome do servidor e não conseguir criar o alternate access mapping para a Central Administration
  • Solução:
    • Usem o seguinte comando para recriar a Central Administration numa porta diferente:
      • psconfig -cmd adminvs -provision -port <port number> -windowsauthprovider "onlyusentlm"

Recursos

Nuno Freitas
Publicado por Nuno Freitas em 19 setembro, 2013

Artigos relacionados