volume: Document multipath configuration
Add some lines about how to enable multipath for block storage. A new README was added, because multipath is relevant for at least FC and iSCSI. Signed-off-by: Fabian Deutsch <fabiand@fedoraproject.org>
This commit is contained in:
		
							
								
								
									
										27
									
								
								pkg/volume/README.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										27
									
								
								pkg/volume/README.md
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,27 @@
 | 
			
		||||
## Multipath
 | 
			
		||||
 | 
			
		||||
To leverage multiple paths for block storage, it is important to perform the
 | 
			
		||||
multipath configuration on the host.
 | 
			
		||||
If your distribution does not provide `/etc/multipath.conf`, then you can
 | 
			
		||||
either use the following minimalistic one:
 | 
			
		||||
 | 
			
		||||
    defaults {
 | 
			
		||||
        find_multipaths yes
 | 
			
		||||
        user_friendly_names yes
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
or create a new one by running:
 | 
			
		||||
 | 
			
		||||
    $ mpathconf --enable
 | 
			
		||||
 | 
			
		||||
Finally you'll need to ensure to start or reload and enable multipath:
 | 
			
		||||
 | 
			
		||||
    $ systemctl enable multipathd.service
 | 
			
		||||
    $ systemctl restart multipathd.service
 | 
			
		||||
 | 
			
		||||
**Note:** Any change to `multipath.conf` or enabling multipath can lead to
 | 
			
		||||
inaccessible block devices, because they'll be claimed by multipath and
 | 
			
		||||
exposed as a device in /dev/mapper/*.
 | 
			
		||||
 | 
			
		||||
Some additional informations about multipath can be found in the
 | 
			
		||||
[iSCSI documentation](iscsi/README.md)
 | 
			
		||||
		Reference in New Issue
	
	Block a user