Fork me on GitHub

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Previous revision
install [2019/10/09 20:04]
install [2020/05/13 09:28] (current)
henri
Line 1: Line 1:
 +====== LBackup Installation Overview ======
  
 +  * [[source|LBackup source]] is [[Operating System Specific Builds|easily installable]] on a variety of *NIX systems. ​
 +  ​
 +  * For administrators of Mac OS X systems, there is a [[install#​mac_os_x_download|.pkg installer package]].
 +      * Build v0.9.8r5 or later is required for Mac OS 10.11 (El Capitan) with root less enabled.
 +
 +  * For administrators of Debian based systems there is a [[install#​debian_installation|.deb package installer]].
 +  ​
 +  * Once LBackup is installed, you may then [[configuring_a_basic_backup|configure and run a basic backup]].
 +
 +  * If you wish to run the //latest os x alpha build// (including the latest features) then <​html><​!--subscribe to the [[mailing lists|LBackup announcements mailing list]]--></​html>​ [[http://​www.lbackup.org/​download/​latest_alpha_release/​|download now]] or build it your self from the [[source]].
 +
 +  * Should you have questions or comments then please subscribe and post a message to the [[mailing lists|LBackup discussion mailing list]].
 +
 +\\ 
 +
 +[[screencasts|{{screencast_logo_small_padding.png|}}]]\\
 +  * //Visit the [[screencasts|screencasts page]] to visually learn how to install and configure LBackup//
 +\\ 
 +
 +
 +
 +
 +
 +====== Download ======
 +
 +===== Mac OS X Download =====
 +
 +/*
 +
 +[[http://​lucidsystems.org/​download/​utilities/​LBackup.zip|{{download_lbackup.png|Download}}]]
 +  - [[http://​lucidsystems.org/​download/​utilities/​LBackup.zip|Download LBackup Installer]].
 +  - [[http://​lucidsystems.org/​download/​utilities/​rsync.zip|Download RSync]]. //(Only required for the backup of Mac OS 10.3.9 and earlier)//
 +*/
 +
 +[[http://​www.lucid.systems/​download/​lbackup|{{download_lbackup.png|Download}}]]
 +  - [[http://​www.lucid.systems/​download/​lbackup|Download LBackup Installer]].
 +  - [[http://​www.lbackup.org/​download/​rsync.zip|Download RSync]]. **//(Only required for the backup of Mac OS 10.3.9 and earlier)//​**
 +[[http://​www.gnu.org/​copyleft/​gpl.html|{{download_gnugpl_v3.png|GNU GPL v3}}]]
 +
 +
 +
 +\\ 
 +
 +====== Installation ======
 +
 +
 +
 +===== Mac OS X Installation =====
 +
 +  - [[Unzipping the Download|Unzip]]. //(It may have been unzipped by your browser automatically)//​
 +  - [[Mounting the DMG Image|Mount disk image]]. //(This step may happen automatically)//​
 +  - Install the LBackup using the package installer, located within the disk image. ​
 +  - [[developer:​rsync_hfs|Download,​ compile and install rsync3]] //​(Recommended for Mac OS 10.4.7 and later)//
 +  - [[upgrading_lbackup|Check for any upgrade procedures.]] //(Only if you are upgrading from an earlier version)//
 +  - Begin the [[install#​configuration|configuration process]] or [[upgrading_lbackup|upgrade procedures]].
 +\\ 
 +
 +
 +
 +\\
 +
 +===== Debian Installation =====
 +
 +The following installation instructions also apply to Debian derivatives (eg. Ubuntu) which support dpkg and apt.
 +
 +  - [[known issues|Read about known issues]].
 +  - [[upgrading_lbackup|Check for any upgrade procedures.]] //(Only if you are upgrading from an earlier version)//
 +  - Install LBackup by issuing the following commands from a root shell : <​file>​
 +cd /tmp
 +apt-get update
 +apt-get install rsync wget dpkg
 +wget http://​www.lbackup.org/​download/​lbackup.deb -O lbackup.deb
 +dpkg -i lbackup.deb
 +</​file>​
 +\\ 
 +
 +/*wget http://​www.lucidsystems.org/​download/​utilities/​lbackup_deb_installers -O lbackup.deb*/​
 +
 +  * If your system is behind an http proxy, you should enter the command below prior to running the wget command listed above. Replace the username, password, proxyserveraddress and proxyport with the varibles which are appropriate for your network : <​file>​
 +export http_proxy=http://​username:​password@proxyserveraddress:​proxyport
 +</​file>​
 +
 +
 +
 +\\
 +
 +===== Other Operating Systems =====
 +
 +The LBackup team welcomes installers for other operating systems. If you have created an installer for LBackup please consider [[contribute|submitting]] it to the [[http://​www.lucidsystems.org/​contact/​|LBackup project]]. Alternatively,​ to request an installer for a specific operating system, please [[http://​www.lucidsystems.org/​lucidcontact.php|click here]]. If you need to run LBackup on your *NIX based operating system right now, then you can [[lbackup_source_code|install LBackup from the source code.]]
 +
 +\\ \\
 +
 +\\ \\
 +
 +====== Configuration ======
 +
 +Once LBackup is installed, these instructions will help you get your backup working.
 +
 +  - [[permissions|Check drive permissions]] and [[access control lists|ACL volume settings]]. //(Only if you are running Mac OS X)//
 +  - Create your backup configuration. //​([[configuring_a_basic_backup|Get started quickly]] by coping the '/​lbackup/​example_backup_config'​ directory)//​
 +  - [[usage|Run LBackup]] //(eg. '/​usr/​local/​sbin/​lbackup /​path/​to/​configuration/​file.conf'​)//​
 +  - Test the manual backup.
 +  - Test the automated backup is working as expected.
 +  - The [[lbackup|LBackup documentation]] provides further details regarding the various configuration options.
 +\\ \\ 
 +
 +====== Installation Notes ======
 +\\
 +
 +===== Mac OS X Installer =====
 +
 +==== LBackup ====
 +
 +Before you install LBackup. Please ensure that your system meets the [[requirements]].
 +\\ \\
 +
 +Once the LBackup installer download has completed, double click the installer package from the mounted disk image in the the finder and follow the prompts. You should then have successfully installed LBackup. ​
 +\\
 +<​sub>​If you have disabled "open safe downloads automatically"​ in Safari, or if you are using another browser you may need to unzip the installer and mount the disk image manually.</​sub>​
 +\\ \\
 +
 +
 +Once LBackup has been successfully installed, there will be a folder called "​lbackup"​ located within the root directory of your file system. Within the "​lbackup"​ folder there is an example configuration folder. ​
 +\\ \\
 +
 +Next step : [[configuring_a_basic_backup|configure and run a basic backup]].
 +
 +\\ \\ 
 +
 +
 +
 +==== RSync ====
 +
 +=== MacOS 10.14.x ===
 +The version of rsync that ships with macOS 10.14 is very broken. You are best to compile your self or to install via a package management system such as [[http://​brew.sh|brew]],​ [[http://​macports.com|MacPorts]] etc. Using the bundled version of rsync on 10.14 is not supported.
 +
 +Also, at this stage due to SIP now protecting even files in the users home directory. The easiest way to complete a local backup of a home folder on a system with SIP enabled is to [[network_backup|backup over SSH]] (which bypasses all the SIP protection) because full disk access to rsync when granted because it is started via SSH. For now 10.14 provides full disk access to the SSH executable and as such any process started via SSH. The other easy option is to disable SIP entirely. However, there are benefits to SIP ; as such  backing up via loop back address (127.0.0.1) over SSH is recommended. If you are backing up clients over the [[network_backup|network via SSH]] then this is not an issue as rsync will be granted full disk access.
 +
 +More details relating to SIP and LBackup are availble from the [[developer/​dealing_with_sip|dealing with SIP developer page]].
 +
 +=== MacOS 10.6.x , 10.7.x and 10.8.x ===
 +
 +The latest version of LBackup supports rsync version 3. This version of rsync supports the preservation of various Mac OS meta data. In addition, if compiled with some patches even more meta data is able to be preserved. Rsync v3 is recommended if you are running Mac OS 10.4.7 or later, including Mac OS 10.6.x, 10.7.x or 10.8.x. Rsync version 3 is not installed on these versions of OS X by default. However, on modern systems which run these later operating systems, rsync is very quick to compile. Instructions relating to compiling [[developer:​rsync_hfs|rsync version 3 with various Mac OS X meta data patches]] is available within the [[:​developer|developer section]]. ​
 +
 +<​html><​!--</​html>​
 +Under Snow Leopard (Mac OS 10.6.x) there is an issue with rsync hanging. You can resolve this issue by setting the Terminal Application to run in 32 bit mode. You may do this from the GetInfo window in the Finder.
 +
 +<​html><​center></​html>​{{terminal_enable_32_bit_mode.png|}}<​html></​center></​html>​
 +<​html>​--></​html>​
 +
 +=== Mac OS 10.5.x ===
 +
 +The latest version of LBackup supports rsync version 3. This version of rsync supports the preservation of various Mac OS meta data. In addition, if compiled with some patches even more meta data is able to be preserved. Rsync v3 is recommended if you are running Mac OS 10.4.7 or later, including Mac OS 10.5.x. Rsync version 3 is not installed on Mac 10.5.x by default. However, on modern systems is very quick to compile. Instructions for compiling [[developer:​rsync_hfs|rsync version 3 with various Mac OS X meta data patches]] is available in the [[:​developer|developer section]]. ​
 +
 +=== Mac OS 10.4.x ===
 +
 +As of LBackup version 0.9.8q5 the standard version or rsync which ships with 10.4.x or later. However, it is recommended that if you are running Mac OS 10.4.7 or a later version of Mac OS X Tiger, that you upgrade to the latest version of LBackup and [[developer:​rsync_hfs|compile and install rsync version 3]]. 
 +
 +=== Mac OS 10.3.x ===
 +LBackup has been extensively tested on OS X with a [[http://​lucidsystems.org/​download/​utilities/​rsync.zip|patched version of RSync]]. This is well suited if you are backing up to or from a machine running Mac OS 10.3.9 or earlier. ​
 +
 +=== Mac OS 10.2.x ===
 +If you are backing up to or from a machine running an Mac OS 10.2.9 or earlier then it is recommended that you use either the patched version of of RSync, compile one your yourself, or use [[http://​archive.macosxlabs.org/​rsyncx/​rsyncx.html|RSyncX]].
 +
 +
 +\\ \\
 +Ensure that whichever version of RSync which you use will copy the meta data you need to preserve.
 +\\ \\
 +====== Quick Download Links ======
 +  * [[Quick Download Links#Mac OS X|Mac OS X]]
 +  * [[http://​www.lbackup.org/​download/​lbackup.deb|Debian Install]] (.deb)
 +  * [[http://​aur.archlinux.org/​packages/​lbackup/​lbackup.tar.gz|Arch Linux]] //(Install Script Bundle)//