Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Next revision Both sides next revision
devel:documentation:systems:dev:winrm_connector [2019/06/11 13:21]
kucerar provisioning,operations, powershell 		devel:documentation:systems:dev:winrm_connector [2019/06/14 13:28]
cirkval
Line 1: Line 1:
 ====== WinRM Connector ====== ====== WinRM Connector ======
-This connector can be used to connect to basically to any system which can be managed via powershell commands or some specialized client which can be called from powershell.+Windows Remote Management (WinRM) connector can be used to connect to basically to any system which can be managed via powershell commands or some specialized client which can be called from powershell.
  
 Connector is based on Connid CMD connector. We made fork of CMD connector version 0.4-SNAPSHOT. Connector is based on Connid CMD connector. We made fork of CMD connector version 0.4-SNAPSHOT.
Line 36: Line 36:
 ===== Configuration ===== ===== Configuration =====
 Connector has few settings which need to be configured before you used it. Connector has few settings which need to be configured before you used it.
 +
 +If your connector server is running on Windows then you need to enter "python " before the actual path to script. E.g. "python C:\scripts\homeDir\testDir.py"
  
 === Create script === === Create script ===
Line 98: Line 100:
 | \_\_ACCOUNT\_\_  | CREATE, UPDATE, DELETE, SEARCH  | | \_\_ACCOUNT\_\_  | CREATE, UPDATE, DELETE, SEARCH  |
 | \_\_GROUP\_\_    | NONE                  | | \_\_GROUP\_\_    | NONE                  |
 +
 +===== Installation =====
 +For using this connector you need to install a few things which is needed.
 +  * Install python, tested version is 2.7
 +  * Install pip for managing Python packages - for linux use package managers based on you distribution and install package python-pip. If you are using windows pip will be installed together with python if you use official installator.
 +  * Install pywinrm and dependencies. You can follow official guide https://github.com/diyan/pywinrm Just don't forget to install additional packages if you want use Kerberos or CredSSP authentication. If you are using windows you need to execute only the commands for pip, you don't need to install other system dependencies.
 +
 +Now we have prepared the tool which is used by our connector. Next you need to install java connector server. Connector server is not mandatory but as we wrote in the first section it's recommended to use it.
 +
 +You can download whole bundle with prepared and tested connector server here:<note important>It's not released to public yet</note>
 +
 +Or you can follow this guide and prepare the connector server yourself if you want.
 +This connector is tested in java connector server 1.4.5.1 https://connid.atlassian.net/wiki/spaces/BASE/pages/360458/Downloads#Downloads-JavaConnectorServer
 +and with connector-framework 1.4.3.0
 +
 +Next you will need to add these libraries into lib folder of the connector server:
 +  * jackson-annotations-2.9.8
 +  * jackson-core-2.9.8
 +  * jackson-databind-2.9.8
 +You will probably need to add these libs into classpath in ConnectorServer.sh or ConnectorServer.bat it depends on your OS.
 +
 +Now you can put winrm-connector-0.5.jar to the bundles folder inside connector server and you can start it.
 +
 +Next thing which you need to do is configure WinRM on windows server or check if WinRM is accessible. You can follow steps from out [[tutorial:adm:configuration_-_winrm|tutorial]]