You can export all or part of the server control information
and client file data from a server to sequential media so that this
information can be imported to another server.
Privilege class
To issue this command, you
must have system privilege.
Syntax
.-FILEData--=--None-------------.
>>-EXPort Server--+-------------------------------+------------->
'-FILEData--=--+-ALl----------+-'
+-None---------+
+-ARchive------+
+-Backup-------+
+-BACKUPActive-+
+-ALLActive----+
'-SPacemanaged-'
.-Preview--=--No--------------.
>--+-----------------------------+------------------------------>
| (1) (2) |
'-Preview----------=--+-No--+-'
'-Yes-'
>--+------------------------------------+----------------------->
| (1) |
'-DEVclass------=--device_class_name-'
.-Scratch--=--Yes---------.
>--+-------------------------+---------------------------------->
| (2) |
'-Scratch------=--+-Yes-+-'
'-No--'
>--+------------------------------------------+----------------->
| .-,-----------. |
| (2) V | |
'-VOLumenames------=--+---volume_name-+--+-'
'-FILE:--file_name-'
>--+------------------------------+----------------------------->
'-USEDVolumelist--=--file_name-'
>--+----------------------------------------------+------------->
| .-FROMTime--=--00:00:00-. |
'-FROMDate--=--date--+-----------------------+-'
'-FROMTime--=--time-----'
>--+------------------------------------------+----------------->
| .-TOTime--=--23:59:59-. |
'-TODate--=--date--+---------------------+-'
'-TOTime--=--time-----'
.-ENCryptionstrength--=--AES-----.
>--+--------------------------------+--------------------------->
'-ENCryptionstrength--=--+-AES-+-'
'-DES-'
.-ALLOWSHREDdable--=--No------.
>--+-----------------------------+-----------------------------><
'-ALLOWSHREDdable--=--+-No--+-'
'-Yes-'
Notes:
- If PREVIEW=NO, a device class must be specified.
- If PREVIEW=NO and SCRATCH=NO, one or more volumes
must be specified.
Parameters
- FILEData
- Specifies the type of files that are exported for all nodes that
are defined to the server. This parameter is optional. The default
value is NONE.
If you are exporting to sequential media, the device
class to access the file data is determined by the device class for
the storage pool. If it is the same device class that is specified
in this command, two drives are needed to export server information.
The mount limit for the device class must be set to at least 2.
The following descriptions mention
active and
inactive backup
file versions. An active backup file version is the most recent backup
version for a file that still exists on the client workstation. All
other backup file versions are called inactive copies. The following
values are available:
- ALl
- Tivoli® Storage
Manager exports
all backup versions of files, all archived files, and all files that
were migrated by a Tivoli Storage
Manager for Space Management client.
- None
- Tivoli Storage
Manager does
not export files, only definitions.
- ARchive
- Tivoli Storage
Manager exports
only archived files.
- Backup
- Tivoli Storage
Manager exports
only backup versions, whether the versions are active or inactive.
- BACKUPActive
- Tivoli Storage
Manager exports
only active backup versions.
- ALLActive
- Tivoli Storage
Manager exports
all active backup versions of files, all archived files, and all files
that were migrated by a Tivoli Storage
Manager for Space Management client.
- SPacemanaged
- Tivoli Storage
Manager exports
only files that were migrated by a Tivoli Storage
Manager for Space Management client.
- Preview
- Specifies whether you want to preview the results of the export
operation, without exporting information. You can use this parameter
to preview how many bytes of data are transferred so that you can
determine how many volumes are required. This parameter supports the
following values:
- No
- Specifies that the server information is to be exported. If you
specify this value, you must also specify a device class.
- Yes
- Specifies that the operation is previewed but not completed. Information
is reported to the server console and the activity log. If you specify
this value, you do not need to specify a device class.
This parameter is optional. The default value is
NO.
- DEVclass
- Specifies the device class to which export data is to be written.
This parameter is required if you specify PREVIEW=NO.
You cannot
specify the DISK, NAS, or CENTERA device classes.
If all drives for the
device class are busy when the export runs, Tivoli Storage
Manager cancels
lower priority operations to make a drive available.
Tip: You
can export data to a storage pool on another server by specifying
a device class whose device type is SERVER.
- Scratch
- Specifies whether scratch volumes can be used. The default value
is YES. Possible values are:
- Yes
- Specifies that scratch volumes can be used for export. If you
also specify a list of volumes, scratch volumes are used only if there
is not enough space on the volumes specified.
- No
- Specifies that scratch volumes cannot be used for export. To determine
how many volumes you might need, you can run the command specifying
PREVIEW=YES.
- VOLumenames
- Specifies the volumes to be used to contain exported data. This
parameter is optional, unless you specify SCRATCH=NO and PREVIEW=NO.
If you do not specify a volume name, scratch volumes are used.
Possible
values are:
- volume_name
- Specifies the volume name. To specify multiple volumes, separate
the names with commas and no intervening spaces.
- FILE:file_name
- Specifies the name of a file that contains a list of volumes.
In the file, each volume name must be on a separate line. Blank and
comment lines that begin with an asterisk are ignored.
Use these naming conventions when specifying
volumes associated with the following device types:
- USEDVolumelist
- Specifies the file where a list of volumes used in the export
operation are stored. This parameter is optional.
This file can
be used in the import operation. This file contains comment lines
with the date and time the export was done, and the command issued
to create the export.
Attention: If you specify an
existing file, the file is overwritten.
- FROMDate
- Specifies the earliest date for which files to be exported were
stored on the server. Files that were stored on the server earlier
than the specified date are not exported. This parameter only applies
to client file data. This parameter does not affect other information
that might be exported, for example, policy. Tivoli Storage
Manager ignores
the FROMDATE parameter when the FILEDATA parameter is set to NONE.
Directory processing: The FROMDATE parameter
does not apply to directories. All directories in a file space are
processed even if the directories were not backed up in the specified
date range.
Important: If you have group data on
the node that you are exporting, data that was backed up before the
designated FROMDATE and FROMTIME can also be exported. Group data
on the node is, for example, virtual machine data or system state
backup data. This export is a result of incremental backup processing
for the data. The incremental backup processing can cause extra files
that do not meet the filtering criteria to be exported, so that there
is a consistent image for the backup data.
Use one of the
following values to specify the date:
Value |
Description |
Example |
MM/DD/YYYY |
A specific date |
09/15/1998 |
TODAY |
The current date |
TODAY |
TODAY-days or -days |
The current date minus days specified.
The maximum number of days you can specify is 9999. |
TODAY –3 or –3. |
EOLM (End Of Last Month) |
The last day of the previous month. |
EOLM |
EOLM-days |
The last day of the previous month
minus days specified. |
EOLM-1 To include files that
were active a day before the last day of the previous month.
|
BOTM (Beginning Of This Month) |
The first day of the current month. |
BOTM |
BOTM+days |
The first day of the current month,
plus days specified. |
BOTM+9 To include files that
were active on the 10th day of the current month.
|
If this parameter is not specified, Tivoli Storage
Manager exports
all objects stored before the TODATE parameter and as qualified by
the FILEDATA parameter. If no TODATE parameter is specified, then
all data as qualified by the FILEDATA parameter is exported.
When
a server-to-server export operation uses a relative FROMDATE, for
example, TODAY-1, and the operation is restarted at a later date,
the restarted process still uses the date that was used during the
original operation. For example, if a server-to-server export operation
is started on 07/04/2009 and the FROMDATE is specified as TODAY-1,
the date that is used for selecting files is 07/03/2009. If this same
export operation is suspended and restarted ten days later (07/14/2009),
the date that is used for selecting files is still 07/03/2009. This
behavior ensures that the entire export operation uses the same cutoff
date for selecting files to export.
- TODate
- Specifies the latest date for files to be exported from the server.
Files stored on the server on a date later than the TODATE value are
not exported. TODATE only applies to client file data and does not
affect other information that is being exported, such as policy.
- Tivoli Storage
Manager ignores
the TODATE parameter when the FILEDATA parameter is set to NONE.
- If a TODATE parameter is specified without a TOTIME parameter,
the server exports all objects inserted on or before the day specified
by the TODATE parameter.
- If you specified the FROMDATE parameter, the value of TODATE must
be later than or equal to the FROMDATE value. If the TODATE and FROMDATE
are equal, then the TOTIME parameter must be later that the FROMTIME
parameter.
- The TODATE parameter does not apply to directories. All directories
in a file space are processed even if the directories were not backed
up in the specified date range.
Use one of the following values to specify the date: Value |
Description |
Example |
MM/DD/YYYY |
A specific date |
10/15/2006 |
TODAY |
The current date |
TODAY |
TODAY-days or -days |
The current date minus days specified.
The maximum number of days you can specify is 9999. |
TODAY –3 or –3. |
EOLM (End Of Last Month) |
The last day of the previous month. |
EOLM |
EOLM-days |
The last day of the previous month
minus days specified. |
EOLM-1 To include files that
were active a day before the last day of the previous month.
|
BOTM (Beginning Of This Month) |
The first day of the current month. |
BOTM |
BOTM+days |
The first day of the current month,
plus days specified. |
BOTM+9 To include files that
were active on the 10th day of the current month.
|
When a server-to-server export operation uses a relative
TODATE, for example, TODAY-1, and the operation is restarted at a
later date, the restarted process still uses the date that was used
during the original operation. For example, if a server-to-server
export operation is started on 07/04/2009 and the TODATE is specified
as TODAY-1, the date that is used for selecting files is 07/03/2009.
If this same export operation is suspended and restarted ten days
later (07/14/2009), the date that is used for selecting files is still
07/03/2009. This behavior ensures that the entire export operation
uses the same cutoff date for selecting files to export.
- FROMTime
- Specifies the earliest time for which objects to be exported were
stored on the server. When you specify FROMTIME, you must also use
the FROMDATE parameter. This parameter only applies to client file
data. This parameter does not affect other information that might
be exported, for example, policy. Objects that were stored on the
server before the specified time and date are not exported. Tivoli Storage
Manager ignores
the FROMTIME parameter when the FILEDATA parameter is set to NONE.
Important: If you have group data on the node that you are exporting,
data that was backed up before the designated FROMDATE and FROMTIME
can also be exported. An example of group data on the node is virtual
machine data or system state backup data, This export is a result
of incremental backup processing for the data. The incremental backup
processing can cause extra files that do not meet the filtering criteria
to be exported so that there is a consistent image for the backup
data.
The default value for this parameter when used with
the FROMDATE parameter is midnight (00:00:00).
Use one of the
following values to specify the time:
Value |
Description |
Example |
HH:MM:SS |
A specific time |
10:30:08 |
NOW |
The current time |
NOW |
NOW+HH:MM or +HH:MM |
The current time plus hours and minutes
specified. The FROMTIME+ can only be used with a FROMDATE before today. |
NOW+02:00 or +02:00. If
you issue this command at 5:00 with FROMTIME=NOW+02:00 or FROMTIME=+02:00,
the export operation only contains files that were put on the server
after 7:00 on the FROMDATE that you specify.
|
NOW-HH:MM or -HH:MM |
The current time minus hours and
minutes specified |
NOW–02:00 or –02:00. If
you issue this command at 5:00 with FROMTIME=NOW–02:00 or FROMTIME=–2:00,
the export includes files that were put on the server after 3:00.
|
- TOTime
- Specifies the latest time that objects to be exported were stored
on the server. You must specify the TODATE parameter in order to use
the TOTIME parameter. TOTIME only applies to client file data and
does not affect other information that is being exported, such as
policy. Tivoli Storage
Manager ignores
the TOTIME parameter if the FILEDATA parameter is set to NONE.
The
default value for this parameter, when used with the TODATE parameter,
is midnight minus one second (23:59:59).
Important: The
value of the TOTIME and TODATE parameters must be later than the FROMDATE
and the FROMTIME value.
Use one of the following values to
specify the time:
Value |
Description |
Example |
HH:MM:SS |
A specific time |
10:30:08 |
NOW+HH:MM or+HH:MM |
The current time plus hours and minutes
specified. |
NOW+02:00 or +02:00. If
you issue this command at 05:00 with FROMTIME=01:00 and TOTIME=NOW+02:00,
the export includes files that were stored from 01:00 until 07:00.
|
NOW-HH:MM or-HH:MM |
The current time minus hours and
minutes specified. |
NOW-02:00 or -02:00. If
you issue this command at 05:00 with FROMTIME=01:00 and TOTIME=NOW-02:00,
the export includes files that were stored from 01:00 until 03:00.
|
- ENCryptionstrength
- Indicates which algorithm to use to encrypt passwords when exporting
administrative and node records. This parameter is optional. The default
value is AES. If you are exporting to a server that does not support
AES, specify DES. Possible values are:
- AES
- Specifies the Advanced Encryption Standard.
- DES
- Specifies the Data Encryption Standard.
- ALLOWSHREDdable
- Specifies whether data from a storage pool that enforces shredding
is exported. This parameter is optional. The default value is NO.
Possible values are:
- No
- Specifies that data is not exported from a storage pool that enforces
shredding.
- Yes
- Specifies that data can be exported from a storage pool that enforces
shredding. The data on the export media is not shredded.
Example: Export a server to specific tape volumes
From
the server, export server information to tape volumes TAPE01, TAPE02,
and TAPE03. Specify that these tape volumes be read by a device that
is assigned to the MENU1 device class.
export server devclass=menu1
volumenames=tape01,tape02,tape03