mikewalch commented on a change in pull request #126: Created documentation for
upgrading to 2.0
URL: https://github.com/apache/accumulo-website/pull/126#discussion_r229507326
##########
File path: _docs-2/administration/upgrading.md
##########
@@ -4,6 +4,73 @@ category: administration
order: 7
---
+## Upgrading from 1.8/9 to 2.0
+
+Follow the steps below to upgrade your Accumulo instance and client to 2.0.
+
+### Upgrade Accumulo instance
+
+**IMPORTANT!** Before upgrading to Accumulo 2.0, you will need to upgrade to
Java 8 and Hadoop 3.x.
+
+Upgrading to Accumulo 2.0 is done by stopping Accumulo 1.8/9 and starting
Accumulo 2.0.
+
+Before stopping Accumulo 1.8/9, install Accumulo 2.0 and configure it by
following the [2.0 install instructions]({% durl getting-started/quick-install
%}).
+
+There are several changes to scripts and configuration in 2.0 so be careful
when using configuration or automated setup designed for 1.8/9.
+Below are some changes in 2.0 that you should be aware of:
+* `accumulo.properties` has replaced `accumulo-site.xml`. You can either
convert `accumulo-site.xml` by hand
+ from XML to properties or use the following Accumulo command.
+ ```
+ accumulo convert-config -x old/accumulo-site.xml -p new/accumulo.properties
+ ```
+* `accumulo-client.properties` has replaced `client.conf`. The [client
properties]({% durl configuration/client-properties %})
+ in the new file are different so take care when customizing.
+* `accumulo-cluster` script has replaced the `start-all.sh` & `stop-all.sh`
scripts.
+ - Default host files (i.e `masters`, `monitor`, `gc`) are no longer in
`conf/` directory of tarball but can be created using `accumulo-cluster
create-config`
+ - Tablet server hosts must be listed in a `tservers` file instead of a
`slaves` file. To minimize confusion, Accumulo will not start if the old
`slaves` file is present.
+* `accumulo-service` script can be used to start/stop Accumulo services (i.e
master, tablet server, monitor) on a single node.
+ - Can be used even if Accumulo was started using `accumulo-cluster` script.
+* Accumulo 2.0 logging is configured by three files. Any previous logging
customization should be added to these files.
Review comment:
This should be fixed now
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
With regards,
Apache Git Services
