SAS Migration Utility Reference

Run the Migration Utility Using a Properties File

An alternative to supplying SAS Software Migration Utility invocation options on the command line is to provide these options in the form of a properties file. You do this by creating a file containing values for the various migration utility properties you want to use and saving this file in the same directory where the migration utility batch or script file resides. For information about product-specific properties, see Review Product-Specific SAS Migration Utility Properties.

Note: SAS supplies a migration utility template file (smu.properties.template) that provides examples for how to use various properties. You can find this file in your SAS Software Depot in the smu subdirectory underneath utilities. [cautionend]

When you run the migration utility, you reference your properties file with the -properties command-line option. For example:

smu -s -a -properties "C:\SAS Software Depot\utilities\smu\mid_tier.properties" -replace

The migration utility enables you to use a combination of properties and command-line options. For example:

smu -s -a -analyze -profile myhost 
-properties "C:\SAS Software Depot\utilities\smu\mid_tier.properties" -replace

In migration utility properties files, when specifying Windows paths or domains as a part of a user ID, you must escape any backslashes (\) with another backslash character. For example:

SMU.config.dir=C:\\SAS\\config\\913BIPlatform\\Lev1
SMU.user=mydomain\\sasadm

The migration utility recognizes the pound sign (#) as the comment character, when it is used as the first character in a line.

Below is the listing of a sample migration utility properties file with comments that describe each property:

Note: Migration utility properties are case-sensitive. [cautionend]

# Sample smu.properties file
#
# Specifies the absolute path of the SAS 9.1.3 configuration 
# directory that the migration utility reads from.  This 
# should usually be the "Lev" directory.  It usually contains
# a SASMain, Data, and product directories.
#
SMU.config.dir=C:\\SAS\\MetadataServer\\Lev1
SMU.config.dir=/users/sas/SAS/913BIPlatform/Lev1


# Specifies the path to sas.exe that is used by the SAS 9.1.3
# Metadata Server. Required if SMU.SASHOME is not used.
#
SMU.SASROOT=C:\\Program Files\\SAS\\SAS 9.1
SMU.SASROOT=/usr/local/SAS/SAS_9.1


# Specifies the pathname to the top-level directory where SAS 
# 9.1.3 products are installed.
#
SMU.SASHOME=C:\\Program Files\\SAS
SMU.SASHOME=/usr/local/SAS


# The metadata server host. This must be defined for the 
# migration utility to run successfully.  The port defaults to 
# 8561.  If a different metadata port was used, this must be 
# set to the correct port.
#
SMU.host.metadata=metadata.example.com
#SMU.port.metadata=8561


# The metadata server administrative user and password.  This 
# must be an unrestricted user so all data can be read for 
# metadata extraction.  The password should be encoded using the 
# {sas001} method.  Use proc pwencode to get the encoded password.
#
#
#SMU.user=mydomain\\adminuser
SMU.user=adminuser
SMU.password=


# A workspace profile is acceptable as an alternative to providing 
# the host, port, user and password (if the password is in the 
# profile).  This can be just the profile name, which will look in 
# the default location and the current working directory, or a full
# path to the profile.
#
#SMU.profile=MyServer


# Specifies the absolute path to the directory where migration 
# utility should write its output.  If the directory does not 
# exist, migration utility creates it for you.
#
# SMU.Output.Dir=/home/sas/smu_packages/metadata_tier
SMU.Output.Dir=C:\\SMU_packages\\metadata_tier


# Causes the migration utility to extract any WebDAV content that
# it locates.  Use either the SMU.DAV.* properties or the 
# SMU.WFS.XythosHome property.  If you want to re-use this 
# properties file, we recommend that you not use SMU.isdavtier
# but instead specify -davtier on the smu command line.
#
#SMU.isdavtier=true


# Specifies the absolute path where the Xythos Web File Server 
# is installed.  Specifying this property will cause the WebDAV 
# content to be extracted using a Xythos-specific mechanism that 
# is more efficient than using standard DAV extraction.
#
#SMU.WFS.XythosHome=C:\\Program Files\\SAS\\xythos\\2.2
#SMU.WFS.XythosHome=/usr/local/SAS/xythos/2.2


# The host where the Xythos server is running.  This is
# used to help migrate items in a Xythos DAV server to
# the SAS Content Server.  If this is omitted, the
# migration process will use a best guess as to which
# server represents the Xythos server.
#
#SMU.xythoshost=davnode.example.com


# The port the Xythos server is listening on.  This
# was 8300 in 9.1.3 by default.  If your site used
# a different port, specify it here.  This property
# is used to help migrate items in a Xythos DAV server
# to the SAS Content Server.  If this is omitted, the
# default value of 8300 is assumed.
#
#SMU.xythosport=8301

# If a non-Xythos WebDAV server is being used at a site, (such as 
# Apache HTTP Server) and extraction of the content is desired, 
# these properties will configure that extraction.
#
# A user with sufficient read permission to extract the desired
# content.
#
#SMU.DAV.User=
#SMU.DAV.Password=


# The DAV URL for the root of the WebDAV data.
#
#SMU.DAV.URL=http://davnode.example.com:8300/sasdav


# Explicitly sets the machine host name on which the migration utility 
# is running.  Use for machines that have multiple network interfaces 
# or a dynamic name.  Specify a fully qualified host name for the machine.
#
# SMU.localhost=myserver.example.com


# The Analytics Platform core install directory.  The value provided 
# here is the default installation path.  If your AP was installed to 
# a different location set this value to your path.
#
# If you're migrating Analytics Platform applications, you'll also need 
# to enable their migration by setting SMU.apcore.migration.is_enabled 
# to true.
#
#SMU.apcore.dir=C:\\Program Files\\SAS\\SASAPCore
#SMU.apcore.migration.is_enabled=false


# This property is used by the SDW to verify the version of the migration 
# utility that was used to create a migration package vs. the one in the 
# install package.
#
# DO NOT CHANGE THIS VALUE.
#
SMU.version=1.0

Top of Page