File: //opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/ilo.cpython-310.pyc
o
�N�g�? � @ s� d Z ddlZddlZddlZddlm mZ ddlZ e�
e �Z dd� Z
dd� Zdd� Zd3d
d �Zd4d
d�Zdd� Zdd� Zd5dd�Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Z d&d'� Z d(d)� Z d*d+� Z d,d-� Z d.d/� Z!d6d1d2�Z"dS )7zO
Manage HP ILO
:depends: hponcfg (SmartStart Scripting Toolkit Linux Edition)
� Nc C s t jj�d�r dS dS )z.
Make sure hponcfg tool is accessible
ZhponcfgT)FzGilo execution module not loaded: the hponcfg binary is not in the path.)�salt�utils�path�which� r r �D/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/ilo.py� __virtual__ s r c C s� | � dd�i i}d}tj�td d�}tj�|�s t�|� tj|| t t�
� � dddd ��}|j }|� |� W d
� n1 sAw Y t
d d |� ��}t
d
|� |d dkrv|d �� D ]}|�d�rsd|�d�d i S qadS zLt�d�|d �� dd� ��D ]8}|| � dd� �|jd�r�|| � dd� �|jd t |� |ji� |d7 }q�|| � dd� �|j|ji� q�W |S ty� Y dS w )z
Execute ilom commands
�_� r Zcachedir�tmpz.xml�wF)�dir�prefix�suffix�mode�deleteNz cmd.run_allz hponcfg -f z file.remove�retcode�stderrz
MESSAGE=ZFailed�=���� �stdout� � T)�replace�osr �joinZ__opts__�isdir�mkdir�tempfileZNamedTemporaryFile�str�getpid�name�writeZ__salt__�
splitlines�
startswith�split�ETZ
fromstring�get�tag�updateZattrib� SyntaxError) r" Zxml�retZid_numZtmp_dirZfhZ tmpfilename�cmd�ir r r �
__execute_cmd sJ
� �
�$�
� ��r/ c C � d} t d| �S )zp
Show global settings
CLI Example:
.. code-block:: bash
salt '*' ilo.global_settings
a, <!-- Sample file for Get Global command -->
<RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="x" PASSWORD="x">
<RIB_INFO MODE="read">
<GET_GLOBAL_SETTINGS />
</RIB_INFO>
</LOGIN>
</RIBCL>ZGlobal_Settings�r/ ��_xmlr r r �global_settingsM s
r4 �P c C �2 t � }|d d d | krdS d�| �}td|�S )z�
Configure the port HTTP should listen on
CLI Example:
.. code-block:: bash
salt '*' ilo.set_http_port 8080
�Global Settings� HTTP_PORT�VALUETaS <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<RIB_INFO MODE="write">
<MOD_GLOBAL_SETTINGS>
<HTTP_PORT value="{}"/>
</MOD_GLOBAL_SETTINGS>
</RIB_INFO>
</LOGIN>
</RIBCL>Z
Set_HTTP_Port�r4 �formatr/ ��port�_currentr3 r r r �
set_http_portc �
��
r? � c C r6 )z�
Configure the port HTTPS should listen on
CLI Example:
.. code-block:: bash
salt '*' ilo.set_https_port 4334
r7 r8 r9 TaT <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<RIB_INFO MODE="write">
<MOD_GLOBAL_SETTINGS>
<HTTPS_PORT value="{}"/>
</MOD_GLOBAL_SETTINGS>
</RIB_INFO>
</LOGIN>
</RIBCL>ZSet_HTTPS_Portr: r< r r r �set_https_port� r@ rB c C �, t � } | d d d dkrdS d}td|�S )zl
Enable the SSH daemon
CLI Example:
.. code-block:: bash
salt '*' ilo.enable_ssh
r7 �
SSH_STATUSr9 �YTaU <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<RIB_INFO MODE="write">
<MOD_GLOBAL_SETTINGS>
<SSH_STATUS value="Yes"/>
</MOD_GLOBAL_SETTINGS>
</RIB_INFO>
</LOGIN>
</RIBCL>Z
Enable_SSH�r4 r/ �r> r3 r r r �
enable_ssh� �
rH c C rC )zn
Disable the SSH daemon
CLI Example:
.. code-block:: bash
salt '*' ilo.disable_ssh
r7 rD r9 �NTaT <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<RIB_INFO MODE="write">
<MOD_GLOBAL_SETTINGS>
<SSH_STATUS value="No"/>
</MOD_GLOBAL_SETTINGS>
</RIB_INFO>
</LOGIN>
</RIBCL>Z Disable_SSHrF rG r r r � disable_ssh� rI rK � c C r6 )z
Enable SSH on a user defined port
CLI Example:
.. code-block:: bash
salt '*' ilo.set_ssh_port 2222
r7 ZSSH_PORTr9 TaS <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<RIB_INFO MODE="write">
<MOD_GLOBAL_SETTINGS>
<SSH_PORT value="{}"/>
</MOD_GLOBAL_SETTINGS>
</RIB_INFO>
</LOGIN>
</RIBCL>ZConfigure_SSH_Portr: r< r r r � set_ssh_port� r@ rM c C � d� | �}td|�S )a9
Configure SSH public keys for specific users
CLI Example:
.. code-block:: bash
salt '*' ilo.set_ssh_key "ssh-dss AAAAB3NzaC1kc3MAAACBA... damian"
The SSH public key needs to be DSA and the last argument in the key needs
to be the username (case-senstive) of the ILO username.
a� <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<RIB_INFO MODE="write">
<IMPORT_SSH_KEY>
-----BEGIN SSH KEY-----
{}
-----END SSH KEY-----
</IMPORT_SSH_KEY>
</RIB_INFO>
</LOGIN>
</RIBCL>ZImport_SSH_Publickey�r; r/ )Z
public_keyr3 r r r � set_ssh_key� s
��
rP c C rN )z�
Delete a users SSH key from the ILO
CLI Example:
.. code-block:: bash
salt '*' ilo.delete_user_sshkey damian
aH <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="admin" PASSWORD="admin123">
<USER_INFO MODE="write">
<MOD_USER USER_LOGIN="{}">
<DEL_USERS_SSH_KEY/>
</MOD_USER>
</USER_INFO>
</LOGIN>
</RIBCL>ZDelete_user_SSH_keyrO ��usernamer3 r r r �delete_ssh_key s
��
rS c C r0 )ze
List all users
CLI Example:
.. code-block:: bash
salt '*' ilo.list_users
z�<RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="x" PASSWORD="x">
<USER_INFO MODE="read">
<GET_ALL_USERS />
</USER_INFO>
</LOGIN>
</RIBCL>Z All_usersr1 r2 r r r �
list_users, �
rT c C r0 )zt
List all users in detail
CLI Example:
.. code-block:: bash
salt '*' ilo.list_users_info
z�<RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<USER_INFO MODE="read">
<GET_ALL_USER_INFO />
</USER_INFO>
</LOGIN>
</RIBCL>ZAll_users_infor1 r2 r r r �list_users_infoA rU rV c s4 g d�� d� | |d�� fdd�|D ���}td|�S )a�
Create user
CLI Example:
.. code-block:: bash
salt '*' ilo.create_user damian secretagent VIRTUAL_MEDIA_PRIV
If no permissions are specify the user will only have a read-only account.
Supported privelges:
* ADMIN_PRIV
Enables the user to administer user accounts.
* REMOTE_CONS_PRIV
Enables the user to access the Remote Console functionality.
* RESET_SERVER_PRIV
Enables the user to remotely manipulate the server power setting.
* VIRTUAL_MEDIA_PRIV
Enables the user permission to access the virtual media functionality.
* CONFIG_ILO_PRIV
Enables the user to configure iLO settings.
)Z
ADMIN_PRIVZREMOTE_CONS_PRIVZRESET_SERVER_PRIVZVIRTUAL_MEDIA_PRIVZCONFIG_ILO_PRIVa <RIBCL version="2.2">
<LOGIN USER_LOGIN="x" PASSWORD="y">
<RIB_INFO mode="write">
<MOD_GLOBAL_SETTINGS>
<MIN_PASSWORD VALUE="7"/>
</MOD_GLOBAL_SETTINGS>
</RIB_INFO>
<USER_INFO MODE="write">
<ADD_USER USER_NAME="{0}" USER_LOGIN="{0}" PASSWORD="{1}">
{2}
</ADD_USER>
</USER_INFO>
</LOGIN>
</RIBCL>�
c s( g | ]}|� � � v rd |� � � d��qS )�<z
value="Y" />)�upper)�.0r. �Z_privr r �
<listcomp>� s ( z create_user.<locals>.<listcomp>Z Create_user)r; r r/ )r" �passwordZ
privilegesr3 r r[ r � create_userV s ���
r^ c C rN )zl
Delete a user
CLI Example:
.. code-block:: bash
salt '*' ilo.delete_user damian
a <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<USER_INFO MODE="write">
<DELETE_USER USER_LOGIN="{}" />
</USER_INFO>
</LOGIN>
</RIBCL>Z Delete_userrO rQ r r r � delete_user� �
��
r_ c C rN )z�
Returns local user information, excluding the password
CLI Example:
.. code-block:: bash
salt '*' ilo.get_user damian
a <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<USER_INFO MODE="read">
<GET_USER USER_LOGIN="{}" />
</USER_INFO>
</LOGIN>
</RIBCL>Z User_InforO rQ r r r �get_user� r` ra c C � d� | |�}td|�S )zz
Change a username
CLI Example:
.. code-block:: bash
salt '*' ilo.change_username damian diana
a� <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<USER_INFO MODE="write">
<MOD_USER USER_LOGIN="{0}">
<USER_NAME value="{1}"/>
<USER_LOGIN value="{1}"/>
</MOD_USER>
</USER_INFO>
</LOGIN>
</RIBCL>ZChange_usernamerO )Z old_usernameZ new_usernamer3 r r r �change_username� s
��
rc c C rb )z�
Reset a users password
CLI Example:
.. code-block:: bash
salt '*' ilo.change_password damianMyerscough
aN <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<USER_INFO MODE="write">
<MOD_USER USER_LOGIN="{}">
<PASSWORD value="{}"/>
</MOD_USER>
</USER_INFO>
</LOGIN>
</RIBCL>ZChange_passwordrO )rR r] r3 r r r �change_password� s
��
rd c C r0 )zu
Grab the current network settings
CLI Example:
.. code-block:: bash
salt '*' ilo.network
z�<RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<RIB_INFO MODE="read">
<GET_NETWORK_SETTINGS/>
</RIB_INFO>
</LOGIN>
</RIBCL>ZNetwork_Settingsr1 r2 r r r �network� rU re c C s^ t � }| |d d d v r#||d d d v r#||d d d v r#dS d�| ||�}td|�S ) z�
Configure Network Interface
CLI Example:
.. code-block:: bash
salt '*' ilo.configure_network [IP ADDRESS] [NETMASK] [GATEWAY]
�Network SettingsZ
IP_ADDRESSr9 Z SUBNET_MASKZGATEWAY_IP_ADDRESSTa� <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<RIB_INFO MODE="write">
<MOD_NETWORK_SETTINGS>
<IP_ADDRESS value="{}"/>
<SUBNET_MASK value="{}"/>
<GATEWAY_IP_ADDRESS value="{}"/>
</MOD_NETWORK_SETTINGS>
</RIB_INFO>
</LOGIN>
</RIBCL> ZConfigure_Network)re r; r/ )�ip�netmaskZgateway�currentr3 r r r �configure_network
s
��
rj c C rC )zc
Enable DHCP
CLI Example:
.. code-block:: bash
salt '*' ilo.enable_dhcp
rf � DHCP_ENABLEr9 rE TaX <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<RIB_INFO MODE="write">
<MOD_NETWORK_SETTINGS>
<DHCP_ENABLE value="Yes"/>
</MOD_NETWORK_SETTINGS>
</RIB_INFO>
</LOGIN>
</RIBCL>Z Enable_DHCP�re r/ �ri r3 r r r � enable_dhcp/ rI rn c C rC )ze
Disable DHCP
CLI Example:
.. code-block:: bash
salt '*' ilo.disable_dhcp
rf rk r9 rJ TaW <RIBCL VERSION="2.0">
<LOGIN USER_LOGIN="adminname" PASSWORD="password">
<RIB_INFO MODE="write">
<MOD_NETWORK_SETTINGS>
<DHCP_ENABLE value="No"/>
</MOD_NETWORK_SETTINGS>
</RIB_INFO>
</LOGIN>
</RIBCL>Z Disable_DHCPrl rm r r r � disable_dhcpK rI ro � c C s d� ||| �}td|�S )z�
Configure SNMP
CLI Example:
.. code-block:: bash
salt '*' ilo.configure_snmp [COMMUNITY STRING] [SNMP PORT] [SNMP TRAP PORT]
aF <RIBCL VERSION="2.2">
<LOGIN USER_LOGIN="x" PASSWORD="y">
<RIB_INFO mode="write">
<MOD_GLOBAL_SETTINGS>
<SNMP_ACCESS_ENABLED VALUE="Yes"/>
<SNMP_PORT VALUE="{}"/>
<SNMP_TRAP_PORT VALUE="{}"/>
</MOD_GLOBAL_SETTINGS>
<MOD_SNMP_IM_SETTINGS>
<SNMP_ADDRESS_1 VALUE=""/>
<SNMP_ADDRESS_1_ROCOMMUNITY VALUE="{}"/>
<SNMP_ADDRESS_1_TRAPCOMMUNITY VERSION="" VALUE=""/>
<RIB_TRAPS VALUE="Y"/>
<OS_TRAPS VALUE="Y"/>
<SNMP_PASSTHROUGH_STATUS VALUE="N"/>
</MOD_SNMP_IM_SETTINGS>
</RIB_INFO>
</LOGIN>
</RIBCL>ZConfigure_SNMPrO )Z communityZ snmp_portZ
snmp_trapportr3 r r r �configure_snmpg s
��
rq )r5 )rA )rL )rp rp )#�__doc__�loggingr r Zxml.etree.ElementTreeZetreeZ ElementTreer' Zsalt.utils.pathr � getLogger�__name__�logr r/ r4 r? rB rH rK rM rP rS rT rV r^ r_ ra rc rd re rj rn ro rq r r r r �<module> s:
/
>%