Resources for Intelligence Platform Migration

Quick Links

Analysis Report Messages


Connect Server

SAS/CONNECT® servers enable clients to execute code on a remote host, or to move data between client and server machines.

For any updates or hot fixes that are required before you can migrate, see the baseline requirements topic.


caution Conflict over port number found between server-name-1 and server-name-2.
You can ignore this message if server-name-1 and server-name-2 are the same server (for example, Connection: Connect Server and Connection: Connect Server). Contact SAS Technical Support if the two servers are different.

caution failed to migrate. A connect spawner must be associated with this connect server in the metadata. Note: The metadata of this connect server will migrate with the metadata repository.
When you define a SAS/CONNECT server in SAS Management Console, you can choose whether to use a spawner, script, or SASCMD method to connect to the server:
  • If you want to use a spawner to connect to the SAS/CONNECT server in the target SAS deployment, then in the previous deployment, define a spawner that is associated with this SAS/CONNECT server.
  • If you want to define the SAS/CONNECT server using a SASCMD or Script signon, then you can ignore this warning message.

When you use the SAS Deployment Wizard in the target SAS deployment, the configration of the SAS/CONNECT server requires the associated Connect spawner information. Without an associated spawner, the configuration will fail. Therefore, when a spawner is not associated with a SAS/CONNECT server, the SAS Migration Utility assumes you will use a SASCMD or Script signon, and omits the SAS/CONNECT server from the migration package to avoid a configuration failure.

caution For connect server migration, the hot fix E9BC13 needs to be applied on Windows machines that will run both a 9.1 SAS/CONNECT spawner and a 9.2 or later SAS/CONNECT spawner. The hot fix must be applied before running the SAS Deployment Wizard to deploy the 9.2 or later environment.
If your deployment is on Windows and you plan to run both a SAS 9.1 and a SAS 9.2 or later spawner on the same machine, then apply hot fix E9BC13 for Base SAS to the SAS 9.1.3 environment before you run the SAS Deployment Wizard to deploy the target SAS environment.

This warning message always appears in the analysis report, even if you have already applied the hot fix. The SAS Migration Utility cannot determine whether the hot fix has been applied.

caution Conflicting port values found for servers A and B. Please correct the port values before continuing with migration.
Correct the port values in the previous deployment's metadata (for example, with SAS Management Console) for the two SAS/CONNECT server definitions before you create a migration package with the SAS Migration Utility. If you do not correct the conflicting port values in the previous deployment's metadata, the configuration in the SAS Deployment Wizard will fail.

caution The server name contains characters not compatible with SAS 9.2. Please remove the incompatible characters from server name before migration.
For SAS/CONNECT, SAS/SHARE, and Operating System Services in migrations to early releases of SAS 9.2, some users can see this message even though no action is needed. The SAS Deployment Wizard corrects the name automatically for this server. You can disregard this error for the SAS/CONNECT, SAS/SHARE, and Operating System Services.

Be aware that you might need to correct the names of other servers before you migrate. The naming convention in the SAS Management Console has changed. In SAS 9.2 and later, the forward slash and backslash are not supported in server names. Other unsupported characters in server names include control characters (e.g., tabs, newlines) and leading or trailing blanks. The name must not be greater than 60 characters, and must be specified (non-null).

ok The SASCMD value is not specified with the connect server, it is required that this value be defined to successfully validate the connect server. You might need to manually define the SASCMD value; otherwise, a default value will be added during migration.
In the previous deployment's SAS Management Console, add the SASCMD value to the SAS/CONNECT server's ServerComponent's property field. This SASCMD value is required in order to validate the SAS/CONNECT server successfully in the target SAS deployment. The validation is a new feature in SAS 9.2 and later of the Server Manager plug-in in SAS Management Console. If the value is not specified in the the previous deployment, then validation is not performed, and a default SASCMD value is added to the target SAS deployment. The default value depends on the deployment.

Contributing to Migration

The migration team appreciates your feedback. Send e-mail to with questions and comments for our developers, testers, and writers.