The SAS Deployment Manager
includes an option called Update Host Name References. This option,
which is referred to here as the Update Host Name References tool,
provides an automated way to update references to server host names
in your SAS deployment. You can use this tool if the host name or
the network domain name of an existing server machine has changed.
You can also use it if you have created an exact clone of one or more
servers (or an entire deployment) on another machine or machines.
To use the tool, you
launch the SAS Deployment Manager on each machine in your deployment
and choose the Update Host Name References option. For each existing
machine whose name has changed (or each machine that you have cloned
to a new machine), you specify the old host name and the new host
name. You can specify all forms of the old and new name, including
the fully qualified name, the short name, and the IP address. Or,
if you are cloning a machine, you can configure the tool to access
the Domain Name System to determine the various forms of the old and
new names.
The tool then searches
metadata, configuration files, and other files to find occurrences
of the old host names and changes them to the new names. When it is
finished, the tool produces a report of the changes.
You must run the Update
Host Name References tool on every SAS server host machine and every
middle-tier host machine in the deployment, even if only one host
name has changed. The reason for this requirement is that each machine's
configuration files contain references to other machines in the deployment.
You must also run the tool on client machines where certain software
is installed.
See Client Software Components That Require Changes to Host Name References. Otherwise, it is not necessary to
run the tool on client machines.
In each execution of
the tool, you must enter the complete list of host name changes for
the deployment.
Note: You can automate running
the SAS Deployment Manager when you need to perform the same configuration
action on multiple machines in your deployment. The SAS Deployment
Manager uses the same record and playback mechanism as the SAS Deployment
Wizard to perform a non-interactive, silent configuration.
For more information, see Automating the SAS Installation on Multiple Machines in SAS Intelligence Platform: Installation and Configuration Guide.
After running the Update
Host Name References tool, you might still need to manually change
some host name references. For example, the tool does not update host
names in configuration files for Web application servers. These and
other manual steps are specified in the generated report and in
Step 7: Complete the Required Manual Steps.
Before using the Update
Host Name References tool, be sure to review all of the documentation
in this appendix and complete all of the specified prerequisite tasks.
CAUTION:
The Update
Host Name References tool is not supported by certain SAS products
and solutions. Refer to SAS Installation Note 39344 to determine whether
your installed products and solutions are supported.