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/17 11:05]
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.
  
-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 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:
- +
-<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> +
- +
-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. +
- +
-For setting new password for you remote connector use+
 <code> <code>
-./bin/ConnectorServer.sh -setKey -key yourKey -properties conf/connectorserver.properties +su - connector-server 
-</code> +pip install --user pywinrm
- +
- +
-If you want to be able to run connector server as a service follow next steps +
- +
-<code> +
-# create user which we run the connector server +
-useradd connector-server +
- +
-#create file +
-/etc/systemd/system/java-connector-server.service +
- +
-# content of the file, change path according where you have your connector server +
-[Unit] +
-Description=Java Connector Server Service +
-[Service] +
-User=connector-server +
-WorkingDirectory=/opt/connid-connector-server +
-ExecStart=/bin/bash /opt/connid-connector-server/bin/ConnectorServer.sh -run -properties /opt/connid-connector-server/conf/connectorserver.properties +
-SuccessExitStatus=143 +
-[Install] +
-WantedBy=multi-user.target +
- +
-# Reload and enable deamon +
-systemctl daemon-reload +
-systemctl enable java-connector-server+
  
-# Use this to start/stop/status +#those only if you need them 
-systemctl start java-connector-server +pip install --user pywinrm[kerberos] 
-systemctl stop java-connector-server +pip install --user pywinrm[credssp]
-systemctl status java-connector-server+
 </code> </code>
 +</note>
  
-Now you can put winrm-ad-connector-1.0.1.jar to the bundles folder inside connector server and you can start 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 is strongly recommended.
  
-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]]+  - Follow [[devel:documentation:systems:dev:remote-connector|this howto]] to install remote connector server as a service. 
 +  - Put ''winrm-ad-connector-1.0.1.jar'' to the ''bundles'' folder inside connector server installation and restart the connector server. 
 +  - Configure WinRM on windows server or check if WinRM is accessible. You can follow steps from our [[tutorial:adm:configuration_-_winrm|tutorial]].
  
 ===== Configuration ===== ===== Configuration =====
  • by kotynekv