When you run the Decommission Server Analysis tool, you create a Results database containing detailed information comparing the source server and the target server. The source server is the server being removed from service, and the target server is the server taking the place of the source server. The source and the target servers must be Domino servers that have hierarchical names and that are in the same domain.

Inconsistencies between the source and target servers are marked in the Results database to alert you to the administrative tasks you may need to do before you can decommission the server. Each comparison that the Decommission Server Analysis tool makes is somewhat individual. Relationships between analysis items are not determined by this tool; therefore, you need to review each report and make your own comparisons before taking any action. Perform comparisons between only two servers at a time. You do not need to resolve all differences before you decommission a server.

Before decommissioning a server

Before decommissioning a server, you may need to perform the following types of administrative activities:

• Check each database for formulas that contain specific server name references.
• Update the documents in the Domino Directory, such as the Connection and Program documents, to reflect the new server name.
• If the old server had cross-certificates, make sure the new server has the same cross-certificates.
• Notify other domains that access the server about the change.
• Inform users about the new location for databases, including their mail database, if necessary.
• Make sure the network protocols on the old and new servers match.
• Replicate all the databases from the old server to the new server.
• Update mail routing tables to ensure that mail gets delivered correctly.

1. To use the Decommission Server Analysis Tool, you must have administrator access to both the source and the target servers.

If you don't have administrator rights, some portions of the report may not be completed properly.

3. From the tools pane, select Analyze - Decommission Server.

4. Complete these fields:

Field	Enter
Source server	Name of the server being decommissioned
Target server	Name of the server that will replace the server being decommissioned
Results database	Name and/or location of the Results database if you are not using the default file name DECOMSRV.NSF. Complete these fields: Server Title File Name Folder
Append to this database	(Default) Adds the new report to the end of the existing information in the Results database without deleting any existing data
Overwrite this database	Adds the new Results database by overwriting the existing database

5. Click OK.

When the analysis is complete, the Results database opens to the Reports view. This can take up to several minutes depending on network traffic and the number of databases on both the source and target servers.

Viewing the report in the Results database

The Decommission Server Analysis tool generates a categorized list of items that were analyzed. Each category represents a different aspect of a server's configuration that needs attention. Within each category, items are listed alphabetically. Each item lists any differences between the source and the target server's settings or values. In the Results database, you can view the categorized list of the items that were analyzed.

Each item is represented by a document. A document's status is indicated by an icon to the left of the document as follows:

Icon	Explanation
	A difference was found when doing the comparisons and may require the attention of an administrator.
	An error was encountered when performing or trying to perform a comparison.
No icon	No attention is required because the fields being compared are either equivalent or the source's values are a complete subset of the target's values.

Click a document to open it and view the actual report that was generated. A sample report is shown here:

Report Field	Description
Report category	The section or category that the document belongs to. These categories are: Certificates, Cluster, Connections, Databases, Domains, Internet, Miscellaneous, Network, Programs, Security, SMTP, and Router.
Report title	The specific field or item that is being analyzed -- for example, Databases -- Mail Users or Databases -- No Matching Replica.
Report date	Date the report is generated.
Server to be decommissioned (source server)	Name of the server being retired.
Server to accept responsibility (target server)	Name of the server that will assume the responsibilities of the server being decommissioned.
Errors	Errors that occur during the analysis on this item or field. This field is blank if there are no errors.
Report details	Information that indicates the problem or inconsistency that exists between the source and target servers.

Report comparisons

The following types of field comparisons are done between the two Server documents and the Configuration documents:

Field Comparison	Explanation
Boolean	The content of the two fields being compared must be an exact match. In some cases, if the field on the source server is not set, no comparison is done with the value for the target server.
Numeric	The two fields are compared and differences are reported.
Text list	Two text lists are compared and a report is generated if the source is not a complete subset of the target.
Name list	Two names lists are compared by expanding both lists to single entries, removing duplicates, and generating a report if the source is not a complete subset of the target. When expanding names lists, all groups are expanded until only single entries remain.
Special cases	In some cases, a blank field has a special meaning. In these cases, the specific interpretation of blank for each field is taken into consideration when comparisons are performed.

Comparisons are made to the following documents:

Document comparison	Explanation
Connection documents	A comparison is performed on any connection in which the server to be decommissioned is listed as the source server in the Connection document. The comparison ensures that all destination servers in those connections are also included in the target server's Connection documents. A report is generated if the Tasks differ or if any corresponding connections do not exist. All connections listing the server to be decommissioned as the Destination server are reported.
Program documents	All Program documents that list the source server as the server on which to run the program are included in the report. No comparison between the source and target Program documents is done because there is no way to ensure that the executables exist or are the same on the source and target.
Domain documents	All Foreign domain documents are checked to see if the Gateway server name lists the source server. If one is found, a document is generated showing which foreign domain documents list the source.
Cross-Certificates	Any cross-certificate that lists the source server in the Issued By field is reported.

These comparisons are made to databases:

Database comparison	Explanation
Mail-in databases, Rooms, Resources, Certifiers, Person documents	Each document that lists the source server as the Mail server is reported.
Replicas	Any database on the source server that does not have a matching replica on the target server is reported. A file name comparison for all databases that do not have replicas on the target is done. Any database on the source that has a name conflict with a different database with the same name on the target is listed.

These comparisons are made to networks:

Network comparison	Explanation
Enabled ports	A comparison is done for both port name and protocol. A report is generated for any differences.
Notes named networks	If the source and target servers do not share the same Notes named networks, a report is generated.

See also

Managing servers
Decommissioning a Domain Search server
Deleting a server name

Glossary