You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@karaf.apache.org by Paul Spencer <pa...@mindspring.com> on 2020/08/21 15:15:18 UTC
The command jdbc:ds-factories is not documented
Karaf 4.2.9
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:
1) Add documentation of jdbc:ds-factories
2) Reference jdbc:ds-factories as the source of driverName and driveClass to the descriptions of the jdbc:ds-create options -dn and -dc
***
* Output of --help and the command
***
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()>
***
* Example of creating a PostgreSQL Datasource named "testdsn for the database "test" on "localhost"
***
karaf@root()> jdbc:ds-create -dn "PostgreSQL JDBC Driver" -url "jdbc:postgresql://localhost:5432/test" --username testuser --password testpwd testdsn
Paul Spencer
Re: The command jdbc:ds-factories is not documented
Posted by Jean-Baptiste Onofre <jb...@nanthrax.net>.
Good catch about command documentation. Can you please create a Jira about that ?
By the way, on the same area (missing documentation), I think karaf debugs is not documented neither, and it should.
Regards
JB
> Le 21 août 2020 à 17:15, Paul Spencer <pa...@mindspring.com> a écrit :
>
> Karaf 4.2.9
>
> 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:
> 1) Add documentation of jdbc:ds-factories
>
> 2) Reference jdbc:ds-factories as the source of driverName and driveClass to the descriptions of the jdbc:ds-create options -dn and -dc
>
>
> ***
> * Output of --help and the command
> ***
> 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()>
>
> ***
> * Example of creating a PostgreSQL Datasource named "testdsn for the database "test" on "localhost"
> ***
> karaf@root()> jdbc:ds-create -dn "PostgreSQL JDBC Driver" -url "jdbc:postgresql://localhost:5432/test" --username testuser --password testpwd testdsn
>
> Paul Spencer
>
>