chvlrepo command

Purpose

Modifies the configuration of a virtual log repository.

Syntax

To change the configuration of the local virtual log repository:

chvlrepo [-lf FileCount] [-lfs FileSize] [-sf FileCount] [-sfs FileSize] [-state RepositoryState] [-root Path]

To change the configuration of a virtual log repository in a shared storage pool:

chvlrepo {-sp StoragePool} [-lf FileCount] [-lfs FileSize] [-sf FileCount] [-sfs FileSize] [-state RepositoryState]

Description

The chvlrepo command changes the configuration of virtual log repositories, including the default property values for new virtual logs created with the mkvlog command. Changing the default properties does not affect the properties of existing virtual logs.

By default, the local virtual log repository is changed, but a repository in a shared storage pool can be specified instead by using the -sp parameter.

The state property of a virtual log cannot be changed if virtual logs exist in the repository.

The -root parameter can be used only to change the repository root directory for the local virtual log repository, and only if no virtual logs exist in the repository. If the virtual log root directory is changed, any log data in the old location is preserved, but new virtual logs write data to the new location.

Flags

Flag name	Description
-lf	Sets the default maximum number of log files, in the range 1 - 1000.
-lfs	Sets the default maximum size of each log file, in bytes, or suffixed with K, M, or G.
-s, -state	Sets the state of the repository to disabled or enabled. Virtual logs can be created only in a repository that is in the enabled state.
-sf	Sets the default maximum number of state files, in the range 1 - 1000.
-sfs	Sets the default maximum size of each state file, in bytes, or suffixed with K, M, or G.
-sp	Specifies the name of the shared storage pool to use. If not specified, the local repository is changed.
-root	Sets the root directory for the virtual log repository. All log data is stored here.

Exit Status

Table 1. Command specific return codes
Return code	Description
0	All files were written successfully.
>0	An error occurred.

Examples

To set the default log file size for new virtual logs in the local virtual log repository to 2 MB, type the command as follows:
```
chvlrepo -lfs 2M
```
The system displays the output as follows:
```
Updated repository.
```
To set the default log file size for new virtual logs in the virtual log repository in the shared storage pool sspool1 to 2 MB, type the command as follows:
```
chvlrepo -sp sspool1 -lfs 2M
```
The system displays the output as follows:
```
Updated repository.
```
To set the root directory for the local virtual log repository, type the command as follows:
```
chvlrepo -root /mnt/logs/
```
The system displays the output as follows:
```
Updated repository.
```
To attempt to set the root directory for the virtual log repository in the shared storage pool sspool1, type the following command:
```
chvlrepo -sp sspoo1 -root /mnt/logs
```
The system displays the following output:
```
The root directory of a shared storage pool cannot be changed.
```

Related Information

The chvlog command, the lsvlog command, the lsvlrepo command, the mkvlog command, and the rmvlog command.

Last updated: Wed, November 18, 2020