Skip to content

Commit 23a1898

Browse files
author
Ed Coleman
committed
Update create-empty utility usage in Advanced Troubleshooting
- Update empty rfile to keyword executable command format - Update to include creating an empty wal file.
1 parent 4a11d35 commit 23a1898

File tree

1 file changed

+8
-11
lines changed

1 file changed

+8
-11
lines changed

_docs-2/troubleshooting/advanced.md

+8-11
Original file line numberDiff line numberDiff line change
@@ -208,7 +208,7 @@ references to the file in the METADATA table and within the tablet server
208208
hosting the file can be resolved by Accumulo. An empty file can be created using
209209
the CreateEmpty utility:
210210

211-
$ accumulo org.apache.accumulo.core.file.rfile.CreateEmpty /path/to/empty/file/empty.rf
211+
$ accumulo create-empty --type RFILE /path/to/empty/file/empty.rf
212212

213213
The process is to delete the corrupt file and then move the empty file into its
214214
place (The generated empty file can be copied and used multiple times if necessary and does not need
@@ -249,21 +249,18 @@ metadata table!), the following process can be followed to create a valid, empty
249249
WAL file. Run the following commands as the Accumulo unix user (to ensure that
250250
the proper file permissions in HDFS)
251251

252-
```
253-
$ UUID=$(uuidgen); \
254-
echo -n -e '--- Log File Header (v4) ---U+1F47B$'"${UUID}"'\x00\x00\x00\x00' > "${UUID}".wal; \
255-
echo 'created: '"${UUID}"'.wal'
256-
```
252+
The create-empty utility can be used to create an empty wal file.
257253

258-
The above creates a file with the text "--- Log File Header (v4) ---" a unicode character to flag no decryption
259-
parameters, a UUID and then four bytes. The file created will be `[uuid]`.wal and the name is echoed to the command
260-
line. You should verify the contents of the file with a hexdump tool.
254+
255+
$ accumulo create-empty --type WAL [filename]
256+
257+
Note the create-empty utility default type (or specifying `--type RFILE` will create an empty rfile)
261258

262259
Then, place this empty WAL in HDFS and then replace the corrupt WAL file in HDFS with the empty WAL for the
263260
tserver / host pair with the following hdfs commands:
264261

265-
$ hdfs dfs -moveFromLocal [uuid].wal /user/accumulo/[uuid].wal
266-
$ hdfs dfs -mv /user/accumulo/[uuid].wal /accumulo/wal/[tserver+port]/[uuid]
262+
$ hadoop fs –rm /accumulo/wal/[tserver+port]/[uuid]; \
263+
hadoop fs -mv /path/to/empty/file/empty.rf /accumulo/wal/[tserver+port]/[uuid]
267264

268265
Note:
269266
- the `+` separator for port.

0 commit comments

Comments
 (0)