]>
Commit | Line | Data |
---|---|---|
04e24b14 DW |
1 | Managing Remotes |
2 | ================ | |
3 | ||
4 | :term:`Remote` | |
5 | -------------- | |
6 | ||
7 | A remote refers to a separate Proxmox Backup Server installation and a user on that | |
8 | installation, from which you can `sync` datastores to a local datastore with a | |
9 | `Sync Job`. You can configure remotes in the web interface, under **Configuration | |
10 | -> Remotes**. Alternatively, you can use the ``remote`` subcommand. The | |
11 | configuration information for remotes is stored in the file | |
12 | ``/etc/proxmox-backup/remote.cfg``. | |
13 | ||
14 | .. image:: images/screenshots/pbs-gui-remote-add.png | |
15 | :align: right | |
16 | :alt: Add a remote | |
17 | ||
18 | To add a remote, you need its hostname or ip, a userid and password on the | |
19 | remote, and its certificate fingerprint. To get the fingerprint, use the | |
20 | ``proxmox-backup-manager cert info`` command on the remote, or navigate to | |
21 | **Dashboard** in the remote's web interface and select **Show Fingerprint**. | |
22 | ||
23 | .. code-block:: console | |
24 | ||
25 | # proxmox-backup-manager cert info |grep Fingerprint | |
26 | Fingerprint (sha256): 64:d3:ff:3a:50:38:53:5a:9b:f7:50:...:ab:fe | |
27 | ||
28 | Using the information specified above, you can add a remote from the **Remotes** | |
29 | configuration panel, or by using the command: | |
30 | ||
31 | .. code-block:: console | |
32 | ||
33 | # proxmox-backup-manager remote create pbs2 --host pbs2.mydomain.example --userid sync@pam --password 'SECRET' --fingerprint 64:d3:ff:3a:50:38:53:5a:9b:f7:50:...:ab:fe | |
34 | ||
35 | Use the ``list``, ``show``, ``update``, ``remove`` subcommands of | |
36 | ``proxmox-backup-manager remote`` to manage your remotes: | |
37 | ||
38 | .. code-block:: console | |
39 | ||
40 | # proxmox-backup-manager remote update pbs2 --host pbs2.example | |
41 | # proxmox-backup-manager remote list | |
42 | ┌──────┬──────────────┬──────────┬───────────────────────────────────────────┬─────────┐ | |
43 | │ name │ host │ userid │ fingerprint │ comment │ | |
44 | ╞══════╪══════════════╪══════════╪═══════════════════════════════════════════╪═════════╡ | |
45 | │ pbs2 │ pbs2.example │ sync@pam │64:d3:ff:3a:50:38:53:5a:9b:f7:50:...:ab:fe │ │ | |
46 | └──────┴──────────────┴──────────┴───────────────────────────────────────────┴─────────┘ | |
47 | # proxmox-backup-manager remote remove pbs2 | |
48 | ||
49 | ||
50 | .. _syncjobs: | |
51 | ||
52 | Sync Jobs | |
53 | --------- | |
54 | ||
55 | .. image:: images/screenshots/pbs-gui-syncjob-add.png | |
56 | :align: right | |
57 | :alt: Add a Sync Job | |
58 | ||
59 | Sync jobs are configured to pull the contents of a datastore on a **Remote** to | |
60 | a local datastore. You can manage sync jobs under **Configuration -> Sync Jobs** | |
61 | in the web interface, or using the ``proxmox-backup-manager sync-job`` command. | |
62 | The configuration information for sync jobs is stored at | |
63 | ``/etc/proxmox-backup/sync.cfg``. To create a new sync job, click the add button | |
64 | in the GUI, or use the ``create`` subcommand. After creating a sync job, you can | |
65 | either start it manually on the GUI or provide it with a schedule (see | |
66 | :ref:`calendar-events`) to run regularly. | |
67 | ||
68 | .. code-block:: console | |
69 | ||
70 | # proxmox-backup-manager sync-job create pbs2-local --remote pbs2 --remote-store local --store local --schedule 'Wed 02:30' | |
71 | # proxmox-backup-manager sync-job update pbs2-local --comment 'offsite' | |
72 | # proxmox-backup-manager sync-job list | |
73 | ┌────────────┬───────┬────────┬──────────────┬───────────┬─────────┐ | |
74 | │ id │ store │ remote │ remote-store │ schedule │ comment │ | |
75 | ╞════════════╪═══════╪════════╪══════════════╪═══════════╪═════════╡ | |
76 | │ pbs2-local │ local │ pbs2 │ local │ Wed 02:30 │ offsite │ | |
77 | └────────────┴───────┴────────┴──────────────┴───────────┴─────────┘ | |
78 | # proxmox-backup-manager sync-job remove pbs2-local | |
79 | ||
80 |