• "read_local_config" : This item is permitted only in the global configuration file. If the item is not present, the component uses only the global configuration file. If the item is present, its value is true  or false , indicating whether the component should read configuration information from the local configuration file. 

If the "read_local_config"  item is present in the global configuration file along with other items, the component checks the "read_local_config"  item value first: 

•If the value is false , the component processes the other items in the global configuration file and ignores the local configuration file. 

•If the value is true , the component ignores the other items in the global configuration file and attempts to read the local configuration file. 

• "path" : The item value is a string that names the file to use for storing keyring data. The file should be named using an absolute path, not a relative path. This item is mandatory in the configuration. If not specified, component_keyring_file  initialization fails. 

• "read_only" : The item value indicates whether the keyring data file is read only. The item value is true  (read only) or false  (read/write). This item is mandatory in the configuration. If not specified, component_keyring_file  initialization fails. 

•The database administrator has the responsibility for creating any configuration files to be used, and for ensuring that their contents are correct. If an error occurs, server startup fails and the administrator must correct any issues indicated by diagnostics in the server error log. 

Given the preceding configuration file properties, to configure component_keyring_file , create a global configuration file named component_keyring_file.cnf  in the directory where the component_keyring_file  library file is installed, and optionally create a local configuration file, also named component_keyring_file.cnf , in the data directory. The following instructions assume that a keyring data file named /usr/local/mysql/keyring/component_keyring_file  is to be used in read/write fashion. 

•To use a global configuration file only, the file contents look like this: 

{ "path": "/usr/local/mysql/keyring/component_keyring_file", "read_only": false } 

Create this file in the directory where the component_keyring_file  library file is installed. 

•Alternatively, to use a global and local configuration file pair, the global file looks like this: 

{ "read_local_config": true } 

Create this file in the directory where the component_keyring_file  library file is installed. 

The local file looks like this: 

{ "path": "/usr/local/mysql/keyring/component_keyring_file", "read_only": false } 

Create this file in the data directory. 

