SharePoint Blogs / SharePoint University
SharePoint Blogs and SharePoint University - all in one place!
Need SharePoint Training? Attend a SharePoint Bootcamp!

Please delete cookies related to sharepointblogs.com and sharepointu.com to resolve login issues!

TIP - How to rename a SharePoint Server machine name.
When you change the machine name of a Sharepoint server in the wrong manner, Sharepoint gets very unhappy and becomes non-functional.  The following steps are some I have used to get Sharepoint back on-line with the new server name.  It can probably be streamlined as well - this is a decent starting point in my opinion.
 
Best Option
Assumes you can rename SharePoint BEFORE renaming the server. 
  • rename the SharePoint server using STSADM. (-o renameserver)
  • rename the machine to match
  • reboot
  • users / logins will refer to old machine name.  You can't change the account, so add the equivalent users back and set permissions.  When I added the new one, it wired into the old name and updated that users info instead of actually adding New.
  • In SCA (SharePoint Central Administration) update administrators where necessary.

Typical Option

Since site admins will often rename the server without checking with anyone, you have a bigger problem.  Some or all of the following may be necessary.

  • Servers renamed after SharePoint was installed will mean that SP probably won't even come up.
  • Run STSADM using: 
    Stsadm.exe -o renameserver -oldservername <oldServerName> -newservername <newServerName>
    (STSADM should have run ok, but SP will still not be happy.)
  • Now fix the Alternate Access Mappings (AAM) for the site in Central Administration with STSADM:
  • You should be now able to get into CA to finish fixing the AAMs and correct the zone (setting the new name as default instead of extranet).  Messed up site AAMs will prevent you from being able to log in.
  • Once in SCA and update all admin and secondary admin logins to make sure they are all referring to the new box. 
  • Next bring up the root SP site.  Should work ok now.
  • The Index server may not be running, so start it.  Give it a while and search.  If you get results, you're ok.
  • Check pages in site and nagivation links at top with / refs using default.aspx and not explicitly typing in the default.aspx page name.  If these work, the AAMs are good.
  • In the site, you may need to fix the logins that refer to the old machine name. 
  • SharePoint should be working again and you should be done. 

---
Notes courtesy of D. Vineyard @ CSC, Fort Worth, Texas


Posted 07-15-2008 7:28 AM by RChakravarti

Comments

Links (7/15/2008) « Steve Pietrek - Everything SharePoint wrote Links (7/15/2008) &laquo; Steve Pietrek - Everything SharePoint
on 07-15-2008 7:40 PM

Pingback from  Links (7/15/2008) &laquo; Steve Pietrek - Everything SharePoint

Joe Dean wrote re: TIP - How to rename a SharePoint Server machine name.
on 08-18-2008 5:33 PM

Thanks for the help. It worked great!!

A couple of things though. I did notice that after you run the stsadm renameserver that you will have to open central admin yourself by entering the URL and port manually. I also noticed that  when you change the farm admins name (if you are using a local admin account) that the display name does not change, so you must change that manually by editing the admin profile in sharepoint CA.

RChakravarti wrote re: TIP - How to rename a SharePoint Server machine name.
on 08-22-2008 8:11 AM

Joe -

Glad it helped you, and thanks for that feedback too.

RC

Jeverson wrote re: TIP - How to rename a SharePoint Server machine name.
on 10-10-2008 10:42 AM

Really a time-saver.

Thanks a lot!

TaShimzA wrote re: TIP - How to rename a SharePoint Server machine name.
on 11-10-2008 5:32 AM

elo,  when i run the script above i get a line error and it will not work.. this is the command i run:

C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\BIN>stsa

dm -o addalternatedomain -url http://VM03-W3K:14966 -urlzone extranet -incomingu

rl http://AAICT-Intranet:14966

Renaming Server | keyongtech wrote Renaming Server | keyongtech
on 01-18-2009 10:59 AM

Pingback from  Renaming Server | keyongtech

Add a Comment

(required)  
(optional)
(required)  
Remember Me?
Need SharePoint Training? Attend a SharePoint Bootcamp!
Posts (c) their respective authors. Everything else (c) 2009 SharePoint Experts, Inc.