Skip to content

09. Manage hosts and profiles

Ludovic edited this page Dec 5, 2023 · 2 revisions

Manage hosts

  • The MANAGE HOSTS tab's dashboard provides an easy way to monitor hosts packages and update status. Hosts that are registered to Repomanager regulary send their system and packages informations to the server.

    Importing client hosts into Repomanager is possible by using a client side tool like linupdate

https://github.com/lbr38/resources/raw/main/screenshots/repomanager/repomanager-5.png?raw=true https://github.com/lbr38/resources/raw/main/screenshots/repomanager/repomanager-3.png?raw=true

Enable hosts management

From the SETTINGS tab:

  1. Use the slider button to enable Manage hosts then save the configuration. A new MANAGE HOSTS tab will be available.
https://raw.githubusercontent.com/lbr38/resources/main/screenshots/repomanager/documentation/hosts/enable-host-management.png

Register a new host

The host must execute linupdate command line to register to Repomanager. Check linupdate documentation:

  • Install and start using linupdate here
  • Enable reposerver module and register a host using linupdate here

Remove a host

There is two ways to remove a host that was registered to Repomanager:

  • From the host by using linupdate command line. Check linupdate documentation here
  • From Repomanager MANAGE HOSTS tab:
  1. Select the host(s) you want to delete.
  2. Use the Delete button.
https://raw.githubusercontent.com/lbr38/resources/main/screenshots/repomanager/documentation/hosts/delete-host.gif

Notes:

  • A deleted host is marked as deleted in database and is not visible anymore in Repomanager but its data remains.
  • To make a host visible again in Repomanager, it has to register again to Repomanager using linupdate. Check linupdate documentation here

Reset a host

Reseting a host deletes all known data about it.

From the MANAGE HOSTS tab:

  1. Select the host(s) you want to reset.
  2. Use the Reset button.
https://raw.githubusercontent.com/lbr38/resources/main/screenshots/repomanager/documentation/hosts/reset-host.gif

Request a host to execute packages update

From the MANAGE HOSTS tab:

  1. Select the host(s) you want to update.
  2. Use the Update packages button.

(insert gif)


Request a host to send general packages informations

From the MANAGE HOSTS tab:

  1. Select the host(s) you want to update.
  2. Use the General informations button.

(insert gif)


Request a host to send packages informations

From the MANAGE HOSTS tab:

  1. Select the host(s) you want to update.
  2. Use the Packages informations button.

(insert gif)


Manage profiles

  • The MANAGE PROFILES tab provides a way to create and manage configuration profiles for client hosts, including what repositories they should have access to, to update their packages, and what packages they should exclude from their packages updates (e.g. critical packages).

    Deploying profile configuration on client hosts is possible by using a client side tool like linupdate

https://raw.githubusercontent.com/lbr38/resources/main/screenshots/repomanager/documentation/profiles/manage-profiles.png

Enable profile management

From the SETTINGS tab:

  1. Use the slider button to enable Manage profiles then save the configuration. A new MANAGE PROFILES tab will be available.
https://raw.githubusercontent.com/lbr38/resources/main/screenshots/repomanager/documentation/profiles/enable-profile-management.png

Set server profile settings

(needs writing)


Create a new profile

From the MANAGE PROFILES tab:

  1. Use the Create a new profile field to specify a new profile to create.
  2. Once the profile has been created, you can edit its configuration using the Cog icon button.
  3. Define what repositories this profile will have access to, and what packages must be excluded from updates.
  4. Save.
  5. Any client host can now use this profile and retrieve its configuration from it.
https://raw.githubusercontent.com/lbr38/resources/main/screenshots/repomanager/documentation/profiles/create.gif

Duplicate a profile and its configuration

From the MANAGE PROFILES tab:

  1. Use the Duplicate icon button to duplicate a profile and its configuration.
https://raw.githubusercontent.com/lbr38/resources/main/screenshots/repomanager/documentation/profiles/duplicate.gif

Rename a profile

From the MANAGE PROFILES tab:

  1. Click on the profile name you wish to rename and specify a new name.
  2. Press Enter to save.
https://raw.githubusercontent.com/lbr38/resources/main/screenshots/repomanager/documentation/profiles/rename.gif

Delete a profile

From the MANAGE PROFILES tab:

  1. Use the Delete icon button to delete a profile. Client hosts that were using this profile will no longer be able to retrieve any configuration from it.
https://raw.githubusercontent.com/lbr38/resources/main/screenshots/repomanager/documentation/profiles/delete.gif