<!--
	Licensed to the Apache Software Foundation (ASF) under one
	or more contributor license agreements.  See the NOTICE file
	distributed with this work for additional information
	regarding copyright ownership.  The ASF licenses this file
	to you under the Apache License, Version 2.0 (the
	"License"); you may not use this file except in compliance
	with the License.  You may obtain a copy of the License at
	
	http://www.apache.org/licenses/LICENSE-2.0
	
	Unless required by applicable law or agreed to in writing,
	software distributed under the License is distributed on an
	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	KIND, either express or implied.  See the License for the
	specific language governing permissions and limitations
	under the License.
-->
<section id="gettingstarted_ldapservers_view">
	<title>LDAP Servers View</title>
	<para>
		The LDAP Servers view allows you to manage the servers. This view
		displays a list of all your servers. You can use this view to
		start or stop the servers.
	</para>
	<para>
		Here is an example screenshot of the LDAP Servers view:
		<screenshot>
			<mediaobject>
				<imageobject>
					<imagedata scale="50"
						fileref="images/views_ldap_servers.png"
						format="PNG" />
				</imageobject>
			</mediaobject>
		</screenshot>
	</para>
	<para>
		Use the LDAP Servers view to perform the following tasks:
		<itemizedlist spacing="normal" mark="bullet">
			<listitem>Create a server</listitem>
			<listitem>Rename a server</listitem>
			<listitem>Configure a server</listitem>
			<listitem>Start a server</listitem>
			<listitem>Create a connection to the server</listitem>
			<listitem>Stop a server</listitem>
			<listitem>Delete a server</listitem>
		</itemizedlist>
	</para>
	<para>
		The LDAP Servers view displays the current status of all the servers.
		The
		<emphasis role="strong">State</emphasis>
		column indicates whether or not a server has been started. The
		following lists the possible server status:
		<itemizedlist spacing="normal" mark="bullet">
			<listitem>Starting</listitem>
			<listitem>Started</listitem>
			<listitem>Stopping</listitem>
			<listitem>Stopped</listitem>
		</itemizedlist>
	</para>
	<para>
		<emphasis role="strong">Toolbar</emphasis>
	</para>
	<para>
		The toolbar of the LDAP Servers view contains the following actions:
		<itemizedlist spacing="normal" mark="bullet">
			<listitem>
				<imageobject>
					<imagedata scale="50"
						fileref="images/icons_server_new.gif" format="GIF" />
				</imageobject>
				-
				<emphasis>New server</emphasis>
				: Creates a new LDAP server.
			</listitem>
			<listitem>
				<imageobject>
					<imagedata scale="50"
						fileref="images/icons_run.gif" format="GIF" />
				</imageobject>
				-
				<emphasis>Run</emphasis>
				: Starts the selected LDAP server.
			</listitem>
			<listitem>
				<imageobject>
					<imagedata scale="50"
						fileref="images/icons_stop.gif" format="GIF" />
				</imageobject>
				-
				<emphasis>Stop</emphasis>
				: Stops the selected LDAP server.
			</listitem>
		</itemizedlist>
	</para>
	<para>
		<emphasis role="strong">Context Menu</emphasis>
	</para>
	<para>
		The context menu of the LDAP Servers view contains the following actions:
		<itemizedlist spacing="normal" mark="bullet">
			<listitem>
				<imageobject>
					<imagedata scale="50"
						fileref="images/icons_server_new.gif" format="GIF" />
				</imageobject>
				-
				<emphasis>New Server</emphasis>
				: Creates a new LDAP server.
			</listitem>
			<listitem>
				<emphasis>Open Configuration</emphasis>
				: Opens the configuration editor.
			</listitem>
			<listitem>
				<imageobject>
					<imagedata scale="50"
						fileref="images/icons_delete.gif" format="GIF" />
				</imageobject>
				-
				<emphasis>Delete</emphasis>
				: Deletes the selected LDAP server.
			</listitem>
			<listitem>
				<emphasis>Rename...</emphasis>
				: Renames the selected LDAP server.
			</listitem>
			<listitem>
				<imageobject>
					<imagedata scale="50"
						fileref="images/icons_run.gif" format="GIF" />
				</imageobject>
				-
				<emphasis>Run</emphasis>
				: Starts the selected LDAP server.
			</listitem>
			<listitem>
				<imageobject>
					<imagedata scale="50"
						fileref="images/icons_stop.gif" format="GIF" />
				</imageobject>
				-
				<emphasis>Stop</emphasis>
				: Stops the selected LDAP server.
			</listitem>
			<listitem>
				<imageobject>
					<imagedata scale="50"
						fileref="images/icons_connection_add.gif" format="GIF" />
				</imageobject>
				-
				<emphasis>Create a Connection</emphasis>
				: Creates a preconfigured connection to the selected LDAP server.
			</listitem>
			<listitem>
				<emphasis>Properties</emphasis>
				: Opens the properties dialog of the selected LDAP server which shows details like version and the path the to configuration folder.
			</listitem>
		</itemizedlist>
	</para>


	<para>
		<emphasis role="strong">Icons</emphasis>
	</para>
	<para>The following icons can appear in the LDAP Servers view:</para>
	<para>
		<informaltable>
			<tgroup cols="2">
				<colspec colname="Icon" colwidth="1* " />
				<colspec colname="Description" colwidth="3*" />
				<thead>
					<row>
						<entry>Icon</entry>
						<entry>Description</entry>
					</row>
				</thead>
				<tbody>
					<row>
						<entry align="center">
							<mediaobject>
								<imageobject>
									<imagedata scale="50"
										fileref="images/icons_server.gif" format="GIF" />
								</imageobject>
							</mediaobject>
						</entry>
						<entry>Server</entry>
					</row>
					<row>
						<entry align="center">
							<mediaobject>
								<imageobject>
									<imagedata scale="50"
										fileref="images/icons_server_starting1.gif"
										format="GIF" />
								</imageobject>
							</mediaobject>
							<mediaobject>
								<imageobject>
									<imagedata scale="50"
										fileref="images/icons_server_starting2.gif"
										format="GIF" />
								</imageobject>
							</mediaobject>
							<mediaobject>
								<imageobject>
									<imagedata scale="50"
										fileref="images/icons_server_starting3.gif"
										format="GIF" />
								</imageobject>
							</mediaobject>
						</entry>
						<entry>Starting server</entry>
					</row>
					<row>
						<entry align="center">
							<mediaobject>
								<imageobject>
									<imagedata scale="50"
										fileref="images/icons_server_started.gif"
										format="GIF" />
								</imageobject>
							</mediaobject>
						</entry>
						<entry>Started server</entry>
					</row>
					<row>
						<entry align="center">
							<mediaobject>
								<imageobject>
									<imagedata scale="50"
										fileref="images/icons_server_stopping1.gif"
										format="GIF" />
								</imageobject>
							</mediaobject>
							<mediaobject>
								<imageobject>
									<imagedata scale="50"
										fileref="images/icons_server_stopping2.gif"
										format="GIF" />
								</imageobject>
							</mediaobject>
							<mediaobject>
								<imageobject>
									<imagedata scale="50"
										fileref="images/icons_server_stopping3.gif"
										format="GIF" />
								</imageobject>
							</mediaobject>
						</entry>
						<entry>Stopping server</entry>
					</row>
					<row>
						<entry align="center">
							<mediaobject>
								<imageobject>
									<imagedata scale="50"
										fileref="images/icons_server_stopped.gif"
										format="GIF" />
								</imageobject>
							</mediaobject>
						</entry>
						<entry>Stopped server</entry>
					</row>
				</tbody>
			</tgroup>
		</informaltable>
	</para>
</section>