Previous Page | Next Page

SAS Migration Utility Reference

smu Command Syntax Description

-s -a

is required by the migration utility when running on Windows only.

Default: None
Required: Yes
Equivalent property: not applicable
- -

is required by the migration utility when running on UNIX or z/OS only. These are two dashes (- -) without any space between them.

Default: None
Required: Yes
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 SAS 9.1.3 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 SAS 9.1.3 system to be eligible for automatic migration with the SAS Deployment Wizard.

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 SAS 9.1.3 content into a migration package.

Default: None
Required: No
Equivalent property: not applicable
-davtier

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 Run 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 SAS 9.1.3 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 SAS 9.1.3 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 path name to the top-level directory where SAS 9.1.3 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 path name of a valid SAS 9.1.3 client connection profile that contains connection parameters containing unrestricted user credentials for the SAS 9.1.3 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
-metadatahost host-name

specifies the name of the machine on which the SAS 9.1.3 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
-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 SAS 9.1.3 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 9.1.3. 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
-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.

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

Previous Page | Next Page | Top of Page