Difference between revisions of "Anything-sync-daemon"

From ArchWiki
Jump to: navigation, search
m (Debug Mode)
(Sync at More Frequent Intervals (Optional): update for systemd)
Line 49: Line 49:
 
  $ asd p
 
  $ asd p
  
=== Sync at More Frequent Intervals (Optional) ===
+
=== Sync at more frequent intervals (optional) ===
  
{{Note|This step is NOT required. '''asd''' will update once per hour on its own.}}
+
The package provided timer syncs once per hour. Users may optionally redefine this behavior simply by [[Systemd#Editing_provided_unit_files|extending the systemd unit]]. The example below changes the timer to sync once every ten minutes:
  
Users wishing to have syncs occur more frequently can simply add a line to the root crontab to call the ''sync'' function of asd like so:
+
{{hc|/etc/systemd/system/asd-resync.timer.d/frequency.conf|<nowiki>
 +
[Unit]
 +
Description=Timer for Arofile-sync-daemon - 10min
  
# crontab -e
+
[Timer]
 +
# Empty value resets the list of timers
 +
OnUnitActiveSec=
 +
OnUnitActiveSec=10min
 +
</nowiki>}}
  
Example syncing targets once every ten minutes:
+
See {{ic|man systemd.timer}} for additional options.
  */10 * * * *    /usr/bin/anything-sync-daemon resync &> /dev/null
 
  
 
== Support ==
 
== Support ==
 
Post in the [https://bbs.archlinux.org/viewtopic.php?id=139141 discussion thread] with comments or concerns.
 
Post in the [https://bbs.archlinux.org/viewtopic.php?id=139141 discussion thread] with comments or concerns.

Revision as of 08:21, 9 August 2014

zh-CN:Anything-sync-daemon

Anything-sync-daemonAUR (asd) is a is a diminutive pseudo-daemon designed to manage target directories in tmpfs and to periodically sync them back to your physical disc (HDD/SSD). This is accomplished via a symlinking step and an innovative use of rsync to maintain back-up and synchronization between the two. One of the major design goals of asd is a completely transparent user experience.

Asd or Psd?

Warning: If syncing browser profiles is desired, it is recommended NOT to use asd for this purpose. Instead, use psd which has built in sanity checks for unique situations specific to running a browser profile in tmpfs. Anything-sync-daemon does not have these checks; under certain circumstances, browser profile data can be lost. You have been warned.

Benefits of Asd

Running this daemon is beneficial for two reasons:

  1. Reduced wear to physical discs
  2. Speed

Since the target directories are relocated into tmpfs, the corresponding onslaught of I/O associated with system usage of them is also redirected from the physical disc to RAM, thus reducing wear to the physical disc and also improving speed and responsiveness. The access time of RAM is on the order of nanoseconds while the access time of physical discs is on the order of milliseconds. This is a difference of six orders of magnitude or 1,000,000 times faster.

Setup and Installation

Anything-sync-daemonAUR is available for download from the AUR. Build it and install like any other package.

Edit /etc/asd.conf

User managed settings are defined in /etc/asd.conf which is included in the package. At a minimum, define the target directory/directories to be managed by asd.

Example:

WHATTOSYNC=('/var/lib/monitorix' '/srv/http' '/foo/bar')

Optionally redefine the location of your distro's tmpfs. Do this by uncommenting and redefining the VOLATILE variable. Note that for Arch Linux, the default value of "/dev/shm" should work just fine. Be sure to read the warning about using software such as bleachbit with asd since bleachbit likes to remove files stored in /tmp. This is why a value of /dev/shm is better.

Optionally redefine the permissions of the link in tmpfs. The default is 700 to protect privacy of users.

Using asd

Do not call /usr/bin/anything-sync-daemon directly (except to view debug mode). The initial synchronization will occur when the daemon starts. Additionally, cron (if running on your system) will call it to sync or update once per hour. Finally, asd will sync back a final time when it is called to stop.

Systemd

The provided daemon file should be used to interact with asd (/usr/lib/systemd/system/asd.service):

# systemctl [option] asd.service

Available options:

start  Turn on daemon; make symlinks and actively manage targets in tmpfs.
stop  Turn off daemon; remove symlinks and rotate tmpfs data back to disc.
enable  Autostart daemon when system comes up.
disable  Remove daemon from the list of autostart daemons.

Preview Mode

The preview option can be called to show users exactly what asd will do based on the /etc/asd.conf entered. Call it like so:

$ anything-sync-daemon preview

or

$ asd p

Sync at more frequent intervals (optional)

The package provided timer syncs once per hour. Users may optionally redefine this behavior simply by extending the systemd unit. The example below changes the timer to sync once every ten minutes:

/etc/systemd/system/asd-resync.timer.d/frequency.conf
[Unit]
Description=Timer for Arofile-sync-daemon - 10min

[Timer]
# Empty value resets the list of timers
OnUnitActiveSec=
OnUnitActiveSec=10min

See man systemd.timer for additional options.

Support

Post in the discussion thread with comments or concerns.