You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@accumulo.apache.org by mm...@apache.org on 2018/09/12 21:58:13 UTC

[accumulo-website] branch master updated: Update properties.md for experimental props (#107)

This is an automated email from the ASF dual-hosted git repository.

mmiller pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/accumulo-website.git


The following commit(s) were added to refs/heads/master by this push:
     new d47fe6b  Update properties.md for experimental props (#107)
d47fe6b is described below

commit d47fe6b5192b46d5c95954d980f2a153bf940089
Author: Mike Miller <mm...@apache.org>
AuthorDate: Wed Sep 12 17:58:11 2018 -0400

    Update properties.md for experimental props (#107)
---
 _docs-2-0/administration/properties.md | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/_docs-2-0/administration/properties.md b/_docs-2-0/administration/properties.md
index a236a1f..e0b5db3 100644
--- a/_docs-2-0/administration/properties.md
+++ b/_docs-2-0/administration/properties.md
@@ -6,7 +6,7 @@ order: 3
 
 <!-- WARNING: Do not edit this file. It is a generated file that is copied from Accumulo build (from core/target/generated-docs) -->
 
-Below are properties set in `accumulo.properties` or the Accumulo shell that configure Accumulo servers (i.e tablet server, master, etc):
+Below are properties set in `accumulo.properties` or the Accumulo shell that configure Accumulo servers (i.e tablet server, master, etc). Properties labeled 'Experimental' could be part of an incomplete feature or have a higher risk of changing in the future.
 
 | Property | Description |
 |--------------|-------------|
@@ -28,6 +28,7 @@ Below are properties set in `accumulo.properties` or the Accumulo shell that con
 | <a name="general_kerberos_renewal_period" class="prop"></a> general.kerberos.renewal.period | The amount of time between attempts to perform Kerberos ticket renewals. This does not equate to how often tickets are actually renewed (which is performed at 80% of the ticket lifetime).<br>**type:** TIMEDURATION, **zk mutable:** no, **default value:** `30s` |
 | <a name="general_legacy_metrics" class="prop"></a> general.legacy.metrics | Use the old metric infrastructure configured by accumulo-metrics.xml, instead of Hadoop Metrics2<br>**type:** BOOLEAN, **zk mutable:** no, **default value:** `false` |
 | <a name="general_max_scanner_retry_period" class="prop"></a> general.max.scanner.retry.period | The maximum amount of time that a Scanner should wait before retrying a failed RPC<br>**type:** TIMEDURATION, **zk mutable:** no, **default value:** `5s` |
+| <a name="general_rpc_server_type" class="prop"></a> general.rpc.server.type | **Experimental.** Type of Thrift server to instantiate, see org.apache.accumulo.server.rpc.ThriftServerType for more information. Only useful for benchmarking thrift servers<br>**type:** STRING, **zk mutable:** no, **default value:** empty |
 | <a name="general_rpc_timeout" class="prop"></a> general.rpc.timeout | Time to wait on I/O for simple, short RPC calls<br>**type:** TIMEDURATION, **zk mutable:** no, **default value:** `120s` |
 | <a name="general_security_credential_provider_paths" class="prop"></a> general.security.credential.provider.paths | Comma-separated list of paths to CredentialProviders<br>**type:** STRING, **zk mutable:** no, **default value:** empty |
 | <a name="general_server_message_size_max" class="prop"></a> general.server.message.size.max | The maximum size of a message that can be sent to a server.<br>**type:** BYTES, **zk mutable:** no, **default value:** `1G` |
@@ -35,7 +36,11 @@ Below are properties set in `accumulo.properties` or the Accumulo shell that con
 | <a name="general_vfs_cache_dir" class="prop"></a> general.vfs.cache.dir | Directory to use for the vfs cache. The cache will keep a soft reference to all of the classes loaded in the VM. This should be on local disk on each node with sufficient space. It defaults to ${java.io.tmpdir}/accumulo-vfs-cache-${user.name}<br>**type:** ABSOLUTEPATH, **zk mutable:** no, **default value:** `${java.io.tmpdir}/accumulo-vfs-cache-${user.name}` |
 | <a name="general_vfs_classpaths" class="prop"></a> general.vfs.classpaths | Configuration for a system level vfs classloader. Accumulo jar can be configured here and loaded out of HDFS.<br>**type:** STRING, **zk mutable:** no, **default value:** empty |
 | <a name="general_vfs_context_classpath_prefix" class="prop"></a> **general.vfs.context.classpath.*** | Properties in this category are define a classpath. These properties start  with the category prefix, followed by a context name. The value is a comma separated list of URIs. Supports full regex on filename alone. For example, general.vfs.context.classpath.cx1=hdfs://nn1:9902/mylibdir/*.jar. You can enable post delegation for a context, which will load classes from the context first i [...]
+| <a name="general_volume_chooser" class="prop"></a> general.volume.chooser | **Experimental.** The class that will be used to select which volume will be used to create new files.<br>**type:** CLASSNAME, **zk mutable:** no, **default value:** {% jlink -f org.apache.accumulo.server.fs.RandomVolumeChooser %} |
 | <a name="instance_prefix" class="prop"></a> **instance.*** | Properties in this category must be consistent throughout a cloud. This is enforced and servers won't be able to communicate if these differ. |
+| <a name="instance_crypto_opts_prefix" class="prop"></a> **instance.crypto.opts.*** | **Experimental.** Properties related to on-disk file encryption. |
+| <a name="instance_crypto_opts_sensitive_prefix" class="prop"></a> **instance.crypto.opts.sensitive.*** | **Experimental.** Sensitive properties related to on-disk file encryption. |
+| <a name="instance_crypto_service" class="prop"></a> instance.crypto.service | **Experimental.** The class which executes on-disk file encryption. The default does nothing. To enable encryption, replace this classname with an implementation of theorg.apache.accumulo.core.spi.crypto.CryptoService interface.<br>**type:** CLASSNAME, **zk mutable:** no, **default value:** {% jlink -f org.apache.accumulo.core.security.crypto.impl.NoCryptoService %} |
 | <a name="instance_dfs_dir" class="prop"></a> instance.dfs.dir | **Deprecated.** ~~HDFS directory in which accumulo instance will run. Do not change after accumulo is initialized.~~<br>~~**type:** ABSOLUTEPATH~~, ~~**zk mutable:** no~~, ~~**default value:** `/accumulo`~~ |
 | <a name="instance_dfs_uri" class="prop"></a> instance.dfs.uri | **Deprecated.** ~~A url accumulo should use to connect to DFS. If this is empty, accumulo will obtain this information from the hadoop configuration. This property will only be used when creating new files if instance.volumes is empty. After an upgrade to 1.6.0 Accumulo will start using absolute paths to reference files. Files created before a 1.6.0 upgrade are referenced via relative paths. Relative paths will always be r [...]
 | <a name="instance_rpc_sasl_allowed_host_impersonation" class="prop"></a> instance.rpc.sasl.allowed.host.impersonation | One-line configuration property controlling the network locations (hostnames) that are allowed to impersonate other users<br>**type:** STRING, **zk mutable:** no, **default value:** empty |
@@ -117,7 +122,7 @@ Below are properties set in `accumulo.properties` or the Accumulo shell that con
 | <a name="rpc_ssl_client_protocol" class="prop"></a> rpc.ssl.client.protocol | The protocol used to connect to a secure server, must be in the list of enabled protocols on the server side (rpc.ssl.server.enabled.protocols)<br>**type:** STRING, **zk mutable:** no, **default value:** `TLSv1.2` |
 | <a name="rpc_ssl_server_enabled_protocols" class="prop"></a> rpc.ssl.server.enabled.protocols | Comma separated list of protocols that can be used to accept connections<br>**type:** STRING, **zk mutable:** no, **default value:** `TLSv1.2` |
 | <a name="rpc_useJsse" class="prop"></a> rpc.useJsse | Use JSSE system properties to configure SSL rather than the rpc.javax.net.ssl.* Accumulo properties<br>**type:** BOOLEAN, **zk mutable:** no, **default value:** `false` |
-| <a name="table_prefix" class="prop"></a> **table.*** | Properties in this category affect tablet server treatment of tablets, but can be configured on a per-table basis. Setting these properties in the site file will override the default globally for all tables and not any specific table. However, both the default and the global setting can be overridden per table using the table operations API or in the shell, which sets the overridden value in zookeeper. Restarting accumulo tablet se [...]
+| <a name="table_prefix" class="prop"></a> **table.*** | Properties in this category affect tablet server treatment of tablets, but can be configured on a per-table basis. Setting these properties in accumulo.properties will override the default globally for all tables and not any specific table. However, both the default and the global setting can be overridden per table using the table operations API or in the shell, which sets the overridden value in zookeeper. Restarting accumulo tab [...]
 | <a name="table_balancer" class="prop"></a> table.balancer | This property can be set to allow the LoadBalanceByTable load balancer to change the called Load Balancer for this table<br>**type:** STRING, **zk mutable:** yes, **default value:** `org.apache.accumulo.server.master.balancer.DefaultLoadBalancer` |
 | <a name="table_bloom_enabled" class="prop"></a> table.bloom.enabled | Use bloom filters on this table.<br>**type:** BOOLEAN, **zk mutable:** yes, **default value:** `false` |
 | <a name="table_bloom_error_rate" class="prop"></a> table.bloom.error.rate | Bloom filter error rate.<br>**type:** FRACTION, **zk mutable:** yes, **default value:** `0.5%` |
@@ -135,6 +140,7 @@ Below are properties set in `accumulo.properties` or the Accumulo shell that con
 | <a name="table_compaction_minor_merge_file_size_max" class="prop"></a> table.compaction.minor.merge.file.size.max | The max RFile size used for a merging minor compaction. The default value of 0 disables a max file size.<br>**type:** BYTES, **zk mutable:** yes, **default value:** `0` |
 | <a name="table_constraint_prefix" class="prop"></a> **table.constraint.*** | Properties in this category are per-table properties that add constraints to a table. These properties start with the category prefix, followed by a number, and their values correspond to a fully qualified Java class that implements the Constraint interface.<br>For example:<br>table.constraint.1 = org.apache.accumulo.core.constraints.MyCustomConstraint<br>and:<br> table.constraint.2 = my.package.constraints.My [...]
 | <a name="table_custom_prefix" class="prop"></a> **table.custom.*** | Prefix to be used for user defined arbitrary properties. |
+| <a name="table_delete_behavior" class="prop"></a> table.delete.behavior | **Experimental.** This determines what action to take when a delete marker is seen. Valid values are `process` and `fail` with `process` being the default.  When set to `process`, deletes will supress data.  When set to `fail`, any deletes seen will cause an exception. The purpose of `fail` is to support tables that never delete data and need fast seeks within the timestamp range of a column. When setting this to [...]
 | <a name="table_durability" class="prop"></a> table.durability | The durability used to write to the write-ahead log. Legal values are: none, which skips the write-ahead log; log, which sends the data to the write-ahead log, but does nothing to make it durable; flush, which pushes data to the file system; and sync, which ensures the data is written to disk.<br>**type:** DURABILITY, **zk mutable:** yes, **default value:** `sync` |
 | <a name="table_failures_ignore" class="prop"></a> table.failures.ignore | If you want queries for your table to hang or fail when data is missing from the system, then set this to false. When this set to true missing data will be reported but queries will still run possibly returning a subset of the data.<br>**type:** BOOLEAN, **zk mutable:** yes, **default value:** `false` |
 | <a name="table_file_blocksize" class="prop"></a> table.file.blocksize | The HDFS block size used when writing RFiles. When set to 0B, the value/defaults of HDFS property 'dfs.block.size' will be used.<br>**type:** BYTES, **zk mutable:** yes, **default value:** `0B` |