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:adm:systems:winrm_ad_connector [2019/09/11 11:27]
kucerar setting key 		devel:documentation:adm:systems:winrm_ad_connector [2019/10/08 13:11]
fiserp [Installation]
Line 120: Line 120:
  
 ===== Installation ===== ===== Installation =====
-For using this connector you need to install a few things which is needed.+For using WinRM part of this connector you need to install a few things which is needed, otherwise you can skip these steps.
   * Install python, tested version is 2.7   * 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 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.   * 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.
 +
 +<note tip>Better way to install python packages through ''pip'' is to **not** install them system-wide. Create user for the connector server (see later on this page) and install packages only for this user. This ensures stability (system-wide updates do not change versions, thus cannot break your connector) and isolation from the rest of the OS (''pip'' does not accidentally break OS-provided libraries). To install what you need, just issue:
 +<code>
 +su - connector-server
 +pip install --user pywinrm
 +
 +#those only if you need them
 +pip install --user pywinrm[kerberos]
 +pip install --user pywinrm[credssp]
 +</code>
 +</note>
  
 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. 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.
  
 <note>Configure log rotation for connector server log file</note> <note>Configure log rotation for connector server log file</note>
-You can download whole bundle with prepared and tested connector server here:<note important>It's not released to public yet</note>+You can download whole bundle with prepared and tested connector server https://git.bcvsolutions.eu/modules/connector-server/tree/develop 
 +<note important>It's private at this time</note>
  
 Or you can follow this guide and prepare the connector server yourself if you want. Or you can follow this guide and prepare the connector server yourself if you want.
Line 139: Line 151:
   * jackson-databind-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. You will probably need to add these libs into classpath in ConnectorServer.sh or ConnectorServer.bat it depends on your OS.
 +
 +Next it's good to do some more configuration as setting new password for connector server and create new user under which the connector server will be started.
  
 For setting new password for you remote connector use For setting new password for you remote connector use
  • by kotynekv