Skip to content
Snippets Groups Projects
Commit 02c075b1 authored by Goik Martin's avatar Goik Martin
Browse files

Apache Infocenter

parent d94977e5
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
Doc/Sdi/apache.xml
+ 81
− 26
View file @ 02c075b1
......@@ -234,62 +234,117 @@
<orderedlist>
<listitem>
<para>Install <xref linkend="glo_Java"/> <link
xlink:href="http://www.webupd8.org/2012/09/install-oracle-java-8-in-ubuntu-via-ppa.html">using
a ppa</link>. This way <xref linkend="glo_Java"/> updates will
become part of your system's regular updates via
<command>aptitude</command> or <command>apt-get</command>.</para>
<para>Install <xref linkend="glo_Java"/> using a ppa in <link
xlink:href="http://www.webupd8.org/2012/09/install-oracle-java-8-in-ubuntu-via-ppa.html">Ubuntu</link>
or <link
xlink:href="http://www.webupd8.org/2014/03/how-to-install-oracle-java-8-in-debian.html">Debian</link>.
This way <xref linkend="glo_Java"/> updates will become part of your
system's regular updates via <command>aptitude</command> or
<command>apt-get</command>.</para>
</listitem>
<listitem>
<para>Fetch a current Eclipse platform binary like
<para>Fetch a current Eclipse platform runtime binary like
<filename>eclipse-platform-4.5.1-linux-gtk-x86_64.tar.gz</filename>
from <uri
xlink:href="http://download.eclipse.org/eclipse/downloads/drops4/R-4.5.1-201509040015/">http://download.eclipse.org/eclipse/downloads/drops4/R-4.5.1-201509040015</uri>
matching your system.</para>
<tip>
<para>The above link may be outdated. Check for a current
production version.</para>
</tip>
</listitem>
<listitem>
<para>Create a non-privileged user <code>infocenter</code> running
the <productname
xlink:href="http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm">Infocenter</productname>
application server.</para>
application server. <command
xlink:href="http://linux.die.net/man/8/useradd">useradd</command> is
your friend.</para>
</listitem>
<listitem>
<para>Become user <code>infocenter</code> and extract the
archive.</para>
<para>Become user <quote>infocenter</quote> and extract
<filename>eclipse-platform-4.5.1-linux-gtk-x86_64.tar.gz</filename>.</para>
</listitem>
<listitem>
<para>Configure <productname
xlink:href="http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm">Infocenter</productname>
listening to port 8081. Configure an Apache virtual host redirecting
incoming <xref linkend="glo_HTTP"/> and <abbrev>https</abbrev>
requests to <productname
xlink:href="http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm">Infocenter</productname>:</para>
<para>The following shell script allows for starting <productname
xlink:href="http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm">Infocenter's</productname>
jetty server:</para>
<programlisting language="none">#!/bin/bash
<programlisting language="none"> &lt;VirtualHost *:443&gt;
java -Xmx512M -Dadvanced.syncDefault=true \
-classpath /home/infocenter/eclipse/plugins/org.eclipse.help.base_4.0.300.v20150904-0015.jar org.eclipse.help.standalone.Infocenter \
-pluginCustomization /home/infocenter/my.properties \
-clean -host localhost -port 8081 -command start -eclipsehome /home/infocenter/eclipse -data /home/infocenter/workspace \
-vmargs "-Xmx384M"&gt;&gt; ~/ic.log 2&gt;&gt; ~/ic.log &amp;
#end</programlisting>
<para>You may examine <filename>ic.log</filename> for possible
troubleshooting measures.</para>
<tip>
<para>Read <link
xlink:href="http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm">Information
Center</link> for command line argument explanations.</para>
</tip>
</listitem>
...
<listitem>
<para>The MI firewall will block connection attempts to port 8081.
As an easy workaround for testing purposes you may tunnel
connections by <command>ssh</command> to your local machine:</para>
# Listen to Infocenter's Jetty server
ProxyVia On
RewriteRule ^/$ https://infocenter.mi.hdm-stuttgart.de/index.jsp [l]
RewriteRule ^/(.*) http://localhost:8081/help/$1 [L,P]
<programlisting language="none">ssh root@sdiXY.mi.hdm-stuttgart.de -L 8081:localhost:8081</programlisting>
&lt;/VirtualHost&gt;
</programlisting>
<para>Your <productname
xlink:href="http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm">Infocenter</productname>
should now be visible via <uri
xlink:href="http://localhost:8081/help/index.jsp">http://localhost:8081/help/index.jsp</uri>.</para>
</listitem>
<listitem>
<para>Remove alien documentation </para>
<para>Configure an Apache virtual host redirecting incoming <xref
linkend="glo_HTTP"/> requests to <productname
xlink:href="http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm">Infocenter</productname>:</para>
<programlisting language="none">&lt;VirtualHost *:80&gt;
...
ServerAdmin webmaster@localhost
DocumentRoot /var/www/html
&lt;Location /docs/&gt;
order deny,allow
allow from all
ProxyPass http://localhost:8081/help/
ProxyPassReverse http://localhost:8081/help/
&lt;/Location&gt;
...
&lt;/VirtualHost&gt;</programlisting>
<tip>
<para>This requires <link
xlink:href="http://askubuntu.com/questions/58179/install-mod-proxy-to-get-proxypass-to-work#answer-58185">enabling</link>
the Apache <xref linkend="glo_HTTP"/> proxy module.</para>
</tip>
</listitem>
<listitem>
<para>Add a suitable script to automatically start your <productname
<para>Add a suitable script to <filename>/etc/init.d</filename> plus
a corresponding link to <filename>/etc/rc2.d</filename> for an
automated start of your <productname
xlink:href="http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm">Infocenter</productname>
instance during boot.</para>
instance during boot. The link should be chosen assuring to start
<productname
xlink:href="http://help.eclipse.org/mars/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm">Infocenter</productname>
prior to <productname>Apache</productname>.</para>
<para>Test proper startup after reboot.</para>
</listitem>
</orderedlist>
</section>
......
ws/Docbook/Extensions/Tdata/META-INF/MANIFEST.MF 0 → 100644
+ 10
− 0
View file @ 02c075b1
Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: goik
Bundle-SymbolicName: de.hdm_stuttgart.mi.fig; singleton:=true
Bundle-Version: 1.0
Require-Bundle: org.eclipse.ui;bundle-version="[3.3.0,4.0.0)",
org.eclipse.core.runtime,
org.eclipse.core.expressions;bundle-version="[3.3.0,4.0.0)"
Bundle-Vendor: mi.hdm-stuttgart.de
Bundle-Localization: plugin
ws/Docbook/Extensions/Tdata/Makefile
+ 5
− 3
View file @ 02c075b1
all: eclipsehelp epub
eclipsehelp:
/usr/share/xmlmind/bin/xxetool convert -d -vvv -p eclipse.plugin.id my.special.id -p eclipse.plugin.name Test \
/usr/share/xmlmind/bin/xxetool convert -d -vvv -p eclipse.plugin.id de.hdm_stuttgart.mi.fig -p eclipse.plugin.name Figures \
-p eclipse.plugin.provider 'Martin Goik, goik@hdm-stuttgart.de' db5.toEclipseHelp \
fig.xml -u /tmp/fig;
fig.xml -u /tmp/de.hdm_stuttgart.mi.fig
perl -i -p -e '$$/=undef;s/\n[ \t]*<!DOCTYPE[^>]+\n[^>]*>$$//m' /tmp/de.hdm_stuttgart.mi.fig/*.xml
cp -r META-INF /tmp/de.hdm_stuttgart.mi.fig
epub:
/usr/share/xmlmind/bin/xxetool convert -d -vvv db5.toEpub fig.xml -u /tmp/fig.epub
clean:
cd /tmp; rm -rf xxe* fig fig.epub fig fig.epub
cd /tmp; rm -rf xxe* de.hdm_stuttgart.mi.fig fig.epub fig fig.epub
#end
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment