geode-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Pulkit Chandra (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (GEODE-2052) Docs to segregate types of properties
Date Wed, 02 Nov 2016 12:46:59 GMT

     [ https://issues.apache.org/jira/browse/GEODE-2052?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Pulkit Chandra updated GEODE-2052:
----------------------------------
    Description: 
Geode has a lot of properties. But they are not mentioned in context but rather listed as
geode properties which can go in geode.properties and gfsecurity.properties.

It would nice to have a segregation by Locator and Server under geode.properties. The reason
for this ask is that some properties do not apply to both locator and server. Currently the
only way to know this is by experience or trial and error.

We also found out that some of the gemfire.properties do not get applied when supplied in
geode.properties but rather have to be passed as command line properties. e.g. enabling rest
api.
It would be nice to call that out clearly in docs.

There are example of properties which have to be applied together in order to enable a functionality
e.g. rest api needs bind address property and http-service-port. Its not called out clearly
in the docs that they are *mandatory*. 
[link to docs section](http://geode.incubator.apache.org/docs/guide/rest_apps/setup_config.html)

quote 

```
To enable the developer REST API service in Apache Geode, set the start-dev-rest-api Geode
property to true when starting a data node using either gfsh or the ServerLauncher API. Setting
this property to true on a data node will start up an embedded Jetty server and deploy the
REST developer API WAR file.
```
It should highlight that its necessary to have 2 more properties bind-address and http-service-port
defined to make it work.

We would be happy to provide further details on this matter if needed.

  was:
Geode has a lot of properties. But they are not mentioned in context but rather listed as
geode properties which can go in geode.properties and gfsecurity.properties.

It would nice to have a segregation by Locator and Server under geode.properties. The reason
for this ask is that some properties do not apply to both locator and server. Currently the
only way to know this is by experience or trial and error.

We also found out that some of the gemfire.properties do not get applied when supplied in
geode.properties but rather have to be passed as command line properties. e.g. enabling rest
api.
It would be nice to call that out clearly in docs.

There are example of properties which have to be applied together in order to enable a functionality
e.g. rest api needs bind address property and http-service-port. Its not called out clearly
in the docs that they are *mandatory*. 
[link to docs section](http://geode.incubator.apache.org/docs/guide/rest_apps/setup_config.html)

quote 
```
To enable the developer REST API service in Apache Geode, set the start-dev-rest-api Geode
property to true when starting a data node using either gfsh or the ServerLauncher API. Setting
this property to true on a data node will start up an embedded Jetty server and deploy the
REST developer API WAR file.
```
It should highlight that its necessary to have 2 more properties bind-address and http-service-port
defined to make it work.

We would be happy to provide further details on this matter if needed.


> Docs to segregate types of properties
> -------------------------------------
>
>                 Key: GEODE-2052
>                 URL: https://issues.apache.org/jira/browse/GEODE-2052
>             Project: Geode
>          Issue Type: Improvement
>          Components: docs
>            Reporter: Pulkit Chandra
>
> Geode has a lot of properties. But they are not mentioned in context but rather listed
as geode properties which can go in geode.properties and gfsecurity.properties.
> It would nice to have a segregation by Locator and Server under geode.properties. The
reason for this ask is that some properties do not apply to both locator and server. Currently
the only way to know this is by experience or trial and error.
> We also found out that some of the gemfire.properties do not get applied when supplied
in geode.properties but rather have to be passed as command line properties. e.g. enabling
rest api.
> It would be nice to call that out clearly in docs.
> There are example of properties which have to be applied together in order to enable
a functionality e.g. rest api needs bind address property and http-service-port. Its not called
out clearly in the docs that they are *mandatory*. 
> [link to docs section](http://geode.incubator.apache.org/docs/guide/rest_apps/setup_config.html)
> quote 
> ```
> To enable the developer REST API service in Apache Geode, set the start-dev-rest-api
Geode property to true when starting a data node using either gfsh or the ServerLauncher API.
Setting this property to true on a data node will start up an embedded Jetty server and deploy
the REST developer API WAR file.
> ```
> It should highlight that its necessary to have 2 more properties bind-address and http-service-port
defined to make it work.
> We would be happy to provide further details on this matter if needed.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message