Issue GLASSFISH-17356 reports the following errors and omissions in the JNDI chapter of the Application Development Guide:
Additionally, actual documentation is poor and has many errors.
In http://docs.oracle.com/cd/E18930_01/html/821-2418/beans.html#beanv and http://download.oracle.com/docs/cd/E18930_01/html/821-2418/beans.html the examples presents typo erros resulting in badly formatted XML.
In reference http://glassfish.java.net/javaee5/ejb/EJB_FAQ.html, the doc looks like a bit clearer. Otherwise, in section "What is the relationship between @EJB and ejb-ref/ejb-local-ref?" it gives hints about the relationship between @EJB and ejb-ref but is unclear about the relationship with jndi-name inside glassfish-web.xml.
What is preferred to make remote invocation? lookup name inside web.xml or jndi-name inside glassfish-web.xml? What are the differences between these strategies?
I couldn't make work any of these alternatives. It worked for me just specifying mapped-name inside web.xml and referencing the IP 127.0.0.1.
Could someone add comments about which kind of network issues may arise from these configuration?
Could someone at least improve logging to make possible to identify the bugs in each specific environment?