[jboss-jira] [JBoss JIRA] Created: (AS7-1164) add jdbc-driver : documentation incomplete or misleading

[Heiko Rupp (JIRA)]

add jdbc-driver : documentation incomplete or misleading
--------------------------------------------------------

                 Key: AS7-1164
                 URL: https://issues.jboss.org/browse/AS7-1164
             Project: Application Server 7
          Issue Type: Bug
          Components: Domain Management
    Affects Versions: 7.0.0.CR1
            Reporter: Heiko Rupp


I want to add a jdbc driver to a profile. The driver has been uploaded to /deployment
[domain at localhost:9999 subsystem=datasources] pwd
/profile=default/subsystem=datasources
[domain at localhost:9999 subsystem=datasources] ./jdbc-driver=postgres9:add(driver-name=postgres9,deployment-name=postgresql-9.0-801.jdbc4.jar,driver-class-name=org.postgresql.Driver)
{
    "outcome" => "failed",
    "failure-description" => {"domain-failure-description" => "Operation handler failed: java.util.NoSuchElementException: No child 'driver-module-name' exists"},
    "rolled-back" => true
}

Documentation says:

[domain at localhost:9999 jdbc-driver=h2] :read-operation-description(name=add)                 
{
    "outcome" => "success",
    "result" => {
        "operation-name" => "add",
        "description" => "Adds a new JDBC driver service",
        "attributes" => {
            "driver-name" => {
                "description" => "The symbolic name of this driver used to reference it in the register",
                "type" => STRING,
                "required" => true
            },
            "deployment-name" => {
                "description" => "The name of the deployment unit from which the driver was loaded, if it was loaded from a deployment",
                "type" => STRING
            },
            "driver-module-name" => {
                "description" => "The name of the module from which the driver was loaded, if it was loaded from the module path",
                "type" => STRING
            },
            "module-slot" => {
                "description" => "The slot of the module from which the driver was loaded, if it was loaded from the module path",
                "type" => STRING
            },
            "driver-class-name" => {
                "description" => "The fully qualified class name of the driver's implementation of java.sql.Driver",
                "type" => STRING
            },
            "driver-major-version" => {
                "description" => "The driver's major version number",
                "type" => INT
            },
            "driver-minor-version" => {
                "description" => "The driver's minor version number",
                "type" => INT
            },
            "jdbc-compliant" => {
                "description" => "Whether or not the driver is JDBC compliant",
                "type" => BOOLEAN
            }
        }
    }
}


Here, only the driver-name is required.
For driver-module-name it says "if loaded from module", which I read as "optional".
Obviously from above error message, this is not optional


--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira