smu Command Syntax Description : SAS Help Center

--

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 .

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

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 path name 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 path name of a valid current SAS client that contains connection parameters containing unrestricted user credentials for the current of the SAS deployment to be migrated. (A SAS client connection profile is used by clients such as , 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

You should 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.

(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, middle_tier@myhost.example.com).

This is required when you have two tiers on the same machine (for example, the SAS server tier and ).

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