Configuring the virtual log repository

You can configure a virtual log repository by using the chvlrepo command. You can display the properties of the virtual log repositories by using the lsvlrepo command.

To configure or display the properties of a virtual log repository, use the following commands, as applicable:

To display the current properties of virtual log repositories, enter the lsvlrepo command. Entering the lsvlrepo -detail command returns results similar to the following:

Local Repository:
State:                   enabled
Repository Root:         /var/vio/vlogs
Maximum Log Files:       10
Maximum Log File Size:   2097152
Maximum State Files:     10
Maximum State File Size: 1048576

To display this information in a custom format, use the -field flag. Specify a string with field names, separated by characters that are not alphanumeric, to display a customized output. The output contains one line for every virtual log repository. For example, entering the lsvlrepo -field "state-path lf" command returns results similar to one of the following:
- ```
enabled-/tmp/vlogs/ 10
```
- ```
disabled-/var/vio/SSP/cTA1/D_E_F_A_U_L_T_061310/vlogs/ 3
```
See lsvlrepo command for a list of all field names.
To change the directory in which virtual logs are stored, enter the chvlrepo command. The virtual log repository directory cannot be changed if any virtual logs exist in the repository. To change the directory, enter the following command:
```
chvlrepo -path /mnt/logs
```
You can change properties, such as the default number and size of log files, by using other options of the chvlrepo command. See chvlrepo command for a list of all the options. For example, entering the following command changes the default values for virtual logs that are created in the local virtual log repository to have four log files, each up to 3 MB in size, and two state files, each up to 100 KB in size:
```
chvlrepo -lf 4 -lfs 3M -sf 2 -sfs 100K
```
Changing these default values does not change the configuration of existing virtual logs.
You can also use the chvlrepo command to disable the repository to stop the creation of virtual logs. A virtual log repository cannot be disabled if there are any virtual logs in the repository. For example, entering the following command disables the repository:
```
chvlrepo -state disabled
```

Last updated: Thu, October 15, 2020