--is required by the migration utility when running on UNIX and z/OS. These are two hyphens (--) without any space between them.
Default: None
Required: Yes (for UNIX and z/OS only) Equivalent Property: Not applicable -analyze
specifies that the migration utility performs only the first of its two execution phases:
analyze. In the analyze phase, the migration utility locates the current SAS content required for migration, performs a validation to ensure the content can be reliably migrated, and saves the required information for the migration utility package phase.
During the analyze phase, the migration utility generates a migration analysis report that you can use to inventory and enumerate those SAS products found on your current SAS system to be eligible for automatic migration with the SAS Deployment Wizard.
Default: None Required: No
Equivalent Property: Not applicable
When not specified, the migration utility performs both of its two phases, analyze and package. In the package phase, the migration utility uses information saved by the analyze phase to search the system and copy current SAS content into a migration package.
-localhost fully-qualified-host-name
explicitly sets the machine host name on which the migration utility is running.
Use ‑localhost for machines that have multiple network interfaces or a dynamic name. fully-qualified-host-name should be a fully qualified host name for the machine. For example: ‑localhost myserver.example.com
Default: None Required: No
smu Command Syntax Description 137
Equivalent Property: SMU.localhost -properties pathname
specifies the absolute path and file name to a file that contains inputs for the migration utility in the form of properties. For example: ‑properties "C:\SAS Software Depot\utilities\smu\smu.properties".
For more information, see “Running the Migration Utility Using a Properties File”.
Enclose any paths containing spaces in double quotation marks.
Default: None Required: No
Equivalent Property: Not applicable -sasconfigdir path
specifies the path to the current SAS configuration directory.
Enclose any paths containing spaces in double quotation marks.
Examples:
"C:\SAS 9.4\Config\Lev1"
/opt/sas/config/Lev1 Default: None
Required: Yes
Equivalent Property: SMU.config.dir -sasexedir path
specifies the current SAS path to the SAS executable (on Windows) or the top level SAS installation directory on (UNIX). If you are running the migration utility on a machine that does not contain the SAS executable or script, use ‑sasproductdir instead.
Enclose any paths containing spaces in double quotation marks.
Examples:
"C:\Program Files\SASHome\SASFoundation\9.4"
/opt/sas/SASHome/SASFoundation/9.4 Default: None
Required: No, when ‑sasproductdir is used Equivalent Property: SMU.SASROOT
-sasproductdir path
specifies the pathname to the top-level directory where the current SAS products are installed.
Enclose any paths containing spaces in double quotation marks.
Examples:
"C:\Program Files\SASHome"
/opt/sas/SASHome Default: None
Required: No, when ‑sasexedir is used Equivalent Property: SMU.SASHOME
-profile filename
specifies the absolute pathname of a valid current SAS client connection profile that contains connection parameters containing unrestricted user credentials for the current SAS Metadata Server of the SAS deployment to be migrated. (A SAS client connection profile is used by clients such as SAS Management Console, SAS Information Map Studio, SAS Data Integration Studio, and SAS OLAP Cube Studio.)
Unless you specify an absolute path to the profile, the migration utility checks the machine's default SAS client connection profile directory.
By default, SAS stores connection profiles here:
• Windows:
C:\Documents and Settings\user-ID\Workspaces
• UNIX and z/OS:
$HOME/Workspaces
Enclose any paths containing spaces in double quotation marks.
Default: SAS connection profile directory (see earlier paths) Required: No (See “smu Command Notes”.)
Equivalent Property: SMU.profile
“Running the Migration Utility Using a Properties File”
-metadatahost host-name
specifies the name of the machine on which the current SAS Metadata Server resides. host-name is either a fully qualified host name or an IP address for the metadata server machine.
Default: None
Required: No (See “smu Command Notes”.) Equivalent Property: SMU.host.metadata
See “Running the Migration Utility Using a Properties File”
-metadataport port
specifies the port the migration utility uses to connect to the SAS Metadata Server. If no port is specified, the migration utility uses 8561 by default.
Default: 8561 Required: No
Equivalent Property: SMU.port.metadata -user <domain\>userID -password password
specifies the user ID and password for sasadm or another unrestricted user ID on the current SAS Metadata Server. The migration utility accepts passwords that are encoded using PROC PWENCODE.
CAUTION:
We recommend that you encode any passwords used in a migration utility properties file. The migration utility supports the {sas002} method through PROC PWENCODE. For more information, see “PWENCODE Procedure” in Base SAS Procedures Guide.
smu Command Syntax Description 139
(Specify the unrestricted user ID in the manner in which you would when you normally run SAS. For example, if SAS has stored the user ID as domain-qualified, and you specify it with the migration utility as unqualified, the connection fails.) Default: None
Required: No (See “smu Command Notes”.) Equivalent Properties: SMU.user, SMU.password
See “Running the Migration Utility Using a Properties File”
-outputdir path -replace
specifies the absolute path to the parent output directory where the migration utility should write its output. If the directory does not exist, the migration utility creates it for you.
If the specified directory already exists and contains information from a previous migration utility invocation, the migration utility returns an error, unless you specify the -REPLACE option.
The migration utility writes the migration analysis report to SMU.Output.Dir/
tier/AnalysisReport.
Enclose any paths containing spaces in double quotation marks.
Default: None Required: Yes
Equivalent Property: SMU.Output.Dir -tier name -replace
specifies a name for the subdirectory (under the parent directory) where the migration utility writes its migration analysis report and the migration package. In addition, the migration utility appends an at sign (@) and the fully qualified host name to the specified tier name directory (for example,
This is required when you have two tiers on the same machine (for example, the SAS server tier and middle tier).
If the specified directory already exists and contains information from a previous migration utility invocation, the migration utility returns an error, unless you specify the -REPLACE option.
If you omit ‑tier, the migration utility creates a directory using the fully qualified host name.
Enclose any paths containing spaces in double quotation marks.
Default: fully qualified host name
Required: No (except when two tiers are on the same machine) Equivalent Property: Not applicable
-help
displays the list of migration utility options and a brief description for each.
Default: None Required: No
Equivalent Property: Not applicable
“Running the Migration Utility Using a Properties File”