Commande DSMSTA SETSTORAGESERVER

Editer en ligne

Utilisez l'adresse DSMSTA SETSTORAGESERVER command pour initialiser l'agent de stockage et ajouter des informations de communication au fichier de configuration du périphérique et au fichier d'options de l'agent de stockage dsmsta.opt.

Classe de privilège

Utilisez cet utilitaire sur le système client où l'agent de stockage est installé. Cet utilitaire ne supprime pas les entrées précédentes dans les fichiers. Il ajoute des informations aux fichiers existants. L'option DEVCONFIG, qui définit un nom pour le fichier de configuration de l'appareil, doit figurer dans le fichier dsmsta.opt pour que la commande fonctionne. Voir l' exemple.

Lorsque vous configurez l'agent de stockage à l'aide de la commande DSMSTA SETSTORAGESERVER , utilisez des adresses qui correspondent à la méthode de communication utilisée par le client de sauvegarde et d'archivage. Le client de sauvegarde et d'archivage prend en charge soit IPv4 (COMMMETHOD TCPIP), soit IPv6 (COMMMETHOD V6TCPIP), mais pas les deux en même temps.

Syntaxe

Lire le diagramme syntaxiqueSauter le diagramme syntaxique visuelDSMSTA SETSTORAGESERVERMYName=nom de l'agent de stockageDSMSTA SETSTORAGESERVERMYName=nom de l'agent de stockageMYPAssword=mot de passe de l'agent de stockageMYHLAddress=adresse de l'agent de stockageSERVERName=server_nameSERVERPAssword=mot_de_passe du serveurHLAddress=adresse_tcpip_du_serveurLLAddress=port_tcpip_serveurSTAKEYDBPW=mot_de_passe obfusquéSSL=YES

Paramètres

Tous les paramètres sont obligatoires. Les abréviations autorisées pour les options sont indiquées en lettres majuscules.

Nom de famille
Spécifie le nom de l'agent de stockage. Ce nom est affiché dans la commande SET STANAME qui est insérée dans le fichier de configuration de l'appareil.

Vous devez utiliser le même nom lorsque vous définissez l'agent de stockage en tant que serveur du serveur IBM Storage Protect .

MYPAssword
Spécifie le mot de passe de l'agent de stockage. Cette valeur est cryptée et utilisée dans la commande SET STAPASSWORD qui est insérée dans le fichier de configuration de l'appareil.

Vous devez utiliser le même mot de passe lorsque vous définissez l'agent de stockage en tant que serveur du serveur IBM Storage Protect .

Adresse MYHLA
Indique l'adresse TCP/IP de l'agent de stockage. Cette valeur est utilisée en interne dans la commande SET STAHLADDRESS qui est insérée dans le fichier de configuration de l'appareil.
SERVERNAME
Spécifie le nom du serveur IBM Storage Protect . Ce nom est affiché dans la commande DEFINE SERVER qui est insérée dans le fichier de configuration de l'appareil.
Mot de passe du serveur
Spécifie le mot de passe du serveur. Cette valeur est cryptée et affichée dans le paramètre SERVERPASSWORD de la commande DEFINE SERVER qui est insérée dans le fichier de configuration de l'appareil.
HLAddress
Indique l'adresse TCP/IP du serveur. Cette valeur est utilisée dans le paramètre HLADDRESS de la commande DEFINE SERVER.
LLAddress
Indique le port TCP/IP sur lequel accéder au serveur. Cette valeur est utilisée dans le paramètre LLADDRESS de la commande DEFINE SERVER.
STAKEYDBPW
Spécifie le mot de passe utilisé pour vérifier et contrôler l'accès à la base de données de clés d' SSL. La valeur du paramètre STAKEYDBPW est stockée dans le fichier d'options de l'agent de stockage.
SSL
Indique si l'agent de stockage utilisera le protocole SSL ( SSL ) pour communiquer avec le serveur. La valeur par défaut est NO.
Important :

Gestion des caractères spéciaux dans l'interpréteur de commandes lors de l'utilisation de DSMSTA

Lorsque vous exécutez la DSMSTA commande à partir d'un shell de type Unix ou Linux (par exemple, bash ou ksh), veillez à échapper ou à mettre entre guillemets les arguments contenant des caractères spéciaux. Les shells interprètent les caractères tels que $, @, !, &, et d'autres de manière spécifique, ce qui peut entraîner un comportement inattendu ou des erreurs s'ils ne sont pas gérés correctement.

Pourquoi est-il nécessaire de s'échapper?

Par exemple, dans le mot de passe St0r@93Pr0t3ct$3rv3r, le symbole $ est interprété par l'interpréteur de commandes comme une référence à une variable. S'il n'est pas correctement échappé ou cité, l'interpréteur de commandes tentera de remplacer $3rv3r par la valeur d'une variable de l'interpréteur de commandes nommée 3rv3r, qui n'existe probablement pas. Le mot de passe transmis à la commande est alors incorrect.

Approches recommandées :

Vous pouvez empêcher l'interprétation du shell en utilisant l'une des options suivantes :
  • Guillemets simples (') : Empêche toute interprétation des caractères spéciaux. Par exemple :
    ./dsmsta setstorageserver myname=sta_node mypassword='St0r@93Pr0t3ct$3rv3r'
myhla=10.90.6.56 hla=10.90.5.249 lla=1500 servername=server1
serverpa='P@$$w0rd4TSMserver' ssl=yes
  • Caractères d'échappement (\) : Échappe les caractères spéciaux individuels. Par exemple :
    ./dsmsta setstorageserver myname=sta_node mypassword=St0r@93Pr0t3ct$3rv3r
myhla=10.90.6.56 hla=10.90.5.249 lla=1500 servername=server1
serverpa=P@\$\$w0rd4TSMserver ssl=yes

Meilleure pratique

Utilisez des guillemets simples pour les mots de passe. Si le mot de passe comprend un guillemet simple ('), échappez-le ou utilisez des guillemets doubles pour vous assurer qu'il est traité correctement.

Exemple d'émission de la commande DSMSTA SETSTORAGESERVER

Emettez la commande DSMSTA SETSTORAGESERVER avec les informations suivantes :
  • Agent de stockage
    • Nom : storagnt
    • Mot de passe : fun4me
    • TCP/IP adresse : agent.example.com
Serveur IBM Storage Protect
  • Nom : tsmsrver
  • Mot de passe : not4u
  • TCP/IP adresse : tsmsrver.example.com
  • SSL port : 1542
La commande est la suivante :
dsmsta setstorageserver myname=storagnt mypassword=fun4me
myhladdress=agent.example.com
servername=tsmsrver serverpassword=not4u
   hladdress=tsmsrver.example.com lladdress=1502
La commande génère les lignes suivantes dans le fichier de configuration de l'agent de stockage :
set staname storagnt
set stapassword xxxxx
set stahladdress agent.example.com
define server tsmsrver serverpassword=xxxxxxxx
  hladdress=tsmsrver.example.com lladdress=1502
Les mots de passe (représentés par xxxxxxxx) sont cryptés dans le fichier. La commande génère également la ligne suivante dans le fichier dsmsta.opt pour l'agent de stockage :
servername tsmsrver
Pour activer la communication via le protocole SSL et garantir que l'agent de stockage soit authentifié via un serveur d'annuaire LDAP, exécutez la commande suivante :
dsmsta setstorageserver myname=storagnt mypassword=fun4me
myhladdress=agent.example.com
servername=tsmsrver serverpassword=not4u
ssl=yes
stakeydbpw=password
hladdress=tsmsrver.example.com lladdress=1500
ssltcpport=1543