diff --git a/developers.html b/developers.html index c597b81681c97be7b649bd4368d19e3265af96bc..33a7965074de14d00830bf75b0d64025c27da3f2 100644 --- a/developers.html +++ b/developers.html @@ -225,11 +225,6 @@ Apache Ant(TM) version 1.10.7 compiled on May 2 2019 <code style="color:darkgreen"><b>ANT_HOME/lib/</b></code> subdirectory. Also be sure to check ownership and executable permissions for this file. </li> - <li> - When using JDK13, add the following switch to <code>NETBEANS_HOME/etc/netbeans.conf</code> configuration file - <br /> - <code style="color:darkgreen"><b>-J-Djavax.xml.bind.context.factory=com.sun.xml.bind.v2.ContextFactory</b></code> - </li> <li> Optional: extract, build and install the latest <a href="http://www.jcraft.com/jsch">jsch-0.1.54.jar</a> package @@ -1439,87 +1434,128 @@ need to be connected to the NPS intranet. </h2> <p> - <a href="https://www.netbeans.org" target="_blank">NetBeans</a> + <a href="https://netbeans.apache.org" target="_Netbeans">Apache NetBeans</a> is the Integrated Development Environment (IDE) used for most Savage project development. </p> + <ul> + <li> + Includes + <a href="https://blogs.apache.org/netbeans" target="_blank">Blog</a>, + <a href="https://netbeans.apache.org/download/nb113/index.html" target="_Netbeans">NetBeans 11.3 features</a>, + <a href="https://netbeans.apache.org/kb/docs/java" target="_Netbeans">tutorials</a>, + <a href="https://netbeans.apache.org/community" target="_Netbeans">Community</a>, + <a href="https://netbeans.apache.org/participate" target="_Netbeans">Participate</a>, + <a href="https://netbeans.apache.org/help" target="_Netbeans">Get Help</a> and + <a href="https://netbeans.apache.org/plugins" target="_Netbeans">Plugins</a>. + </li> + <li> + <a href="https://netbeans.org" target="_blank">Netbeans.org</a> + provides immense prior documentation and information, including the + <a href="http://plugins.netbeans.org/PluginPortal" target="_blank">Netbeans Plugins Portal</a>. + </li> + <li> + <a href="https://dzone.com/java-jdk-development-tutorials-tools-news" target="_blank">DZone Java Zone</a> + has interesting news and resources. + </li> + <li> + <a href="https://docs.oracle.com/cd/E50453_01/doc.80/e50452/toc.htm" target="_blank">Developing Applications with NetBeans IDE 8.0</a> + (also + <a href="https://docs.oracle.com/cd/E50453_01/doc.80/e50452.pdf" target="_blank">.pdf</a> + and + <a href="https://dzone.com/articles/free-oracle-book-developing" target="_blank">Dzone article</a>) + is a prior-version free book. + </li> + </ul> <p> - Free book: - <a href="https://netbeans.dzone.com/articles/free-oracle-book-developing" target="_blank">Developing Applications with NetBeans IDE 8.0</a> - (<a href="https://docs.oracle.com/cd/E50453_01/doc.80/e50452/toc.htm">.html</a> - and - <a href="https://docs.oracle.com/cd/E50453_01/doc.80/e50452.pdf">.pdf</a>) - </p> - - <p> - Once installed, recommended configuration settings and - suggested modules include the following: + <a href="https://docs.oracle.com/en/java/javase/index.html" target="_blank">Javadoc documentation</a> + (<a href="https://docs.oracle.com/en/java/javase/13/docs/api/index.html" target="_blank">JDK 13</a>) + is helpful, be sure to download a local copy Javadoc for Java from the + <a href="https://www.oracle.com/java/technologies/javase-jdk13-doc-downloads.html" target="_blank">Javadoc downloads</a> page. </p> <ul> <li> - First-time use of Subversion under Windows can yield a - <a href="images/NetbeansSubversionClientWindows.png">warning dialog</a>, - click to accept installation of plugin + Extract the <code style="color:darkgreen"><b>docs</b></code> directory tree provided by the .zip + into your local directory containing Java. </li> <li> - <a href="https://docs.oracle.com/cd/E50453_01/index.htm" target="_blank">Netbeans documentation</a> - and - <a href="https://docs.oracle.com/javase/8/docs" target="_blank">Java documentation</a> - are helpful. - Be sure to download Javadoc for Java from the - <a href="https://www.oracle.com/technetwork/java/javase/downloads">Java downloads</a> page. - Extract the <code style="color:darkgreen"><b>docs</b></code> directory tree provided by the .zip to the directory containing Java. Then select the Netbeans menu for <i>Tools > Java Platform</i> and - add the local directory under the Javadoc tab. For good measure you can also add the online Java Javadoc url at - <a href="https://docs.oracle.com/javase/8/docs/api" target="_blank">https://docs.oracle.com/javase/8/docs/api</a> + add the local directory under the Javadoc tab. + </li> + <li> + For good measure add the online Java Javadoc url + <code><a href="https://www.oracle.com/java/technologies/javase-jdk13-doc-downloads.html" target="_blank">https://www.oracle.com/java/technologies/javase-jdk13-doc-downloads.html</a></code> there as well. - <p> - Javadoc location is configured under <i>Tools > Java Platform > select platform (JDK 1.8)</i> subtab - </p> </li> <li> - For backwards-compatible <code>jaxb</code> support on - <code style="color:darkgreen"><b>netbeans.conf</b></code> in Netbeans 11, append: - <br /> - <b><code>netbeans_default_options</code></b>="<b><code>-J-Djavax.xml.bind.context.factory=com.sun.xml.bind.v2.ContextFactory</code></b>" + Here is an example + <a href="images/Netbeans11.3Javadoc13Configuration.png" target="_blank">screenshot</a>. + The same Javadoc is used for both Oracle and OpenJDK Java (which is a good sign regarding compatibility). </li> + </ul> + + <p> + Once installed, recommended configuration settings may need modification. + Use administrator permissions when launching the text editor to modify the configuration file. + </p> + <ul> <li> - If upgrading Java without re-installing Netbeans, you may need to - <a href="https://stackoverflow.com/questions/2809366/changing-the-version-on-which-netbeans-runs">modify Netbeans version of Java platform</a> - by editing - <code style="color:darkgreen"><b>netbeans.conf</b></code> - in the program-installation directory, such as + <code><b>NETBEANS_HOME/etc/netbeans.conf</b></code> + locations in the Netbeans installation directory tree: <br /> - <code style="color:darkgreen"><b>C:\Program Files\NetBeans_11.2\etc\netbeans.conf</b></code> (default user settings) + <code style="color:darkgreen"><b>C:\Program Files\netbeans\NetBeans_11.3\etc\netbeans.conf</b></code> (default user settings) + or, noting subdirectory structure, <br /> + <code style="color:darkgreen"><b>C:\Program Files\NetBeans_11.2\etc\netbeans.conf</b></code> (default user settings) or, noting hyphen, - <code style="color:darkgreen"><b>C:\Program Files\NetBeans-11.2\etc\netbeans.conf</b></code> (default user settings) <br /> + <code style="color:darkgreen"><b>C:\Program Files\NetBeans-11.2\etc\netbeans.conf</b></code> or, for older versions of Netbeans, <br /> - <code style="color:darkgreen"><b>C:\Program Files\NetBeans 8.2\etc\netbeans.conf</b></code> (default user settings) + <code style="color:darkgreen"><b>C:\Program Files\NetBeans 8.2\etc\netbeans.conf</b></code> (default user settings) or <br /> <code style="color:darkgreen"><b>C:\Users\<b>MyName</b>\AppData\Roaming\NetBeans\8.0.2\etc\netbeans.conf</b></code> - - <br /> - Modify original settings to also include: - <br /> - <b><code>netbeans_default_options</code></b>="<b><code>-J-server</code> <code>-J-Xmx2g</code> <code>-J-XX:PermSize=32m</code></b>" - <br /> - (for details, see <a href="https://wiki.netbeans.org/FaqSettingHeapSize">Netbeans FaqSettingHeapSize</a>) - </li> + </li> <li> - <a href="https://plugins.netbeans.org/PluginPortal">NetBeans Plugin Portal</a> - has many useful additions for Netbeans + <i>Java version.</i> + If upgrading Java for an existing Netbeans installation, you may need to + <a href="https://stackoverflow.com/questions/2809366/changing-the-version-on-which-netbeans-runs" target="_blank">modify Netbeans version of Java platform</a> + by changing menu <i>Tools > Java Platforms</i> + and also + <code style="color:darkgreen"><b>netbeans.conf</b></code> property + <code>netbeans_jdkhome="C:\Program Files\Java\jdk-13.0.2"</code> + (for example). </li> <li> - <a href="https://netbeans.dzone.com">DZone NetBeans Zone</a> - has interesting news and resources, including - <a href="https://refcardz.dzone.com/refcardz/netbeans-ide-7-programming">refcard: Netbeans IDE 7.0 - Programming in Java</a> - and - <a href="https://refcardz.dzone.com/refcardz/netbeans-platform-70">refcard: NetBeans Platform 7.0 Framework for Building Pluggable Enterprise Applications </a>. + <i>JAXB compatibility.</i> + Append the following property to + <code>netbeans_default_options</code> environment variable: + <br /> + <code style="color:darkgreen"><b>-J-Djavax.xml.bind.context.factory=com.sun.xml.bind.v2.ContextFactory</b></code> + </li> + <li> + (TODO test, reportedly + <a href="https://netbeans.apache.org/download/nb113/index.html#_hidpi">fixed</a> under Netbeans 11.3) + <br /> + <a href="https://stackoverflow.com/questions/23651486/netbeans-ide-scaling-on-windows-8-10" target="_blank">NetBeans IDE scaling on Windows 8/10</a>: + Change parameter in + <code style="color:darkgreen"><b>netbeans.conf</b></code> file: + <br /> + <code>-J-Dsun.java2d.dpiaware=true</code> + to + <code>-J-Dsun.java2d.dpiaware=false</code> + <br /> + Alternatively "Go to the Compatibility tab and then select Change High DPI Settings. From there, check the Override High DPI Scaling box and set it to System." </li> <!-- + <li> + (TODO: likely fixed under Netbeans 11.3) + Modify original settings to also include: + <br /> + <b><code>netbeans_default_options</code></b>="<b><code>-J-server</code> <code>-J-Xmx2g</code> <code>-J-XX:PermSize=32m</code></b>" + <br /> + (for details, see <a href="https://wiki.netbeans.org/FaqSettingHeapSize" target="_blank">Netbeans FaqSettingHeapSize</a>) + </li> <li> (TODO verify latest, update if needed) Add <a href="https://updates.netbeans.org/netbeans/updates/6.9/uc/m1/dev/catalog.xml">NetBeans Development</a> @@ -1527,23 +1563,37 @@ need to be connected to the NPS intranet. <i>XML Schema and WSDL</i> plugin </li> --> + </ul> + <p> + Further configuration settings of interest: + </p> + <ul> <li> - <a href="https://savage.nps.edu/X3D-Edit/#Downloads">Install X3D-Edit</a> (which includes KML support) as plugin modules + <i>Ant build support.</i> + Perform + <a href="Ant">Ant</a> installation directions above, then + <i>Tools > Options > Miscellaneous > Ant:</i> + set directory for <a href="#Ant">local version of Ant installation</a>, + unset Reuse Output Tabs, + set Save All Modified Files, + set Always Show Output. </li> <li> - If X3D-Edit plugin is not installed, select - <br /> - <i>Tools > Options > Miscellaneous > Files:</i> add new file type <code style="color:darkgreen"><b>x3d</b></code> with value <code style="color:darkgreen"><b>XML Files (text/xml)</b></code> to support X3D scene validation + <a href="https://savage.nps.edu/X3D-Edit/#Downloads" target="_blank">Install X3D-Edit</a> + (which includes KML support) as a set of plugin modules. </li> <li> - <i>Tools > Options > Miscellaneous > Files:</i> add new file type <code style="color:darkgreen"><b>sch</b></code> with value <code style="color:darkgreen"><b>XML Files (text/xml)</b></code> to support Schematron rule-set validation + If X3D-Edit plugin is not installed, select + <br /> + <i>Tools > Options > Miscellaneous > Files:</i> add new file type <code style="color:darkgreen"><b>x3d</b></code> with <i>Associatiated file type (MIME)</i> selection <code style="color:darkgreen"><b>XML Files (text/xml)</b></code> to support X3D scene validation, + <br /> + and + <br /> + <i>Tools > Options > Miscellaneous > Files:</i> add new file type <code style="color:darkgreen"><b>sch</b></code> with <i>Associatiated file type (MIME)</i> selection <code style="color:darkgreen"><b>XML Files (text/xml)</b></code> to support Schematron rule-set validation. </li> <li> - <i>Tools > Options > Miscellaneous > Ant:</i> - set directory for <a href="#Ant">local version of Ant installation</a>, - unset Reuse Output Tabs, - set Save All Modified Files, - set Always Show Output + <a href="http://plugins.netbeans.org/PluginPortal" target="_blank">NetBeans Plugin Portal</a> + has many useful additions for Netbeans. </li> <li> <i>Tools > Plugins > Settings:</i> @@ -1551,6 +1601,7 @@ need to be connected to the NPS intranet. </li> </ul> + <!-- old <p> <a name="NetBeansWindows64">Netbeans Windows 64-bit</a> configuration for latest Java: </p> @@ -1562,7 +1613,7 @@ need to be connected to the NPS intranet. Add the new java installation in Netbeans via <i>Tools, Java Platforms</i> menu </li> - <li>s + <li> Set the new java version in each Project Properties </li> <li> @@ -1619,13 +1670,9 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> <ul> <li> - <a href="https://stackoverflow.com/questions/23651486/netbeans-ide-scaling-on-windows-8-10">NetBeans IDE scaling on Windows 8/10</a>: - Change parameter in - <code style="color:darkgreen"><b>netbeans.conf</b></code> file (shown above): - <br /> - <code>-J-Dsun.java2d.dpiaware=true</code> - to - <code>-J-Dsun.java2d.dpiaware=false</code> + Old: first-time use of Subversion under Windows can yield a + <a href="images/NetbeansSubversionClientWindows.png">warning dialog</a>, + click to accept installation of plugin </li> <li> <i>Window > Debugging > Sources > (Right Click) Add Source Root</i> @@ -1636,6 +1683,7 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> <a href="http://rubenlaguna.com/wp/2008/02/22/attach-source-code-to-a-netbeans-library-wrapper-module">Attach source code to a NetBeans Library Wrapper Module</a> </li> </ul> + --> <!-- =========================================================== --> <h2> <a name="Projects">Projects</a> @@ -1778,6 +1826,7 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> for improved confidentiality between clients and servers. </p> + <!-- <p> Note that https certificate details can be used for confirmation of site identity: </p> @@ -1791,11 +1840,9 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> <br /> <a href="images/MmowgliHttpsCertificate.png">mmowgli.nps.navy.mil https certificate</a> </li> - <!-- <li> <a href="images/MovesInstituteHttpsCertificate.png">movesInstitute.org https certificate</a> </li> - --> <li> <a href="images/X3d-earthHttpsCertificate.png">x3d-earth.nps.edu https certificate</a> </li> @@ -1821,9 +1868,10 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> </li> </ul> + --> <p> - Browser companies still have not deployed DoD Certificate Authority (CA) links + Browser companies still! have not deployed DoD Certificate Authority (CA) links (apparently because they want the government to pay them to do so). Thus end users have to manually confirm each of the above certificates when first accessing these servers. </p> @@ -1838,7 +1886,10 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> <p> If server keys are changed, you may need to clear previously cached values. Cached certificate values can be found in directory <code style="color:darkgreen"><b>~/.ssh/known_hosts</b></code> - or else invoke <code style="color:darkgreen"><b>man ssh</b></code> for further details. + or else invoke either + <code style="color:darkgreen"><b>man ssh</b></code> + or + <code style="color:darkgreen"><b>man ssh-keygen</b></code> for further details. </p> @@ -1870,6 +1921,18 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> For Official Use Only (FOUO) (<a href="https://mmog.ern.nps.edu/awstats/awstats.pl?config=SavageDefense.nps.navy.mil" target="_blank" title="restricted access" alt="restricted access">usage statistics</a>) </li> + <li> + <a href="https://savage.nps.edu/manager/html">https://savage.nps.edu/manager/html</a> + Tomcat manager (used by + <a href="https://savage.nps.edu/X3dValidator">X3D Validator</a> + and other tools) + (TODO restrict to NPS intranet access?) + </li> + <li> + <a href="https://modelexchange.nps.edu">https://modelexchange.nps.edu</a> + NPS X3D Model Exchange + </li> + <!-- <li> <a href="https://www.movesinstitute.org">https://www.movesinstitute.org</a> Modeling, Virtual Environments and Simulation (MOVES) Institute @@ -1878,34 +1941,22 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> <li> <a href="http://mmowgli.nps.edu">http://mmowgli.nps.edu</a> Massive Multiplayer Online Wargame Leveraging the Internet (MMOWGLI) - <!-- Akamai-zed + Akamai-zed (<a href="https://mmog.ern.nps.edu/awstats/awstats.pl?config=mmowgli.nps.edu" target="_blank">usage statistics</a>) - --> </li> <li> <a href="http://mmowgli.nps.edu">http://web.mmowgli.nps.edu</a> image server (<a href="https://mmog.ern.nps.edu/awstats/awstats.pl?config=web.mmowgli.nps.edu" target="_blank">usage statistics</a>) </li> - <!-- TODO also usage stats for test.mmowgli.nps.edu and portal.mmowgli.nps.edu --> + TODO also usage stats for test.mmowgli.nps.edu and portal.mmowgli.nps.edu <li> <a href="http://oam.nps.edu">http://oam.nps.edu</a> Open Aerial Map (OAM) - <!-- (<a href="https://mmog.ern.nps.edu/awstats/awstats.pl?config=oam.nps.edu" target="_blank">usage statistics</a>) - --> </li> <li> <a href="https://x3d-earth.nps.edu">https://x3d-earth.nps.edu</a> X3D Earth server - <!-- (<a href="https://mmog.ern.nps.edu/awstats/awstats.pl?config=x3d-earth.nps.edu" target="_blank">usage statistics</a>) - --> - </li> - <li> - <a href="https://savage.nps.edu/manager/html">https://savage.nps.edu/manager/html</a> - Tomcat manager (used by - <a href="https://savage.nps.edu/X3dValidator">X3D Validator</a> - and other tools) - (TODO restrict to NPS intranet access?) </li> <li> <a href="https://mmog.ern.nps.edu">https://mmog.ern.nps.edu</a> @@ -1934,7 +1985,6 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> <a href="http://httpd.apache.org">Apache</a> http server. </p> ---> <p> Mailing lists and hypermail archives: </p> @@ -1965,7 +2015,7 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> </p> <ul> <li> - <a href="mailto:mcgredo@nps.edu(Don%20McGregor),brutzman@nps.edu(Don%20Brutzman)?subject=Savage%20hserver%20help%20request">Savage server help request</a> + <a href="mailto:mcgredo@nps.edu(Don%20McGregor),brutzman@nps.edu(Don%20Brutzman)?subject=Savage%20server%20help%20request">Savage server help request</a> </li> <li> <a href="mailto:brutzman@nps.edu(Don%20Brutzman),mcgredo@nps.edu(Don%20McGregor),?subject=Savage.nps.edu%20password%20request">savage.nps.edu password request</a> @@ -1979,6 +2029,7 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_221"</pre> <a href="http://technet.microsoft.com/en-us/library/ee309278%28office.12%29.aspx">here</a>) </li> </ul> +--> <!-- =========================================================== --> @@ -2793,7 +2844,7 @@ which can lead to the Internet of Things becoming the Web of Things. </i> <a href="https://savage.nps.edu/developers.html">https://savage.nps.edu/developers.html</a> </blockquote> <blockquote> - Revised 1 March 2020. + Revised 14 March 2020. </blockquote> <p>