各种笔记
選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。

506 行
24 KiB

4年前
  1. # 服务器用法
  2. arangod [<option>]
  3. 可以将数据库目录指定为位置 第一个参数
  4. arangod /path/to/datadir
  5. 或者显示作为命名参数
  6. arangod --database.directory /path/to/datadir
  7. 所有其他参数都需要作为命名参数传递
  8. 两个连字符(--)后跟选项名称 然后 等号或者空格 最后是参数值 如果参数值包含了空格 还需要用引号引起来
  9. = 两边 有空格
  10. # 各种配置选项
  11. ## Global
  12. Name Typ
  13. check-configuration boolean
  14. 检查配置并退出 这是一个命令,不需要指定任何值。执行命令后,进程终止。
  15. config string
  16. The configuration file or ‘none’
  17. Default: ""
  18. configuration string
  19. The configuration file or ‘none’
  20. Default: ""
  21. console boolean
  22. Start a JavaScript emergency console
  23. This option can be specified without value to enable it.
  24. Default: false
  25. daemon boolean
  26. Background the server, running it as daemon
  27. This option can be specified without value to enable it.
  28. Default: false
  29. default-language string
  30. ISO-639 language code
  31. Default: ""
  32. define string…
  33. Define key=value for a @key@ entry in config file
  34. Default: []
  35. dump-dependencies boolean
  36. Dump dependency graph
  37. This is a command, no value needs to be specified. The process terminates after executing the command.
  38. dump-options boolean
  39. Dump configuration options in JSON format
  40. This is a command, no value needs to be specified. The process terminates after executing the command.
  41. fortune boolean
  42. Show fortune cookie on startup
  43. This option can be specified without value to enable it.
  44. Default: false
  45. gid string
  46. Switch to group-id after reading config files
  47. Default: ""
  48. hund boolean
  49. Make ArangoDB bark on startup
  50. This option can be specified without value to enable it.
  51. Default: false
  52. log string…
  53. The global or topic-specific log level
  54. Default: ["info","info"]
  55. Deprecated in: v3.5.0
  56. pid-file string
  57. Pid-file in daemon mode
  58. Default: ""
  59. supervisor boolean
  60. Background the server, starts a supervisor
  61. This option can be specified without value to enable it.
  62. Default: false
  63. uid string
  64. Switch to user-id after reading config files
  65. Default: ""
  66. version boolean
  67. Reports the version and exits
  68. This is a command, no value needs to be specified. The process terminates after executing the command.
  69. working-directory string
  70. Working directory in daemon mode
  71. Default: "/var/tmp"
  72. ## Agency
  73. Name Type Description
  74. agency.activate boolean Activate agency
  75. This option can be specified without value to enable it.
  76. Default: false
  77. Effective on Agents only.
  78. agency.compaction-keep-size uint64 Keep as many indices before compaction point
  79. Default: 50000
  80. Effective on Agents only.
  81. agency.compaction-step-size uint64 Step size between state machine compactions
  82. Default: 1000
  83. Effective on Agents only.
  84. agency.disaster-recovery-id string Allows for specification of the id for this agent; dangerous option for disaster recover only!
  85. Default: ""
  86. Effective on Agents only.
  87. agency.election-timeout-max double Maximum timeout before an agent calls for new election (in seconds)
  88. Default: 5
  89. Effective on Agents only.
  90. agency.election-timeout-min double Minimum timeout before an agent calls for new election (in seconds)
  91. Default: 1
  92. Effective on Agents only.
  93. agency.endpoint string… Agency endpoints
  94. Default: []
  95. Effective on Agents only.
  96. agency.max-append-size uint64 Maximum size of appendEntries document (# log entries)
  97. Default: 250
  98. Effective on Agents only.
  99. agency.my-address string Which address to advertise to the outside
  100. Default: ""
  101. Effective on Agents only.
  102. agency.pool-size uint64 Number of agent pool
  103. Default: 1
  104. Effective on Agents only.
  105. agency.size uint64 Number of agents
  106. Default: 1
  107. Effective on Agents only.
  108. agency.supervision boolean Perform arangodb cluster supervision
  109. This option can be specified without value to enable it.
  110. Default: false
  111. Effective on Agents only.
  112. agency.supervision-frequency double Arangodb cluster supervision frequency (in seconds)
  113. Default: 1
  114. Effective on Agents only.
  115. agency.supervision-grace-period double Supervision time, after which a server is considered to have failed (in seconds)
  116. Default: 10
  117. Effective on Agents only.
  118. agency.supervision-ok-threshold double Supervision time, after which a server is considered to be bad [s]
  119. Default: 5
  120. Effective on Agents only.
  121. agency.wait-for-sync boolean Wait for hard disk syncs on every persistence call (required in production)
  122. This option can be specified without value to enable it.
  123. Default: true
  124. Effective on Agents only.
  125. ## ArangoSearch
  126. Name Type Description
  127. arangosearch.threads uint64 The exact number of threads to use for asynchronous tasks (0 == autodetect)
  128. Default: 0
  129. arangosearch.threads-limit uint64 Upper limit to the autodetected number of threads to use for asynchronous
  130. ## Audit
  131. Name Type Description
  132. audit.hostname string Enterprise Edition only
  133. Hostname to use
  134. Default: ""
  135. audit.output string… Enterprise Edition only
  136. Audit destinatio
  137. ## Backup
  138. Name Type Description
  139. backup.api-enabled string Whether the backup api is enabled (true) or not (false), or only enabled for superuser JWT (jwt)
  140. Default: "true"
  141. backup.local-path-prefix This option restricts any backup target to a given path prefix Default: "/"
  142. ## Cache
  143. cache.rebalancing-interval uint64 Microseconds between rebalancing attempts
  144. Default: 2000000
  145. cache.size uint64 Size of cache in bytes
  146. Default: dynamic (e.g. 33252951040)
  147. ## Cluster
  148. Name Type Description
  149. cluster.agency-endpoint string… Agency endpoint to connect to
  150. Default: []
  151. Effective on Coordinators and DB-Servers only.
  152. cluster.create-waits-for-sync-replication boolean Active coordinator will wait for all replicas to create collection
  153. This option can be specified without value to enable it.
  154. Default: true
  155. Effective on Coordinators and DB-Servers only.
  156. cluster.default-replication-factor uint32 Default replication factor for non-system collections
  157. Default: 0
  158. Effective on Coordinators only.
  159. Introduced in: v3.6.0
  160. cluster.force-one-shard boolean Force one-shard mode for all new collections
  161. This option can be specified without value to enable it.
  162. Default: false
  163. Effective on Coordinators only.
  164. Introduced in: v3.6.0
  165. cluster.index-create-timeout double Amount of time (in seconds) the coordinator will wait for an index to be created before giving up
  166. Default: 3600
  167. Effective on Coordinators only.
  168. cluster.max-number-of-shards uint32 Maximum number of shards when creating new collections (0 = unrestricted)
  169. Default: 1000
  170. Effective on Coordinators only.
  171. Introduced in: v3.5.1
  172. cluster.max-replication-factor uint32 Maximum replication factor for new collections (0 = unrestricted)
  173. Default: 10
  174. Effective on Coordinators only.
  175. Introduced in: v3.6.0
  176. cluster.min-replication-factor uint32 Minimum replication factor for new collections
  177. Default: 1
  178. Effective on Coordinators only.
  179. Introduced in: v3.6.0
  180. cluster.my-address string This server’s endpoint (cluster internal)
  181. Default: ""
  182. Effective on Coordinators and DB-Servers only.
  183. cluster.my-advertised-endpoint string This server’s advertised endpoint (e.g. external IP address or load balancer, optional)
  184. Default: ""
  185. Effective on Coordinators and DB-Servers only.
  186. cluster.my-role string This server’s role
  187. Default: ""
  188. cluster.require-persisted-id boolean If set to true, then the instance will only start if a UUID file is found in the database on startup. Setting this option will make sure the instance is started using an already existing database directory and not a new one. For the first start, the UUID file must either be created manually or the option must be set to false for the initial startup
  189. This option can be specified without value to enable it.
  190. Default: false
  191. cluster.resign-leadership-on-shutdown boolean Create resign leader ship job for this dbsever on shutdown
  192. This option can be specified without value to enable it.
  193. Default: false
  194. Effective on DB-Servers only.
  195. cluster.synchronous-replication-timeout-factor double All synchronous replication timeouts are multiplied by this factor
  196. Default: 1
  197. cluster.synchronous-replication-timeout-minimum double All synchronous replication timeouts will be at least this value (in seconds)
  198. Default: 30
  199. cluster.synchronous-replication-timeout-per-4k double All synchronous replication timeouts are increased by this amount per 4096 bytes (in seconds)
  200. Default: 0.1
  201. cluster.system-replication-factor uint32 Default replication factor for system collections
  202. Default: 2
  203. Effective on Coordinators only.
  204. cluster.upgrade string Perform a cluster upgrade if necessary (auto = perform upgrade and shut down only if --database.auto-upgrade true is set, disable = never perform upgrade, force = always perform an upgrade and shut down, online = always perform an upgrade but don’t shut down)
  205. Default: "auto"
  206. Possible values: “auto”, “disable”, “force”, “online”
  207. cluster.write-concern uint32 Write concern used for writes to new collections
  208. Default: 1
  209. Effective on Coordinators only.
  210. Introduced in: v3.6.0
  211. ## Database
  212. Name Type Description
  213. database.auto-upgrade boolean Perform a database upgrade if necessary
  214. This option can be specified without value to enable it.
  215. Default: false
  216. database.check-version boolean Checks the versions of the database and exit
  217. This is a command, no value needs to be specified. The process terminates after executing the command.
  218. database.directory string Path to the database directory
  219. Default: ""
  220. database.force-sync-properties boolean Force syncing of collection properties to disk, will use waitForSync value of collection when turned off
  221. This option can be specified without value to enable it.
  222. Default: true
  223. database.ignore-datafile-errors boolean Load collections even if datafiles may contain errors
  224. This option can be specified without value to enable it.
  225. Default: false
  226. database.init-database boolean Initializes an empty database
  227. This is a command, no value needs to be specified. The process terminates after executing the command.
  228. database.password string Initial password of root user
  229. Default: ""
  230. database.required-directory-state string Required state of database directory at startup (non-existing: database directory must not exist, existing: database directory must exist, empty: database directory must exist but be empty, populated: database directory must exist and contain specific files already, any: any state allowed)
  231. Default: "any"
  232. Possible values: “any”, “empty”, “existing”, “non-existing”, “populated”
  233. database.restore-admin boolean Resets the admin users and sets a new password
  234. This is a command, no value needs to be specified. The process terminates after executing the command.
  235. database.throw-collection-not-loaded-error boolean Throw an error when accessing a collection that is still loading
  236. This option can be specified without value to enable it.
  237. Default: false
  238. Deprecated in: v3.7.0
  239. database.upgrade-check boolean Skip a database upgrade
  240. This option can be specified without value to enable it.
  241. Default: true
  242. database.wait-for-sync boolean Default wait-for-sync behavior, can be overwritten when creating a collection
  243. This option can be
  244. ## Foxx
  245. Name Type Description
  246. foxx.api boolean Enables Foxx management REST APIs
  247. This option can be specified without value to enable it.
  248. Default: true
  249. Effective on Coordinators and Single Servers only.
  250. Introduced in: v3.5.0
  251. foxx.queues boolean Enable Foxx queues
  252. This option can be specified without value to enable it.
  253. Default: true
  254. Effective on Coordinators and Single Servers only.
  255. foxx.queues-poll-interval double Poll interval (in seconds) for Foxx queue manager
  256. Default: 1
  257. Effective on Coordinators and Single Servers only.
  258. foxx.store boolean Enables Foxx store in web interface
  259. This option can be specified without value to enable it.
  260. Default: true
  261. Effective on Coordinators and Single Servers only.
  262. Introduced in: v3.5.0
  263. # Frontend
  264. Name Type Description
  265. frontend.proxy-request-check boolean Enable proxy request checking
  266. This option can be specified without value to enable it.
  267. Default: true
  268. Effective on Coordinators and Single Servers only.
  269. frontend.trusted-proxy string… List of proxies to trust (may be IP or network). Make sure --frontend.proxy-request-check is enabled
  270. Default: []
  271. Effective on Coordinators and Single Servers only.
  272. frontend.version-check boolean Alert the user if new versions are available
  273. This option can be specified without value to enable it.
  274. Default: true
  275. Effective on Coordinators and Single Servers only.
  276. ## HTTP
  277. Name Type Description
  278. http.allow-method-override boolean Allow HTTP method override using special headers
  279. This option can be specified without value to enable it.
  280. Default: false
  281. http.hide-product-header boolean Do not expose “Server: ArangoDB” header in HTTP responses
  282. This option can be specified without value to enable it.
  283. Default: false
  284. http.keep-alive-timeout double Keep-alive timeout in seconds
  285. Default: 300
  286. http.trusted-origin string… Trusted origin URLs for CORS requests with credentials
  287. Default: []
  288. # JavaScript
  289. Name Type Description
  290. javascript.allow-admin-execute boolean For testing purposes allow ‘_admin/execute’, NEVER enable on production
  291. This option can be specified without value to enable it.
  292. Default: false
  293. Effective on Coordinators and Single Servers only.
  294. javascript.allow-external-process-control boolean Allow execution and control of external processes from within JavaScript actions
  295. This option can be specified without value to enable it.
  296. Default: false
  297. Effective on Coordinators and Single Servers only.
  298. Introduced in: v3.5.0
  299. javascript.allow-port-testing boolean Allow testing of ports from within JavaScript actions
  300. This option can be specified without value to enable it.
  301. Default: false
  302. Effective on Coordinators and Single Servers only.
  303. Introduced in: v3.5.0
  304. javascript.app-path string Directory for Foxx applications
  305. Default: "./js/apps"
  306. Effective on Coordinators and Single Servers only.
  307. javascript.copy-installation boolean Copy contents of ‘javascript.startup-directory’ on first start
  308. This option can be specified without value to enable it.
  309. Default: false
  310. Effective on Coordinators and Single Servers only.
  311. javascript.enabled boolean Enable the V8 JavaScript engine
  312. This option can be specified without value to enable it.
  313. Default: true
  314. Effective on Coordinators and Single Servers only.
  315. javascript.endpoints-blacklist string… Endpoints that cannot be connected to via @arangodb/request module in JavaScript actions if not whitelisted
  316. Default: []
  317. Effective on Coordinators and Single Servers only.
  318. Introduced in: v3.5.0
  319. javascript.endpoints-whitelist string… Endpoints that can be connected to via @arangodb/request module in JavaScript actions
  320. Default: []
  321. Effective on Coordinators and Single Servers only.
  322. Introduced in: v3.5.0
  323. javascript.environment-variables-blacklist string… Environment variables that will be inaccessible in JavaScript if not whitelisted
  324. Default: []
  325. Effective on Coordinators and Single Servers only.
  326. Introduced in: v3.5.0
  327. javascript.environment-variables-whitelist string… Environment variables that will be accessible in JavaScript
  328. Default: []
  329. Effective on Coordinators and Single Servers only.
  330. Introduced in: v3.5.0
  331. javascript.files-whitelist string… Filesystem paths that will be accessible from within JavaScript actions
  332. Default: []
  333. Effective on Coordinators and Single Servers only.
  334. Introduced in: v3.5.0
  335. javascript.gc-frequency double JavaScript time-based garbage collection frequency (each x seconds)
  336. Default: 60
  337. Effective on Coordinators and Single Servers only.
  338. javascript.gc-interval uint64 JavaScript request-based garbage collection interval (each x requests)
  339. Default: 2000
  340. Effective on Coordinators and Single Servers only.
  341. javascript.harden boolean Disables access to JavaScript functions in the internal module: getPid() and logLevel()
  342. This option can be specified without value to enable it.
  343. Default: false
  344. Effective on Coordinators and Single Servers only.
  345. Introduced in: v3.5.0
  346. javascript.module-directory string… Additional paths containing JavaScript modules
  347. Default: ["./enterprise/js"]
  348. Effective on Coordinators and Single Servers only.
  349. javascript.script string… Run scripts and exit
  350. Default: []
  351. javascript.script-parameter string… Script parameter
  352. Default: []
  353. javascript.startup-directory string Path to the directory containing JavaScript startup scripts
  354. Default: "./js"
  355. Effective on Coordinators and Single Servers only.
  356. javascript.startup-options-blacklist string… Startup options whose names match this regular expression will not be exposed (if not whitelisted) to JavaScript actions
  357. Default: []
  358. Effective on Coordinators and Single Servers only.
  359. Introduced in: v3.5.0
  360. javascript.startup-options-whitelist string… Startup options whose names match this regular expression will be whitelisted and exposed to JavaScript
  361. Default: []
  362. Effective on Coordinators and Single Servers only.
  363. Introduced in: v3.5.0
  364. javascript.v8-contexts uint64 Maximum number of V8 contexts that are created for executing JavaScript actions
  365. Default: 0
  366. Effective on Coordinators and Single Servers only.
  367. javascript.v8-contexts-max-age double Maximum age for each V8 context (in seconds) before it is disposed
  368. Default: 60
  369. Effective on Coordinators and Single Servers only.
  370. javascript.v8-contexts-max-invocations uint64 Maximum number of invocations for each V8 context before it is disposed
  371. Default: 0
  372. Effective on Coordinators and Single Servers only.
  373. javascript.v8-contexts-minimum uint64 Minimum number of V8 contexts that keep available for executing JavaScript actions
  374. Default: 0
  375. Effective on Coordinators and Single Servers only.
  376. javascript.v8-max-heap uint64 Maximal heap size (in MB)
  377. Default: 3072
  378. javascript.v8-options string… Options to pass to v8
  379. Default: []
  380. ## LDAP
  381. Name Type Description
  382. ldap.allow-offline boolean Enterprise Edition only
  383. If a refresh attempt fails to connect to the LDAP server, continue with the cached authentication data
  384. This option can be specified without value to enable it.
  385. Default: false
  386. ldap.async-connect boolean Enterprise Edition only
  387. Whether or not the connection to the LDAP library will be done asynchronously
  388. This option can be specified without value to enable it.
  389. Default: false
  390. ldap.basedn string Enterprise Edition only
  391. Ldap basedn, eg. dc=example,dc=com
  392. Default: ""
  393. ldap.binddn string Enterprise Edition only
  394. Ldap binddn, eg. cn=admin,dc=example,dc=com
  395. Default: ""
  396. ldap.bindpasswd string Enterprise Edition only
  397. Ldap bindpassword, eg. admin
  398. Default: ""
  399. ldap.debug boolean Enterprise Edition only
  400. Turn on internal OpenLDAP library output (warning: will print to stdout)
  401. This option can be specified without value to enable it.
  402. Default: false
  403. ldap.enabled boolean Enterprise Edition only
  404. Enable LDAP
  405. This option can be specified without value to enable it.
  406. Default: false
  407. ldap.network-timeout double Enterprise Edition only
  408. Timeout value (in seconds) after which network operations following the initial connection return in case of no activity (a value of 0 means default timeout)
  409. Default: 0
  410. ldap.port uint16 Enterprise Edition only
  411. Port to use
  412. Default: 389
  413. ldap.prefix string Enterprise Edition only
  414. Ldap prefix, eg. uid= xor dn= xor cn=
  415. Default: ""
  416. ldap.referrals boolean Enterprise Edition only
  417. Whether or not the LDAP library should implicitly chase referrals
  418. This option can be specified without value to enable it.
  419. Default: false
  420. ldap.refresh-rate double Enterprise Edition only
  421. Refresh user settings after this time (in seconds)
  422. Default: 300
  423. ldap.restart boolean Enterprise Edition only
  424. Whether or not the LDAP library should implicitly restart connections
  425. This option can be specified without value to enable it.
  426. Default: false
  427. ldap.retries uint32 Enterprise Edition only
  428. Number of tries to attempt connecting to the LDAP server. Setting it to values greater than one will retry connecting in case the LDAP server is unavailable or denies the connection
  429. Default: 1
  430. ldap.roles-attribute-name string Enterprise Edition only
  431. Ldap attributename where the role are located.
  432. Default: ""
  433. ldap.roles-exclude string Enterprise Edition only
  434. Regexp to exclude groups. Leave empty to exclude none.
  435. Default: ""
  436. ldap.roles-include string Enterprise Edition only
  437. Regexp to include groups. Leave empty to include all.
  438. Default: ""
  439. ldap.roles-search string Enterprise Edition only
  440. Ldap search for roles; ‘{USER}’ is replaced by the ‘dn’ of the user.
  441. Default: ""
  442. ldap.roles-transformation string… Enterprise Edition only
  443. Regexp to normalizer role name, e.g. ‘/^ (.[^ ]])*/$2/’
  444. Default: []
  445. ldap.search-attribute string Enterprise Edition only
  446. Ldap search attribute, eg. uid
  447. Default: "uid"
  448. ldap.search-filter string Enterprise Edition only
  449. Ldap search filter, eg. (objectClass=simpleSecurityObject)
  450. Default: "objectClass=*"
  451. ldap.search-scope string Enterprise Edition only
  452. Ldap search scope, one of base, one, sub
  453. Default: "sub"
  454. ldap.serialize-timeout double Enterprise Edition only
  455. Maximum amount of time (in seconds) that will be waited for the serialization mutex
  456. Default: 5
  457. ldap.serialized boolean Enterprise Edition only
  458. Whether or not calls into the LDAP library should be serialized. This option can be used to work around thread-unsafe LDAP library functionality
  459. This option can be specified without value to enable it.
  460. Default: false
  461. ldap.server string Enterprise Edition only
  462. Server to use
  463. Default: ""
  464. ldap.suffix string Enterprise Edition only
  465. Ldap suffix, eg. ,dc=example,dc=com
  466. Default: ""
  467. ldap.superuser-role string Enterprise Edition only
  468. Role mapping to the super-users
  469. Default: ""
  470. ldap.timeout double Enterprise Edition only
  471. Timeout value (in seconds) for synchronous LDAP API calls (a value of 0 means default timeout)
  472. Default: 0
  473. ldap.tls boolean Enterprise Edition only
  474. Enable TLS
  475. This option can be specified without value to enable it.
  476. Default: false
  477. ldap.tls-cacert-dir string Enterprise Edition only
  478. Ldap tls cacert dir
  479. Default: ""
  480. ldap.tls-cacert-file string Enterprise Edition only
  481. Ldap tls cacert file
  482. Default: ""
  483. ldap.tls-cert-check-strategy string Enterprise Edition only
  484. Ldap tls cert check strategy, one of never, hard, demand, allow, try
  485. Default: "hard"
  486. ldap.tls-version string Enterprise Edition only
  487. Ldap tls version, one of 1.0, 1.1, 1.2
  488. Default: "1.2"
  489. ldap.url string Enterprise Edition only
  490. Ldap url, eg. ldap://example.com:389/dc=example,dc=com?uid?sub
  491. Default: ""