Downloading and running the Domain Configuration tool
The Domain Configuration tool configures your on-premises servers to connect to your hosted IBM SmartCloud® Notes® servers. The server configuration information that you provide in the Account Settings of SmartCloud Notes Administration is the data that is used to configure the connections.
Before you begin
Before you can download and run the Domain Configuration tool for the first time, all of the required Account Settings information must be complete. To confirm that all of the required information is available, complete the task Checking the status of your hybrid account setup. If any information is incomplete, provide the missing information.
The IBM® Notes client from which the tool is run must be able to connect to the passthru servers in the passthru domain. The client must also be able to connect to the directory synchronization and mail hub servers in the on-premises hub domain. Firewall rules at your company might prevent connections from systems inside the firewall to the passthru servers. In this case, use a Notes client running on a system connected outside the firewall. Allow a direct connection to the passthru servers, and through them, connect to the servers in the on-premises hub domain.
If you are configuring the service for the first time, to make sure your on-premises environment is prepared, complete the task Using the pre-configuration tool to check your environment.
About this task
You run the Domain Configuration tool when you first configure the service to interoperate with your on-premises environment.
You also run the tool after the initial configuration. Run the tool again if you change a server configuration in Account Settings or if you correct a configuration problem in your on-premises environment.
- Pre-configuration Test - Runs the same series of pre-configuration tests as the SmartCloud Notes Hybrid Pre-configuration tool (liveservercheck.nsf). If you did not complete the task Using the pre-configuration tool to check the status of your hybrid account setup, you can run those tests now. The tool then provides a report that identifies configuration issues that you can address before configuration.
- Pre-configuration Report - Simulates the configuration, and provides a report of the configuration changes that would be made to your environment during the actual configuration process.
After you run the Domain Configuration tool, a detailed report lists the changes that were made to your on-premises server configuration. Typical changes include:
- Allowing SmartCloud Notes servers sufficient access to your Domino® directories to perform directory synchronization
- Creating connection documents to support server passthrough and mail routing to SmartCloud Notes servers
- Modifying server configuration documents to allow passthrough access to these servers
- Setting a server environment variable
Procedure
What to do next
If you must run the tool again to make sure that your setup is still correct, perform steps 1-5 to get a new copy of liveserverconfig.nsf. When troubleshooting any communication issues with the service, running the tool is a good way to check whether anything has been changed, and whether you must return to the previous settings.
When you are satisfied that your environment is set up correctly after the initial service configuration, complete the task Verifying Internet domain names in a hybrid environment.