[ 
https://issues.apache.org/jira/browse/KARAF-6821?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17191015#comment-17191015
 ] 

ASF subversion and git services commented on KARAF-6821:
--------------------------------------------------------

Commit a0931de8d1365e1cfaa40cd0de614a34e73886ea in karaf's branch 
refs/heads/karaf-4.2.x from jbonofre
[ https://gitbox.apache.org/repos/asf?p=karaf.git;h=a0931de ]

[KARAF-6821] Document jdbc:ds-factories command

(cherry picked from commit a31bd27a2baf9fff5dbbab9b5cf34ff495dad7c2)


> Command jdbc:ds-factories is not documented
> -------------------------------------------
>
>                 Key: KARAF-6821
>                 URL: https://issues.apache.org/jira/browse/KARAF-6821
>             Project: Karaf
>          Issue Type: Documentation
>          Components: karaf
>    Affects Versions: 4.2.9
>         Environment: Karaf 4.2.9
>            Reporter: Paul Spencer
>            Assignee: Jean-Baptiste Onofré
>            Priority: Major
>             Fix For: 4.3.0, 4.2.10
>
>
> The command jdbc:ds-factories is not documented. This is important because 
> the command exposes the driverName and driveClass needed by the 
> jdbc:ds-create command.
> The current documentation uses a Derby database which has an obvious 
> driverName. The PostgreSQL driver name is not obvious and finding the name 
> can be a source of frustration for new users.
>  # Suggestions:
>  Add documentation of jdbc:ds-factories
>  # Reference jdbc:ds-factories as the source of driverName and driveClass to 
> the descriptions of the jdbc:ds-create options -dn and -dc
> h3. Output of --help and the command
> {quote}karaf@root()> jdbc:ds-factories --help
>  DESCRIPTION
>      jdbc:ds-factories
>     List the JDBC DataSourceFactories
> SYNTAX
>      jdbc:ds-factories
> karaf@root()>
> karaf@root()> jdbc:ds-factories
>  Name │ Class │ Version │ Registration bundle
>  
> ───────────────────────┼────────────────────────────────────────┼───────────────────────┼───────────────────────────────
>  derby-native │ org.apache.derby.jdbc.AutoloadedDriver │ 
> 10.14.2000000.1828579 │ derby [246]
>  derby │ org.apache.derby.jdbc.EmbeddedDriver │ │ org.ops4j.pax.jdbc.derby 
> [247]
>  PostgreSQL JDBC Driver │ org.postgresql.Driver │ 42.2.8 │ 
> org.postgresql.jdbc42 [159]
>  karaf@root()>
> {quote}
> h3. Example of creating a PostgreSQL Datasource named "testdsn for the 
> database "test" on "localhost"
> {quote}karaf@root()> jdbc:ds-create -dn "PostgreSQL JDBC Driver" -url 
> "jdbc:postgresql://localhost:5432/test" --username testuser --password 
> testpwd testdsn
> {quote}



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

Reply via email to