You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@syncope.apache.org by clucgdc <gi...@git.apache.org> on 2017/08/24 15:37:41 UTC
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
GitHub user clucgdc opened a pull request:
https://github.com/apache/syncope/pull/61
SYNCOPE-917 Add tutorial/use-case "Configure a database resource"
SYNCOPE-917 Add tutorial/use-case "Configure a database resource".
Updated from https://cwiki.apache.org/confluence/display/SYNCOPE/Configure+a+Database+resource.
Removed nbactions.xml from PR.
You can merge this pull request into a Git repository by running:
$ git pull https://github.com/clucgdc/syncope 2_0_X
Alternatively you can review and apply these changes as the patch at:
https://github.com/apache/syncope/pull/61.patch
To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:
This closes #61
----
commit 8f34cc38284b13eb702b7cd4513f9baca666cbfa
Author: Cam Luc <cl...@gmail.com>
Date: 2017-08-24T03:58:51Z
SYNCOPE-917 Add tutorial/use-case "Configure a database resource" (Updated from https://cwiki.apache.org/confluence/display/SYNCOPE/Configure+a+Database+resource)
commit 86207a4e184c29eb41b8ab9fd7941e40708cd901
Author: Cam Luc <cl...@gmail.com>
Date: 2017-08-24T15:16:17Z
revert for modification
----
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135190610
--- Diff: src/main/asciidoc/reference-guide/tutorials/configdatabaseresource.adoc ---
@@ -0,0 +1,160 @@
+=== Configure a Database resource
+:hardbreaks:
+
+For Syncope 2.0.x
+
+* Introduction
+* Pre-requisites
+* Configure Database Table connector instance
+* Configure Database Table resource
+* Configure Resource Provision rules
+
+==== Introduction
+
+This tutorial shows all the steps needed to configure an external Database Table resource identified by the following connection parameters:
+
+[cols="2*"]
+|===
+|Host
+|localhost
+
+|Port
+|3306
+
+|User
+|root
+
+|User password
+|password
+
+|JDBC connection URL
+|jdbc:mysql://localhost:3306/demo
+
+|Database
+|demo
+
+|Table
+|test
+|===
+
+==== Pre-requisites
+
+. Download JDBC driver (MySQL JDBC driver in this case) and include it into your JEE container classpath.
+
+. Verify that the bundle exists or https://cwiki.apache.org/confluence/display/SYNCOPE/Install+connector+bundles[Install ConnId Database Table connector bundle]
--- End diff --
The docs in the wiki are old, and applies up to Syncope 1.2. You should link to other parts of this guide, instead.
This sentence becomes then:
```
Verify that the bundle exists or <<install-connector-bundles,install the ConnId Database Table connector bundle>>
```
as https://syncope.apache.org/docs/reference-guide.html#install-connector-bundles is the target link (the part after `#` is the actual link to use in the statement above).
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135969624
--- Diff: src/main/asciidoc/reference-guide/tutorials/tutorials.adoc ---
@@ -17,9 +17,6 @@
// under the License.
//
== Tutorials
+:hardbreaks:
--- End diff --
`:hardbreaks:`
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope issue #61: SYNCOPE-917 Add tutorial/use-case "Configure a database r...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on the issue:
https://github.com/apache/syncope/pull/61
What if you make:
5.1 Working with a database
5.1.1 Configure database resource
5.1.2 Propagate to database resource
5.1.3 Pull from database resource
(and then the same for Active Directory and LDAP)
?
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope issue #61: SYNCOPE-917 Add tutorial/use-case "Configure a database r...
Posted by clucgdc <gi...@git.apache.org>.
Github user clucgdc commented on the issue:
https://github.com/apache/syncope/pull/61
> I think that, after Resource configuration, you should also include an example Pull Task and show an example when users are pulled from the external DB or propagated there after create / update.
It is part of my plan.
5.1. configure database resource (done)
5.2. configure active directory resource (todo)
5.3. configure propagation task (todo)
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope issue #61: SYNCOPE-917 Add tutorial/use-case "Configure a database r...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on the issue:
https://github.com/apache/syncope/pull/61
Hi @clucgdc thanks for this PR.
You need to rename all files with JPG (uppercase) extension to jpg (lowercase), otherwise when building on non-Windows boxes you'll get the following errors:
```
asciidoctor: WARNING: image to embed not found or not readable: /home/ilgrosso/work/syncope/syncope2/src/main/asciidoc/images/configdatabaseresource04.jpg
asciidoctor: WARNING: image to embed not found or not readable: /home/ilgrosso/work/syncope/syncope2/src/main/asciidoc/images/configdatabaseresource05.jpg
asciidoctor: WARNING: image to embed not found or not readable: /home/ilgrosso/work/syncope/syncope2/src/main/asciidoc/images/configdatabaseresource06.jpg
asciidoctor: WARNING: image to embed not found or not readable: /home/ilgrosso/work/syncope/syncope2/src/main/asciidoc/images/configdatabaseresource07.jpg
asciidoctor: WARNING: image to embed not found or not readable: /home/ilgrosso/work/syncope/syncope2/src/main/asciidoc/images/configdatabaseresource08.jpg
asciidoctor: WARNING: image to embed not found or not readable: /home/ilgrosso/work/syncope/syncope2/src/main/asciidoc/images/configdatabaseresource09.jpg
asciidoctor: WARNING: image to embed not found or not readable: /home/ilgrosso/work/syncope/syncope2/src/main/asciidoc/images/configdatabaseresource10.jpg
```
Please note that for the fix above and other observation during review, you should not close this PR and open a new one (as you did with #60): just keep committing and pushing on your own fork, and new commits will be added here.
Once the review will be successfully completed, I'll ask you to squash the commits to keep our history clear.
Thank you again!
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135191006
--- Diff: src/main/asciidoc/reference-guide/tutorials/configdatabaseresource.adoc ---
@@ -0,0 +1,160 @@
+=== Configure a Database resource
+:hardbreaks:
+
+For Syncope 2.0.x
+
+* Introduction
+* Pre-requisites
+* Configure Database Table connector instance
+* Configure Database Table resource
+* Configure Resource Provision rules
+
+==== Introduction
+
+This tutorial shows all the steps needed to configure an external Database Table resource identified by the following connection parameters:
+
+[cols="2*"]
+|===
+|Host
+|localhost
+
+|Port
+|3306
+
+|User
+|root
+
+|User password
+|password
+
+|JDBC connection URL
+|jdbc:mysql://localhost:3306/demo
+
+|Database
+|demo
+
+|Table
+|test
+|===
+
+==== Pre-requisites
+
+. Download JDBC driver (MySQL JDBC driver in this case) and include it into your JEE container classpath.
+
+. Verify that the bundle exists or https://cwiki.apache.org/confluence/display/SYNCOPE/Install+connector+bundles[Install ConnId Database Table connector bundle]
+
+==== Configure Database Table connector instance
+
+The list of all configurable parameters is available at https://connid.atlassian.net/wiki/display/BASE/Database+Table[Database Table Connector Configuration].
+Use this tutorial as reference for your configuration.
+
+. Open browser and access to the Syncope administration console http://host:port/syncope-console
+. Log in with following credentials:
+ Username: admin
+ Password: password
+. Click on Topology side menu. Notice the Syncope node, and the Connector Bundles node connected to the Syncope node.
+. Click on Connector Bundles node. Notice context menu Add new connector.
+
++
+[.text-center]
+image::configdatabaseresource01.jpg[title="Add new connector menu",alt="Add new connector menu"]
+
+. Select Add new connector. New connector modal dialog appears.
+
++
+[.text-center]
+image::configdatabaseresource02.jpg[title="Add new connector dialog",alt="Add new connector dialog"]
+
++
+Provide Display name.
+Location may be different on your environment
+Bundle: net.tirasa.connid.bundles.db.table
+Version may be different on your environment
+
+. Select Next.
+
++
+[.text-center]
+image::configdatabaseresource03.jpg[title="Add new connector continue",alt="Add new connector continue"]
+
++
+Host: localhost
+Port: 3306
+User: root
+User Password: password
+Database: demo
+Table: test
+Key Column: id
+Password Column: password
+JDBC Driver: com.mysql.jdbc.Driver
+JDBC Connection URL: jdbc:mysql://localhost:3306/demo
+Retrieve password: (yes)
+
+. Select Next.
+
++
+[.text-center]
+image::configdatabaseresource04.jpg[title="Add new connector continue",alt="Add new connector continue"]
+
++
+Select needed Capabilities. Refer to https://cwiki.apache.org/confluence/display/SYNCOPE/Connector+instances#Connectorinstances-Create_new_Connector[Connector instance configuration]
--- End diff --
As explained, no wiki links.
Use `connector-instance-details` as explained above.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by clucgdc <gi...@git.apache.org>.
Github user clucgdc commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r136146937
--- Diff: src/main/asciidoc/reference-guide/tutorials/tutorials.adoc ---
@@ -17,9 +17,6 @@
// under the License.
//
== Tutorials
+:hardbreaks:
--- End diff --
This was moved from a child-page of tutorial section up to tutorial main-page. Because tutorial child -pages use a lot of new lines to describe steps, I decided to move it up one level.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135712262
--- Diff: src/main/asciidoc/reference-guide/tutorials/configdatabaseresource.adoc ---
@@ -1,14 +1,7 @@
=== Configure a Database resource
-:hardbreaks:
For Syncope 2.0.x
--- End diff --
Please remove this al well: the Reference Guide is for a specific version of Apache Syncope - currently, 2.0.5-SNAPSHOT
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope issue #61: SYNCOPE-917 Add tutorial/use-case "Configure a database r...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on the issue:
https://github.com/apache/syncope/pull/61
@clucgdc are you still interested? If not, please close this PR as I don't have karma to do that.
---
[GitHub] syncope issue #61: SYNCOPE-917 Add tutorial/use-case "Configure a database r...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on the issue:
https://github.com/apache/syncope/pull/61
Just a few minor changes.
How about my comment above:
> I think that, after Resource configuration, you should also include an example Pull Task and show an example when users are pulled from the external DB or propagated there after create / update.
?
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by clucgdc <gi...@git.apache.org>.
Github user clucgdc commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135875840
--- Diff: src/main/asciidoc/reference-guide/tutorials/tutorials.adoc ---
@@ -17,9 +17,6 @@
// under the License.
//
== Tutorials
+:hardbreaks:
--- End diff --
Which line do you mean?
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope issue #61: SYNCOPE-917 Add tutorial/use-case "Configure a database r...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on the issue:
https://github.com/apache/syncope/pull/61
No updates during the last three months: shall we close this PR?
---
[GitHub] syncope issue #61: SYNCOPE-917 Add tutorial/use-case "Configure a database r...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on the issue:
https://github.com/apache/syncope/pull/61
Hey @clucgdc any news?
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135191229
--- Diff: src/main/asciidoc/reference-guide/tutorials/tutorials.adoc ---
@@ -0,0 +1,25 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+== Tutorials
+
+include::configdatabaseresource.adoc[]
+
+include::configactivedirectoryresource.adoc[]
--- End diff --
Do not include empty files nor include them yet.
Add them as files and reference here only when available, thanks.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by Humbedooh <gi...@git.apache.org>.
Github user Humbedooh closed the pull request at:
https://github.com/apache/syncope/pull/61
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by clucgdc <gi...@git.apache.org>.
Github user clucgdc commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135427190
--- Diff: src/main/asciidoc/reference-guide/tutorials/configdatabaseresource.adoc ---
@@ -0,0 +1,160 @@
+=== Configure a Database resource
+:hardbreaks:
--- End diff --
Which line are you referring to?
Without ":hardbreaks:", sentences on different lines are being collapsed together into a single line
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope issue #61: SYNCOPE-917 Add tutorial/use-case "Configure a database r...
Posted by clucgdc <gi...@git.apache.org>.
Github user clucgdc commented on the issue:
https://github.com/apache/syncope/pull/61
That'd be fine. I'll go with that structure.
5.1 Working with a database
...
5.2 Working with Active Directory
...
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135190937
--- Diff: src/main/asciidoc/reference-guide/tutorials/configdatabaseresource.adoc ---
@@ -0,0 +1,160 @@
+=== Configure a Database resource
+:hardbreaks:
+
+For Syncope 2.0.x
+
+* Introduction
+* Pre-requisites
+* Configure Database Table connector instance
+* Configure Database Table resource
+* Configure Resource Provision rules
+
+==== Introduction
+
+This tutorial shows all the steps needed to configure an external Database Table resource identified by the following connection parameters:
+
+[cols="2*"]
+|===
+|Host
+|localhost
+
+|Port
+|3306
+
+|User
+|root
+
+|User password
+|password
+
+|JDBC connection URL
+|jdbc:mysql://localhost:3306/demo
+
+|Database
+|demo
+
+|Table
+|test
+|===
+
+==== Pre-requisites
+
+. Download JDBC driver (MySQL JDBC driver in this case) and include it into your JEE container classpath.
+
+. Verify that the bundle exists or https://cwiki.apache.org/confluence/display/SYNCOPE/Install+connector+bundles[Install ConnId Database Table connector bundle]
+
+==== Configure Database Table connector instance
+
+The list of all configurable parameters is available at https://connid.atlassian.net/wiki/display/BASE/Database+Table[Database Table Connector Configuration].
+Use this tutorial as reference for your configuration.
+
+. Open browser and access to the Syncope administration console http://host:port/syncope-console
+. Log in with following credentials:
+ Username: admin
+ Password: password
+. Click on Topology side menu. Notice the Syncope node, and the Connector Bundles node connected to the Syncope node.
+. Click on Connector Bundles node. Notice context menu Add new connector.
+
++
+[.text-center]
+image::configdatabaseresource01.jpg[title="Add new connector menu",alt="Add new connector menu"]
+
+. Select Add new connector. New connector modal dialog appears.
+
++
+[.text-center]
+image::configdatabaseresource02.jpg[title="Add new connector dialog",alt="Add new connector dialog"]
+
++
+Provide Display name.
+Location may be different on your environment
+Bundle: net.tirasa.connid.bundles.db.table
+Version may be different on your environment
+
+. Select Next.
+
++
+[.text-center]
+image::configdatabaseresource03.jpg[title="Add new connector continue",alt="Add new connector continue"]
+
++
+Host: localhost
+Port: 3306
+User: root
+User Password: password
+Database: demo
+Table: test
+Key Column: id
+Password Column: password
+JDBC Driver: com.mysql.jdbc.Driver
+JDBC Connection URL: jdbc:mysql://localhost:3306/demo
+Retrieve password: (yes)
+
+. Select Next.
+
++
+[.text-center]
+image::configdatabaseresource04.jpg[title="Add new connector continue",alt="Add new connector continue"]
+
++
+Select needed Capabilities. Refer to https://cwiki.apache.org/confluence/display/SYNCOPE/Connector+instances#Connectorinstances-Create_new_Connector[Connector instance configuration]
+
+. Select Finish.
+
+==== Configure Database Table resource
+
+. Click on newly created Connector. Notice context menu Add new resource / Edit connector / Remove connector.
+. Select Add new resource. New resource modal dialog appears.
+
++
+[.text-center]
+image::configdatabaseresource05.jpg[title="Add new resource dialog",alt="Add new resource dialog"]
+
++
+Provide Key (Unique name to identify a resource)
+Select needed Propagation actions. Refer to http://syncope.apache.org/docs/reference-guide.html#propagationactions[Propagation Actions]
--- End diff --
Link as referenced above.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135445658
--- Diff: src/main/asciidoc/reference-guide/tutorials/configdatabaseresource.adoc ---
@@ -0,0 +1,160 @@
+=== Configure a Database resource
+:hardbreaks:
--- End diff --
Sorry, I was meaning the lines from 2 to 11, which start with `:hardbreaks:`, until before `==== Introduction`
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135190201
--- Diff: src/main/asciidoc/reference-guide/tutorials/configdatabaseresource.adoc ---
@@ -0,0 +1,160 @@
+=== Configure a Database resource
+:hardbreaks:
--- End diff --
There is no need to add such index: AsciiDoctor generates it automatically.
Please remove it.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135714121
--- Diff: src/main/asciidoc/reference-guide/tutorials/tutorials.adoc ---
@@ -17,9 +17,6 @@
// under the License.
//
== Tutorials
+:hardbreaks:
--- End diff --
This is not needed.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---
[GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Posted by ilgrosso <gi...@git.apache.org>.
Github user ilgrosso commented on a diff in the pull request:
https://github.com/apache/syncope/pull/61#discussion_r135190717
--- Diff: src/main/asciidoc/reference-guide/tutorials/configdatabaseresource.adoc ---
@@ -0,0 +1,160 @@
+=== Configure a Database resource
+:hardbreaks:
+
+For Syncope 2.0.x
+
+* Introduction
+* Pre-requisites
+* Configure Database Table connector instance
+* Configure Database Table resource
+* Configure Resource Provision rules
+
+==== Introduction
+
+This tutorial shows all the steps needed to configure an external Database Table resource identified by the following connection parameters:
+
+[cols="2*"]
+|===
+|Host
+|localhost
+
+|Port
+|3306
+
+|User
+|root
+
+|User password
+|password
+
+|JDBC connection URL
+|jdbc:mysql://localhost:3306/demo
+
+|Database
+|demo
+
+|Table
+|test
+|===
+
+==== Pre-requisites
+
+. Download JDBC driver (MySQL JDBC driver in this case) and include it into your JEE container classpath.
+
+. Verify that the bundle exists or https://cwiki.apache.org/confluence/display/SYNCOPE/Install+connector+bundles[Install ConnId Database Table connector bundle]
+
+==== Configure Database Table connector instance
+
+The list of all configurable parameters is available at https://connid.atlassian.net/wiki/display/BASE/Database+Table[Database Table Connector Configuration].
+Use this tutorial as reference for your configuration.
+
+. Open browser and access to the Syncope administration console http://host:port/syncope-console
--- End diff --
It should rather be `protocol://host:port/syncope-console`, according to the rest of this guide
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---