Client Operations
DRLM client operations allow us to add, remove, modify and list clients of database.
Add Client
This command is used to add clients to DRLM database. It is called like this:
~# drlm addclient [options]
If the client you wish to add is online (network reachable), you will only need to set its IP in order to add it to the database. It will then automatically fetch all the required client parameters (hostname, network and MAC address) and save those parameters to database. In the event that the program has not obtained the values correctly, they can be modified with the modclient command explained below.
In this case, the drlm addclient has the following required options:
- -i client_ip, --ipaddr client_ip
Examples:
~# drlm addclient -i 192.168.0.15 ~# drlm addclient -i 192.168.0.15/24
If the drlm addclient does not correctly fetch the client’s hostname, DRLM will asign one automatically or you can set it manually in the same command.
Examples:
~# drlm addclient -i 192.168.0.15 -c rear-debian
- -I, --installclient
If the client is network reachable you can also automatically install the client when is added to DRLM. So in only one command the client is added and installed. Installclient have additional options than you can add behind the -I. For more information about Installclient read the “Install Client” section.
Examples:
~# drlm addclient -i 192.168.0.15/24 -I ~# drlm addclient -i 192.168.0.15/24 -c rear-debian -I ~# drlm addclient -i 192.168.0.15/24 -c rear-debian -I -u root -U http://url.to.rear/download
If the client is not network reachable when you want to register it in the database or you wish to manually enter all the required parameters, you can do it with the required options available:
- -r, --repo
Instead of installing the recommended ReaR package, installs it from the client repositories
- -U url_rear_package, --urlrear url_rear_package
Instead of installing the recommended ReaR package, downloads and installs it from the URL provided
- -c client_name, --client client_name
Set the client’s name.
Note
It is not mandatory, but recommended that the client_name is the same as the client hostname.
- -i ip, --ipaddr ip
Client IP address (not in CIDR notation if you are manually adding all the required parameters).
- -M mac_address, --macaddr mac_address
Client MAC address.
Examples:
~# drlm addclient -c clientHost1 -M 00-40-77-DB-33-38 -i 13.74.90.10 ~# drlm addclient --client clientHost1 --macaddr 00-40-77-DB-33-38 -i 13.74.90.10
Help option:
- -h, --help
Show drlm addclient help.
Examples:
~# drlm addclient -h ~# drlm addclient --help
Install Client
This command is used to install and configure DRLM and ReaR on a remote Server. It is called like this:
~# drlm instclient [options]
The drlm instclient has some requiered options:
- -c client_name, --client client_name
Select Client name to add.
- -I client_id, --id client_id
Client Id.
Additional options:
- -u user, --user user
User with admin privileges to install and configure software
Note
if not user is specified root will be used.
- -r, --repo
Instead of installing the recommended ReaR package, installs it from the client repositories
- -U url_rear_package, --urlrear url_rear_package
rpm or deb package for specific distro. For example http://download.opensuse.org/repositories/Archiving:/Backup:/Rear/Debian_7.0/all/rear_1.17.2_all.deb
Note
If not url is specified will be used the package defined in “REAR DEB PACKAGE URL” section of /usr/share/drlm/conf/default.conf
- -C, --config
ReaR and the required packages for ReaR will not be installed, but the client will be configured. Useful when the client has no connection to the internet or repository.
Examples:
~# drlm instclient -c ReaRCli1 -u admin -U http://download.opensuse.org/repositories/Archiving:/Backup:/Rear/Debian_7.0/all/rear_1.17.2_all.deb ~# drlm instclient -c ReaRCli2 -C ~# drlm instclient -c ReaRCli3
Help option:
- -h, --help
Show drlm instclient help.
Examples:
~# drlm instclient -h
Delete Client
This command is used to delete clients from DRLM database. It is called like this:
~# drlm delclient [options]
The drlm delclient has some required options:
- -c client_name, --client client_name
Select Client to delete by NAME.
- -I client_id, --id client_id
Select Client to delete by ID.
Examples:
~# drlm delclient -c clientHost1 ~# drlm delclient -I 12
Help option:
- -h, --help
Show drlm delclient help.
Examples:
~# drlm delclient -h ~# drlm delclient --help
Modify Client
This command is used to modify clients from DRLM database. It is called like this:
~# drlm modclient [options]
The drlm modclient has some required options:
- -c client_name, --client client_name
Select Client to change by NAME
- -I client_id, --id client_id
Select Client to change by ID
Additional options:
- -i ip, --ipaddr ip
et new IP address to client.
Examples:
~# drlm modclient -c clientHost1 -i 13.74.90.10
- -M mac_address, --macaddr mac_address
Set new MAC address to client.
Examples:
~# drlm modclient -c clientHost1 -M 00-40-77-DB-33-38 ~# drlm modclient -I 12 --macaddr 00-40-77-DB-33-38
- -n network_name, --netname network_name
Assign new NETWORK to client.
Examples:
~# drlm modclient -c clientHost1 -n vlan12 ~# drlm modclient -I 12 --netname vlan12
Help option:
- -h, --help
Show drlm modclient help.
Examples:
~# drlm modclient -h ~# drlm modclient --help
List Clients
This command is used to list the clients stored at the database. It is called like this:
~# drlm listclient [options]
The drlm listclient has some options:
- -c client_name, --client client_name
Select Client to list.
Examples:
~# drlm listclient -c clientHost1 ~# drlm listclient --client clientHost1
- -A, --all
List all clients. This option is set by default if any option is specified.
Examples:
~# drlm listclient ~# drlm listclient -A
- -U, --unsched
List clients that have no scheduled jobs. This option needs to be run together with -A
Examples:
~# drlm listclient -U ~# drlm listclient -AU ~# drlm listclient --all --unsched
- -p, --pretty
Marks those clients that are online with green and those that are offline with red.
Note
This option is enabled by default. It can be disabled by setting DEF_PRETTY=false in /etc/drlm/local.conf.
Examples:
~# drlm listclient -p ~# drlm listclient --pretty --unsched
Help option:
- -h, --help
Show drlm listclient help.
Examples:
~# drlm listclient -h