smu Command Syntax Description

-s -a
is required by smu when running on Windows only. The later versions of the migration utility (smu92* and smu93*) do not require the -s and -a options to run.
Default: None
Required: Yes (for smu.exe only)
Equivalent Property: Not applicable
- -
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 smu.zos only)
Equivalent Property: Not applicable
-analyze
specifies that the migration utility only perform 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 also 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.
-davtier
(SAS 9.1.3 only) specifies that the migration utility should include any local WebDAV content it locates. -davtier should be specified only when running the migration utility on the WebDAV tier. If -davtier is not specified, the migration utility ignores any local WebDAV content it locates.
Default: None
Required: No
Equivalent Property: SMU.isdavtier
-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. host-name should be a fully qualified host name for the machine. For example: -localhost myserver.example.com
Default: None
Required: No
Equivalent Property: SMU.localhost
-properties pathname
specifies the absolute path and filename to a file that contains inputs for the migration utility in the form of Java-like 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.
The default SAS 9.1.3 configuration directory used by the SAS 9.1.3 Configuration Wizard is as follows:
  • Windows:
    C:\SAS\configuration-directory\Lev1
  • UNIX:
    /users/sas/SAS/configuration-name/Lev1
Enclose any paths containing spaces in double quotation marks.
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.
The default SAS 9.1.3 directory for used by the SAS 9.1.3 Configuration Wizard is as follows:
  • Windows:
    C:\Program Files\SAS\SAS 9.1
  • UNIX:
    /usr/local/SAS/SAS_9.1
Enclose any paths containing spaces in double quotation marks.
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.
The default SAS 9.1.3 top-level product directory used by the SAS 9.1.3 Configuration Wizard is as follows:
  • Windows:
    C:\Program Files\SAS
  • UNIX:
    /usr/local/SAS
Enclose any paths containing spaces in double quotation marks.
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 encrypted using PROC PWENCODE.
(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 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, middle_tier@myhost.example.com).
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
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
Copyright © SAS Institute Inc. All rights reserved.