From 845d528fbafff229d3c8a424a15e2c675a3b73f6 Mon Sep 17 00:00:00 2001 From: randomJoe211 <69501902+randomJoe211@users.noreply.github.com> Date: Thu, 2 Sep 2021 10:13:38 +0800 Subject: [PATCH] Delete docs-2.0/19.FAQ directory --- docs-2.0/19.FAQ/0.FAQ.md | 217 --------------------------------------- 1 file changed, 217 deletions(-) delete mode 100644 docs-2.0/19.FAQ/0.FAQ.md diff --git a/docs-2.0/19.FAQ/0.FAQ.md b/docs-2.0/19.FAQ/0.FAQ.md deleted file mode 100644 index a7633413c02..00000000000 --- a/docs-2.0/19.FAQ/0.FAQ.md +++ /dev/null @@ -1,217 +0,0 @@ -# FAQ - -This topic lists the frequently asked questions for using Nebula Graph. You can use the search box in the help center or the search function of the browser to match the questions you are looking for. - -If the solutions described in this topic cannot solve the problem, ask for help on the [Nebula Graph forum](https://discuss.nebula-graph.io/) or submit an issue on [GitHub](https://github.com/vesoft-inc/nebula-graph/issues). - -## About manual updates - -???+ faq "Why is the behavior of manual not consistent with the system?" - - Nebula Graph {{ nebula.base20 }} is still under development. Its behavior changes from time to time. Please tell us if the manual and the system are not consistent. - -???+ faq "Some errors in this manula" - - 1. Click the `pencil` button at the top right side of this page. - 2. Use markdown to fix this error. Then "Commit changes" at the bottom, which will start a Github pull request. - 3. Sign the [CLA](../15.contribution/how-to-contribute.md). - This pull request (and the fix) will be merged after to reviewer's accept. - -## About forward and backward compatibility - -???+ caution "Major version compatibility" - - Neubla Graph {{ nebula.release }} is not compatible with Nebula Graph 1.x nor 2.0-RC in both data formats and RPC-protocols, and vice versa. - Check [how to upgrade to Neubla Graph {{ nebula.release }}](../4.deployment-and-installation/3.upgrade-nebula-graph.md). - You must upgrade [all clients](../20.appendix/6.eco-tool-version.md). - -???+ faq "Micro version compatibility" - - Neubla Graph {{ nebula.release }} is compatible with Nebula Graph {{ nebula.base20 }} in both data formats and RPC-protocols. - - -## About executions - -???+ faq "How is the time spent value at the end of each return message calculated?" - - Take the return message of `SHOW SPACES` as an example: - - ```nGQL - nebula> SHOW SPACES; - +-------------------+ - | Name | - +-------------------+ - | basketballplayer | - +-------------------+ - Got 1 rows (time spent 1235/1934 us) - ``` - - * The first number 1235 shows the time spent by the database itself, that is, the time it takes for the query engine to receive a query from the client, fetch the data from the storage server and perform a series of calculations. - - * The second number 1934 shows the time spent from the client's perspective, that is, the time it takes for the client from sending a request, receiving a response, and displaying the result on the screen. - -???+ faq "Can I set replica_factor as an even number in CREATE SPACE statements, e.g., replica_factor = 2?" - - NO. - - The Storage Service garantees its availability based on the Raft consensus protocol. The number of failed replicas must not exceed half of the total replica number. - - When `replica_factor=2`, if one replica fails, the Storage Service fails. No matter `replica_factor=3` or `replica_factor=4`, if more than one replica fails, the Storage Service fails, so `replica_factor=3` is recommended. - - To prevent unnecessary waste of resources, we recommend that you set an odd replica number. - - We suggest that you set replica_factor to 3 for the production environment and 1 for the test environment. Do not use an even number. - -???+ faq "How to resolve `[ERROR (-7)]: SyntaxError: syntax error near`?" - - In most cases, a query statement requires a `YIELD` or a `RETURN`. Check your query statement to see if `YIELD` or `RETURN` is provided. - -???+ faq "How to count the vertices/edges number of each tag/edge type?" - - See [show-stats](../3.ngql-guide/7.general-query-statements/6.show/14.show-stats.md). - -???+ faq "How to get all the vertices/edge of each tag/edge type?" - - 1. Create and rebuild the index. - - ```ngql - > CREATE TAG INDEX i_player ON player(); - > REBUILD TAG INDEX i_player; - ``` - - 2. Use `LOOKUP` or `MATCH`. - - ```ngql - > LOOKUP ON player; - > MATCH (n:player) RETURN n; - ``` - - See [`INDEX`](../3.ngql-guide/14.native-index-statements/1.create-native-index.md), [`LOOKUP`](../3.ngql-guide/7.general-query-statements/5.lookup.md) and [`MATCH`](../3.ngql-guide/7.general-query-statements/2.match.md). - -???+ faq "How to resolve the `can’t solve the start vids from the sentence` error?" - - The graphd requires `start vids` to begin a graph traversal. The `start vids` can either be specified by the user, for example, - - ```ngql - > GO FROM ${vids} ... - > MATCH (src) WHERE id(src) == ${vids} - # The start vids are explicitly given by ${vids}. - ``` - - or be found from a (property) index, for example, - - ```ngql - # CREATE TAG INDEX i_player ON player(name(20)); - # REBUILD TAG INDEX i_player; - - > LOOKUP ON player WHERE player.name == "abc" | ... YIELD ... - > MATCH (src) WHERE src.name == "abc" ... - # The start vids are found from the property index on name. - ``` - - Otherwise, an error like `can’t solve the start vids from the sentence` will be raised. - -???+ faq "How to resolve error `Storage Error: The VID must be a 64-bit integer or a string.`?" - - Check your vid is an integer or a `fix_string(N)`. If it is a string type, make sure your input is not longer than `N` (default value is `8`). - See [create space](../3.ngql-guide/9.space-statements/1.create-space.md). - -???+ faq "How to resolve error `edge conflict` or `vertex conflict`?" - - Nebula Graph returns such errors when the Storage Service receives multiple requests to insert or update the same vertex or edge within milliseconds. Try the failed requests again later. - -???+ faq "Storage Error E_RPC_FAILURE" - - Storaged returns too many data back to graphd. Possible solutions: - - 1. Check whether storaged is Out-of-memory. (`dmesg| grep nebula`). - 2. In `nebula-graphd.conf`, modify or add the item `--storage_client_timeout_ms=60000` to change the timeout(ms). - 3. Modify your nGQL to reduce full scans (including limit sentence). - 4. Use better hardware (NVMe, more memory). - 5. retry. - -???+ faq "The leader has changed. Try again later" - - Known Issue. Just retry 1 to N times, where N is the partition number. The reason is that meta client needs some heartbeats to update or errors to trigger the new leader information. - -???+ faq "How to stop a slow query" - - You can't. Even killing a client will not stop the running slow query. You have to wait the query to complete. - -## About operation and maintenance - -???+ faq "The log files are too large. How to recycle the logs?" - - Nebula Graph uses [glog](https://github.com/google/glog) to print logs. `glog` can't recycle the outdated files. You can use crontab to delete them by yourself. Refer to the discussions of [`Glog should delete old log files automatically`](https://github.com/google/glog/issues/423). - -???+ faq "How to check the Nebula Graph version?" - - 1. Use the ` --version` command to get the Git commit IDs of the Nebula Graph binary files. - - For exmaple, to check the version of the Graph Service, go to the directories where the `nebula-graphd` binary files are stored, and run `./nebula-graphd --version` as follows to get the commit IDs. - - ```bash - $ ./nebula-graphd --version - nebula-graphd version Git: ab4f683, Build Time: Mar 24 2021 02:17:30 - This source code is licensed under Apache 2.0 License, attached with Common Clause Condition 1.0. - ``` - - 2. Search for the commit ID obtained in the preceding step on the [GitHub commits](https://github.com/vesoft-inc/nebula-graph/commits/master) page. - - 3. Compare the commit time of the binary files with the [release time](https://github.com/vesoft-inc/nebula-graph/releases) of Nebula Graph versions to find out the version of the Nebula Graph services. - - -???+ faq "How to scale out or scale in?" - - Nebula Graph {{ nebula.release }} doesn't provide any commands or tools to support automatic scale out/in. You can do by the following steps: - - 1. metad: metad can not be scaled out or scale in. The process can't be moved to a new machine. You can not add a new metad process to the service. - - 2. Scale in graphd : remove graphd from client's code. Close this graphd process. - - 3. Scale out graphd: prepare graphd's binary and config files in the new host. Modify the config files and add all existing metad's addresses. Then start the new graphd process. - - 4. Scale in storaged: （All spaces' replace number must be greater than 1）, ref to [Balance remove command](../8.service-tuning/load-balance.md#storage_1). After the command finish, stop this storaged process. - - 5. Scale out storaged: （All spaces' replace number must be greater than 1）prepare storaged's binary and config files in the new host, Modify the config files and add all existing metad's adDresses. Then start the new storaged process. - - You may also need to run [Balance Data and Balance leader](../8.service-tuning/load-balance) after scaling in/out storaged. - -## About connections - -???+ faq "Which ports should be opened on the firewalls?" - - If you have not changed the predefined ports in the [configurations](../5.configurations-and-logs/1.configurations/1.configurations.md), open the following ports for the Nebula Graph services: - - |Service|Ports| - |-|-| - |Meta|9559, 9560, 19559, 19560| - |Graph|9669, 19669, 19670| - |Storage|9777 ~ 9780, 19779, 19780| - - If you have customized the configuration files and changed the predefined ports, find the port numbers in your configuration files and open them on the firewalls. - -???+ faq "How to test whether a port is open or closed?" - - You can use telnet as follows to check for port status. - - ```bash - telnet - ``` - - For example: - - ```bash - // If the port is open: - $ telnet 192.168.1.10 9669 - Trying 192.168.1.10... - Connected to 192.168.1.10. - Escape character is '^]'. - - // If the port is closed or blocked: - $ telnet 192.168.1.10 9777 - Trying 192.168.1.10... - telnet: connect to address 192.168.1.10: Connection refused - ``` - - If you cannot use the telnet command, check if telnet is installed or enabled on your host.