You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@accumulo.apache.org by GitBox <gi...@apache.org> on 2022/06/01 20:34:27 UTC
[GitHub] [accumulo-website] EdColeman opened a new pull request, #321: Add ZooKeeper info viewer utility documentation
EdColeman opened a new pull request, #321:
URL: https://github.com/apache/accumulo-website/pull/321
Adds documentation for utility added with https://github.com/apache/accumulo/pull/2751
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] EdColeman commented on pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
EdColeman commented on PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#issuecomment-1164482253
Closing to stage on next_release branch instead of main
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] EdColeman closed pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
EdColeman closed pull request #321: Add ZooKeeper info viewer utility documentation
URL: https://github.com/apache/accumulo-website/pull/321
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] EdColeman commented on a diff in pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
EdColeman commented on code in PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#discussion_r904118488
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
+
+ $ accumulo zoo-info-viewer --print-instances
+
+ -----------------------------------------------
+ Report Time: 2022-05-31T21:07:19.673258Z
+ -----------------------------------------------
+ Instances (Instance Name, Instance ID)
+ test_a=1111465d-b7bb-42c2-919b-111111111111
+ test_b=2222465d-b7bb-42c2-919b-222222222222
+ uno=9cc9465d-b7bb-42c2-919b-ddf74b610c82
+
+ -----------------------------------------------
+
+## mode: print id-map
+If a shell is not available or convent, the zoo-info-viewer can provide the same
+information as the `namespaces -l` and `tables -l` commands. Note, the zoo-info-viewer output is
+sorted by the id.
+
+ $ accumulo zoo-info-viewer --print-id-map
+ -----------------------------------------------
+ Report Time: 2022-05-25T19:33:42.079969Z
+ -----------------------------------------------
+ ID Mapping (id => name) for instance: 8f006afd-8673-4a5a-b940-60405755197f
+ Namespace ids:
+ +accumulo => accumulo
+ +default => ""
+ 1 => ns_sample1
+
+ Table ids:
+ !0 => accumulo.metadata
+ +r => accumulo.root
+ +rep => accumulo.replication
+ 2 => ns_sample1.tbl1
+ 3 => tbl2
+
+ -----------------------------------------------
+
+## mode: print property mappings
+
+With Accumulo version 2.1, the storage of properties in ZooKeeper has changed and the properties are not direclty
+readable with the ZooKeeper zkCli utility. The properties can be listed in an Accumulo shell with the `config` command
+however, if a shell is not available, this utility `zoo-info-viewer` can be used instead.
+
+The `zoo-info-viewer` option `--print-props` with no other options will print all the configuration properties
+for system, namespaces and tables. The `print-props` can be filtered the with additional options, `--system` will print
Review Comment:
print-props
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] dlmarion commented on pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
dlmarion commented on PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#issuecomment-1164413097
Use the `edit` button at the top right next to the title.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] EdColeman commented on a diff in pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
EdColeman commented on code in PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#discussion_r904118488
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
+
+ $ accumulo zoo-info-viewer --print-instances
+
+ -----------------------------------------------
+ Report Time: 2022-05-31T21:07:19.673258Z
+ -----------------------------------------------
+ Instances (Instance Name, Instance ID)
+ test_a=1111465d-b7bb-42c2-919b-111111111111
+ test_b=2222465d-b7bb-42c2-919b-222222222222
+ uno=9cc9465d-b7bb-42c2-919b-ddf74b610c82
+
+ -----------------------------------------------
+
+## mode: print id-map
+If a shell is not available or convent, the zoo-info-viewer can provide the same
+information as the `namespaces -l` and `tables -l` commands. Note, the zoo-info-viewer output is
+sorted by the id.
+
+ $ accumulo zoo-info-viewer --print-id-map
+ -----------------------------------------------
+ Report Time: 2022-05-25T19:33:42.079969Z
+ -----------------------------------------------
+ ID Mapping (id => name) for instance: 8f006afd-8673-4a5a-b940-60405755197f
+ Namespace ids:
+ +accumulo => accumulo
+ +default => ""
+ 1 => ns_sample1
+
+ Table ids:
+ !0 => accumulo.metadata
+ +r => accumulo.root
+ +rep => accumulo.replication
+ 2 => ns_sample1.tbl1
+ 3 => tbl2
+
+ -----------------------------------------------
+
+## mode: print property mappings
+
+With Accumulo version 2.1, the storage of properties in ZooKeeper has changed and the properties are not direclty
+readable with the ZooKeeper zkCli utility. The properties can be listed in an Accumulo shell with the `config` command
+however, if a shell is not available, this utility `zoo-info-viewer` can be used instead.
+
+The `zoo-info-viewer` option `--print-props` with no other options will print all the configuration properties
+for system, namespaces and tables. The `print-props` can be filtered the with additional options, `--system` will print
Review Comment:
`--print-props` is what the command line parsing currently expects.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] dlmarion commented on pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
dlmarion commented on PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#issuecomment-1164332935
Quick question - is the target for this merge correct? If it's for 2.1, then the target should be `next-release`, right?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] EdColeman commented on a diff in pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
EdColeman commented on code in PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#discussion_r904370419
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
+
+ $ accumulo zoo-info-viewer --print-instances
+
+ -----------------------------------------------
+ Report Time: 2022-05-31T21:07:19.673258Z
+ -----------------------------------------------
+ Instances (Instance Name, Instance ID)
+ test_a=1111465d-b7bb-42c2-919b-111111111111
+ test_b=2222465d-b7bb-42c2-919b-222222222222
+ uno=9cc9465d-b7bb-42c2-919b-ddf74b610c82
+
+ -----------------------------------------------
+
+## mode: print id-map
+If a shell is not available or convent, the zoo-info-viewer can provide the same
Review Comment:
spell check correction for my version of `convenient`
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] dlmarion commented on a diff in pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
dlmarion commented on code in PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#discussion_r903932252
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
Review Comment:
```suggestion
The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name to id mapping run:
```
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
+
+ $ accumulo zoo-info-viewer --print-instances
+
+ -----------------------------------------------
+ Report Time: 2022-05-31T21:07:19.673258Z
+ -----------------------------------------------
+ Instances (Instance Name, Instance ID)
+ test_a=1111465d-b7bb-42c2-919b-111111111111
+ test_b=2222465d-b7bb-42c2-919b-222222222222
+ uno=9cc9465d-b7bb-42c2-919b-ddf74b610c82
+
+ -----------------------------------------------
+
+## mode: print id-map
+If a shell is not available or convent, the zoo-info-viewer can provide the same
Review Comment:
I'm not sure what you mean by `convent` here.
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
+
+ $ accumulo zoo-info-viewer --print-instances
+
+ -----------------------------------------------
+ Report Time: 2022-05-31T21:07:19.673258Z
+ -----------------------------------------------
+ Instances (Instance Name, Instance ID)
+ test_a=1111465d-b7bb-42c2-919b-111111111111
+ test_b=2222465d-b7bb-42c2-919b-222222222222
+ uno=9cc9465d-b7bb-42c2-919b-ddf74b610c82
+
+ -----------------------------------------------
+
+## mode: print id-map
+If a shell is not available or convent, the zoo-info-viewer can provide the same
+information as the `namespaces -l` and `tables -l` commands. Note, the zoo-info-viewer output is
+sorted by the id.
+
+ $ accumulo zoo-info-viewer --print-id-map
+ -----------------------------------------------
+ Report Time: 2022-05-25T19:33:42.079969Z
+ -----------------------------------------------
+ ID Mapping (id => name) for instance: 8f006afd-8673-4a5a-b940-60405755197f
+ Namespace ids:
+ +accumulo => accumulo
+ +default => ""
+ 1 => ns_sample1
+
+ Table ids:
+ !0 => accumulo.metadata
+ +r => accumulo.root
+ +rep => accumulo.replication
+ 2 => ns_sample1.tbl1
+ 3 => tbl2
+
+ -----------------------------------------------
+
+## mode: print property mappings
+
+With Accumulo version 2.1, the storage of properties in ZooKeeper has changed and the properties are not direclty
+readable with the ZooKeeper zkCli utility. The properties can be listed in an Accumulo shell with the `config` command
+however, if a shell is not available, this utility `zoo-info-viewer` can be used instead.
+
+The `zoo-info-viewer` option `--print-props` with no other options will print all the configuration properties
+for system, namespaces and tables. The `print-props` can be filtered the with additional options, `--system` will print
Review Comment:
Is it `print-props` or `print-properties`?
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
+
+ $ accumulo zoo-info-viewer --print-instances
+
+ -----------------------------------------------
+ Report Time: 2022-05-31T21:07:19.673258Z
+ -----------------------------------------------
+ Instances (Instance Name, Instance ID)
+ test_a=1111465d-b7bb-42c2-919b-111111111111
+ test_b=2222465d-b7bb-42c2-919b-222222222222
+ uno=9cc9465d-b7bb-42c2-919b-ddf74b610c82
+
+ -----------------------------------------------
+
+## mode: print id-map
+If a shell is not available or convent, the zoo-info-viewer can provide the same
+information as the `namespaces -l` and `tables -l` commands. Note, the zoo-info-viewer output is
+sorted by the id.
+
+ $ accumulo zoo-info-viewer --print-id-map
+ -----------------------------------------------
+ Report Time: 2022-05-25T19:33:42.079969Z
+ -----------------------------------------------
+ ID Mapping (id => name) for instance: 8f006afd-8673-4a5a-b940-60405755197f
+ Namespace ids:
+ +accumulo => accumulo
+ +default => ""
+ 1 => ns_sample1
+
+ Table ids:
+ !0 => accumulo.metadata
+ +r => accumulo.root
+ +rep => accumulo.replication
+ 2 => ns_sample1.tbl1
+ 3 => tbl2
+
+ -----------------------------------------------
+
+## mode: print property mappings
+
+With Accumulo version 2.1, the storage of properties in ZooKeeper has changed and the properties are not direclty
+readable with the ZooKeeper zkCli utility. The properties can be listed in an Accumulo shell with the `config` command
+however, if a shell is not available, this utility `zoo-info-viewer` can be used instead.
Review Comment:
```suggestion
However, if a shell is not available, this utility `zoo-info-viewer` can be used instead.
```
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
+
+ $ accumulo zoo-info-viewer --print-instances
+
+ -----------------------------------------------
+ Report Time: 2022-05-31T21:07:19.673258Z
+ -----------------------------------------------
+ Instances (Instance Name, Instance ID)
+ test_a=1111465d-b7bb-42c2-919b-111111111111
+ test_b=2222465d-b7bb-42c2-919b-222222222222
+ uno=9cc9465d-b7bb-42c2-919b-ddf74b610c82
+
+ -----------------------------------------------
+
+## mode: print id-map
+If a shell is not available or convent, the zoo-info-viewer can provide the same
+information as the `namespaces -l` and `tables -l` commands. Note, the zoo-info-viewer output is
+sorted by the id.
+
+ $ accumulo zoo-info-viewer --print-id-map
+ -----------------------------------------------
+ Report Time: 2022-05-25T19:33:42.079969Z
+ -----------------------------------------------
+ ID Mapping (id => name) for instance: 8f006afd-8673-4a5a-b940-60405755197f
+ Namespace ids:
+ +accumulo => accumulo
+ +default => ""
+ 1 => ns_sample1
+
+ Table ids:
+ !0 => accumulo.metadata
+ +r => accumulo.root
+ +rep => accumulo.replication
+ 2 => ns_sample1.tbl1
+ 3 => tbl2
+
+ -----------------------------------------------
+
+## mode: print property mappings
+
+With Accumulo version 2.1, the storage of properties in ZooKeeper has changed and the properties are not direclty
+readable with the ZooKeeper zkCli utility. The properties can be listed in an Accumulo shell with the `config` command
Review Comment:
```suggestion
readable with the ZooKeeper zkCli utility. The properties can be listed in an Accumulo shell with the `config` command.
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] EdColeman commented on a diff in pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
EdColeman commented on code in PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#discussion_r904382209
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
+
+ $ accumulo zoo-info-viewer --print-instances
+
+ -----------------------------------------------
+ Report Time: 2022-05-31T21:07:19.673258Z
+ -----------------------------------------------
+ Instances (Instance Name, Instance ID)
+ test_a=1111465d-b7bb-42c2-919b-111111111111
+ test_b=2222465d-b7bb-42c2-919b-222222222222
+ uno=9cc9465d-b7bb-42c2-919b-ddf74b610c82
+
+ -----------------------------------------------
+
+## mode: print id-map
+If a shell is not available or convent, the zoo-info-viewer can provide the same
Review Comment:
addressed in 226d85fb
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] EdColeman commented on a diff in pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
EdColeman commented on code in PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#discussion_r904382026
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
+
+ $ accumulo zoo-info-viewer --print-instances
+
+ -----------------------------------------------
+ Report Time: 2022-05-31T21:07:19.673258Z
+ -----------------------------------------------
+ Instances (Instance Name, Instance ID)
+ test_a=1111465d-b7bb-42c2-919b-111111111111
+ test_b=2222465d-b7bb-42c2-919b-222222222222
+ uno=9cc9465d-b7bb-42c2-919b-ddf74b610c82
+
+ -----------------------------------------------
+
+## mode: print id-map
+If a shell is not available or convent, the zoo-info-viewer can provide the same
+information as the `namespaces -l` and `tables -l` commands. Note, the zoo-info-viewer output is
+sorted by the id.
+
+ $ accumulo zoo-info-viewer --print-id-map
+ -----------------------------------------------
+ Report Time: 2022-05-25T19:33:42.079969Z
+ -----------------------------------------------
+ ID Mapping (id => name) for instance: 8f006afd-8673-4a5a-b940-60405755197f
+ Namespace ids:
+ +accumulo => accumulo
+ +default => ""
+ 1 => ns_sample1
+
+ Table ids:
+ !0 => accumulo.metadata
+ +r => accumulo.root
+ +rep => accumulo.replication
+ 2 => ns_sample1.tbl1
+ 3 => tbl2
+
+ -----------------------------------------------
+
+## mode: print property mappings
+
+With Accumulo version 2.1, the storage of properties in ZooKeeper has changed and the properties are not direclty
+readable with the ZooKeeper zkCli utility. The properties can be listed in an Accumulo shell with the `config` command
+however, if a shell is not available, this utility `zoo-info-viewer` can be used instead.
+
+The `zoo-info-viewer` option `--print-props` with no other options will print all the configuration properties
+for system, namespaces and tables. The `print-props` can be filtered the with additional options, `--system` will print
Review Comment:
addressed in 226d85fb
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] dlmarion commented on a diff in pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
dlmarion commented on code in PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#discussion_r904167309
##########
_docs-2/troubleshooting/tools.md:
##########
@@ -152,3 +152,116 @@ An XML dump file can be later used to restore ZooKeeper.
$ accumulo org.apache.accumulo.server.util.RestoreZookeeper --overwrite < dump.xml
This command overwrites ZooKeeper so take care when using it. This is also why it cannot be called using `accumulo-util`.
+
+# zoo-info-viewer (new in 2.1)
+
+View Accumulo information stored in ZooKeeper in a human-readable format. The utility can be run without an Accumulo
+instance. If an instance id or name is not provided on the command line, the instance will be read from
+HDFS, otherwise only a running ZooKeeper instance is required to run the command.
+
+To run the command:
+
+ $ accumulo zoo-info-viewer [--instanceId id | --instanceName name] [mode-options] [--outfile filename]
+
+ mode options:
+ --print-instances
+ --print-id-map
+ --print-properties [--system] [-ns | --namespaces list] [-t | --tables list]
+
+## mode: print instances
+The instance name(s) and instance id(s) are stored in ZooKeeper. To see the available name, id mapping run:
+
+ $ accumulo zoo-info-viewer --print-instances
+
+ -----------------------------------------------
+ Report Time: 2022-05-31T21:07:19.673258Z
+ -----------------------------------------------
+ Instances (Instance Name, Instance ID)
+ test_a=1111465d-b7bb-42c2-919b-111111111111
+ test_b=2222465d-b7bb-42c2-919b-222222222222
+ uno=9cc9465d-b7bb-42c2-919b-ddf74b610c82
+
+ -----------------------------------------------
+
+## mode: print id-map
+If a shell is not available or convent, the zoo-info-viewer can provide the same
+information as the `namespaces -l` and `tables -l` commands. Note, the zoo-info-viewer output is
+sorted by the id.
+
+ $ accumulo zoo-info-viewer --print-id-map
+ -----------------------------------------------
+ Report Time: 2022-05-25T19:33:42.079969Z
+ -----------------------------------------------
+ ID Mapping (id => name) for instance: 8f006afd-8673-4a5a-b940-60405755197f
+ Namespace ids:
+ +accumulo => accumulo
+ +default => ""
+ 1 => ns_sample1
+
+ Table ids:
+ !0 => accumulo.metadata
+ +r => accumulo.root
+ +rep => accumulo.replication
+ 2 => ns_sample1.tbl1
+ 3 => tbl2
+
+ -----------------------------------------------
+
+## mode: print property mappings
+
+With Accumulo version 2.1, the storage of properties in ZooKeeper has changed and the properties are not direclty
+readable with the ZooKeeper zkCli utility. The properties can be listed in an Accumulo shell with the `config` command
+however, if a shell is not available, this utility `zoo-info-viewer` can be used instead.
+
+The `zoo-info-viewer` option `--print-props` with no other options will print all the configuration properties
+for system, namespaces and tables. The `print-props` can be filtered the with additional options, `--system` will print
Review Comment:
ok, you may want to update line 169 then
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [accumulo-website] EdColeman commented on pull request #321: Add ZooKeeper info viewer utility documentation
Posted by GitBox <gi...@apache.org>.
EdColeman commented on PR #321:
URL: https://github.com/apache/accumulo-website/pull/321#issuecomment-1164402768
It is for 2.1, so yes I guess next_release should be the target, just used to main in accumulo repo. Any idea how I change the target? Close this and create new seems like it would work, but may be rather drastic
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@accumulo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org