You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@geode.apache.org by "Karen Smoler Miller (JIRA)" <ji...@apache.org> on 2018/05/29 17:57:00 UTC

[jira] [Assigned] (GEODE-4726) Documentation is misleading with a multi-homed Geode cluster

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

Karen Smoler Miller reassigned GEODE-4726:
------------------------------------------

    Assignee: Karen Smoler Miller

> Documentation is misleading with a multi-homed Geode cluster
> ------------------------------------------------------------
>
>                 Key: GEODE-4726
>                 URL: https://issues.apache.org/jira/browse/GEODE-4726
>             Project: Geode
>          Issue Type: Bug
>          Components: configuration, docs
>            Reporter: Kyle R Dunn
>            Assignee: Karen Smoler Miller
>            Priority: Major
>              Labels: pull-request-available
>          Time Spent: 1h
>  Remaining Estimate: 0h
>
> The necessary step for binding Geode to an arbitrary network interface (e.g. {{eth2}}), is not clearly documented.  A multi-homing scenario (i.e. several non-loopback NICs) is quite common.
> The {{server-bind-address=w.x.y.z}} parameter appears to have no effect on the interface used by the server process;  however passing {{bind-address=w.x.y.z}} to the server startup produces the correct startup behavior.  The documentation around this is a bit misleading.
> The symptom was a startup hang, ultimately timing out, like the following:
> {code:bash}
> [info 2018/02/22 13:13:29.134 MST server1 <main> tid=0x1] Attempting to join the distributed system through coordinator 172.16.139.1(locator1:70192:locator)<ec><v0>:1024 using address 192.168.0.29(server1:70198):1024
> {code}
> The following script was used successfully on Mac OS to bind to the "last" interface listed by ifconfig (vmnet8).
> {code:bash}
> #!/bin/bash
> rm -rf locator1 server1
> export GEODE_HOME=/opt/pivotal-gemfire-9.3.0
> export CLASSPATH=${GEODE_HOME}/lib/gemfire-greenplum-3.1.1.jar
> gfsh <<EOF
> start locator --name=locator1 --locators=172.16.139.1[10334] --bind-address=172.16.139.1 --port=10334 --include-system-classpath
> start server --name=server1 --start-rest-api=true --http-service-port=28080  --locators=172.16.139.1[10334] --bind-address=172.16.139.1 --cache-xml-file=../config/ggc_cache.xml --classpath=${CLASSPATH} --include-system-classpath
> EOF
> {code}
> The contents of {{ggc_cache.xml}} is below.
> {code:xml}
> <?xml version="1.0" encoding="UTF-8"?>
> <cache xmlns="http://geode.apache.org/schema/cache"
>   xmlns:gpdb="http://schema.pivotal.io/gemfire/gpdb"
>   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
>   xsi:schemaLocation="http://geode.apache.org/schema/cache
>   http://geode.apache.org/schema/cache/cache-1.0.xsd
>   http://schema.pivotal.io/gemfire/gpdb
>   http://schema.pivotal.io/gemfire/gpdb/gpdb-2.4.xsd"
>   version="1.0">
>     <disk-store name="pdx_meta_data"/>
>     <pdx read-serialized="true" persistent="true" disk-store-name="pdx_meta_data"/>
>     
>     <jndi-bindings>
>       <jndi-binding jndi-name="DemoDatasource" type="SimpleDataSource"
>           jdbc-driver-class="org.postgresql.Driver" user-name="gpadmin"
>           password="supersecret" connection-url="jdbc:postgresql://172.16.139.132:5432/gemfire_db">
>       </jndi-binding>
>     </jndi-bindings>
>     <region name="TestData" refid="PARTITION">
>     </region>
>     <region name="CustDim" refid="PARTITION">
>           <gpdb:store datasource="DemoDatasource">
>           <gpdb:types>
>               <gpdb:pdx name="com.aexp.gemfire.demo.entity.Customer"
>                   schema="public"
>                   table="cust_dim">
>                   <gpdb:id field="id" />
>                   <gpdb:fields>
>                       <gpdb:field name="id" column="id" class="java.lang.String" />
>                       <gpdb:field name="Name" class="java.lang.String" />
>                       <gpdb:field name="income" class="java.lang.Double" />
>                   </gpdb:fields>
>               </gpdb:pdx>
>           </gpdb:types>
>           </gpdb:store>
>     </region>
>     <!-- I put the following in as place mark to talk about enabling GemFire to watch
>     and make sure the system doesn't run out of memory -->
>     <resource-manager critical-heap-percentage="80" eviction-heap-percentage="75"/>
>   
>     <gpdb:gpfdist port="3333" />
> </cache>
> {code}



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)