Dell PowerStore Service Scripts Guide

PDF

Manage an IMT import (svc_nas nas_svc_imt)

This service script enables you to manage an In-band Migration Tool (IMT) import. You can use this script to perform such actions as forcibly clearing failed nodes to allow a stalled IMT import to finish.

Usage

Function	System Operations
Mode	Service
Usage	Service
Requires service user password?	Yes
Requires root privileges?	No
May cause data unavailability?	Yes
May cause data loss?	No
Scope	Node
Prerequisites	None

Format

svc_nas run nas_svc_imt -h <NAS server name> [-i { <import session id> | --all | --failed}] [-n {id |--all}] [-f] [-s] [-r] [-c] [-d] [-l] [-t]

Optional arguments

Qualifier	Description
-h, --help	Show the help message.
-i, --show-imports	Show the ID and state of file system imports for the specified NAS server. The format of the command is as follows: nas_svc_imt `<NAS server name>` [-i \|--show-imports] {--all \| --failed} You can filter the file system imports by including one of the following: `id`: Show the ID of a specific file system import session. `--all`: Show the state of all file system imports. `--failed`: Show only the file system imports that failed. The import state is one of the following: `MIS_EXECUTING`: The import is actively processing nodes. `MIS_PAUSED`: The import is paused by the user or due to a fault. `MIS_WAITING_FOR_RESYNC`: The import is idle but with one or more persistently failed nodes. Use `svc_nas_imt --show-failed-nodes` for more information. `MIS_SYNCING`: The import is idle and has no persistently failed nodes; it is pending completion. `MIS_COMPLETE`: The import has completed successfully. `MIS_CANCELLED`: The import has been canceled. `MIS_FAILED`: The import failed due to an unrecoverable error.
-n, --show-failed-nodes	Show the identity (the `ino`) and path of the persistently failed nodes for the specified file system import. The `ino` is the decimal inode number of a directory or file on the target file system. The format of the command is as follows: nas_svc_imt `<NAS server name>` [-n \| --show-failed-nodes] {`<import session id>` \| --all} You can filter the list of file system imports with failed nodes by including one of the following: `id`: Show the ID of a specific file system import session. `--all`: Show the identity (or `ino`) and path of the persistently failed nodes for all the file system imports for the specified NAS server.
-f, --show-dirty-files	Show the identity (or `ino`) and path of the dirty files for the specified file system import. The format of the command is as follows: nas_svc_imt `<NAS server name>` [-f \| --show-dirty-files] {`<import session id>` \| --all} You can filter the list of file system imports with failed nodes by including one of the following: `id`: Show the ID of a specific file system import session. `--all`: Show the identity and path of the dirty files for all the file system imports for the specified NAS server.
-s, --show-nodes	Show the import details of the specified node or nodes if more than one `--node` option is present. The `ino` is the decimal inode number of a directory or file on the target file system. The format of the command is as follows: nas_svc_imt `<NAS server name>` [-s \| --shownodes] --node `<ino>` The reported node state is one of the following: `MNS_NONE`: The node is not part of the import, or it has not yet been discovered by the import. `MNS_PENDING:` The node has been discovered and is part of the import but it has not yet been processed. `MNS_FAILED`: The node is part of the import but an error was encountered during processing or when attempting to apply a subsequent client modification to the node. `MNS_MOVING`: The node is now being processed. `MNS_MOVED`: The node has been successfully processed. `MNS_STREAM`: The node is a named stream that is part of the import.
-r, --resync-nodes	Trigger a resync of the specified node or nodes if more than one `--node` option is present. The `ino` is the decimal inode number of a directory or file on the target file system. The format of the command is as follows: nas_svc_imt `<NAS server name>` [-r \| --resync-nodes] `<import session id>` --node `<ino>` If the specified nodes do not match their counterpart on the source file system, a task is asynchronously performed to reimport each of the specified nodes.
-c, --clear-failed-nodes	Forcibly clear the error on specified persistently failed node or nodes if more than one `--node` option is present associated with the given file system import. The `ino` is the decimal inode number of a directory or file on the target file system. The format of the command is as follows: nas_svc_imt `<NAS server name>` [-c \| --clear-failed-nodes] `<import session id>` [--yes] --node `<ino>` When an error is forcibly cleared on a node (in other words, a directory or file), the contents might not be the same on the source and target. These differences should be resolved manually after import completion. Confirmation of this action is necessary either through the interactive prompt or by specifying `--yes`.
-d, --drop-failed-nodes	Drop the specified node (or nodes if more than one `--node` option is present) from the given file system import. The `ino` is the decimal inode number of a directory or file on the target file system. The format of the command is as follows: nas_svc_imt `<NAS server name>` [-d \| --drop-failed-nodes] `<import session id>` [--yes] --node `<ino>` The import does not perform processing on a dropped node or not even attempt writes. Differences should be expected and must be resolved manually after import completion. Confirmation of this action is necessary through either the interactive prompt or by specifying `--yes`.
-l, --list-dhsm-conns	Lists the HTTP and HTTPS connections that have been migrated to the destination of the specified file system import. The format of the command is as follows: nas_svc_imt `<NAS server name>` --list-dhsm-conns `<import session id>`
-t, --set-dhsm-conn	Set which HTTP or HTTPS connection should be made the active DHSM connection on the destination of the specified file system import. The `<cid>` is the connection ID. The format of the command is as follows: nas_svc_imt `<NAS server name>` --set-dhsm-conn `<import session id>` --cid `<cid>`