Softek TDMF for UNIX
TDM-U30QC-001
Version 3.0
This quick reference card is NOT intended for first–time installation purposes. Softek highly recommends that new users read
all Softek TDMF manuals for complete details on installation procedures, requirements, usage, and functionality.
NOTE: Softek TDMF migrations can be performed through
the Softek Common Console. For more information
on useing the Softek Common Console, refer to the
Softek Common Console 2.5 User Guide for Softek
TDMF 3.0 (SCC-W25UG).
Installing Softek TDMF
AIX
1. Login as root.
2. Mount the Softek TDMF Media CD, and mount the
CD-ROM as follows:
mount -rv cdrfs /dev/cd0 /cdrom
3. Type the following commands to install Softek TDMF:
a.mkdir /var/opt/SFTKtdmf/
b.installp -a -V 4 -e /var/opt/SFTKtdmf/
tdmfinstall.log -d /cdrom/Softek/TDMF/
AIX/<OS>/
SFTKtdmf_aix_<Version>_<REL>__<Build>.bf
f tdmf
Where <OS> is the AIX version, <Version> is the AIX
version you want to install in X.X.X.X format, <REL> is
the release name in X.X.X.X format, and <Build> is
the build number.
4. Add /usr/SFTKtdmf/bin/ to the PATH environment
variable, to access Softek TDMF commands.
HP-UX
1. Login as root.
2. Load and mount the Softek TDMF Media CD. If you
do not know the name of the CD-ROM device, issue
the following command:
ioscan -funC disk | pg
This displays a list of CD-ROM devices. Look for the
relevant device and mount it:
mount -F cdfs -o ro /dev/dsk/c2t1d0 /cdrom
3. Use one of the following to install Softek TDMF:
a. For HP-UX 11.00
swinstall -s /cdrom/Softek/TDMF/HPUX/11/
SFTKtdmf_hpux_B.11.00_<REL>_<Build>.depot
SFTKtdmf
b. For HP-UX 11.11
swinstall -s /cdrom/Softek/TDMF/HPUX/11i/
SFTKtdmf_hpux_B.11.11__<REL>__<Build>.depo
t SFTKtdmf
c. For HP-UX PA-RISC 11.23
swinstall -s /cdrom/Softek/TDMF/HPUX/
1123pa/
SFTKtdmf_hpux_B.11.23_<REL>_<Build>.depot
SFTKtdmf
d. For HP-UX 11.23 Itanium
swinstall -s /cdrom/Softek/TDMF/HPUX/
1123ipf/
SFTKtdmf_hpux_B.11.23_<REL>_<Build>.depot
SFTKtdmf
Quick Reference Card
Where:
H <REL> is the release name in X.X.X.X format.
H <Build> is the build number.
The output regarding the install status is displayed.
Included in this output is a listing of a job used to
display information about the kernel rebuild.
4. Run the swjob command listed in the output from
swinstall.
For example: swjob -a log hp-0092 @hp:/
This outputs the log generated during install (by the
swinstall command); the log provides status
information about the kernel rebuild and driver load.
NOTE: On HP-UX 11.11, this information can be found in
the swagent.log file located in /var/adm/sw/.
Solaris
1. Login as root.
2. Load and mount the Softek TDMF CD-ROM. If the /
usr/sbin/vold process is running, the CD is
automatically mounted.
3. Type the following command:
pkgadd -d /cdrom/Softek/TDMF/solaris/
<Version>/
SFTKtdmf_solaris_<Version>_<REL>_<Build>.p
kg SFTKtdmf
<Version> is the Solaris version you want to install,
<REL> is the release name in X.X.X.X format, and
<Build> is the build number.
4. Add opt/SFTKtdmf/bin to the PATH environment
variable.
Licensing
Adding
D Type the following command to enter the license key:
tdmf license [-s <license_string>]
where -s is the flag to set the license and
<license_string> is the license key obtained from
Softek.where -s is the flag to set the license and
<license_string> is the license key obtained from
Softek.
Querying
D Type the following command to query the state of a
current license:
tdmf licensing Up for Migration
Creating Migration Volumes
1. Decide on grouping of volumes to be migrated.
2. Decide on naming standard for migration volumes.
3. Create the migration volumes using tdmf create:
tdmf create [-n] [-g <group_tag>]
<migration_volume> <source_volume_path>
[<target_volume_path> …]
Where:
H -n: Sets Start on System Boot to False.
H -g <group_tag>: Assigns the migration volume
to the specified group; the group is created if it
does not already exist.
H <migration_volume>: is the Softek TDMF virtual
device that defines the relationship between
source and target volume(s).
H <source_volume_path> is the source volume
that will be assigned to the migration volume.
H <target_volume_path> is one or more target
volumes eligible to be the target device for the
migration.
Changing the Mount Points
D Unmount all filesystems on the affected source
volumes.
Automatically
D Type the following command:
migmodfs -m|-s [-dp] -a|-g
<group_tag>|<migration_volume name> ...
Where:
H -m: Change mount points from original source
volumes to migration volumes.
H -s: Change mount points from migration volumes
back to source volumes.
H -d: Delete all backup copies of /etc/
filesystems on AIX, /etc/fstab on HP-UX,
and /etc/vfstab on Solaris
H -p: Make changes without asking for verification.
H -a: Change entries for all defined migration
volumes.
H -g: Change entries for migration volumes with
specified <group_tag>.
H <migration_volume>: is the Softek TDMF virtual
device that defines the relationship between
source and target volume(s).
Manually
In some circumstances, it may be preferable to change
the mount point table manually and should be edited
according to the appropriate file system specifications.
D On AIX, the mount point table is located under
/etc/filesystems
D On HP-UX, the mount point table is located under /
etc/fstab
D On Solaris, the mount point table is located under
/etc/vfstab
Once you have updated the mount point table, you must
unmount the file system off the source volumes and re-
mount them on the newly created migration volumes
using the mount command.
Adding Target Volumes
Each migration volume can have one or more targets,
but no two migration volumes can have the same target
volume. Adding a target will overwrite all data that
currently exists on the target volume. The target volume
must be un-mounted and must contain no usable data.
A maximum of eight target volumes may be added to
any migration volume.
1. Type the following command:
tdmf add <migration_volume>
<target_volume> [<target_volume> …]
Where:
H<migration_volume>: is the Softek TDMF virtual
device that defines the relationship between
source and target volume(s).
H <target_volume_path> is one or more target
volumes eligible to be the target device for the
migration.
2. Repeat for all migration volumes.
Managing the Migration Environment
Deleting Migration Volumes
1. Unmount the file system associated with the
migration volume that you want to delete by issuing
the following command:
Umount <mount_path>
where <mount_path> is the path to the mount point
migration volume.
2. Update the mount point table (/etc/filesystems
on AIX, /etc/fstab on HP-UX, and /etc/vfstab
on Solaris)
3. Type the following command to delete the migration
volume:
tdmf delete <migration_volume>
where <migration_volume> indicates the migration
volume to be removed.
4. Remount the file system on the source or target
volume by issuing following command:
mount <mount_path>
where <mount_path> is the path to the source or
target volume.
Removing Target Volumes
D Type the following command to remove one or more
target volumes from a migration volume:
tdmf remove -a | -g <group_tag> |
<migration_volume> [<target_volume_path>
[<target_volume_path> ...]]
NOTE: If either the -a or -g <group_tag> options, or a
migration volume name is specified with no target
volume path, the first target volume for each
migration volume included will be removed.
Managing Migration Groups
The tdmf group command can be used to transfer an
existing migration volume from one migration group to
another; add an existing migration volume to a migration
group; or remove a migration volume from a migration
group.
D Type the following command:
tdmf group <group_tag> [-r] [-a]]
<migration_volume> [<migration_volume>
...]
Using Softek TDMF
Starting a Copy
D Type the following command:
tdmf copy [-f] [-x] [-s <100th's_secs>]
[-b <blocksizeKB>] [-t<num_of_threads>] -a
| -g <group_tag> | <migration_volume_name>
[<migration_volume_name]...]
Where:
H -f: Forces a copy to start at the beginning for all
target volumes.
H -x: Performs an automatic switchover upon
completion of the copy operations, redesignating
the first target volumes as the new source volumes
for each migration volume.
H -s: Throttles the copy operation by ensuring that a
minimum amount of time elapses between each
copy I/O to each target volume (the default is 10
(100th's of a second)).
H -b: Sets the size of the buffer for each copy
operation (the default is 256 KB).
H -t: Sets the number of concurrent threads
performing the copy operation in parallel for the
migration volumes indicated (the default is 4).
NOTE: To resume a terminated copy operation, issue the
tdmf copy command without the -f option.
Stopping a Copy
D The tdmf copy command can be terminated at any
time with either of the following UNIX commands:
$ kill %<job_number> or $ kill <process_id>
where <job_number> is the job number and
<process_id> the process id.
Resuming a Copy
D To restart the copy operation with a reduced sleep
value, enter the following command without the
–f option:
$ tdmf copy –s 0 migvol1 &
This will restart copy operation from the point it was
‘killed’ but with no sleep value.
Switching I/O to the Migrated Devices
1. Make the tdmf copy operation has completed and
the state of the target volume is UPTODATE.
2. Type the following command to switch primary
I/O from the source volume to the target volume
without any impact to running applications:
tdmf switchover -a | -g <group_tag> |
<migration_volume_name>
[<new_source_volume_path>]
[<migration_volume_name>
[<new_source_volume_path>] ...]
3. Check that the SOURCE and UPTODATE volumes have
switched:
tdmf status -l -a
Status Monitoring
D Progress of the copy can be monitored by using the
tdmf status command:
tdmf status [-l] -a | -g <group_tag> |
<migration_volume_name>
[<migration_volume_name> ...]
Target Volume States
D SCRATCH: A target volume that is not in a usable state.
A copy operation has not completed, or has never
been started.
D COPYING: A target volume that has been the subject of
a tdmf copy command which is not yet complete. It is
also receiving mirrored writes by applications to the
migration volume.
D UPTODATE: A target volume that has been the subject
of a successful tdmf copy command. It is part of an
active migration configuration and is being written to
synchronously with the source volume. It is being
maintained as an up-to-date copy of the source
volume.
D MIXED: Applies to a migration volume with multiple
target volumes which are not in the same state.
Examine the state of each individual target to
determine what action to take. For example MIXED
will be shown if some of the target volumes for a
migration volume are in SCRATCH state and some are
in COPYING state. The -l option will show the
details of each target volume.
Softek TDMF Commands and
Switches
tdmf add
tdmf add <migration_volume_name>
<target_volume_path>
[<target_volume_path> ...]
where:
D <migration_volume_name>: indicates one or more
migration volumes.
<target_volume_path> is one or more target
D
volumes.
tdmf agent
tdmf agent [launch |kill]
tdmf agent set [-l|-d][-e
<Collector_IP>[:<Collector_Port>] [-i
<Agent_IP>]
[-t <Transmit_Interval>]
where:
D launch: Starts the Softek TDMF UNIX agent.
D kill: Stops the Softek TDMF UNIX agent.
D -l: Displays the current Softek TDMF UNIX agent
parameters.
D -d: Unconfigures the Softek TDMF UNIX agent so it
will not run on reboot.
D -e <Collector_IP>[:<Collector_Port>]:
Specifies the IP address of the Data Collector and
Database.
D -i <Agent_IP>: Specifies the IP address of the tdmf create
Softek TDMF UNIX agent. This is used by the Data
Collector and Database when there are multiple IP tdmf create [-n] [-g <group_tag>]
addresses on the machine where the Softek TDMF <migration-volume_name>
UNIX is installed. <source_volume_path>
[<target_volume_path>
D -t <Transmit_Interval>: The time interval in [<target_volume_path> ...]]
minutes that the Softek TDMF UNIX agent waits
before transmitting status information back to the where:
Data Collector and Database.
D -n is for setting Start on System Boot to false. The

tdmf copy default value is set to true.

tdmf copy [-f] [-x] [-n
<num_concurrent_migvols>][-s
<100th's_secs>] [-o skipblock
<block_count>][-o mount][-o size] [-b
<blocksizeKB>] [-t <num_of_threads>] -a |
-g <group_tag> | <migration_volume_name>
[<migration_volume_name]...]
where:
D -f : Forces a copy to start at the beginning for all
target volumes.
D -x : Performs an automatic switchover upon
completion of the copy operations, re-designating
the first target volumes as the new source volumes
for each migration volume.
D -g <group_tag>: assigns the migration volume to
the specified group <group_tag>,
D <migration_volume> indicates the volume to be
added and <target_volume>.
D <source_volume_path> is the source volume.
D <target_volume_path> is one or more target
volumes.
tdmf dbdump
tdmf dbdump [<filename>]
where:
D <filename>: name of the file to print the contents of
the migration volume database.

D -s : Throttles the copy operation by ensuring that a tdmf delete

minimum amount of time elapses between each
copy I/O to each target volume (the default is 10
(100th's of a second)).
D -o skipblock <block_count>: This override flag
is used to skip the first <block_count> number of
blocks. The range <block_count> can be set is
between 1 and 2048. This flag is primarily used on
Solaris with devices that do not support the reading
tdmf delete -a | -g <group_tag> |
<migration_volume_name>
[<migration_volume_name> ...]
where:
H -a: Deletes all migration volumes for the system.
H -g <group_tag>: Deletes all migration volumes

of block zero. belonging to the group, one or more individual

migration volumes names.
D -o mount: This override flag overrides the restriction
H <migration_volume_name>: Indicates one or
that prevents copying migration volumes that have
mounted targets. more migration volumes.
D -o size: This override flag overrides the restriction tdmf group
that prevents copying migration volumes that have a
larger source volume than a target volume. tdmf group <group_tag> [-r] [-a]]
D -b: Sets the size (in kilobytes) of the buffer for each <migration_volume_name>
copy operation (the default is 256 KBytes). [<migration_volume_name> ...]
D -n <num_concurrent_migvols>: Sets the number where:
of concurrent copy threads running for each
migration volume. The default number is one and H <group_tag> is the name of the new or existing
the maximum number is 4. group.
D -t: Sets the number of concurrent threads H -r: Removes the migration volume(s) from the
performing the copy operation in parallel for the group.
migration volumes indicated (the default is 4). H -a: Removes all migration volumes from the
D -a: to indicate all migration volumes defined for the group.
system. H <migration_volume> indicates the migration
D -g <group_tag>: to indicate all migration volumes volume to be moved or removed.
in a specific group.
D <migration_volume_name>: indicates one or more
tdmf help
migration volumes. tdmf help
tdmf init
tdmf init -b | -a | -g <group_tag> |
<migration_volume_name>
[<migration_volume_name> ...]
where:
H -b: Option used when the system is first booted.
CAUTION: This option should not be used without first
consulting Softek Technical Support.
H -a: Deletes all migration volumes for the host
system.
H -g <group_tag>: Deletes all or specific
migration volumes belonging to the group.
tdmf license
tdmf license [-s <license_string>]
tdmf list
tdmf list <location> [[-A][-B][-D][-F]
[-G][-O][-R][-S]] [<include_string>]
where:
H <location> is either a directory path or
+ALLVMGROUPS, +VMGROUP
<include_string>, +ALLVMVOLUMES,
+ALLMIGGROUPS, +MIGGROUP
<include_string>, +ALLMIGVOLUMES
H - A returns any file type.
H - B returns block volume device paths.
H - D returns directories.
H - F Returns file pathname.
H - G returns group names or paths.
H - O returns other special file types (for example,
pipes).
H - R returns raw special character volume device
paths
H - S returns symbolic link paths.
H <include_string> restricts the output of the list
to files that contain this optional string in their
name or path.
tdmf modfs
migmodfs -m|-s [-dp] -a|-g
<group_tag>|<migration_volume name> ...
where:
H -m: Change mount points from original source
volumes to migration volumes.
H -s: Change mount points from migration volumes
back to source volumes.
H -d: Delete all backup copies of /etc/
filesystems on AIX, /etc/fstab on HP-UX,
and /etc/vfstab on Solaris.
H -p: Make changes without asking for verification.
H -a: Change entries for all defined migration
volumes.
H -g: Change entries for migration volumes with
specified <group_tag>.
tdmf remove
tdmf remove -a | -g <group_tag> |
<migration_volume_name>
[<target_volume_path>
[<target_volume_path> ...]]
where:
H -a: Deletes the first (added) target volume for all
migration volumes on the host system.
H -g <group_tag>: Deletes the first (added) target
volume for all or specific migration volumes within
the specified group <group_tag>.
H <migration_volume> indicates the volume to be
removed>.
H <target_volume_path> is one or more target
volumes.
tdmf status
tdmf status [-l] -a | -g <group_tag> |
<migration_volume_name>
[<migration_volume_name> ...]
where:
H -l: Reports status information for each source
and target volume associated with the specified
migration volume(s).
H -a: Reports status information for all migration
volumes defined for the host system.
H -g <group_tag>: Reports status for all or
specific migration volumes associated with the
specified group.
tdmf switchover
tdmf switchover -a | -g <group_tag> |
<migration_volume_name>
[<new_source_volume_path>]
[<migration_volume_name>
[<new_source_volume_path>] ...]
where:
H -a: Redesignates the first (added) target volume
for all migration volumes on the host system, as
the specified source.
H -g <group_tag>: Redesignates the first
(added) target volume for all or specific migration
volumes on the host system, as the specified
source.
tdmfdebugcapture
tdmfdebugcapture
tdmfdebugcapture produces a compressed tar file,
in the /tmp directory, using the format:
<SystemName>.<Date>-<time>.tar.Z
where:
H <SystemName> is the name of the system ,
H <Date>: The date tdmfdebugcapture ran in the
format Year Month Day.
H <time>: The time at which tdmfdebugcapture ran.

tdmf vary
tdmf vary autostart on|off -a | -g
<group_tag> | <migration_volume_name>
[<migration_volume_name> ...]
tdmf vary migration on|off -a | -g
<group_tag> | <migration_volume_name>
[<migration_volume_name> ...]
where:
H -a: Modifies all migration volumes for the host
system.
H -g <group_tag>: Modifies all or specific
migration volumes belonging to the group.
tdmf version
tdmf version
Uninstalling Softek TDMF
CAUTION: All migration devices must be deleted before
Softek TDMF can be removed from the system.
AIX
1. Login as root.
2. Ensure that all migrations are completed and have
stopped.
3. Type tdmf del -a to delete all migration volumes.
4. Type the following command to remove Softek TDMF
from the server: installp -u tdmf.rte
NOTE: License key information and existing configurations
will remain on the server. To completely remove the
product, delete the directory /etc/opt/SFTKmig.
4. Type the following command to remove Softek TDMF
from the server:
swremove SFTKtdmf
NOTE: License key information and existing configurations
will remain on the server. To completely remove
Softek TDMF, delete the directory /etc/opt/
SFTKtdmf.
The swremove SFTKtdmf command rebuilds the
kernel to remove the Softek TDMF driver; as a
result, you will need to reboot the system for the
new kernel to take effect.
Solaris
NOTE:
1. Login as root.
2. Ensure that all migrations are completed and have
stopped.
3. Type tdmf del -a to delete all migration volumes.
4. Type pkgrm SFTKtdmf to remove Softek TDMF and
to display the installation status of Softek TDMF.
5. Type y to remove the package.
6. Type y to remove Softek TDMF from the server.
NOTE: License key information and existing configurations
will remain on the server. To completely remove
Softek TDMF, delete the directory /etc/opt/
SFTKtdmf.

HP-UX
NOTE:
1. Login as root.
2. Ensure that all migrations are completed and have
stopped.
3. Type tdmf del -a to delete all migration volumes.

Softek TDMF Online Documentation

NOTE: Softek TDMF documentation is available on the Media CD, and on our Web site at:
http://www.softek.com/en/support/tdmf/unix
D Softek TDMF 3.0 Administration and User Guide for AIX, HP-UX, and Solaris (TDM-U30AU)
D Softek TDMF 3.0 Release Notes for AIX, HP-UX, and Solaris (TDM-U30RN)
D Softek Common Console 2.5 User Guide for Softek TDMF 3.0 (SCC-W25UG)

Ordering Hardcopy Documentation

http://www.softek.com/en/support/docorder/
© 2006 Softek Storage Solutions Corporation. All rights reserved. Technical Support
All specifications are subject to change without notice. Printed in U.S.A.
Part Number: TDM-U30QC-001 http://www.softek.com/en/support/