Initializing a DCE LFS Aggregate aggregates

Caution: Do not use the newaggr command to initialize a non-LFS partition, especially if it contains data you want to retain, unless you want to convert the partition to a DCE LFS aggregate; the command destroys all data on the specified partition. Also, do not use the command on a locally mounted partition; doing so causes the kernel to panic. Finally, do not use the command on a partition or aggregate that is currently exported to the DCE namespace or on an aggregate that houses a locally mounted fileset; the command fails in these cases.

To initialize a DCE LFS aggregate, do the following:

1. Log in as root on the machine on which the new aggregate is to be initialized.

2. Issue the newaggr command to initialize the aggregate. (See Part 2 of this guide and reference for more detailed information about the newaggr command.)

# newaggr -aggregate name -blocksize bytes -fragsize bytes [-initialempty blocks]
[-aggrsize blocks] [-logsize blocks] [-overwrite] [-verbose] [-noaction]

The -aggregate name option is the device name or aggregate name of the disk partition to be initialized as a DCE LFS aggregate. These identifiers are specified in the first and second fields of the entry for the aggregate in the dcelocal/var/dfs/dfstab file.

The -blocksize bytes option is the number of bytes to be available in each DCE LFS block on the aggregate. Allowable values are the powers of 2 from 1024 to 65,536.

The -fragsize bytes option is the number of bytes to be available in each DCE LFS fragment on the aggregate. Allowable values are the powers of 2 from 1024 to the number of bytes specified with the -blocksize option.

The -initialempty blocks option is the number of DCE LFS blocks to be left empty at the beginning of the partition when the aggregate is initialized. Allowable values are from 0 (zero) to 65,536 divided by the number of bytes specified with the -blocksize option; for example, if 65,536 is specified with the -blocksize option, the -initialempty option can be 0 or 1. If this option is omitted, one block is left empty.

The -aggrsize blocks option is the total number of DCE LFS blocks that are to be available on the aggregate. Because this value cannot exceed the size of the partition, it can be used only to restrict the size of the aggregate. It must be large enough to accommodate at least the log and any blocks left empty at the beginning of the partition. If this option is omitted, the size of the partition being initialized is used.

The -logsize blocks option is the number of DCE LFS blocks to be reserved for the log on the aggregate. This value cannot exceed the number of DCE LFS blocks used for the -aggrsize option, and it must specify at least enough blocks for the log to be initially created. If this option is omitted, 1% of the total number of DCE LFS blocks on the aggregate (-aggrsize) is used.

The -overwrite option specifies that an existing file system found on the partition can be overwritten. If this option is omitted and a file system is found on the partition, the command informs you that a file system already exists. It then terminates with an exit code of at least 16 without overwriting the existing file system.

The -noaction option directs the command to display information about what it would do without actually modifying the partition. Include the other options as you would to actually execute the command. The command displays the default values it would use for its options and informs you if the partition already contains a file system.