github/sqoop
5
0
Fork 0
mirror of https://github.com/apache/sqoop.git synced 2025-05-21 03:10:49 +08:00
Code Issues Projects Releases Wiki Activity

SQOOP-1673: DOC: Update Upgrade.rst to reflect the latest in the code

Browse Source 
(Veena Basavaraj via Jarek Jarcec Cecho)
This commit is contained in:
Jarek Jarcec Cecho 2014-11-04 09:20:08 -08:00
parent 312ce98580
commit f62e161dc2
1 changed files with 7 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
docs/src/site/sphinx/Upgrade.rst
View File

@ -25,9 +25,9 @@ This page describes procedure that you need to take in order to upgrade Sqoop fr
Upgrading Server
================
As Sqoop server is using external repository for persisting connection and job objects, this repository needs to be updated in addition to updating the server bits. There are two ways how to upgrade Sqoop server metadata and it's structures, you can either execute upgrade tool or configure Server to perform all necessary changes on start up.
As Sqoop server is using a database repository for persisting sqoop entities such as the connector configurables, driver configurable, links and jobs, the repository schema might need to be updated as part of the server upgrade. There are two ways how to upgrade Sqoop entities in the repository, you can either execute upgrade tool or configure the sqoop server to perform all necessary upgrades on start up.
It's strongly advised to back up the repository before moving on to next steps. Backup instructions will vary depending on the repository implementation. For example, using MySQL as a repository will require a different back procedure than Apache Derby. Please follow the repositories' backup procedure
It's strongly advised to back up the repository before moving on to next steps. Backup instructions will vary depending on the repository implementation. For example, using MySQL as a repository will require a different back procedure than Apache Derby. Please follow the repositories' backup procedure.
Upgrading Server using upgrade tool
-----------------------------------
@ -49,21 +49,21 @@ In case of any failure, please take a look into `Upgrade Tool <Tools.html#upgrad
Upgrading Server on start-up
----------------------------
The capability of performing the upgrade has been built-in to the server, however is disabled by default to avoid any unintentional changes to the repository. You can start the upgrade procedure by stopping the server: ::
The capability of performing the upgrade has been built-in to the server, however is disabled by default to avoid any unintentional changes to the repository. You can start the repository schema upgrade procedure by stopping the server: ::
sqoop2-server stop
Now you can update server bits. Before starting the server again you will need to enable the auto-upgrade feature that will perform all necessary during Sqoop Server boot up procedure. You need to set following properties in configuration file ``sqoop.properties``::
Before starting the server again you will need to enable the auto-upgrade feature that will perform all necessary changes during Sqoop Server start up. You need to set the following properties in configuration file ``sqoop.properties``::
org.apache.sqoop.repository.schema.immutable=false
org.apache.sqoop.connector.autoupgrade=true
org.apache.sqoop.framework.autoupgrade=true
org.apache.sqoop.driver.autoupgrade=true
When all properties are set, start server using following command::
When all properties are set, start the sqoop server using the following command::
sqoop2-server start
All required actions will be performed automatically during the server bootstrap procedure. It's strongly advised to set all three properties to their original values once the server has been successfully started.
All required actions will be performed automatically during the server bootstrap. It's strongly advised to set all three properties to their original values once the server has been successfully started and the upgrade has completed
Upgrading Client
================