Installer Devolutions Server pour Linux

Devolutions Server est disponible pour Linux avec Microsoft Kestrel comme serveur web intégré et Microsoft PowerShell 7 pour l'installation en ligne de commande. La présente rubrique explique comment installer manuellement Devolutions Server pour Linux à l'aide d'invites Bash et de scripts PowerShell, ainsi que comment y accéder et le supprimer.

Alternativement, Devolutions Server peut être installé automatiquement à l'aide des scripts disponibles sur le dépôt Devolutions GitHub ScriptLibrary.

Installation des prérequis

Si Microsoft SQL Server n'est pas déjà installé, exécutez l'invite Bash suivante en remplaçant la variable MSSQL_SA_PASSWORD par un mot de passe fort :

source /etc/os-release
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor --batch --yes -o /usr/share/keyrings/microsoft-prod.gpg
curl -fsSL https://packages.microsoft.com/config/ubuntu/$VERSION_ID/mssql-server-2022.list | sudo tee /etc/apt/sources.list.d/mssql-server-2022.list
sudo apt-get update
sudo apt-get install -y mssql-server
sudo MSSQL_SA_PASSWORD="mystrongpassword" MSSQL_PID="evaluation" /opt/mssql/bin/mssql-conf -n setup accept-eula
sudo /opt/mssql/bin/mssql-conf set sqlagent.enabled true
sudo systemctl restart mssql-server

MSSQL_PID est défini à evaluation dans cet exemple, mais une clé de produit peut être saisie à la place.

Microsoft ne prend en charge que certaines versions de SQL. Consultez la documentation de Microsoft pour vous assurer que votre version de SQL est officiellement prise en charge pour votre distribution.

Exécutez cette invite Bash pour installer PowerShell 7 :

sudo apt-get update
sudo apt-get install -y wget apt-transport-https software-properties-common
source /etc/os-release
wget -q https://packages.microsoft.com/config/ubuntu/$VERSION_ID/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install -y powershell

Assurez-vous que l'installation se déroule dans un répertoire accessible par l'utilisateur actuel, car la commande wget télécharge un paquet .deb dans ce répertoire.

Choisissez d'installer le module Devolutions.PowerShell pour l'utilisateur actuel ou pour tous les utilisateurs.
- Pour l'utilisateur actuel (emplacement : /.local/share/powershell/Modules), exécutez :
  Install-Module -Name 'Devolutions.PowerShell' -Confirm:$False
- Pour tous les utilisateurs (emplacement : /opt/microsoft/powershell/7/Modules), exécutez :
  & sudo pwsh -Command { Install-Module -Name 'Devolutions.PowerShell' -Confirm:$False -Scope 'AllUsers' -Force }
Un avertissement indiquant que l'installation provient d'un dépôt non fiable est susceptible d'apparaître. Le module est hébergé sur PowerShell Gallery, l'emplacement officiel pour héberger les modules PowerShell gérés par Microsoft. Pour éviter cet avertissement à l'avenir, exécutez :
```
Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
```
Bien que cela ne soit pas obligatoire, il est fortement recommandé de créer des utilisateurs et des groupes distincts pour Devolutions Server. Voici une invite Bash permettant de créer un utilisateur et un groupe nommés tous les deux dvls, avec le répertoire d'installation défini à /opt/devolutions/dvls :
```
sudo useradd -N dvls
sudo groupadd dvls
sudo usermod -a -G dvls dvls
# optional, add current user to dvls group
sudo usermod -a -G dvls $(id -un)
sudo mkdir -p /opt/devolutions/dvls
sudo chown -R dvls:dvls /opt/devolutions/dvls
sudo chmod 550 /opt/devolutions/dvls
```

Téléchargement et installation de Devolutions Server pour Linux

Exécutez le script PowerShell ci-dessous pour télécharger la dernière version de Devolutions Server pour Linux et extraire le fichier .tar.gz dans l'emplacement /opt/devolutions/dvls :

$DVLSPath = "/opt/devolutions/dvls"
$DVLSProductURL = "https://devolutions.net/productinfo.htm"

$Result = (Invoke-RestMethod -Method 'GET' -Uri $DVLSProductURL) -Split "`r"

$DVLSLinux = [PSCustomObject]@{
    "Version" = (($Result | Select-String DPSLinuxX64bin.Version) -Split "=")[-1].Trim()
    "URL"     = (($Result | Select-String DPSLinuxX64bin.Url) -Split "=")[-1].Trim()
    "Hash"    = (($Result | Select-String DPSLinuxX64bin.hash) -Split "=")[-1].Trim()
}

$DVLSDownloadPath = Join-Path -Path "/tmp" -ChildPath (([URI]$DVLSLinux.URL).Segments)[-1]

Invoke-RestMethod -Method 'GET' -Uri $DVLSLinux.URL -OutFile $DVLSDownloadPath

& tar -xzf $DVLSDownloadPath -C $DVLSPath --strip-components=1

Remove-Item -Path $DVLSDownloadPath

& sudo pwsh -Command {
  Param(
      $DVLSPath
  )

  chown -R dvls:dvls $DVLSPath
  chmod -R o-rwx $DVLSPath
  chmod 660 (Join-Path -Path $DVLSPath -ChildPath 'appsettings.json')
  chmod 770 (Join-Path -Path $DVLSPath -ChildPath 'App_Data')
  chown -R dvls:dvls $DVLSPath
} -Args $DVLSPath

Set-Location -Path $DVLSPath

Il est préférable que Devolutions Server puisse répondre via TLS. Si un certificat n'existe pas encore, il est possible d'en générer un rapidement à l'aide de cette invite Bash :

cd /opt/devolutions/dvls

openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout cert.key -out cert.crt -subj "/CN=MYHOST" -addext "subjectAltName=DNS:MYHOST"
openssl pkcs12 -export -out cert.pfx -inkey cert.key -in cert.crt -passout pass:

Dans l'exemple ci-dessus, le subjectAltName utilise DNS:. Pour répondre sur une adresse IP uniquement, utilisez IP: à la place.

Notez que le certificat .pfx généré n'a pas de mot de passe.

À l'aide du module Devolutions.PowerShell, exécutez l'installation de Devolutions Server via PowerShell. Assurez-vous de personnaliser les valeurs indiquées ici :

MYHOST
MSSQLHOST
DBUSERNAME
YOURSTRONGPASSWORD
MYEMAIL

Import-Module -Name 'Devolutions.PowerShell'

$DVLSPath = "/opt/devolutions/dvls"
# Modify the $DVLSURI to use 'https' if using SSL
$DVLSURI  = "http://MYHOST:5000/"

$DVLSAdminUsername = 'dvls-admin'
$DVLSAdminPassword = 'dvls-admin'
$DVLSAdminEmail    = 'MYEMAIL'

$Params = @{
    "DatabaseHost"           = "MSSQLHOST"
    "DatabaseName"           = "DSERVER"
    "DatabaseUserName"       = "DBUSERNAME"
    "DatabasePassword"       = "YOURSTRONGPASSWORD"
    "ServerName"             = "DSERVER"
    "AccessUri"              = $DVLSURI
    "HttpListenerUri"        = $DVLSURI
    "DPSPath"                = $DVLSPath
    "UseEncryptedconnection" = $False # Modify as needed
    "TrustServerCertificate" = $False # Modify as needed
    "EnableTelemetry"        = $True # Modify as needed
    "DisableEncryptConfig"   = $True
}

$Configuration = New-DPSInstallConfiguration @Params
New-DPSAppsettings -Configuration $Configuration

$Settings = Get-DPSAppSettings -ApplicationPath $DVLSPath

New-DPSDatabase -ConnectionString $Settings.ConnectionStrings.LocalSqlServer
Update-DPSDatabase -ConnectionString $Settings.ConnectionStrings.LocalSqlServer -InstallationPath $DVLSPath
New-DPSDataSourceSettings -ConnectionString $Settings.ConnectionStrings.LocalSqlServer

New-DPSEncryptConfiguration -ApplicationPath $DVLSPath
New-DPSDatabaseAppSettings -Configuration $Configuration

New-DPSAdministrator -ConnectionString $Settings.ConnectionStrings.LocalSqlServer -Name $DVLSAdminUsername -Password $DVLSAdminPassword -Email $DVLSAdminEmail

Si un certificat a déjà été généré, modifiez le fichier appsettings.json pour permettre à Kestrel de répondre via TLS à l'aide de ce script PowerShell :

Import-Module -Name 'Devolutions.PowerShell'

$DVLSPath = '/opt/devolutions/dvls'

$JSON = Get-Content -Path (Join-Path -Path $DVLSPath -ChildPath 'appsettings.json') | ConvertFrom-JSON -Depth 100

$JSON.Kestrel.Endpoints.Http | Add-Member -MemberType NoteProperty -Name 'Certificate' -Value @{
    'Path'     = (Join-Path -Path $DVLSPath -ChildPath 'cert.pfx')
    'Password' = ''
}

$JSON | ConvertTo-JSON -Depth 100 | Set-Content -Path (Join-Path -Path $DVLSPath -ChildPath 'appsettings.json')

$Settings = Get-DPSAppSettings -ApplicationPath $DVLSPath

$AccessUri = (Get-DPSAccessUri -ConnectionString $Settings.ConnectionStrings.LocalSqlServer).AccessUri
Set-DPSAccessUri -ApplicationPath $DVLSPath -ConnectionString $Settings.ConnectionStrings.LocalSqlServer -AccessURI ($AccessUri -Replace "http","https")

& sudo pwsh -Command {
  Param(
      $DVLSPath
  )

  & chown dvls:dvls (Join-Path -Path $DVLSPath -ChildPath 'cert.pfx')
} -Args $DVLSPath

Pour permettre l'exécution en arrière-plan de Devolutions Server pour Linux, il est recommandé de créer un fichier unit pour systemd via cette invite Bash :

sudo tee /etc/systemd/system/dvls.service > /dev/null <<EOT
[Unit]
Description=DVLS

[Service]
Type=simple
Restart=always
RestartSec=10
User=dvls
ExecStart=/opt/devolutions/dvls/Devolutions.Server
WorkingDirectory=/opt/devolutions/dvls
KillSignal=SIGINT
SyslogIdentifier=dvls
Environment="SCHEDULER_EMBEDDED=true"

[Install]
WantedBy=multi-user.target
Alias=dvls.service
EOT

sudo systemctl daemon-reload

Pour démarrer Devolutions Server, exécutez :
```
sudo systemctl start dvls

# View status
sudo systemctl status dvls
```

Accès à Devolutions Server pour Linux

Par défaut, Devolutions Server pour Linux écoute sur le port 5000 sur l'adresse IP ou le nom d'hôte du système d'installation, ce qui ressemble le plus souvent à : http://MYHOST:5000. Sachez que des erreurs OAuth peuvent survenir au premier lancement lorsque vous tentez d'accéder à Devolutions Server depuis une URL non configurée. Dans ce cas, ajoutez des URI supplémentaires à écouter ou modifiez l'URI principale en exécutant le script suivant dans PowerShell :

Import-Module -Name 'Devolutions.PowerShell'

$DVLSPath = "/opt/devolutions/dvls"

$Settings = Get-DPSAppSettings -ApplicationPath $DVLSPath
$ConnectionString = $Settings.ConnectionStrings.LocalSqlServer

Get-DPSAccessUri -ConnectionString $ConnectionString

Set-DPSAccessUri -ConnectionString $ConnectionString -ApplicationPath $DVLSPath -AccessURI 'http://10.10.0.20:5000/' -AdditionalAccessURIs @('http://ubuntu-2204:5000/')

Si Devolutions Server reste inaccessible depuis l'extérieur du système installé, vérifiez que les ports de pare-feu requis sont ouverts, par exemple en ajoutant Uncomplicated Firewall à l'invite : sudo ufw allow 5000.

Importation de la clé de chiffrement de Devolutions Server

Exportation depuis une installation Windows existante

Import-Module -Name 'Devolutions.PowerShell
$existingDVLSInstance = 'C:\my\path\dvlsInstance\'
$destination = 'C:\other\path\encryption.config'
Export-DPSEncryptionKeys -ApplicationPath $existingDVLSInstance -Destination $destination

Importation vers une nouvelle installation Linux

Import-Module -Name 'Devolutions.PowerShell
$newDvlsInstance = '/home/user/linuxDlvsInstance'
$keysToImport = '/path/to/encryption.config'
Import-DPSEncryptionKeys -ApplicationPath $newDvlsInstance -Filename $keysToImport

Mise à jour de Devolutions Server pour Linux

N'extrayez pas la nouvelle archive .tar.gz directement dans /opt/devolutions/dvls. Cela écraserait appsettings.json et encryption.config, ce qui empêcherait le service de démarrer et pourrait rendre les données existantes indéchiffrables. Suivez toujours la méthode de mise à jour détaillée sur cette page.

Sauvegardez la base de données. Voici comment procéder pour Microsoft SQL Server (Linux ou distant) :
```
/opt/mssql-tools18/bin/sqlcmd -S <MSSQLHOST> -U <DBUSERNAME> -P '<PASSWORD>' -C \
  -Q "BACKUP DATABASE [DSERVER] TO DISK = N'/var/opt/mssql/data/DSERVER-$(date +%F-%H%M).bak' WITH INIT, COMPRESSION;"
```
Le chemin complet vers sqlcmd évite l'erreur "command not found" dans les shells non-login où /etc/profile.d/mssql-tools.sh n'a pas été sourcé.
-C approuve le certificat du serveur (requis pour les installations SQL Server locales utilisant un certificat auto-signé).
Sauvegardez dans un répertoire accessible en écriture par l'utilisateur MSSQL. /var/opt/mssql/data/ fonctionne sans configuration supplémentaire.
Assurez-vous que le fichier .bak existe et n'est pas vide avant de passer à l'étape suivante.
Arrêtez le service Devolutions Server à l'aide du script suivant :
```
sudo systemctl stop dvls.service
sudo systemctl status dvls.service   # confirm inactive (dead)
```
Sauvegardez les fichiers d'installation et de configuration. Gardez à l'esprit que /opt/devolutions/dvls est en mode 550 et appartient à dvls:dvls, par conséquent les cmdlets de sauvegarde doivent être exécutées en tant que root. Démarrez PowerShell avec sudo pwsh, puis collez ce script :
```
Import-Module Devolutions.PowerShell
$DVLSPath        = '/opt/devolutions/dvls'
$BackupBase      = "/var/backups/dvls/$(Get-Date -Format 'yyyy-MM-dd-HHmm')"
$BackupConfig    = Join-Path $BackupBase 'config'
$BackupInstall   = Join-Path $BackupBase 'installation'
mkdir -p $BackupConfig $BackupInstall
Backup-DPSConfigurationFiles -ApplicationPath $DVLSPath -BackupConfigurationPath $BackupConfig
Backup-DPSInstallationFiles  -ApplicationPath $DVLSPath -BackupPath              $BackupInstall
```
- Backup-DPSConfigurationFiles préserve : appsettings.json, web.config et encryption.config.
- Backup-DPSInstallationFiles préserve les dossiers personnalisés, le dossier de détection d'anomalies et tous les actifs ajoutés par l'utilisateur.
Videz le répertoire d'installation à l'exception de App_data, car il contient l'état d'exécution qui survit aux mises à niveau. Utilisez ce script pour le faire :
```
sudo find /opt/devolutions/dvls -mindepth 1 -maxdepth 1 ! -name 'App_Data' -exec rm -rf {} +
sudo tar -xzf /tmp/DVLS.<version>.linux-x64.tar.gz -C /opt/devolutions/dvls --strip-components=1
```
Utilisez --strip-components uniquement si l'archive contient un dossier de premier niveau.
Restaurez la configuration et les données personnalisées. Dans cette étape, appsettings.json (chaîne de connexion à la base de données) et web.config sont replacés dans la nouvelle installation. Étant donné que encryption.config a déjà été préservé dans App_Data/ à l'étape n°5, Restore-DPSConfigurationFiles ne le placera pas à la racine de l'installation car ce n'est pas là où il réside sous Linux. Voici le script de restauration :
```
Restore-DPSCustomFolders            -BackupPath              $BackupInstall -ApplicationPath $DVLSPath
Restore-DPSAnomalyDetectionFolder   -BackupPath              $BackupInstall -ApplicationPath $DVLSPath
Restore-DPSConfigurationFiles       -BackupConfigurationPath $BackupConfig  -ApplicationPath $DVLSPath
```
Récupérez les chaînes de connexion depuis le fichier appsettings.json restauré :
```
$ConnectionString = (Get-DPSAppSettings -ApplicationPath $DVLSPath).ConnectionStrings.LocalSqlServer
Update-DPSDatabase -ConnectionString $ConnectionString -InstallationPath $DVLSPath
```
Update-DPSDatabase n'affiche aucune sortie en cas de succès. Vérifiez que la commande a fonctionné en contrôlant qu'elle a retourné le code de sortie 0 et qu'après le démarrage du service à l'étape n°9, le journal affiche des entrées Migration done with status Done sans lignes [ERR].

Réappliquez la propriété et les autorisations :

sudo chown -R dvls:dvls /opt/devolutions/dvls
sudo chmod 550 /opt/devolutions/dvls
sudo chmod 660 /opt/devolutions/dvls/appsettings.json
sudo chmod 770 /opt/devolutions/dvls/App_Data
# If a certs/ directory is in use:
[ -d /opt/devolutions/dvls/certs ] && sudo chmod 750 /opt/devolutions/dvls/certs

Démarrez le service et vérifiez qu'il fonctionne correctement :

sudo systemctl start dvls.service
sudo systemctl status dvls.service
sudo journalctl -u dvls.service -n 100 --no-pager

Résolution des problèmes

Le service ne démarre pas, appsettings.json est manquant ou vide : restaurez depuis $BackupConfig/appsettings.json, répétez les étapes n°8 et 9.
La connexion fonctionne mais les entrées ne se déchiffrent pas : encryption.config n'a pas été restauré. Copiez $BackupConfig/encryption.config dans $DVLSPath/App_Data/, corrigez les autorisations (chown dvls:dvls et chmod 660), puis redémarrez.
Erreurs de schéma de base de données à l'exécution : Update-DPSDatabase a été ignoré ou a échoué. Répétez l'étape n°7.
Restauration complète : arrêtez le service (voir étape n°3), videz /opt/devolutions/dvls à l'exception de App_Data/ (étape n°5), copiez le contenu de $BackupInstall dans /opt/devolutions/dvls, restaurez appsettings.json depuis $BackupConfig, réappliquez la propriété et les autorisations de l'étape n°8, restaurez la base de données depuis le fichier .bak produit à l'étape n°1, puis redémarrez.

Suppression de Devolutions Server

Pour supprimer Devolutions Server, exécutez l'invite Bash ci-dessous et personnalisez-la pour le système. Ce script s'appuie sur le module PowerShell DbaTools pour faciliter la suppression de la base de données MSSQL. Il suppose que localhost est l'installation MSSQL et dvls le nom de la base de données.

# Remove DVLS on Linux, adjust as necessary
& sudo systemctl stop dvls.service
& sudo rm /etc/systemd/system/dvls.service
& sudo rm -rf /opt/devolutions/dvls
& sudo userdel -r dvls
& sudo groupdel dvls

Import-Module dbatools
$Credential = Get-Credential

Set-DbaToolsInsecureConnection

Remove-DbaDatabase -SqlInstance localhost -SqlCredential $Credential -Database 'dvls' -Confirm:$False

PrécédentIdentifier le serveur qui répond dans une topologie haute disponibilité SuivantLier des comptes dans Devolutions Server

Mis à jour il y a 1 mois

Ce contenu vous a-t-il été utile ?