Chapter 3. IBM System Migration Assistant 241
/o logdir Provide the full path and the name of the log file directory. This
parameter is optional.
/t tmpdir Provide the full path and the name of the temporary SMA directory.
This parameter is optional.
/p smapwd Provide the password that will be used to password protect the profile
during capture or that is required to access the profile during migration. This
parameter is optional.
/s tsmpwd Provide a TSM password. This parameter is optional. This is an
advanced featured described in Migration with Tivoli® Storage Manager.
/jdu userid and /jdp pwd Provide a user name and password to enable access
to the domain. The user must have at least account operator privileges in the
domain. These parameters are required only during the apply phase when you
migrate the domain setting. When used, both parameters must be provided. You
must also create a new computer account prior to applying the profile.
/v Enables verbose logging in the SMA log files. This can be helpful to resolve
migration problems.
The command file guides the execution of the command, especially during
capture. The next sections describe the role of the command file in detail.
3.5.1 System Migration Assistant capture phase in batch mode
During the capture phase, SMABAT.EXE reads the contents of the command file
and creates a profile file. An example of a capture command is:
SMABAT /c C:\MyCommandFileDir\TheCommandFile.txt
As the example shows, the command file completely drives the capture process.
SMA provides a default command file, <drive>:\Program
Files\IBM\SMA\commandfile.txt, which you can use as a template to create your
own version.
The remainder of the section explains the various commands in the command
file. SMA will process these commands in the exact order in which they appear in
Note: Edit the command file with care. A semicolon should precede all
comments in the file. SMA does not treat the text in this file in a case sensitive
fashion. If the command file has syntax errors, error messages will be written
to standard output but processing continues. However, depending on the
nature of the error, the actual results might differ significantly from the
intended behavior.
242 Using ThinkVantage Technologies: Volume 1 Creating and Deploying Client Systems
the file. In the command file, each command is described in a separate section
clearly marked with a beginning and end, namely [<command>_start] and
[<command>_end]. One or more parameters and their values can be entered
between these markers, with each parameter-value pair placed on a separate
line.
Example:
[transfer_mode_start]
transfer_mode = selective
[transfer_mode_end]
The same settings can be migrated in batch mode as through the user interface.
File migration is functionally equivalent in both modes, but the batch mode has a
unique method of selecting files and folders, involving inclusion and exclusion on
the basis of various characteristics. These procedures are described last.
The commands, with the exception of those driving file migration, are:
򐂰 Password To specify a password, provide a value for plain_password. The
maximum password length is 16 characters and the minimum is 4 characters.
If a password is provided on the command line, the value in the file will be
ignored.
The functionality of the parameter encoded_password is beyond the scope of
the documentation.
򐂰 Transfer_Mode This has two possible values, for example, selective or
mass. You must specify one of these values. Remember that selective refers
to the standard migration.
򐂰 Profile_Path_and_Name The full path and the name of the profile file. For
example:
[profile_path_and_name_start]
output_profile = C:\sma_profiles\newprofile.SMA
[profile_path_and_name_end]
The value entered here will be ignored when you specify a profile name on
the command line.
򐂰 TSM This is an advanced feature for use with Tivoli Storage Manager
򐂰 Desktop To select a desktop setting, type 1, otherwise type 0 or leave
unspecified. The following desktop settings can be set:
accessibility
active_desktop
colors
desktop_icons
–display
icon_font

Get Using ThinkVantage Technologies, Volume 1: Creating and Deploying Client Systems now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.