MONITORING


Decommissioning a server
You use the Decommission Server Analysis tool when you are consolidating existing servers and/or permanently removing a server from service. Whether you are combining two servers into one server or renaming a server, the result is the same -- the old server name is replaced with the new server name. The analysis tool can help you avoid a loss of service for your IBM® Lotus® Domino® server and can be used to help build a foundation for a decommission "to do" checklist. The role of the Server Analysis Tool is to compare the responsibility of the source server to that of the target server and to report differences that could cause a possible loss of service.

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:

To run an analysis report on Decommission Server

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


2. From the Domino Administrator, click the Server - Analysis tab.

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

4. Complete these fields:
FieldEnter
Source serverName of the server being decommissioned
Target serverName of the server that will replace the server being decommissioned
Results databaseName 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 databaseAdds the new Results database by overwriting the existing database
5. Click OK.


Note You can create multiple reports in the same database or in different databases and then use these reports to verify that differences between the two servers are remedied and cannot be seen by the system when you run the Decommission Server Analysis tool. You can re-run the reports as many times as you wish.

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:
IconExplanation
Icon indicating the item needs administrator attention.A difference was found when doing the comparisons and may require the attention of an administrator.
Icon indicating an error was encountered.An error was encountered when performing or trying to perform a comparison.
No iconNo 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.
Report FieldDescription
Report categoryThe 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 titleThe specific field or item that is being analyzed -- for example, Databases -- Mail Users or Databases -- No Matching Replica.
Report dateDate 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.
ErrorsErrors that occur during the analysis on this item or field. This field is blank if there are no errors.
Report detailsInformation 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 ComparisonExplanation
BooleanThe 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.
NumericThe 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 casesIn 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 comparisonExplanation
Connection documentsA 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 documentsAll 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 documentsAll 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-CertificatesAny cross-certificate that lists the source server in the Issued By field is reported.
These comparisons are made to databases:
Database comparisonExplanation
Mail-in databases, Rooms, Resources, Certifiers, Person documentsEach document that lists the source server as the Mail server is reported.
ReplicasAny 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 comparisonExplanation
Enabled portsA comparison is done for both port name and protocol. A report is generated for any differences.
Notes named networksIf the source and target servers do not share the same Notes named networks, a report is generated.

Related topics