Follow these notes when running the SAS Software Migration
Utility:
-
The SAS Migration Utility command
line has a 254-character limit. Command line input that exceeds this
length causes the utility to fail. If your input exceeds 254 characters,
use a migration utility properties file. For more information, see
Running the Migration Utility Using a Properties File.
-
The current SAS Metadata Server
must be running when you invoke the migration utility.
-
On SAS multiple-machine deployments,
run the migration utility
first on
the machine hosting the SAS Metadata Server.
-
You must run the migration utility
from its executable directory.
By default, this is
the utilities directory in your SAS Software Depot.
Note:
On
UNIX and
z/OS, if you have not already, remember to assign file Execute
permissions to smu.sh before attempting to run the migration utility.
For more information, refer to your UNIX or
z/OS documentation.
-
The migration utility must be run
on every machine that is running SAS using the same output directory
(
SMU.Output.Dir
).
For SAS multiple-machine
deployments, we recommend that you install the utility on shared network
storage that is accessible from every SAS machine to avoid having
to install the migration utility separately on each machine.
-
On SAS multiple-machine deployments,
the migration utility must be able to write to (and read from) its
output directory.
We recommend that the
utility output directory be on shared network storage accessible to
every SAS machine in the deployment.
-
When specifying the metadata server
to connect to, it is a best practice to use a fully qualified host
name or an IP address. Do not refer to the metadata server as
localhost
or
its IP equivalent (127.0.0.1), unless
all of
the machines in your SAS deployment are able to connect to the server
using that host name.
-
On the migration utility command
line, enclose any paths containing spaces in double quotation marks.
(Paths containing spaces in properties files do
not require
double quotation marks.)
Note: A backslash immediately followed
by a double quotation marks (\") is not allowed in the migration utility
command line. Avoid ending Windows paths with a trailing backslash
on the command line. (This limitation does not apply to migration
utility property files.)
-
Metadata server connection information
must be provided to the migration utility through one of the following
methods:
-
the connection-related command-line
options (
-metadatahost
,
-user
,
and so on.)
Note: The migration utility accepts
passwords that are encrypted using PROC PWENCODE.
-
a migration utility properties
file.
-
a SAS client connection profile.
(The client connection
profile must be created and saved on the machine on which you are
running the migration utility.)
-
The machine on which you run the
migration utility must have a Java Runtime Environment (JRE) 1.4.2
Update 9 (or later).
-
On UNIX, modify the PATH environment
variable such that the directory containing the Java binary is the
first JRE found. Verify your setting by executing from the UNIX shell
prompt:
which java
-
It is recommended that you use
the
-replace
command-line option when
invoking the migration utility. This ensures that output from any
previous migration utility invocations that specified the same output
directory and tier directory is overwritten.
-
When migrating from SAS 9.1.3,
to create a migration package on the WebDAV tier, use
-davtier
or
SMU.isdavtier
.
There are certain WebDAV
properties for which there are no command-line equivalents: the
SMU.DAV.*
properties
use standard WebDAV extraction and
SMU.WFS.XythosHome
causes
the migration utility to extract WebDAV content using a Xythos-specific
mechanism that is more efficient. For more information, see
Running the Migration Utility Using a Properties File.