mirror of https://gitee.com/bigwinds/arangodb
138 lines
5.3 KiB
Plaintext
138 lines
5.3 KiB
Plaintext
////////////////////////////////////////////////////////////////////////////////
|
|
/// @brief user guide guide
|
|
///
|
|
/// @file
|
|
///
|
|
/// DISCLAIMER
|
|
///
|
|
/// Copyright 2012 triagens GmbH, Cologne, Germany
|
|
///
|
|
/// Licensed 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.
|
|
///
|
|
/// Copyright holder is triAGENS GmbH, Cologne, Germany
|
|
///
|
|
/// @author Dr. Frank Celler
|
|
/// @author Copyright 2012, triAGENS GmbH, Cologne, Germany
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @page UserManualServer ArangoDB's User Manual
|
|
///
|
|
/// @if LATEX
|
|
/// <ul>
|
|
/// <li>@ref UserManualServerBasics</li>
|
|
/// <li>ArangoQueryLanguage</li>
|
|
/// <li>@ref Glossary</li>
|
|
/// </ul>
|
|
/// @else
|
|
/// @copydetails UserManualServerBasicsTOC
|
|
/// <ul>
|
|
/// <li>Arango Query Language</li>
|
|
/// </ul>
|
|
/// @endif
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @page UserManualServerBasicsTOC
|
|
///
|
|
/// <ul>
|
|
/// <li>@ref UserManualServerBasics
|
|
/// <ul>
|
|
/// <li>@ref UserManualServerStartStop
|
|
/// <ul>
|
|
/// <li>@ref UserManualServerStartStopHttp</li>
|
|
/// <li>@ref UserManualServerStartStopDebug</li>
|
|
/// <li>@ref UserManualServerStartStopOptions</li>
|
|
/// </ul>
|
|
/// </li>
|
|
/// </ul>
|
|
/// </li>
|
|
/// </ul>
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @page UserManualServerBasics Basics
|
|
///
|
|
/// The ArangoDB groups documents into collections. Each collection can be
|
|
/// accessed using queries. For simple queries involving just one collection,
|
|
/// you can use a simple interface from within JavaScript code, see ArangoDB
|
|
/// shell user manual. This interface allows you to select documents from one
|
|
/// collection based on simple search criteria. For more complex queries, you
|
|
/// can use the Arango Query Language, which is an evolution of SQL resp. UNQL.
|
|
///
|
|
/// @EMBEDTOC{UserManualServerBasicsTOC}
|
|
///
|
|
/// @section UserManualServerStartStop Starting the ArangoDB
|
|
/////////////////////////////////////////////////////////////
|
|
///
|
|
/// The ArangoDB has two modes of operation: as server, where it will answer to
|
|
/// client requests and an emergency console, where you can access the database
|
|
/// directly. The latter should - as the name suggests - only be used in case of
|
|
/// an emergency, for example, a corrupted collection. Using the emergency
|
|
/// console allows you to issue all commands normally available in actions and
|
|
/// transactions.
|
|
///
|
|
/// You should never start more than one server for the same database,
|
|
/// independent from the mode of operation.
|
|
///
|
|
/// @subsection UserManualServerStartStopHttp Starting the HTTP Server
|
|
//////////////////////////////////////////////////////////////////////
|
|
///
|
|
/// The following command starts the ArangoDB in server mode. You will be able
|
|
/// to access the server using HTTP request on port 8529. See below for a list
|
|
/// of frequently used options, see @ref CommandLine "here" for a complete list.
|
|
///
|
|
/// @verbinclude option-database-directory
|
|
///
|
|
/// @subsection UserManualServerStartStopDebug Starting the Emergency Console
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
///
|
|
/// The following command starts a emergency console. See below for a list of
|
|
/// frequently used options, see @ref CommandLine "here" for a complete list.
|
|
///
|
|
/// @verbinclude start1
|
|
///
|
|
/// @subsection UserManualServerStartStopOptions Frequently Used Options
|
|
////////////////////////////////////////////////////////////////////////
|
|
///
|
|
/// The following command-line options are frequently used. For a full
|
|
/// list of options see @ref CommandLine "here".
|
|
///
|
|
/// @CMDOPT{@CA{database-directory}}
|
|
///
|
|
/// Uses the @CA{database-directory} as base directory. There is an alternative
|
|
/// version available for use in configuration files, see @ref
|
|
/// CommandLineArango "here".
|
|
///
|
|
/// @copydetails triagens::rest::ApplicationServerImpl::options
|
|
///
|
|
/// @CMDOPT{--log @CA{level}}
|
|
///
|
|
/// Allows the user to choose the level of information which is logged by the
|
|
/// server. The @CA{level} is specified as a string and can be one of the
|
|
/// following values: fatal, error, warning, info, debug, trace. For more
|
|
/// information see @ref CommandLineLogging "here".
|
|
///
|
|
/// @copydetails triagens::arango::ArangoServer::_httpPort
|
|
///
|
|
/// @CMDOPT{--shell}
|
|
///
|
|
/// Opens a debug shell instead of starting the HTTP server.
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Local Variables:
|
|
// mode: c++
|
|
// mode: outline-minor
|
|
// outline-regexp: "^\\(/// @brief\\|/// {@inheritDoc}\\|/// @addtogroup\\|// --SECTION--\\|/// @page\\|/// @\\}\\)"
|
|
// End:
|