summaryrefslogtreecommitdiffstats
path: root/done/GlusterFS 3.5/gfid access.md
blob: db640769e41efb1b83a8a71a464f0f79db6fa979 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
### Instructions

**Feature**

'gfid-access' translator to provide access to data in glusterfs using a virtual path.

**1 Summary**

This particular Translator is designed to provide direct access to files in glusterfs using its gfid.'GFID' is glusterfs's inode numbers for a file to identify it uniquely.

**2 Owners**

Amar Tumballi <atumball@redhat.com>  
Raghavendra G <rgowdapp@redhat.com>  
Anand Avati <aavati@redhat.com>

**3 Current status**

With glusterfs-3.4.0, glusterfs provides only path based access.A feature is added in 'fuse' layer in the current master branch,
but its desirable to have it as a separate translator for long time
maintenance.

**4 Detailed Description**

With this method, we can consume the data in changelog translator
(which is logging 'gfid' internally) very efficiently.

**5 Benefit to GlusterFS**

Provides a way to access files quickly with direct gfid.

​**6. Scope**

6.1. Nature of proposed change

* A new translator.
* Fixes in 'glusterfsd.c' to add this translator automatically based
on mount time option.
* change to mount.glusterfs to parse this new option 
(single digit number or lines changed)

6.2. Implications on manageability

* No CLI required.  
* mount.glusterfs script gets a new option.

6.3. Implications on presentation layer

* A new virtual access path is made available. But all access protocols work seemlessly, as the complexities are handled internally.

6.4. Implications on persistence layer

* None

6.5. Implications on 'GlusterFS' backend

* None

6.6. Modification to GlusterFS metadata

* None

6.7. Implications on 'glusterd'

* None

7 How To Test

* Mount glusterfs client with '-o aux-gfid-mount' and access files using '/mount/point/.gfid/ <actual-canonical-gfid-of-the-file>'.

8 User Experience

* A new virtual path available for users.

9 Dependencies

* None

10 Documentation

This wiki.

11 Status

Patch sent upstream. More review comments required. (http://review.gluster.org/5497)

12 Comments and Discussion

Please do give comments :-)