svn commit: r1746248 - in /marmotta/site/trunk/content/markdown: configuration.md installation.md.vm

[wi...@apache.org]

Author: wikier
Date: Tue May 31 07:41:52 2016
New Revision: 1746248

URL: http://svn.apache.org/viewvc?rev=1746248&view=rev
Log:
remarks on installation/configuration by Rob Atkinson

Modified:
    marmotta/site/trunk/content/markdown/configuration.md
    marmotta/site/trunk/content/markdown/installation.md.vm

Modified: marmotta/site/trunk/content/markdown/configuration.md
URL: http://svn.apache.org/viewvc/marmotta/site/trunk/content/markdown/configuration.md?rev=1746248&r1=1746247&r2=1746248&view=diff
==============================================================================
--- marmotta/site/trunk/content/markdown/configuration.md (original)
+++ marmotta/site/trunk/content/markdown/configuration.md Tue May 31 07:41:52 2016
@@ -2,18 +2,14 @@
 
 # Configuring Apache Marmotta 
 
-You can now access the Apache Marmotta Web Admin Interface through your browser,
-e.g. by accessing the URL: 
-[http://localhost:8080/marmotta](http://localhost:8080/marmotta). There you can
-configure quite some aspects of Marmotta.
+### Step 1: Configure the installation host name
 
-Marmotta uses a home directory to save some data. By default launchers will use 
-`${java.io.tmpdir}${file.separator}marmotta` (`/tmp/marmotta` in Unix systems, 
-`C:\Users\User Name\AppData\Local\Temp\marmotta` on Windows), but you can customize 
-the path to that directory by using the `marmotta.home` system property or the 
-`MARMOTTA_HOME` environment variable. In that directory, Marmotta uses the
-`system-config.properties` file to store all system configuration; please,
-**modify that file carefully**. 
+Accessing Marmotta the fist time using a HTTP request at the hostname ( e.g., 
+[http://localhost:8080/marmotta](http://localhost:8080/marmotta))will automatically 
+configure Marmotta with that hostname to be used for naming resources. If you 
+access it using a local name like localhost or 127.0.0.1 resources created by 
+Marmotta - such as Linked Data Platform containers - will not have accessible 
+URIs.
 
 Note that the host name and port you are using for the first access to your
 installation is **important** since decides on how Linked Data resources will 
@@ -31,6 +27,22 @@ resources, `kiwi.host` is the base URL t
 case you are running Marmotta behind a proxy, `kiwi.context` should contain the 
 public URI, and you can keep the internal one used as `kiwi.host`. 
 
+### Step 2: Admin UI
+
+You can now access the Apache Marmotta Web Admin Interface through your browser,
+e.g. by accessing the URL: 
+[http://localhost:8080/marmotta](http://localhost:8080/marmotta). There you can
+configure quite some aspects of Marmotta.
+
+Marmotta uses a home directory to save some data. By default launchers will use 
+`${java.io.tmpdir}${file.separator}marmotta` (`/tmp/marmotta` in Unix systems, 
+`C:\Users\User Name\AppData\Local\Temp\marmotta` on Windows), but you can customize 
+the path to that directory by using the `marmotta.home` system property or the 
+`MARMOTTA_HOME` environment variable. In that directory, Marmotta uses the
+`system-config.properties` file to store all system configuration; please,
+**modify that file carefully**. 
+
+
 <h2 id="db">Change Database Configuration</h2>
 
 In case you are not going to use Marmotta for something serious, take into account

Modified: marmotta/site/trunk/content/markdown/installation.md.vm
URL: http://svn.apache.org/viewvc/marmotta/site/trunk/content/markdown/installation.md.vm?rev=1746248&r1=1746247&r2=1746248&view=diff
==============================================================================
--- marmotta/site/trunk/content/markdown/installation.md.vm (original)
+++ marmotta/site/trunk/content/markdown/installation.md.vm Tue May 31 07:41:52 2016
@@ -6,6 +6,10 @@ Apache Marmotta is implemented as a Java
 be deployed to any Java Application Container. It has been tested under Jetty 6.x 
 and Tomcat 7.x. It can be installed using the source code or as a binary package.
 
+After installation remember not to access using a local hostname or IP address 
+until you have accessed using its correct external hostname (see 
+[configuration](configuration.html) for further details).
+
 <h2>Requirements</h2>
 
 * Hardware
@@ -37,10 +41,6 @@ Marmotta:
 * on Linux, these are created on the desktop and also in the Applications menu under "Apache Marmotta"
 * on MacOS, there are two actions "Start Marmotta" and "Shutdown Marmotta" in the program folder of the Marmotta installation
 
-After installation, you can access the administration interface of Marmottta by pointing your 
-browser to [http://localhost:8080/](http://localhost:8080/) or by clicking on the Marmotta 
-systray icon and selecting "Administration" from the menu.
-
 <h2 id="war">Installation (binary)</h2>
 
 The binary installation comes as a Java Web Archive (`.war`) file that can be deployed in any