Manage Learn to apply best practices and optimize your operations.

Move a Lotus Domino server to a new certifier without a reinstall

Learn step-by-step how to move a Lotus Domino server to a new certifier without a reinstallation or changing any original settings.

Suppose that there is a company name change and you must to move your Lotus Domino server to a new certifier, without changing any server settings. Learn step-by-step how to move your Lotus Domino server without having to reinstall it or change any settings using the Server1/ExistingCertifier will be moved to Server1/NewCertifier example.

  1. Create a new certifier (/Newcertifier).
  2. Be sure to cross-certify in both directions (/Newcertifier-> /ExistingCertifier and /ExistingCertifier->/Newcertifier).
  3. Create a new server registration with the new certifier (Server1/NewCertifier).
  4. In your "all servers documents" view, duplicate the Server1/ExistingCertifier server document.
  5. Edit the duplicate document and change the server name to "Server1Temp/NewCertifier."
  6. Edit the server document for Server1/Newcertifer (the newly registered document) and copy the value of the field "Certified Public Key" to your clipboard, under the Administration tab.
  7. Next, paste in your new server document by replacing the "Certified Public Key" value in the Server1Temp/NewCertifier server document.
  8. Delete the Server1/NewCertifier server document.
  9. Edit the document for Server1Temp/NewCertifier and change the name to Server1/Newcertifier. Save and close out.
  10. Duplicate all connexion documents where Server1/ExistingCertifer is the source or destination server.
  11. Next, change Server1/Existingcertifier to Server1/NewCertifier in all duplicated documents.
  12. With your admin client, add Server1/NewCertifier in the access control list (ACL) of all Lotus Notes databases marked with 'Manager' access. Specify it as "Administration Server," using the advanced tab for MailFiles and other Lotus Notes databases, if needed.
  13. Replicate names to all Lotus Domino servers.
  14. Use a code-generated button to send an email to all Lotus Notes users with Server1 as their home server, so that they can change the Mailserver Field in their location document. Below is the LotusScript code to create this button.

    Note: Clicking this button will change the servername information in all location and connections documents of the local address book. Domino administrators should adapt this code to meet their own specifications.

    Sub Click(Source As Button) 
    Dim session As New NotesSession 
    Dim db As NotesDatabase 
    Dim view As NotesView 
    Dim doc As NotesDocument 
    Dim nextdoc As NotesDocument 
    Dim destLocation As Variant 
    Dim privnab As New NotesDatabase
    ("","names.nsf") 
            
    If Not (privnab.isopen) Then 
                    privnab.Open "","" 
    End If 
    Set view = db.GetView("($Connections)") 
    Set doc = view.GetFirstDocument 
    While Not doc Is Nothing 
    destServer = doc.GetItemValue("Destination") 
    Set nextdoc=view.GetNextDocument(doc) 
    'THE BELOW LINE MUST BE MODIFIED 
    TO SPECIFY THE RELATIVE SERVER NAME: 
    If destServer(0) = 
    "CN=serverName/O=ExistingCertifier" 
    Then 
    'If you want to remove the document include this line: 
    'Call doc.Remove(True) 
    'If you want to update the Destination
     field include the below instead: 
    Call doc.replaceitemvalue
     ("Destination","CN=servername/O=NewCertifier") 
    'If you want to update the Destination 
    Server Address entry include the below: 
    'Call doc.replaceitemvalue 
    ("OptionalNetworkAddress",
    "<IP address>") 
    'Include the line below if you've 
    included either of the ReplaceItemValue calls: 
    Call doc.save (True,True) 
    End If 
    Set doc=nextdoc 
    Wend 
            
    Set view = db.GetView("($Locations)") 
    Set doc = view.GetFirstDocument 
    While Not doc Is Nothing 
    destServer = Lcase
    (doc.GetItemValue("MailServer")) 
    Set nextdoc=view.GetNextDocument(doc) 
    'THE BELOW LINE MUST BE 
    MODIFIED TO SPECIFY THE 
    RELATIVE SERVER NAME: 
    If destServer(0) = 
    "cn=servername/o=existingcertifier" 
    Then 
    'If you want to remove the document
     include this line: 
    'Call doc.Remove(True) 
    'If you want to update the Destination 
    field include the below instead: 
    Call doc.replaceitemvalue ("Destination",
    "CN=Servername/O=NewCertifier") 
    'If you want to update the Destination 
    Server Address entry include the below: 
    'Call doc.replaceitemvalue 
    ("OptionalNetworkAddress","<IP address>") 
    'Include the line below if you've included 
    either of the ReplaceItemValue calls: 
    Call doc.save (True,True) 
    End If 
    Set doc=nextdoc 
    Wend 
    End Sub
    
  15. Replace the "mailserver" field with "CN=Server1/O=NewCertifier" for all users specifying server1 as Homeserver. Stop the Lotus Domino server.
  16. Replicate names to all Lotus Domino servers.
  17. Stop Server1.
  18. Rename the existing Server ID (Server.id) file under the Domino Directory to ExistingCertifier as the extension (Server.ExistingCertifier).

    Note: Place the ID file that was created during the registration of Server1/NewCertifer and change the name to Server.id to ensure that it corresponds with what is in your notes.ini file.

  19. Copy the notes.ini file to Notes.ini.Existingcertifier.
  20. Edit your notes.ini file, find Server1/ExistingCertifier and replace it with Server1/newCertifier, and then save and close.
  21. Restart your Lotus Domino server.

Do you have comments on this tip? Let us know.This tip was submitted to the SearchDomino.com tip library by member Charles Tanabal. Please let others know how useful it is via the rating scale below. Do you have a useful Lotus Notes, Domino, Workplace or WebSphere tip or code snippet to share? Submit it to our monthly tip contest and you could win a prize.

This was last published in April 2008

Dig Deeper on Lotus Notes Domino Performance

Join the conversation

1 comment

Send me notifications when other members comment.

By submitting you agree to receive email from TechTarget and its partners. If you reside outside of the United States, you consent to having your personal data transferred to and processed in the United States. Privacy

Please create a username to comment.

Basically this worked for me, but there are a few key steps missing. On the server side... (1) For all apps on the server with scheduled server agents, you need to update the run server in each of these agents. Agents fail otherwise. (2) The internet sites view, it is crucial to update the servername in each website listing that it appears. Websites will not load otherwise. (3) Update the servername in any configuration and program documents in the Domino Directory. Config will be dropped and programs will not run otherwise. You should also note that notes client users will need to work-around issues such as... (1) The old servername being cached in the $SavedServers field of the current location doc in the user's personal address book. (Inability to reach new server by name). (2) Any existing workspace app icons/bookmarks will need to be remapped, as you would do in the case of any server rename.
Cancel

-ADS BY GOOGLE

SearchWindowsServer

Search400

  • iSeries tutorials

    Search400.com's tutorials provide in-depth information on the iSeries. Our iSeries tutorials address areas you need to know about...

  • V6R1 upgrade planning checklist

    When upgrading to V6R1, make sure your software will be supported, your programs will function and the correct PTFs have been ...

  • Connecting multiple iSeries systems through DDM

    Working with databases over multiple iSeries systems can be simple when remotely connecting logical partitions with distributed ...

SearchDataCenter

SearchExchange

SearchContentManagement

Close