Skip to content

Commit 52ff6b8

Browse files
author
Ed Coleman
committed
Update documentation to create an empty wal file
1 parent 8614226 commit 52ff6b8

File tree

1 file changed

+19
-11
lines changed

1 file changed

+19
-11
lines changed

_docs-2/troubleshooting/advanced.md

Lines changed: 19 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -249,21 +249,29 @@ 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-
$ echo -n -e '--- Log File Header (v2) ---\x00\x00\x00\x00' > empty.wal
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+
```
253257

254-
The above creates a file with the text "--- Log File Header (v2) ---" and then
255-
four bytes. You should verify the contents of the file with a hexdump tool.
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.
256261

257-
Then, place this empty WAL in HDFS and then replace the corrupt WAL file in HDFS
258-
with the empty WAL.
262+
Then, place this empty WAL in HDFS and then replace the corrupt WAL file in HDFS with the empty WAL for the
263+
tserver / host pair with the following hdfs commands:
259264

260-
$ hdfs dfs -moveFromLocal empty.wal /user/accumulo/empty.wal
261-
$ hdfs dfs -mv /user/accumulo/empty.wal /accumulo/wal/tserver-4.example.com+10011/26abec5b-63e7-40dd-9fa1-b8ad2436606e
265+
$ hdfs dfs -moveFromLocal [uuid].wal /user/accumulo/[uuid].wal
266+
$ hdfs dfs -mv /user/accumulo/[uuid].wal /accumulo/wal/[tserver+port]/[uuid]
262267

263-
After the corrupt WAL file has been replaced, the system should automatically recover.
264-
It may be necessary to restart the Accumulo Manager process as an exponential
265-
backup policy is used which could lead to a long wait before Accumulo will
266-
try to re-load the WAL file.
268+
Note:
269+
- the `+` separator for port.
270+
- the wal file is the uuid, without an extension
271+
272+
After the corrupt WAL file has been replaced, the system should automatically recover. It may be necessary to restart
273+
the Accumulo Manager process as an exponential backup policy is used which could lead to a long wait before Accumulo
274+
will try to re-load the WAL file.
267275

268276
## Zookeeper Failures
269277

0 commit comments

Comments
 (0)