Disassociating

Use the ngunmanage tool to remove a correspondence between files and storage endpoints, delete all Ngenea-specific extended attributes from files if they do not have remote location extended attributes, and change the status of files without Ngenea-specific extended attributes from PREMIGRATED to NORMAL (online).

ngunmanage

Synopsis

ngunmanage [-r] NAME1 ... NAMEn

ngunmanage [-r] [--filelist-format=NUL|quoted] -f FILELIST

where NAMEi is a file or directory name if the option -r is specified or a file name if that option is not specified.

Common options for all use cases:

[-vLEVEL] [--storage-key=PATTERN]
[--lock-level=partial|implicit]
[ --log-target=syslog | --log-format=json ]

Description

Removes a correspondence between files and storage endpoints.

Options

-f FILELIST     process files and directories from a filelist file.
--filelist-format=LF|NUL|quoted
                format of a filelist file:
                "LF"     - filenames delimited by newlines; a filename cannot
                           contain newline characters;
                "NUL"    - filenames delimited by the NUL (0) byte;
                "quoted" - filenames possibly enclosed in single or double
                           quotes and delimited by newlines.
                Default: "LF".
                Compatible with the option: -f FILELIST
--help          display this help and exit.
--lock-level=partial|implicit
                DMAPI locking level:
                "partial"  - explicitly request a DMAPI shared access right
                             for the duration of analyzing file state and
                             explicitly request exclusive DMAPI access right
                             when updating file xattrs or changing file status;
                "implicit" - instruct DMAPI to self-manage access rights when
                             analyzing file state and also self-manage DMAPI
                             access rights when updating file xattrs or
                             changing file status.
                Default: "partial".
--log-format=json
                log messages in JSON format.
                Conflicts with the option: --log-target=syslog
--log-target=syslog
                redirect all logging to the syslog.
                Conflicts with the option: --log-format=json
-r              if program arguments specify directory names, process files in
                the directories recursively.
                Default: skip processing directories.
--storage-key=PATTERN
                remove a correspondence between files and storage endpoints
                only with keys matching a specified extended glob pattern (it
                can consist of multiple glob patterns separated by `|').
                Default: remove a correspondence between files and storage
                         endpoints with all keys.
-v, --verbose[=LEVEL]
                verbosity level:
                0 = error and warning messages (also used when this option
                    is absent);
                1 = print the names of successfully processed files (default);
                2 = debug messages, excluding those related to file locking;
                3 = enable core dump and debug messages related to file locking;
                    print PID and current time with microsecond precision.
-V, --version   display version information and exit.

Examples

Remove all Ngenea-specific extended attributes from the files file1.txt and path/to/file2.txt and change their status to NORMAL (online) if they had the PREMIGRATED status:

ngunmanage file1.txt path/to/file2.txt

Remove remote location extended attributes for storage keys matching the pattern 0[12] or lc from the file file.txt; if the file turns to have no other remote location extended attributes, remove all other Ngenea-specific extended attributes from the file and change its status from PREMIGRATED to NORMAL (online):

ngunmanage --storage-key='0[12]|lc' file.txt

Process files in the directory path/to/dir recursively:

ngunmanage -r path/to/dir

See Also

ngmigrate, ngrecall