Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Changes involving LM #2072

Merged
merged 13 commits into from
Jun 26, 2023
67 changes: 0 additions & 67 deletions docs-2.0/20.appendix/8.about-license.md

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,10 @@ Installing NebulaGraph from the source code allows you to customize the compilin

- The host to be installed with NebulaGraph has access to the Internet.

{{ ent.ent_begin }}
- The [license key](../../9.about-license/2.license-management-suite/3.license-manager.md) is loaded.
{{ ent.ent_end }}

## Installation steps

1. Use Git to clone the source code of NebulaGraph to the host.
Expand Down Expand Up @@ -72,7 +76,13 @@ Installing NebulaGraph from the source code allows you to customize the compilin
$ sudo make install
```

7. The configuration files in the `etc/` directory (`/usr/local/nebula/etc` by default) are references. Users can create their own configuration files accordingly. If you want to use the scripts in the `script` directory to start, stop, restart, and kill the service, and check the service status, the configuration files have to be named as `nebula-graph.conf`, `nebula-metad.conf`, and `nebula-storaged.conf`.
{{ ent.ent_begin }}
7. (Enterprise only) For Enterprise Edition, set the value of `license_manager_url` to the host IP and port number `9119` where the license management tool is located in the Meta service configuration file of NebulaGraph (`nebula-metad.conf`), e.g. `192.168.8.100:9119`.
{{ ent.ent_end }}

!!! note

The configuration files in the `etc/` directory (`/usr/local/nebula/etc` by default) are references. Users can create their own configuration files accordingly. If you want to use the scripts in the `script` directory to start, stop, restart, and kill the service, and check the service status, the configuration files have to be named as `nebula-graph.conf`, `nebula-metad.conf`, and `nebula-storaged.conf`.

## Update the master branch

Expand All @@ -84,11 +94,7 @@ The source code of the master branch changes frequently. If the corresponding Ne

## Next to do

{{ ent.ent_begin }}
- (Enterprise Edition)[Deploy license](../deploy-license.md)
{{ ent.ent_end }}

- [Manage NebulaGraph services](../../2.quick-start/5.start-stop-service.md)
[Manage NebulaGraph services](../../2.quick-start/5.start-stop-service.md)

## CMake variables

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,11 @@ You can install NebulaGraph by downloading the tar.gz file.

- NebulaGraph is currently only supported for installation on Linux systems, and only CentOS 7.x, CentOS 8.x, Ubuntu 16.04, Ubuntu 18.04, and Ubuntu 20.04 operating systems are supported.

{{ ent.ent_begin }}
## Prerequisites

- The [license key](../../9.about-license/2.license-management-suite/3.license-manager.md) is loaded.
{{ ent.ent_end }}

## Installation steps

Expand Down Expand Up @@ -65,13 +70,19 @@ You can install NebulaGraph by downloading the tar.gz file.

3. Modify the name of the configuration file.

Enter the decompressed directory, rename the files `nebula-graphd.conf.default`, `nebula-metad.conf.default`, and `nebula-storaged.conf.default` in the subdirectory `etc`, and delete `.default` to apply the default configuration of NebulaGraph. To modify the configuration, see [Configurations](../../5.configurations-and-logs/1.configurations/1.configurations.md).
Enter the decompressed directory, rename the files `nebula-graphd.conf.default`, `nebula-metad.conf.default`, and `nebula-storaged.conf.default` in the subdirectory `etc`, and delete `.default` to apply the default configuration of NebulaGraph.

{{ ent.ent_begin }}
4. (Enterprise only) For Enterprise Edition, set the value of `license_manager_url` to the host IP and port number `9119` where the license management tool is located in the Meta service configuration file of NebulaGraph (`nebula-metad.conf`), e.g. `192.168.8.100:9119`.
{{ ent.ent_end }}


!!! note

To modify the configuration, see [Configurations](../../5.configurations-and-logs/1.configurations/1.configurations.md).

So far, you have installed NebulaGraph successfully.

## Next to do
{{ ent.ent_begin }}
- (Enterprise Edition)[Deploy license](../deploy-license.md)
{{ ent.ent_end }}

- [Manage NebulaGraph services](../manage-service.md)
[Manage NebulaGraph services](../manage-service.md)
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,9 @@ For now, NebulaGraph does not provide an official deployment tool. Users can dep

- Prepare 5 machines for deploying the cluster.
- Use the NTP service to synchronize time in the cluster.
{{ ent.ent_begin }}
- The [license key](../../9.about-license/2.license-management-suite/3.license-manager.md) is loaded.
{{ ent.ent_end }}

## Manual deployment process

Expand All @@ -27,15 +30,6 @@ Install NebulaGraph on each machine in the cluster. Available approaches of inst

* [Install NebulaGraph by compiling the source code](1.install-nebula-graph-by-compiling-the-source-code.md)

{{ ent.ent_begin }}
### Add a license (for the Enterprise Edition only).

- Adding a license is only required when you deploy a NebulaGraph cluster with the Enterprise Edition. For details, see [Deploy a license for NebulaGraph Enterprise Edition](../../4.deployment-and-installation/deploy-license.md).

- Skip this step when you deploy a cluster with the Community Edition.

{{ ent.ent_end }}

### Modify the configurations

To deploy NebulaGraph according to your requirements, you have to modify the configuration files.
Expand All @@ -62,6 +56,12 @@ Users can refer to the content of the following configurations, which only show

- [Storage Service configurations](../../5.configurations-and-logs/1.configurations/4.storage-config.md)

{{ ent.ent_begin }}
!!! enterpriseonly

For Enterprise Edition, set the value of `license_manager_url` to the host IP and port number `9119` where the license management tool is located in the Meta service configuration file of NebulaGraph (`nebula-metad.conf`), e.g. `192.168.8.100:9119`.
{{ ent.ent_end }}

- Deploy machine A

- `nebula-graphd.conf`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -88,9 +88,7 @@ This topic takes the enterprise edition of NebulaGraph v3.1.0 as an example and

After the upgrade, a `data` directory will be generated in the v{{nebula.release}} installation directory, containing the upgraded data files.

4. Upload the license file to the `share/resources` directory under the v{{nebula.release}} installation directory.

5. Start and connect to the NebulaGraph v{{nebula.release}} enterprise edition service and verify that the data is correct. The following commands can be used as reference:
4. Start and connect to the NebulaGraph v{{nebula.release}} enterprise edition service and verify that the data is correct. The following commands can be used as reference:

```
nebula> SHOW HOSTS;
Expand Down
106 changes: 0 additions & 106 deletions docs-2.0/4.deployment-and-installation/deploy-license.md

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -29,18 +29,20 @@ For all parameters and their current values, see [Configurations](1.configuratio
| `pid_file` | `pids/nebula-metad.pid` | The file that records the process ID. | No|
| `timezone_name` | - | Specifies the NebulaGraph time zone. This parameter is not predefined in the initial configuration files. You can manually set it if you need it. The system default value is `UTC+00:00:00`. For the format of the parameter value, see [Specifying the Time Zone with TZ](https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html "Click to view the timezone-related content in the GNU C Library manual"). For example, `--timezone_name=UTC+08:00` represents the GMT+8 time zone.|No|

!!! note

* While inserting property values of [time types](../../3.ngql-guide/3.data-types/4.date-and-time.md), NebulaGraph transforms time types (except TIMESTAMP) to the corresponding UTC according to the time zone specified by `timezone_name`. The time-type values returned by nGQL queries are all UTC time.
* `timezone_name` is only used to transform the data stored in NebulaGraph. Other time-related data of the NebulaGraph processes still uses the default time zone of the host, such as the log printing time.

{{ ent.ent_begin }}
## enterprise license configurations

| Name | Predefined value | Description |Whether supports runtime dynamic modifications|
| ----------- | ----------------------- | ---------------------------------------------------- |----------------- |
|`license_path`|`share/resources/nebula.license`| Path of the license of the NebulaGraph Enterprise Edition. Users need to [deploy a license file](../../4.deployment-and-installation/deploy-license.md) before starting the Enterprise Edition. This parameter is required only for the NebulaGraph Enterprise Edition. For details about how to configure licenses for other ecosystem tools, see the deployment documents of the corresponding ecosystem tools.| No|
|`license_manager_url`|-|The address of license manager. Set the value to the host IP and port number `9119` where the license management tool is located in the Meta service configuration file of NebulaGraph (`nebula-metad.conf`), e.g. `192.168.8.100:9119`.|No|

{{ ent.ent_end }}

!!! note

* While inserting property values of [time types](../../3.ngql-guide/3.data-types/4.date-and-time.md), NebulaGraph transforms time types (except TIMESTAMP) to the corresponding UTC according to the time zone specified by `timezone_name`. The time-type values returned by nGQL queries are all UTC time.
* `timezone_name` is only used to transform the data stored in NebulaGraph. Other time-related data of the NebulaGraph processes still uses the default time zone of the host, such as the log printing time.

## Logging configurations

| Name | Predefined value | Description |Whether supports runtime dynamic modifications|
Expand Down
Loading