=========
zar 2.0.4
=========
|Maturity| |license gpl|
Overview
========
Zeroincombenze® Archive Replica
-------------------------------
ZAR stand for Zeroincombenze® Archive Replica.
It is a tool kit to backup, restore, replicate files and/or database.
ZAR manages easily backup for Odoo database, keeps last nth copies and purges oldest copies.
Features
--------
* backup and restore odoo database
* backup and restore based on rules by configuration file
* restore database with automatic actions disabled
* multiple copies of database by configuration file
* automatic purging of oldest copies
* configuration based on host name: it works on duplicate host image too
* backup on same host or on remote host
Usage
=====
zar should be execute by postgres user
Execute zar_upd to install and configure.
Configuration file is zar.conf
Execute zar_bck to do backup or restore, based on host role
Execute zar_rest to do restore
To execute in cron, use zar_bck -k
There are avaiable two postgresql facilities:
* pg_db_active
* pg_db_reassign owner
`pg_db_active` show and kill postgres session. It can kill oldest session out of pool.
`pg_db_reassign_owner` can reassign owner to database. It reassign the ownership of all objects.
Getting started
===============
Prerequisites
-------------
Zeroincombenze tools requires:
* Linux Centos 7/8 or Debian 9/10 or Ubuntu 18/20/22
* python 2.7+, some tools require python 3.6+, best python 3.8+
* bash 5.0+
Installation
------------
For stable version:
`pip install zar`
For current version:
`cd $HOME`
`git@github.com:zeroincombenze/tools.git`
`cd $HOME/tools`
`./install_tools.sh`
Upgrade
-------
Stable version via Python Package
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
::
pip install --upgrade zar
Current version via Git
~~~~~~~~~~~~~~~~~~~~~~~
::
cd ./tools
./install_tools.sh -pUT
source $HOME/devel/activate_tools
ChangeLog History
-----------------
2.0.4 (2023-09-08)
~~~~~~~~~~~~~~~~~~
* [IMP] Backup filestore
* [FIX] Remote copy to /dev/null
2.0.3 (2023-09-06)
~~~~~~~~~~~~~~~~~~
* [FIX] DB name with hyphen (-)
2.0.2 (2023-05-14)
~~~~~~~~~~~~~~~~~~
* [IMP] reassing_owner accept db_port
2.0.1 (2023-02-25)
~~~~~~~~~~~~~~~~~~
* [IMP] Remote bckdir different from local
2.0.0 (2022-10-20)
~~~~~~~~~~~~~~~~~~
* [IMP] Stable version
1.3.35.3 (2021-08-13)
~~~~~~~~~~~~~~~~~~~~~
[FIX] pg_db_active: kill process
Credits
=======
Copyright
---------
SHS-AV s.r.l. <https://www.shs-av.com/>
Authors
-------
* `SHS-AV s.r.l. <https://www.zeroincombenze.it>`__
Contributors
------------
* `Antonio M. Vigliotti <info@shs-av.com>`__
* `Antonio Maria Vigliotti <antoniomaria.vigliotti@gmail.com>`__
|
|
.. |Maturity| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt:
.. |license gpl| image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |license opl| image:: https://img.shields.io/badge/licence-OPL-7379c3.svg
:target: https://www.odoo.com/documentation/user/9.0/legal/licenses/licenses.html
:alt: License: OPL
.. |Tech Doc| image:: https://www.zeroincombenze.it/wp-content/uploads/ci-ct/prd/button-docs-2.svg
:target: https://wiki.zeroincombenze.org/en/Odoo/2.0.4/dev
:alt: Technical Documentation
.. |Help| image:: https://www.zeroincombenze.it/wp-content/uploads/ci-ct/prd/button-help-2.svg
:target: https://wiki.zeroincombenze.org/it/Odoo/2.0.4/man
:alt: Technical Documentation
.. |Try Me| image:: https://www.zeroincombenze.it/wp-content/uploads/ci-ct/prd/button-try-it-2.svg
:target: https://erp2.zeroincombenze.it
:alt: Try Me
.. |Zeroincombenze| image:: https://avatars0.githubusercontent.com/u/6972555?s=460&v=4
:target: https://www.zeroincombenze.it/
:alt: Zeroincombenze
.. |en| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/flags/en_US.png
:target: https://www.facebook.com/Zeroincombenze-Software-gestionale-online-249494305219415/
.. |it| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/flags/it_IT.png
:target: https://www.facebook.com/Zeroincombenze-Software-gestionale-online-249494305219415/
.. |check| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/check.png
.. |no_check| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/no_check.png
.. |menu| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/menu.png
.. |right_do| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/right_do.png
.. |exclamation| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/exclamation.png
.. |warning| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/warning.png
.. |same| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/same.png
.. |late| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/late.png
.. |halt| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/halt.png
.. |info| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/info.png
.. |xml_schema| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/certificates/iso/icons/xml-schema.png
:target: https://github.com/zeroincombenze/grymb/blob/master/certificates/iso/scope/xml-schema.md
.. |DesktopTelematico| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/certificates/ade/icons/DesktopTelematico.png
:target: https://github.com/zeroincombenze/grymb/blob/master/certificates/ade/scope/Desktoptelematico.md
.. |FatturaPA| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/certificates/ade/icons/fatturapa.png
:target: https://github.com/zeroincombenze/grymb/blob/master/certificates/ade/scope/fatturapa.md
.. |chat_with_us| image:: https://www.shs-av.com/wp-content/chat_with_us.gif
:target: https://t.me/Assitenza_clienti_powERP
Raw data
{
"_id": null,
"home_page": "",
"name": "zar",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "backup,restore,replica",
"author": "Antonio Maria Vigliotti",
"author_email": "antoniomaria.vigliotti@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a6/a2/eac6c68f3513106028d471707ae24ddfd3cf9fbcd8f1a72757a6ba68627f/zar-2.0.4.tar.gz",
"platform": null,
"description": "=========\nzar 2.0.4\n=========\n\n\n\n|Maturity| |license gpl|\n\n\n\nOverview\n========\n\nZeroincombenze\u00ae Archive Replica\n-------------------------------\n\nZAR stand for Zeroincombenze\u00ae Archive Replica.\nIt is a tool kit to backup, restore, replicate files and/or database.\n\nZAR manages easily backup for Odoo database, keeps last nth copies and purges oldest copies.\n\n\n\nFeatures\n--------\n\n* backup and restore odoo database\n* backup and restore based on rules by configuration file\n* restore database with automatic actions disabled\n* multiple copies of database by configuration file\n* automatic purging of oldest copies\n* configuration based on host name: it works on duplicate host image too\n* backup on same host or on remote host\n\n\n\nUsage\n=====\n\nzar should be execute by postgres user\n\nExecute zar_upd to install and configure.\nConfiguration file is zar.conf\nExecute zar_bck to do backup or restore, based on host role\nExecute zar_rest to do restore\n\nTo execute in cron, use zar_bck -k\n\n\nThere are avaiable two postgresql facilities:\n\n* pg_db_active\n* pg_db_reassign owner\n\n`pg_db_active` show and kill postgres session. It can kill oldest session out of pool.\n\n`pg_db_reassign_owner` can reassign owner to database. It reassign the ownership of all objects.\n\n\n\nGetting started\n===============\n\n\nPrerequisites\n-------------\n\nZeroincombenze tools requires:\n\n* Linux Centos 7/8 or Debian 9/10 or Ubuntu 18/20/22\n* python 2.7+, some tools require python 3.6+, best python 3.8+\n* bash 5.0+\n\n\n\nInstallation\n------------\n\nFor stable version:\n\n`pip install zar`\n\nFor current version:\n\n`cd $HOME`\n`git@github.com:zeroincombenze/tools.git`\n`cd $HOME/tools`\n`./install_tools.sh`\n\n\n\nUpgrade\n-------\n\nStable version via Python Package\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n::\n\n pip install --upgrade zar\n\nCurrent version via Git\n~~~~~~~~~~~~~~~~~~~~~~~\n\n::\n\n cd ./tools\n ./install_tools.sh -pUT\n source $HOME/devel/activate_tools\n\n\n\nChangeLog History\n-----------------\n\n2.0.4 (2023-09-08)\n~~~~~~~~~~~~~~~~~~\n\n* [IMP] Backup filestore\n* [FIX] Remote copy to /dev/null\n\n2.0.3 (2023-09-06)\n~~~~~~~~~~~~~~~~~~\n\n* [FIX] DB name with hyphen (-)\n\n2.0.2 (2023-05-14)\n~~~~~~~~~~~~~~~~~~\n\n* [IMP] reassing_owner accept db_port\n\n2.0.1 (2023-02-25)\n~~~~~~~~~~~~~~~~~~\n\n* [IMP] Remote bckdir different from local\n\n2.0.0 (2022-10-20)\n~~~~~~~~~~~~~~~~~~\n\n* [IMP] Stable version\n\n1.3.35.3 (2021-08-13)\n~~~~~~~~~~~~~~~~~~~~~\n\n[FIX] pg_db_active: kill process\n\n\n\nCredits\n=======\n\nCopyright\n---------\n\nSHS-AV s.r.l. <https://www.shs-av.com/>\n\n\nAuthors\n-------\n\n* `SHS-AV s.r.l. <https://www.zeroincombenze.it>`__\n\n\n\nContributors\n------------\n\n* `Antonio M. Vigliotti <info@shs-av.com>`__\n* `Antonio Maria Vigliotti <antoniomaria.vigliotti@gmail.com>`__\n\n\n|\n|\n\n.. |Maturity| image:: https://img.shields.io/badge/maturity-Beta-yellow.png\n :target: https://odoo-community.org/page/development-status\n :alt: \n.. |license gpl| image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg\n :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n :alt: License: AGPL-3\n.. |license opl| image:: https://img.shields.io/badge/licence-OPL-7379c3.svg\n :target: https://www.odoo.com/documentation/user/9.0/legal/licenses/licenses.html\n :alt: License: OPL\n.. |Tech Doc| image:: https://www.zeroincombenze.it/wp-content/uploads/ci-ct/prd/button-docs-2.svg\n :target: https://wiki.zeroincombenze.org/en/Odoo/2.0.4/dev\n :alt: Technical Documentation\n.. |Help| image:: https://www.zeroincombenze.it/wp-content/uploads/ci-ct/prd/button-help-2.svg\n :target: https://wiki.zeroincombenze.org/it/Odoo/2.0.4/man\n :alt: Technical Documentation\n.. |Try Me| image:: https://www.zeroincombenze.it/wp-content/uploads/ci-ct/prd/button-try-it-2.svg\n :target: https://erp2.zeroincombenze.it\n :alt: Try Me\n.. |Zeroincombenze| image:: https://avatars0.githubusercontent.com/u/6972555?s=460&v=4\n :target: https://www.zeroincombenze.it/\n :alt: Zeroincombenze\n.. |en| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/flags/en_US.png\n :target: https://www.facebook.com/Zeroincombenze-Software-gestionale-online-249494305219415/\n.. |it| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/flags/it_IT.png\n :target: https://www.facebook.com/Zeroincombenze-Software-gestionale-online-249494305219415/\n.. |check| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/check.png\n.. |no_check| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/no_check.png\n.. |menu| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/menu.png\n.. |right_do| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/right_do.png\n.. |exclamation| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/exclamation.png\n.. |warning| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/warning.png\n.. |same| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/same.png\n.. |late| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/late.png\n.. |halt| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/halt.png\n.. |info| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/awesome/info.png\n.. |xml_schema| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/certificates/iso/icons/xml-schema.png\n :target: https://github.com/zeroincombenze/grymb/blob/master/certificates/iso/scope/xml-schema.md\n.. |DesktopTelematico| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/certificates/ade/icons/DesktopTelematico.png\n :target: https://github.com/zeroincombenze/grymb/blob/master/certificates/ade/scope/Desktoptelematico.md\n.. |FatturaPA| image:: https://raw.githubusercontent.com/zeroincombenze/grymb/master/certificates/ade/icons/fatturapa.png\n :target: https://github.com/zeroincombenze/grymb/blob/master/certificates/ade/scope/fatturapa.md\n.. |chat_with_us| image:: https://www.shs-av.com/wp-content/chat_with_us.gif\n :target: https://t.me/Assitenza_clienti_powERP",
"bugtrack_url": null,
"license": "Affero GPL",
"summary": "Zeroincombenze Archive Replica",
"version": "2.0.4",
"project_urls": {
"Changelog": "https://github.com/zeroincombenze/tools/blob/master/zar/egg-info/CHANGELOG.rst",
"Documentation": "https://zeroincombenze-tools.readthedocs.io/en/latest/zerobug",
"Source": "https://github.com/zeroincombenze/tools/tree/master/zar"
},
"split_keywords": [
"backup",
"restore",
"replica"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a6a2eac6c68f3513106028d471707ae24ddfd3cf9fbcd8f1a72757a6ba68627f",
"md5": "8293688007fa25d01607747deac62a1d",
"sha256": "ff348aed9680781881a95f09e51e12ab90d2440a694851fd8dd33a181087f65e"
},
"downloads": -1,
"filename": "zar-2.0.4.tar.gz",
"has_sig": false,
"md5_digest": "8293688007fa25d01607747deac62a1d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 23848,
"upload_time": "2023-12-03T13:17:51",
"upload_time_iso_8601": "2023-12-03T13:17:51.499184Z",
"url": "https://files.pythonhosted.org/packages/a6/a2/eac6c68f3513106028d471707ae24ddfd3cf9fbcd8f1a72757a6ba68627f/zar-2.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-03 13:17:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zeroincombenze",
"github_project": "tools",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"lcname": "zar"
}
JSON
