Mailing-List: contact dev-help@syncope.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@syncope.apache.org
From: ilgrosso <git@git.apache.org>
To: dev@syncope.apache.org
Reply-To: dev@syncope.apache.org
References: <git-pr-61-syncope@git.apache.org>
In-Reply-To: <git-pr-61-syncope@git.apache.org>
Subject: [GitHub] syncope pull request #61: SYNCOPE-917 Add tutorial/use-case "Configure a dat...
Content-Type: text/plain
Message-Id: <20170825062802.AE77DE96B4@git1-us-west.apache.org>
Date: Fri, 25 Aug 2017 06:28:02 +0000 (UTC)
archived-at: Fri, 25 Aug 2017 06:28:05 -0000

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.
---