Using ThinkVantage Technologies, Volume 1: Creating and Deploying Client Systems

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