A.3 DFSTOOL

A.3.1 Managing DFS Operations

dfstool is a command line utility for managing DFS operations. Make sure you are logged in as the root user in the terminal console.

Table A-5 Operations supported by DFSTOOL

Parameters

Description

 
dfstool -c

Create junction.

 
dfstool -d

Delete junction.

 
dfstool -m

Rename the junction name and modify the target path.

 
dfstool -s

List the scan details of the selected volume.

 
dfstool -l

Provide you a list of junctions inside the volume after the scan is completed.

 
dfstool -M

Move an NSS volume to another existing NSS volume.

 
dfstool -S

Split part of a volume’s file structure and data, from a volume to another new or an existing volume in the same DFS management context.

 
dfstool -C

Create DFS Management Context.

 
dfstool -D

Delete DFS Management Context.

 
dfstool -R

Repair the VLDB service for a DFS replica server. Accepts an optional repair level as input.

  • Rebuild: This is the default level. When you rebuild a database, the VLDB service walks the eDirectory tree, looks at volume and server objects, and then completely rebuilds the database from scratch.

  • Lowlevel: This is an additional level. This repair option restores the last saved copy of the database.

  • Refresh: This is an additional level. The VLDB service gets a copy of the database from another server that is currently running the service.

 
dfstool --start-vldb

Start the VLDB service.

 
dfstool --stop-vldb

Stop the VLDB service.

 
dfstool --activate-vldb

Activate the VLDB service.

 
dfstool --deactivate-vldb

Deactivate the VLDB service.

 
dfstool -L

View information about the VLDB service. Accepts an optional information type as input.

  • Basicinfo: This is the default level. Display the basic information about the VLDB service.

  • Statistics: This is an additional level. Display the statistical information about the VLDB service.

  • Repair: This is an additional level. Display information about the currently running repair operation (if any) and the most recently completed repair operation.

  • Complete: This is an additional level. Display a complete report related to the VLDB service.

Table A-6 DFSTOOL Command Options

Options

Description

 
dfstool -A

Check for target path existence for non OES targets by authentication.

NOTE:This option is not available in OES 24.1.

 
dfstool -n

Enter a new name for the junction.

 
dfstool -T

Add a new target type which can be either OES or non-OES. The default option is OES.

 
dfstool -t

Target of a junciton. The format is volumeName[/path/to/directory] for oes targets and serverName/SMBShare/path/to/directory for non-oes targets.

 
dfstool -u

Enter the username. If you do not specify a username, you will be prompted to enter one.

 
dfstool -p

Enter the password. If you do not specify a password, you will be prompted to enter a password.

 
dfstool -H

Does not display the header and the footer when displaying the junctions in the table format.

 
dfstool -i

Ignore the validation of target path existence for non OES targets.

NOTE:This option is not available in OES 24.1.

 
dfstool -j

List of junctions in JSON format.

 
dfstool -P

Enter a VLDB path. The default path is /var/opt/novell/dfs.

 
dfstool -I

Non-interactive and applicable for only for scan and list command.