Update spec file for 0.06 release
[blkdevalias.git] / README
1 blkdevalias is a tool to manage persistent storage device aliases and permissions
2
3 The blkdevalias stuff is currently organised like this:
4
5 /sbin/blkdevalias:
6 Main script. Manages adding/removing/displaying mappings and maintains a
7 persistent table used to direct the udev rules.
8
9 /etc/blkdevalias/map:
10 The persistent mapping table; currently just "<WWID> <ALIAS> <TYPE>".
11
12 /etc/blkdevalias/conf:
13 Configuration of user/group, symlink/node directory etc.
14
15 /etc/udev/rules.d/99-blkdevalias.rules:
16 Rules to manage naming and permissions based on the persistent
17 configuration stored in the table.
18
19 Feedback and testing very much welcome.
20
21 [root@rhel6-vm1 ~]# blkdevalias
22 Usage: /sbin/blkdevalias
23 {configure|createdisk|deletedisk|scandisks|querydisk|map}
24 [root@rhel6-vm1 ~]# blkdevalias configure
25 Configuring the udev wwid map.
26
27 This will configure persistent mappings and permissions for storage
28 devices. The current values will be shown in brackets ('[]'). Hitting
29 <ENTER> without typing an answer will keep the current value. Ctrl-C
30 will abort.
31
32 Default user to own device nodes [oracle]:
33 Default group to own device nodes [oracle]:
34 Default device directory [oracleasm/disks]:
35 Writing wwid map configuration: done
36
37 [root@rhel6-vm1 ~]# blkdevalias listdisks
38 [root@rhel6-vm1 ~]# blkdevalias createdisk DSK1 /dev/sda
39 [root@rhel6-vm1 ~]# blkdevalias createdisk DSK2 /dev/sdb
40 [root@rhel6-vm1 ~]# blkdevalias createdisk DSK3 /dev/sdc
41 [root@rhel6-vm1 ~]# blkdevalias createdisk DSK4 /dev/sdd
42 [root@rhel6-vm1 ~]# blkdevalias listdisks
43 DSK1
44 DSK2
45 DSK3
46 DSK4
47 [root@rhel6-vm1 ~]# blkdevalias querydisk DSK1
48 DSK1 is a valid blkdevalias disk
49 [root@rhel6-vm1 ~]# blkdevalias querydisk -d DSK4
50 DSK4 is a valid blkdevalias diskon device [8, 31]
51 [root@rhel6-vm1 ~]#
52 [root@rhel6-vm1 ~]# blkdevalias deletedisk DSK4
53 Removing wwid map disk "DSK4":                                  [  OK  ]
54 [root@rhel6-vm1 ~]# blkdevalias listdisks
55 DSK1
56 DSK2
57 DSK3
58 [root@rhel6-vm1 ~]# ls -l /dev/oracleasm/disks/
59 total 0
60 lrwxrwxrwx. 1 root root 10 Oct 30 11:01 DSK1 -> ../../sda1
61 lrwxrwxrwx. 1 root root 10 Oct 30 11:01 DSK2 -> ../../sdb1
62 lrwxrwxrwx. 1 root root 10 Oct 30 11:01 DSK3 -> ../../sdc1
63 lrwxrwxrwx. 1 root root 10 Oct 30 11:01 DSK4 -> ../../sdd1
64 [root@rhel6-vm1 ~]# ls -lL /dev/oracleasm/disks/
65 total 0
66 brw-rw----. 1 root oracle 8,  1 Oct 30 11:01 DSK1
67 brw-rw----. 1 root oracle 8, 17 Oct 30 11:01 DSK2
68 brw-rw----. 1 root oracle 8, 33 Oct 30 11:01 DSK3
69 brw-rw----. 1 root oracle 8, 49 Oct 30 11:01 DSK4
70