sis on path
sis off path
sis start [-s] [ -f ] path
sis stop path
sis status [ -l ] [ [ path ] ... ]
The Advanced SIS is only available on NearStore platforms. An a_sis license on NearStore platforms is required to enable the feature. See na_license(1) for more details.
The path parameter is the full path of a flexible volume, its format is /vol/vol_name.
The sis subcommands are:
config
Setup, modify, and retrieve the schedule or the options of a SIS volume. Currently, only used to configure schedule.
When the -s option is specified, the command will setup or modify the schedule on the specified path. Otherwise, it will display the schedule of the specified path. If no option and path is specified, the schedule of all the configured SIS volumes will be displayed.
schedule is [day_list][@hour_list]
or [hour_list][@day_list]
or -
or auto
The hour_list specifies which hours of the day SIS operations should run on each scheduled day. The hour_list is a comma-separated list of the integers from 0 to 23. Hour ranges such as 8-17 are allowed. Step values can be used in conjunction with ranges. For example, 0-23/2 means "every two hours". The default hour_list is 0, i.e. midnight on the morning of each scheduled day.
If "-" is specified, there won't be scheduled SIS operation on the volume. When a non-SIS volume is enabled the first time, an initial schedule is assigned to the volume. This initial schedule is sun-sat@0, that means "once everyday at midnight".
The auto schedule string means the SIS operation will be triggered by the amount of new data written to the volume. The criterion is subject to be changed later.
on
Enables SIS on a volume. The specified volume must be an online flexible volume in order to be enabled.
On a regular volume, SIS operations will be started periodically according to a per-volume schedule. On a SnapVault secondary volume, SIS operations will be kicked off at the end of SnapVault transfers.
The schedule can be modified by the config subcommand. Users can also manually start an SIS operation with the start subcommand.
off
Disables SIS on a volume. If an SIS operation is active on the volume, it needs to be stopped by "sis stop" before disabling.
start
Starts an SIS operation. The volume must be enabled and online before starting the SIS operation. If the SIS operation is already active on the volume, this command will fail.
If the -s option is specified, the SIS operation will scan the file system to process all the existing data. With the -s option, SIS operation will prompt for user confirmation before proceeding. Use -f option to suppress the confirmation. In this release, whole volume scanning is supported on all flexible volumes.
stop
Aborts the currently active SIS operation on the volume. SIS will remain enabled and the operation can be started again by the start subcommand, SnapVault transfer, or the scheduler.
status
Reports the status of SIS volumes. If one or more path are specified, the command will only display the status of the specified volumes. The -l option will display detailed status.
The df -s command will show the space savings generated by SIS operations (see na_df(1)).
This command displays the sis status of all volumes. The following example shows the status output in short format:
toaster> sis status Path State Status Progress /vol/dvol_1 Enabled Idle Idle for 10:45:23 /vol/dvol_2 Enabled Pending Idle for 15:23:41 /vol/dvol_3 Disabled Idle Idle for 37:12:34 /vol/dvol_4 Enabled Active 25 GB Scanned /vol/dvol_5 Enabled Active 25 MB Searched /vol/dvol_6 Enabled Active 40 MB (20%) Done /vol/dvol_7 Enabled Active 30 MB Verified /vol/dvol_8 Enabled Active 10% Merged
The dvol_2 is Pending for resource limitation. The SIS operation on the volume will become Active when the resource is available.
The dvol_3 is Idle because the SIS operation is disabled on the volume.
The dvol_4 is Active. The SIS operation is doing the whole volume scanning. So far, it has scanned 25GB of data.
The dvol_5 is Active. The operation is searching for duplicated data, there are 25MB of data already searched.
The dvol_6 is also Active. The operation has saved 40MB of data. This is 20% of the the total duplicate data found in the searching stage.
The dvol_7 is Active. It is verifying the metadata of processed data blocks. This process will remove unused metadata.
The dvol_8 is Active. Verified metadata are being merged. This process will merge together all verified metadata of processed data blocks to an internal format which supports fast sis operation.
The following examples shows the sis status output in long format:
toaster> sis status -l /vol/dvol_6
Path: /vol/dvol_6
State: Enabled
Status: Active
Progress: 41020 KB (20%) Done
Type: Regular
Schedule: sun-sat@0
Last Operation Begin: Thu Mar 24 13:30:00 PST 2005
Last Operation End: Fri Mar 25 00:34:16 PST 2005
Last Operation Size: 4732932 KB
Last Operation Error: -
Changelog Usage: 2%
toaster> sis status -l /vol/dvol_8
Path: /vol/dvol_8
State: Enabled
Status: Active
Progress: 51208 KB Searched
Type: SnapVault
Schedule: -
Last Operation Begin: Thu Mar 23 18:33:00 PST 2005
Last Operation End: Fri Mar 23 20:24:36 PST 2005
Last Operation Size: 5641028 KB
Last Operation Error: -
Changelog Usage: 1%
This command displays the schedule for all SIS enabled volumes. The following example shows the config output:
toaster> sis config Path Schedule /vol/dvol_1 - /vol/dvol_2 23@sun-fri /vol/dvol_3 auto
Sis on the volume dvol_2 is scheduled to run everyday from Sunday to Friday at 11 PM.
Sis on the volume dvol_3 is set to auto schedule.
Copyright © 1994-2008 NetApp, Inc. Legal Information