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/19 05:28]
kucerar fixes, added more info to installation part 		devel:documentation:adm:systems:winrm_ad_connector [2019/10/17 11:05]
fiserp [Installation]
Line 125: Line 125:
   * 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 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. +
-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. +
- +
-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+
 <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