CR-7263 OPENDJ-2077 Fix screenshots

Mark Craig

15.20.2015 8073ec5af384b04a545b51fbdcbcfd940c7475b5

CR-7263 OPENDJ-2077 Fix screenshots

This patch removes a number of screenshots
that take up space and require maintenance
without adding much beyond what is in the text.

Readers who want the screenshots can follow along
by running the setup program on their computers.

 opendj-server-legacy/src/main/docbkx/admin-guide/chap-replication.xml

@@ -48,76 +48,68 @@
   <see>Replication</see>
  </indexterm>

  <para>You can set up replication during installation by choosing to
  configure replication through the setup wizard.</para>
  <itemizedlist>
   <para>
    You can set up replication during installation by using the setup wizard,
    starting with the Topology Options screen.
   </para>

  <para>In the Topology Options screen for the first server you set up, select
  This server will be part of a replication topology. If you also choose
  Configure as Secure, then replication traffic is protected by SSL.</para>
   <listitem>
    <para>
     In the Topology Options screen for the first server you set up,
     select This server will be part of a replication topology.
    </para>

  <mediaobject xml:id="figure-repla-setup">
   <imageobject>
    <imagedata fileref="images/replA-setup.png" format="PNG" />
   </imageobject>
   <textobject>
    <para>QuickSetup makes it easy to configure replication.</para>
   </textobject>
  </mediaobject>
    <para>
     If you also choose Configure as Secure,
     then replication traffic is protected by Transport Layer Security.
    </para>
   </listitem>

  <para>In the Topology Options screen for subsequent servers, also select
  There is already a server in the topology, providing the Host Name,
  Administration Connector Port number, Admin User, and Admin Password for
  the first replica you set up.</para>
   <listitem>
    <para>
     In the Topology Options screen for subsequent servers,
     select There is already a server in the topology.
    </para>

  <mediaobject xml:id="figure-replb-setup">
   <imageobject>
    <imagedata fileref="images/replB-setup.png" format="PNG" />
   </imageobject>
   <textobject>
    <para>Subsequent servers can point to the first server at setup time.</para>
   </textobject>
  </mediaobject>
    <para>
     Provide the Host Name, Administration Connector Port number,
     global Admin User identifier, and Admin Password for the first server.
    </para>
   </listitem>

  <para>You also set up a global administrator account, stored under
  <literal>cn=admin data</literal> across replicas, used to manage replication
  in the topology.</para>
   <listitem>
    <para>
     When presented with the Create Global Administrator screen,
     provide a Global Administrator ID and Global Administrator Password.
    </para>

  <mediaobject xml:id="figure-replb-global-admin">
   <imageobject>
    <imagedata fileref="images/replB-global-admin.png" format="PNG" />
   </imageobject>
   <textobject>
    <para>The global administrator account exists on all servers in the
    replication topology.</para>
   </textobject>
  </mediaobject>
    <para>
     The Global Administrator account exists on all servers
     in the replication topology.
     The account is stored under <literal>cn=admin data</literal>.
     It provides an account to administer replication
     with the same credentials on every server in the topology.
    </para>
   </listitem>

  <para>You further set up what to replicate.</para>
   <listitem>
    <para>
     In the Data Replication screen,
     select the user and application data base DN(s) to replicate.
    </para>

  <mediaobject xml:id="figure-replb-data-repl">
   <imageobject>
    <imagedata fileref="images/replB-data-repl.png" format="PNG" />
   </imageobject>
   <textobject>
    <para>You choose the user data to replicate. OpenDJ automatically replicates
    administrative data and directory schema.</para>
   </textobject>
  </mediaobject>
    <para>
     OpenDJ directory server automatically replicates
     configuration data and directory schema.
    </para>
   </listitem>
  </itemizedlist>

  <para>Once replication is set up, it works for all the replicas. You can
  monitor the replication connection and status through the OpenDJ Control
  Panel.</para>

  <mediaobject xml:id="figure-repla-monitor-repl">
   <imageobject>
    <imagedata fileref="images/replA-monitor-repl.png" format="PNG" />
   </imageobject>
   <textobject>
    <para>OpenDJ Control Panel indicates the status of data being
    replicated.</para>
   </textobject>
  </mediaobject>

  <para>
   Once replication is set up, it works for all the replicas.
   You can monitor replication status through OpenDJ Control Panel.
  </para>
 </section>

 <section xml:id="about-repl">

 opendj-server-legacy/src/main/docbkx/admin-guide/images/OpenDJ-Control-Panel.png

 opendj-server-legacy/src/main/docbkx/admin-guide/images/replA-monitor-repl.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/admin-guide/images/replA-setup.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/admin-guide/images/replB-data-repl.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/admin-guide/images/replB-global-admin.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/admin-guide/images/replB-setup.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/chap-install-gui.xml

@@ -48,19 +48,11 @@
 quick test installation.</para>

 <note>
  <para>OpenDJ directory server relies on Java 6 or later, so if your browser
  picks up an old installation of Java 5 for example, installation can
  fail. You might see an application error message such as this:</para>
 
  <mediaobject xml:id="figure-missing-java6">
   <alt>Application error due to old Java version</alt>
   <imageobject>
    <imagedata fileref="images/missing-java6.png" format="PNG" />
   </imageobject>
   <textobject>
    <para>Message showing the browser is unable to launch the application</para>
   </textobject>
  </mediaobject>
  <para>
   If your environment picks up an old installation of Java,
   installation can fail.
   You might see an application error due to an old Java version.
  </para>
 </note>

 <para>If the WebStart installation does not work in your browser, copy
@@ -89,95 +81,102 @@
  or <command>opendj/QuickSetup.app</command> (Mac OS X).
 </para>

 <para>Java WebStart launches the the QuickSetup wizard, and soon the
 Welcome screen appears.</para>
 <para>
  Java WebStart launches the the QuickSetup wizard,
  and soon the Welcome screen appears.
 </para>

 <mediaobject xml:id="figure-quicksetup-welcome">
  <imageobject>
   <imagedata fileref="images/QuickSetup-welcome.png" format="PNG" />
  </imageobject>
  <textobject>
   <para>The Welcome screen summarizes the setup process.</para>
  </textobject>
 </mediaobject>
  <itemizedlist>
   <para>
    The QuickSetup wizard presents the following screens:
   </para>

 <mediaobject xml:id="figure-quicksetup-license">
  <imageobject>
   <imagedata fileref="images/QuickSetup-license.png" format="PNG" />
  </imageobject>
  <textobject>
   <para>Accept the license to install OpenDJ directory server if QuickSetup
   presents a license text.</para>
  </textobject>
 </mediaobject>
   <listitem>
    <para>
     <emphasis>Welcome</emphasis>: summarizes the setup process
     and indicates the minimum required Java version
    </para>
   </listitem>

 <mediaobject xml:id="figure-quicksetup-svrconf">
  <imageobject>
   <imagedata fileref="images/QuickSetup-svrconf.png" format="PNG" />
  </imageobject>
  <textobject>
   <para>In the Server Settings screen that the default ports
   are 389 or 1389 for LDAP, 4444 for administrative access.</para>
  </textobject>
 </mediaobject>
   <listitem>
    <para>
     <emphasis>License</emphasis>: presents the license agreement to accept
     before installing OpenDJ software
    </para>
   </listitem>

 <mediaobject xml:id="figure-quicksetup-replopts">
   <imageobject>
     <imagedata fileref="images/QuickSetup-replopts.png" format="PNG" />
   </imageobject>
   <textobject>
    <para>You can replicate data for high availability through the
    Topology Options screen.</para>
   </textobject>
 </mediaobject>
   <listitem>
    <para>
     <emphasis>Server Settings</emphasis>: prompts for basic server settings
     including installation path, host name, port numbers, secure connections,
     and credentials for the directory superuser
     (default bind DN: <literal>cn=Directory Manager</literal>)
    </para>
   </listitem>

 <mediaobject xml:id="figure-quicksetup-gendata">
  <imageobject>
   <imagedata fileref="images/QuickSetup-gendata.png" format="PNG" />
  </imageobject>
   <textobject>
    <para>You can generate test data as part of server setup in the Directory
    Data screen.</para>
   </textobject>
 </mediaobject>
   <listitem>
    <para>
     <emphasis>Topology Options</emphasis>: prompts for data replication options
     including whether this server is part of a replication topology,
     and if so the port number and security settings for this server,
     as well as the connection settings for a remote replica if available
    </para>
   </listitem>

 <mediaobject xml:id="figure-quicksetup-jvmopts">
  <imageobject>
   <imagedata fileref="images/QuickSetup-jvmopts.png" format="PNG" />
  </imageobject>
   <textobject>
    <para>For a real installation, you can adjust JVM parameters for
    your server, for example to allow OpenDJ to use more memory.</para>
   </textobject>
 </mediaobject>
   <listitem>
    <para>
     <emphasis>Directory Data</emphasis>: allows you to import or to generate
     LDAP directory data as part of the setup process
    </para>

 <mediaobject xml:id="figure-quicksetup-review">
  <imageobject>
   <imagedata fileref="images/QuickSetup-review.png" format="PNG" />
  </imageobject>
   <textobject>
    <para>You can opt to start your server when setup completes.</para>
   </textobject>
 </mediaobject>
    <para>
     This screen also allows you to select the backend type for data storage.
    </para>
   </listitem>

 <mediaobject xml:id="figure-quicksetup-finished">
  <imageobject>
   <imagedata fileref="images/QuickSetup-finished.png" format="PNG" />
  </imageobject>
   <textobject>
    <para>Click the Launch Control Panel button to check your newly
    installed server.</para>
   </textobject>
 </mediaobject>
   <listitem>
    <para>
     <emphasis>Runtime Options</emphasis>: allows you to adjust
     JVM settings as part of the setup process,
     for example to allow OpenDJ to use more memory if necessary
    </para>
   </listitem>

 <mediaobject xml:id="figure-quicksetup-control-panel">
  <imageobject>
   <imagedata fileref="images/OpenDJ-Control-Panel.png" format="PNG" />
  </imageobject>
   <textobject>
    <para>OpenDJ Control Panel offers basic administration capabilities.</para>
   </textobject>
 </mediaobject>
   <listitem>
    <para>
     <emphasis>Review</emphasis>: presents current selections
     so that you can check everything is correct before running setup,
     with the option to start OpenDJ directory server after setup completes
    </para>
   </listitem>

   <listitem>
    <para>
     <emphasis>Finished</emphasis>: summarizes how setup completed,
     with the option to launch the OpenDJ Control Panel
    </para>
   </listitem>
  </itemizedlist>

  <para>
   <xref linkend="figure-quicksetup-control-panel" />
   shows the top-level window with status information.
   OpenDJ Control Panel helps to manage directory data, LDAP schema, indexes,
   monitoring, and JVM runtime options through a graphical user interface.
  </para>

  <figure xml:id="figure-quicksetup-control-panel">
   <title>OpenDJ Control Panel</title>

   <mediaobject>
    <imageobject>
     <imagedata fileref="images/OpenDJ-Control-Panel.png" format="PNG" />
    </imageobject>
     <textobject>
      <para>OpenDJ Control Panel offers basic administration capabilities.</para>
     </textobject>
   </mediaobject>
  </figure>
 </section>

 <section xml:id="install-gui-windows-msi">

 opendj-server-legacy/src/main/docbkx/install-guide/chap-uninstall.xml

@@ -57,28 +57,23 @@
   <para>(Windows) Double-click <filename>/path/to/opendj\uninstall.bat</filename>.</para>
   <para>(Mac OS X) Double-click <filename>/path/to/opendj/Uninstall.app</filename>.</para>

   <mediaobject xml:id="figure-uninstall-start">
    <imageobject>
     <imagedata fileref="images/uninstall-start.png" format="PNG" />
    </imageobject>
    <textobject>
     <para>Select what to remove in the initial screen.</para>
    </textobject>
   </mediaobject>
   <para>
    The Uninstall Options screen appears.
   </para>
  </step>

  <step>
   <para>When the process is finished, you might still have some files
   to remove manually.</para>
   <para>
    Select the components to remove in the Uninstall Options screen,
    and then click Uninstall to proceed.
   </para>
  </step>

   <mediaobject xml:id="figure-uninstall-finished">
    <imageobject>
     <imagedata fileref="images/uninstall-finished.png" format="PNG" />
    </imageobject>
    <textobject>
     <para>The final screen indicates what must be removed manually.</para>
    </textobject>
   </mediaobject>
  <step>
   <para>
    To complete the process,
    manually remove any remaining components indicated in the Finished screen.
   </para>
  </step>
 </procedure>


 opendj-server-legacy/src/main/docbkx/install-guide/images/OpenDJ-Control-Panel.png

 opendj-server-legacy/src/main/docbkx/install-guide/images/QuickSetup-finished.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/images/QuickSetup-gendata.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/images/QuickSetup-jvmopts.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/images/QuickSetup-license.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/images/QuickSetup-replopts.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/images/QuickSetup-review.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/images/QuickSetup-svrconf.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/images/QuickSetup-welcome.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/images/missing-java6.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/images/uninstall-finished.png

Binary files differ

 opendj-server-legacy/src/main/docbkx/install-guide/images/uninstall-start.png

Binary files differ