From ff3b55187460b739935cd18a79132e442c8a9c70 Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Fri, 29 May 2015 08:08:17 +0000
Subject: [PATCH] CR-7086 OPENDJ-2034 Mention disabling anti-virus systems

---
 opendj-server-legacy/src/main/docbkx/release-notes/chap-issues.xml        |    7 +++
 opendj-server-legacy/src/main/docbkx/admin-guide/chap-troubleshooting.xml |   10 ++++
 opendj-server-legacy/src/main/docbkx/shared/para-disable-anti-virus.xml   |   34 +++++++++++++++++
 opendj-server-legacy/src/main/docbkx/install-guide/chap-install-gui.xml   |   12 +++++-
 opendj-server-legacy/src/main/docbkx/install-guide/chap-install-cli.xml   |    9 ++++
 5 files changed, 68 insertions(+), 4 deletions(-)

diff --git a/opendj-server-legacy/src/main/docbkx/admin-guide/chap-troubleshooting.xml b/opendj-server-legacy/src/main/docbkx/admin-guide/chap-troubleshooting.xml
index 5ec41d7..d5d044a 100644
--- a/opendj-server-legacy/src/main/docbkx/admin-guide/chap-troubleshooting.xml
+++ b/opendj-server-legacy/src/main/docbkx/admin-guide/chap-troubleshooting.xml
@@ -28,7 +28,8 @@
          xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
          xsi:schemaLocation='http://docbook.org/ns/docbook
                              http://docbook.org/xml/5.0/xsd/docbook.xsd'
-         xmlns:xlink='http://www.w3.org/1999/xlink'>
+         xmlns:xlink='http://www.w3.org/1999/xlink'
+         xmlns:xinclude='http://www.w3.org/2001/XInclude'>
  <title>Troubleshooting Server Problems</title>
  <indexterm><primary>Troubleshooting</primary></indexterm>
  
@@ -80,6 +81,13 @@
   lines in the command output of the following form.</para>
   
   <literallayout class="monospaced">See /var/....log for a detailed log of this operation.</literallayout>
+
+  <para>
+   Prevent anti-virus and intrusion detection systems from interfering
+   with OpenDJ directory server.
+  </para>
+
+  <xinclude:include href="../shared/para-disable-anti-virus.xml" />
  </section>
 
  <section xml:id="troubleshoot-reset-admin-passwords">
diff --git a/opendj-server-legacy/src/main/docbkx/install-guide/chap-install-cli.xml b/opendj-server-legacy/src/main/docbkx/install-guide/chap-install-cli.xml
index a63768b..dac85e4 100644
--- a/opendj-server-legacy/src/main/docbkx/install-guide/chap-install-cli.xml
+++ b/opendj-server-legacy/src/main/docbkx/install-guide/chap-install-cli.xml
@@ -63,6 +63,15 @@
    version.</para>
   </step>
 
+  <step>
+   <para>
+    Prevent anti-virus and intrusion detection systems from interfering
+    with OpenDJ directory server.
+   </para>
+
+   <xinclude:include href="../shared/para-disable-anti-virus.xml" />
+  </step>
+
   <step xml:id="download-opendj">
    <indexterm><primary>Downloading OpenDJ</primary></indexterm>
    
diff --git a/opendj-server-legacy/src/main/docbkx/install-guide/chap-install-gui.xml b/opendj-server-legacy/src/main/docbkx/install-guide/chap-install-gui.xml
index 64404ef..3ad427e 100644
--- a/opendj-server-legacy/src/main/docbkx/install-guide/chap-install-gui.xml
+++ b/opendj-server-legacy/src/main/docbkx/install-guide/chap-install-gui.xml
@@ -9,8 +9,7 @@
   ! or send a letter to Creative Commons, 444 Castro Street,
   ! Suite 900, Mountain View, California, 94041, USA.
   !
-  ! You can also obtain a copy of the license at
-  ! trunk/opendj3/legal-notices/CC-BY-NC-ND.txt.
+  ! You can also obtain a copy of the license at legal-notices/CC-BY-NC-ND.txt.
   ! See the License for the specific language governing permissions
   ! and limitations under the License.
   !
@@ -204,6 +203,15 @@
 
    <step>
     <para>
+     Prevent anti-virus and intrusion detection systems from interfering
+     with OpenDJ directory server.
+    </para>
+
+    <xinclude:include href="../shared/para-disable-anti-virus.xml" />
+   </step>
+
+   <step>
+    <para>
      Install OpenDJ files in one of the following ways.
     </para>
 
diff --git a/opendj-server-legacy/src/main/docbkx/release-notes/chap-issues.xml b/opendj-server-legacy/src/main/docbkx/release-notes/chap-issues.xml
index 0a4a799..dbca9ac 100644
--- a/opendj-server-legacy/src/main/docbkx/release-notes/chap-issues.xml
+++ b/opendj-server-legacy/src/main/docbkx/release-notes/chap-issues.xml
@@ -27,7 +27,8 @@
          xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
          xsi:schemaLocation='http://docbook.org/ns/docbook
                              http://docbook.org/xml/5.0/xsd/docbook.xsd'
-         xmlns:xlink='http://www.w3.org/1999/xlink'>
+         xmlns:xlink='http://www.w3.org/1999/xlink'
+         xmlns:xinclude='http://www.w3.org/2001/XInclude'>
  <title>OpenDJ Fixes, Limitations, &amp; Known Issues</title>
 
  <para>This chapter covers the status of key issues and limitations for OpenDJ
@@ -98,6 +99,10 @@
    </listitem>
 
    <listitem>
+    <xinclude:include href="../shared/para-disable-anti-virus.xml" />
+   </listitem>
+
+   <listitem>
     <para>OpenDJ plugin extensions must follow the guidelines set forth in
     the <filename>README</filename> file delivered in
     <filename>opendj/example-plugin.zip</filename>. When developing your
diff --git a/opendj-server-legacy/src/main/docbkx/shared/para-disable-anti-virus.xml b/opendj-server-legacy/src/main/docbkx/shared/para-disable-anti-virus.xml
new file mode 100644
index 0000000..db3b892
--- /dev/null
+++ b/opendj-server-legacy/src/main/docbkx/shared/para-disable-anti-virus.xml
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ! CCPL HEADER START
+  !
+  ! This work is licensed under the Creative Commons
+  ! Attribution-NonCommercial-NoDerivs 3.0 Unported License.
+  ! To view a copy of this license, visit
+  ! http://creativecommons.org/licenses/by-nc-nd/3.0/
+  ! or send a letter to Creative Commons, 444 Castro Street,
+  ! Suite 900, Mountain View, California, 94041, USA.
+  !
+  ! You can also obtain a copy of the license at legal-notices/CC-BY-NC-ND.txt.
+  ! See the License for the specific language governing permissions
+  ! and limitations under the License.
+  !
+  ! If applicable, add the following below this CCPL HEADER, with the fields
+  ! enclosed by brackets "[]" replaced with your own identifying information:
+  !      Portions Copyright [yyyy] [name of copyright owner]
+  !
+  ! CCPL HEADER END
+  !
+  !      Copyright 2015 ForgeRock AS.
+  !
+-->
+<para xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en'
+      xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
+      xsi:schemaLocation='http://docbook.org/ns/docbook
+                          http://docbook.org/xml/5.0/xsd/docbook.xsd'>
+ Anti-virus and intrusion detection systems
+ that do deep inspection of database files are not compatible
+ with OpenDJ directory server.
+ Disable anti-virus and intrusion detection systems,
+ or at least prevent them from operating on OpenDJ directory server files.
+</para>

--
Gitblit v1.10.0