Resource control
Resource control
The geo-redundancy server requires a separate installation and configuration for its services. Authentication and access authorization for this service are managed by API keys and access control lists (ACLs). There are two distinct use cases:
– Simple data redundancy between sites
– Hosting of data redundancy across sites
In the first case, the SERVERware will be in production on the primary site and the recovery site will be connected to the geo-redundancy server with a administrator API key. The administrator will have access to all the data on the Geo-Redundancy Server and will be able to perform recoveries from any site of any VPS replicated to the default or chosen partition.
For the second case, SERVERware on the main site will be connected to the geo-redundancy server with a user API key, and the recoveries will be handled by the host provider. The hosting provider will provide the credentials and the IP address for the GRS (Geo-Redundancy Server).
The replication service is managed via a command-line tool called swrepl-adm.
Here is how to access it:
- Open an SSH client such as Putty
- In the field Hostname, enter the IP address of the host system (for example, 232.123.44.108).
- Set the port number to 2222 and click the button Open to initiate the connection.
- The default login credentials are root for the user and serverware for the password.
Once connected to your server, you can use the CLI commands to manage the geo-redundancy service.
If you deploy a mirror/cluster configuration of storage servers, use a floating IP so that the SSH client connects to any server in primary state. The replication storage must be located on the storage host in the NETSTOR pool. The Geo-Redundancy server storage should only be considered as a pool with SSD storage.
███████╗██╗ ██╗ ██╗ ██╗ ██╔════╝██║ ██║ ██║ ██║ ███████╗██║ █╗ ██║█████╗███████║ ╚════██║██║███╗██║╚════╝╚════██║ ███████║╚███╔███╔╝ ██║ ╚══════╝ ╚══╝╚══╝ ╚═╝ * SERVERware system IP Address/es: * 127.0.0.1/x 192.168.x.x/x 10.1.x.x/x 192.168.x.x/x * Login into the setup by visiting: * https://127.0.0.1:81/ * https://192.168.x.x:81/ * https://10.1.x.x:81/ * https://192.168.x.x:81/ ~ # - Begin by using the SWREPL application by running the following command:
swrepl-adm swrepl-adm is the application that allows you to manage the replication service (create a site, manage resources, etc.)
The swrepl-adm console will open in the terminal and you can begin creating a site for replication.
Here is the list of commands supported by swrepl-adm:
- site add followed by the arguments below:
-storage [STOCKAGE] -quota [QUOTA] -throttle [BANDE PASSANTE] -admin [true/false] -allowedips [IP AUTORISEES] "description du site" [DESCRIPTION]
This command allows you to add a replication site with a description, an optional storage quota, a bytes-per-second limit, and the allowed IP addresses (by default, all).
-allowedips allows you to specify, in quotes, the list of IPs or subnets separated by commas in CIDR format, for example, "192.168.1.10, 10.1.0.0/16, 2001:db8:a0b:12f0::1/32".
the default value 0.0.0.0/0 in the list means that everything is allowed.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
site update followed by the arguments below:
-storage [STOCKAGE] -quota [QUOTA] -throttle [BANDE PASSANTE] -admin [true/false] -allowedips [IP AUTORISEES] "description du site" [DESCRIPTION]
Updates the replication site with a description, an optional storage quota, a bytes-per-second rate limit, and the allowed IP addresses (the default value allows all addresses).
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
site list [id] allows you to list the replication sites.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
site remove [-force] [id] allows you to delete a replication site.
- replication list [id]Displays the list of all replications defined for this daemon.
- replication helpDisplays help.
- public_key- Displays its own rsa public key.
- admin_key - Displays or allows editing of the administrator's API key.
- task list[-l, -t backup] [id] List tasks, showing *unique id* and other settings.
-l - Limit list size (default is 10, 0 for unlimited)
-t <type> - filter tasks of specific type backup,replication or srv_backup,srv_repl
-r <replid> - filter task from specific replication
-c <cycleid> - filter tasks of specific replication cycle
id - id of task for detailed output - task cancel[id] Cancel task by its id
- task count[-t replication] Count of tasks, with out arguments show global count of all tasks
-t <type> - count tasks of specific type backup,replication or srv_backup,srv_repl
-r <replid> - count task from specific replication
-c <cycleid> - count tasks of specific replication cycle

