Re: [teiid-dev] standalone-teiid.xml and docs in general
Yes, using some kind of admin tool is the preferred way. Another reason
it may not be good to edit manually is when the server is running in
domain mode. Using the admin tools will change the configuration on all
or defined server groups by the user. However, if the server is not
running, you can edit the standalone-teiid.xml to make changes to
configuration. Some times it easy to edit this file than using the
tools.
If we use command line then it is Jboss Admin tool (CLI,
jboss-admin.sh), or use the admin-console web app. Right now user can
use the CLI, however for the Web app I just started looking into and we
are way behind its implementation time line. We need a GWT expert to
move this along much faster.
Ramesh..
On Tue, 2011-12-20 at 20:59 -0500, Steven Hawkins wrote:
It's not so much that the docs are referencing the config file in
expecting it to be documented, rather it's the docs describe editing that file (which
is clearly more difficult if all elements/attributes are not present). So what we
actually need to do is modify the documentation to not reference standalone-teiid.xml at
all, but rather how to make modifications through the CLI, correct?
----- Original Message -----
> Steve,
>
> It is not possible to self documenting this file, as this gets
> overwritten every time there is a configuration change. However, the
> configuration elements are forced to have description in the code,
> which
> can be seen by querying the subsystem using CLI. So, any tools
> written
> above the CLI api can get access to this information.
>
> We should remove any references in docs to see this file for
> explanations.
>
> Ramesh..
>
> On Tue, 2011-12-20 at 12:50 -0500, Steven Hawkins wrote:
> > Should the standalone-teiid.xml be self-documenting and include all
> > known elements/attributes? In carrying forward
> > https://issues.jboss.org/browse/TEIID-1873 the security doc
> > reference elements/attributes that aren't in the file.
> >
> > As we are close to our first alpha any help in updating the docs
> > would be great.
> >
> > Steve
> >
> > _______________________________________________
> > teiid-dev mailing list
> > teiid-dev(a)lists.jboss.org
> > https://lists.jboss.org/mailman/listinfo/teiid-dev
>
>
>