\documentclass{report}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage{geometry}
\geometry{top=15mm, bottom=15mm, left=1cm, right=1cm}
\usepackage[french]{babel}
\usepackage{pslatex}
\usepackage[colorlinks=true,urlcolor=black]{hyperref}
\usepackage{graphicx}
\usepackage{fancyhdr}
\pagestyle{fancy}
\renewcommand{\footrulewidth}{0.4pt}
\fancyfoot[L]{Uubu.fr}
\fancyfoot[R]{lun. nov. 14 17:59:34 CET 2016}
\lfoot{\Large \textit{Uubu.fr}}
\hypersetup{pdfinfo={
Title={iscsiadm},
Author={Sylvain Girod},
Creator={Bash script from uubu.fr's format version 1},
Producer={Bash script and PDFLaTeX},
Subject={Utilitaire d'administration open-iscsi},
CreationDate={D:20161114175934},
ModDate={D:20161114175934},
Keywords={iSCSI;storages}
}}
\begin{document}
 
\begin{center}
{\Huge iscsiadm }
\end{center}
\vspace{1cm}
 
\begin{flushleft}
 
{\large Utilitaire d'administration open-iscsi}
 
\vspace{10mm}
 
\vspace{1cm}{\huge Description }
 
\
 
\hspace{1mm}  iscsiadm permet de découvrir et se connecter à des targets iSCSI, accéder et gérer la base de donnée open-iscsi. Open-iscsi n'utilise pas le terme de nœud tel que définis dans la RFC iSCSI, où un nœud est un simple initiateur ou target iSCSI. Il utilise le terme de nœud pour référer à un portail dans une target. Pour le mode session, un sid (session id) est utilisé. Il peut être affiché avec iscsiadm -m session -P 1.
\vspace{5mm} \\
 
 
\vspace{1cm}{\huge OPTIONS }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} -a, --ip=ipaddr]{(sous-mode ping). ipv4 ou ipv6}
\item[\hspace{1mm} -A, --portal\_type=\texttt{[}ipv4|ipv6\texttt{]}]{(sous-mode flashnode du mode host et seulement avec l'opération new) Spécifie le type de portail pour la nouvelle entrée de nœud flash à créer.}
\item[\hspace{1mm} -b, --packetsize=packetsize]{(sous-mode ping) Taille de paquet ping}
\item[\hspace{1mm} -c, --count=count]{(sous-mode ping) nombre d'itérations ping}
\item[\hspace{1mm} -C, --submode=op]{Spécifie le sous-mode pour mode. op doit être le nom d'un sous-mode}
\item[\hspace{1mm} -d, --debug=debug\_level]{Mode debug, de 0 à 8}
\item[\hspace{1mm} -H, --host=\texttt{[}hostno|MAC\texttt{]}]{Spécifie l'hôte SCSI à utiliser pour l'opération. Peut être un numéro d'hôte iscsi assigné à l'hôte par la couche scsi du kernel, ou l'adresse MAC d'un hôte scsi}
\item[\hspace{1mm} -i, --interval=interval]{(sous-mode ping) interval entre les itérations ping}
\item[\hspace{1mm} -I, --interface=\texttt{[}iface\texttt{]}]{Interface iSCSI à utiliser pour l'opération. les interfaces iSCSI sont définies dans /etc/iscsi/ifaces. pour (modes discovery, node et iface) iSCSI hardware (qla4xxx), la configuration iface doit avoir l'adresse hardware (iface.hwaddress = adresse MAC du port) et le driver/transport\_name (iface.transport\_name). Le nom de l'interface est le nom du fichier de configuration iface. Pour iSCSI logiciel, la configuration doit avoir soit l'adresse hardware (iface.hwaddress) ou le nom de l'interface de la couche réseau (iface.net\_ifacename) et doit avoir le driver/transport\_name.}
\item[\hspace{1mm} -k, --killiscsid=\texttt{[}priority\texttt{]}]{Actuellement la priorité doit être 0. Celà va immédiatement stopper toutes les opértions iscsid et stopper iscsid. Il ne déconnecte aucune session. Équivalent à killall iscsid.}
\item[\hspace{1mm} -D, --discover]{(mode discovery) Découvre les targets en utilisant la découverte avec le recid correspondant au type de découverte et portail spécifiés. S'il n'y a pas d'enregistrement découvert, il est créé en utilisant les paramètres de découvertes dans iscsid.conf. Doit être passé en mode discoverydb pour instruire iscsiadm d'effectuer la découverte.}
\item[\hspace{1mm} -L, --loginall=\texttt{[}all|manual|automatic\texttt{]}]{(mode node) Login pour toutes les sessions avec le nœud ou les valeurs conn passée à toute session en cours, excepté celles marquées onboot.}
\item[\hspace{1mm} -m, --mode op]{Spécifie le mode. (discovery, discoverydb, node, fw, host iface ou session)}
\item[\hspace{1mm} -n, --name=name]{(mode node) spécifie un nom de champ dans un enregistrement. en sous-mode flashnode du mode host, spécifie le nom d'un paramètre du nœud flash. À utiliser avec l'opérateur update}
\item[\hspace{1mm} -o, --op=op]{Spécifie un opérateur de base de données}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} new, delete, update, show, nonpersistent]{Pour tous les modes excepté fw.}
\item[\hspace{6mm} apply et apllyall]{mode iface}
\item[\hspace{6mm} login et logout]{sous-mode flashnode}
\item[\hspace{6mm} delete]{ne devrait pas être utilisé sur une session en cours. delete supprime un recid spécifié. En mode discovery, si iscsiadm effectue un découverte il supprime les enregistrements pour les portals qui ne sont plus retournés.}
\item[\hspace{6mm} new]{créé un nouvel enregistrement de bas pour un objet donné. En mode node, recid est le nom target et portal (IP:port). En mode iface, recid est le nom iface. En mode discovery, recid est le type portal et discovery. En mode session, new logs dans une nouvelle session en utilisant le même nœud et informations iface que la session spécifiée}
\item[\hspace{6mm} update]{Met à jours le recid avec le nom à la valeur spécifiée. En mode discovery, si iscsiadm effectue une découverte, recid, name et value ne sont pas nécesaires. update opère sur les portails retournées par les targets, et met à jours les enregistrements de nœud avec les informations du fichier de configuration et de la ligne de commande.}
\item[\hspace{6mm} show]{défaut pour les modes node, discovery et iface. Également utiisés s'il n'y a pas de commandes passées dans le mode session et qu'un sid est passé. name et value sont ignorés}
\item[\hspace{6mm} nonpersistent]{Instruit iscsiadm de ne pas manipuler la base}
\item[\hspace{6mm} apply]{Les paramètres réseaux prennent effet sur l'iface spécifié}
\item[\hspace{6mm} applyall]{Les paramètres réseaux prennent effet sur tous les ifaces dont l'adresse MAC ou le numéro d'hôte correspond.}
\item[\hspace{6mm} login]{se log dans l'entrée de nœud flash spécifié}
\item[\hspace{6mm} logout]{Se déconnecte de l'entrée de nœud flash spécifié}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} -p, --portal=ip\texttt{[}:port\texttt{]}]{(mode discovery ou pour les opérations node) Utilise le portail spécifié. défaut pour port: 3260.}
\item[\hspace{1mm} -P, --print=printlevel]{(mode node) affiche les nœud en arborescence.}
\item[\hspace{1mm} -T, --targetname=targetname]{Utilise la target spécifiée}
\item[\hspace{1mm} -r, --sid=sid | sysfsdir]{Utiliser le sid spécifié, ou utilise le chemin sysfs (ex: /sys/devices/platform/hostH/sessionS/targetH:B:I/H:B:I:L)}
\item[\hspace{1mm} -R, --rescan]{(mode session) si le sid est également passé, rescan la session, sinon rescan toutes les sessions courantes.}
\item[\hspace{1mm} -s, --stats]{Affiche des statistiques de session ou d'hôte.}
\item[\hspace{1mm} -S, --show]{(mode node et session) En affichant les enregistrements, ne cache pas les valeurs masquée, comme le secret CHAP}
\item[\hspace{1mm} -t, --type=type]{Doit être sendtargets (ou st), slp, isns ou fw (non supporté).}
\item[\hspace{1mm} -u, --logout]{(mode node et session) déconnection du record spécifié}
\item[\hspace{1mm} -U, --logoutall=\texttt{[}all,manual,automatic\texttt{]}]{déconnection de toutes les sessions avec le nœud ou les valeurs conn startup passé, ou toutes les sessions en cours, excepté celles marquée onboot.}
\item[\hspace{1mm} -v, --value=value]{Spécifie une valeur à utiliser avec l'opérateur update}
\item[\hspace{1mm} -x, --index=index]{index de l'entité sur laquelle opérer}
\end{description}
 
\vspace{1cm}{\huge Types de découverte }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} SendTargets]{protocole iSCSI natif qui permet à chaque target iSCSI d'envoyer une liste de targets disponibles à l'initiateur.}
\item[\hspace{1mm} SLP]{Optionnellement, un target iSCSI peut utiliser SLP pour annoncer la disponibilité des targets.}
\item[\hspace{1mm} iSNS]{iSNS enregistre les informations d'enregistrement sur les volumes de stockage dans un grand réseau.}
\item[\hspace{1mm} fw]{De nombreux NIC et systèmes contiennent un mini initiateur iSCSI à utiliser au boot.}
\end{description}
 
\vspace{1cm}{\huge Codes de sortie }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} 0]{ISCSI\_SUCCESS - commande réussie}
\item[\hspace{1mm} 1]{ISCSI\_ERR - Code d'erreur générique}
\item[\hspace{1mm} 2]{ISCSI\_ERR\_SESS\_NOT\_FOUND - session non trouvée}
\item[\hspace{1mm} 3]{ISCSI\_ERR\_NOMEM - impossible d'allouer des ressource pour l'opération}
\item[\hspace{1mm} 4]{ISCSI\_ERR\_TRANS - Problème de connexion}
\item[\hspace{1mm} 5]{ISCSI\_ERR\_LOGIN - erreur de login}
\item[\hspace{1mm} 6]{ISCSI\_ERR\_IDBM - Erreur d'accès/gestion DB}
\item[\hspace{1mm} 7]{ISCSI\_ERR\_INVAL - argument invalide}
\item[\hspace{1mm} 8]{ISCSI\_ERR\_TRANS\_TIMEOUT - timer de connexion expiré}
\item[\hspace{1mm} 9]{ISCSI\_ERR\_INTERNAL - Erreur internel iscsi/kernel}
\item[\hspace{1mm} 10]{ISCSI\_ERR\_LOGOUT - erreur de déconnexion}
\item[\hspace{1mm} 11]{ISCSI\_ERR\_PDU\_TIMEOUT - iSCSI PDU timedout}
\item[\hspace{1mm} 12]{ISCSI\_ERR\_TRANS\_NOT\_FOUND - module de transport iSCSI non chargé dans le kernel}
\item[\hspace{1mm} 13]{ISCSI\_ERR\_ACCESS - problème de permission d'accès iscsid ou de la commande iscsiadm}
\item[\hspace{1mm} 14]{ISCSI\_ERR\_TRANS\_CAPS - le module transport ne supporte pas l'opération}
\item[\hspace{1mm} 15]{ISCSI\_ERR\_SESS\_EXISTS - le session est connectée}
\item[\hspace{1mm} 16]{ISCSI\_ERR\_INVALID\_MGMT\_REQ - requête IPC MGMT invalide}
\item[\hspace{1mm} 17]{ISCSI\_ERR\_ISNS\_UNAVAILABLE - service iSNS non supporté}
\item[\hspace{1mm} 18]{ISCSI\_ERR\_ISCSID\_COMM\_ERR - une lecture/écriture iscsid a échoué}
\item[\hspace{1mm} 19]{ISCSI\_ERR\_FATAL\_LOGIN - erreur de connection iSCSI fatal}
\item[\hspace{1mm} 20]{ISCSI\_ERR\_ISCSID\_NOTCONN - Connection à iscsid impossible}
\item[\hspace{1mm} 21]{ISCSI\_ERR\_NO\_OBJS\_FOUND - records/targets/sessions/portals non trouvé}
\item[\hspace{1mm} 22]{ISCSI\_ERR\_SYSFS\_LOOKUP - recherche dans sysfs impossible}
\item[\hspace{1mm} 23]{ISCSI\_ERR\_HOST\_NOT\_FOUND - recherche d'hôte impossible}
\item[\hspace{1mm} 24]{ISCSI\_ERR\_LOGIN\_AUTH\_FAILED - login failed, problème d'autorisation}
\item[\hspace{1mm} 25]{ISCSI\_ERR\_ISNS\_QUERY - requête iSNS échoué}
\item[\hspace{1mm} 26]{ISCSI\_ERR\_ISNS\_REG\_FAILED - enregistrement/désenregistrement iSNS échoué}
\end{description}
 
\vspace{1cm}{\huge Exemples }
 
\
 
\hspace{1mm} Découvrir les target à une ip donnée \\
\hspace{1mm} \textbf{iscsiadm --mode discoverydb --type sendtargets --portal 192.168.1.10 --discover} \\
\hspace{1mm} login, doit utiliser un enregistrement de node trouvé par la découverte \\
\hspace{1mm} \textbf{iscsiadm --mode node --targetname iqn.2001-05.com.doe:test --portal 192.168.1.1:3260 --login} \\
\hspace{1mm} logout \\
\hspace{1mm} \textbf{iscsiadm --mode node --targetname iqn.2001-05.com.doe:test --portal 192.168.1.1:3260 --logout} \\
\hspace{1mm} lister les enregistrements de nœuds \\
\hspace{1mm} \textbf{iscsiadm --mode node} \\
\hspace{1mm} Afficher toutes les données pour un enregistrement nœud donné \\
\hspace{1mm} \textbf{iscsiadm --mode node --targetname iqn.2001-05.com.doe:test --portal 192.168.1.1:3260} \\
 
\vspace{1cm}{\huge Fichiers }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} /etc/iscsi/iscsid.conf]{Fichier de configuration lu par iscsid et iscsiadm au démarrage}
\item[\hspace{1mm} /etc/iscsi/initiatorname.iscsi]{fichier contenant les initiatorname et initiatoralias iSCSI lu par iscsid et iscsiadm au démarrage}
\item[\hspace{1mm} /etc/iscsi/nodes/]{Base de configuration persistante Open-iSCSI}
\item[\hspace{1mm} /etc/iscsi/send\_targets]{Répertoire contenant les portails}
\end{description}
\end{flushleft}
\end{document}
