@@ -249,21 +249,29 @@ metadata table!), the following process can be followed to create a valid, empty
249249WAL file. Run the following commands as the Accumulo unix user (to ensure that
250250the 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