Huanli-Meng commented on code in PR #5726:
URL: https://github.com/apache/gravitino/pull/5726#discussion_r1867695093
##########
docs/how-to-install.md:
##########
@@ -6,145 +6,151 @@ license: "This software is licensed under the Apache
License version 2."
## Install Apache Gravitino from scratch
+### Prerequisites
+
+If you have not installed Java, install it and configure the `JAVA_HOME`
environment variable. After installation, you can run the
`${JAVA_HOME}/bin/java -version` command to check the Java version.
+
:::note
-Apache Gravitino supports running on Java 8, 11, and 17. Make sure you have
Java installed and
-`JAVA_HOME` configured correctly. To confirm the Java version, run the
-`${JAVA_HOME}/bin/java -version` command.
+Gravitino supports running on Java 8, 11, and 17.
:::
-The Gravitino package comprises both the Gravitino server and the Gravitino
Iceberg REST server. You can manage these servers independently or run them
concurrently on a single server.
-
-### Get the Apache Gravitino binary distribution package
-
-Before installing Gravitino, make sure you have the Gravitino binary
distribution package. You can download the latest Gravitino binary distribution
package from [GitHub](https://github.com/apache/gravitino/releases).
-You can also build it yourself by following the instructions in [How to Build
Gravitino](./how-to-build.md).
-
- - If you build Gravitino yourself using the `./gradlew compileDistribution`
command, you can find the Gravitino binary distribution package in the
`distribution/package` directory.
-
- - If you build Gravitino yourself using the `./gradlew assembleDistribution`
command, you can get the compressed Gravitino binary distribution package with
the name `gravitino-<version>-bin.tar.gz` in the `distribution` directory with
sha256 checksum file `gravitino-<version>-bin.tar.gz.sha256`.
-
-The Gravitino binary distribution package contains the following files:
-
-```text
-|── ...
-└── distribution/package
- |── bin/
- | ├── gravitino.sh # Gravitino server Launching
scripts.
- | └── gravitino-iceberg-rest-server.sh # Gravitino Iceberg REST
server Launching scripts.
- |── catalogs
- | └── hadoop/ # Apache Hadoop catalog
dependencies and configurations.
- | └── hive/ # Apache Hive catalog
dependencies and configurations.
- | └── jdbc-doris/ # JDBC doris catalog
dependencies and configurations.
- | └── jdbc-mysql/ # JDBC MySQL catalog
dependencies and configurations.
- | └── jdbc-postgresql/ # JDBC PostgreSQL catalog
dependencies and configurations.
- | └── kafka/ # Apache Kafka PostgreSQL
catalog dependencies and configurations.
- | └── lakehouse-iceberg/ # Apache Iceberg catalog
dependencies and configurations.
- | └── lakehouse-paimon/ # Apache Paimon catalog
dependencies and configurations.
- |── conf/ # All configurations for
Gravitino.
- | ├── gravitino.conf # Gravitino server and
Gravitino Iceberg REST server configuration.
- | ├── gravitino-iceberg-rest-server.conf # Gravitino server
configuration.
- | ├── gravitino-env.sh # Environment variables, etc.,
JAVA_HOME, GRAVITINO_HOME, and more.
- | └── log4j2.properties # log4j configuration for the
Gravitino server and Gravitino Iceberg REST server.
- |── libs/ # Gravitino server
dependencies libraries.
- |── logs/ # Gravitino server and
Gravitino Iceberg REST server logs. Automatically created after the server
starts.
- |── data/ # Default directory for the
Gravitino server to store data.
- |── iceberg-rest-server/ # Gravitino Iceberg REST
server package and dependencies libraries.
- └── scripts/ # Extra scripts for Gravitino.
-```
+### Get the Gravitino package
+
+The Gravitino package comprises the Gravitino server and the Gravitino Iceberg
REST server. You can manage these servers independently or run them
concurrently on a single server.
+
+1. Download the latest Gravitino package from
[GitHub](https://github.com/apache/gravitino/releases).
+
+ :::note
+ You can also build Gravitino by following the instructions in [How to
Build Gravitino](./how-to-build.md).
-#### Initialize the RDBMS (Optional)
+ - If you build Gravitino using the `./gradlew compileDistribution`
command, you can find the Gravitino package in the `distribution/package`
directory.
-If you want to use the relational backend storage, you need to initialize the
RDBMS first. For the details on initializing the RDBMS, please check [How to
use relational backend storage](./how-to-use-relational-backend-storage.md).
+ - If you build Gravitino using the `./gradlew assembleDistribution`
command, you can get the compressed Gravitino package with the name
`gravitino-<version>-bin.tar.gz` in the `distribution` directory with sha256
checksum file `gravitino-<version>-bin.tar.gz.sha256`.
+ :::
-#### Configure the Apache Gravitino server
+2. Extract the Gravitino package and you should have these directories and
files:
-The Gravitino server configuration file is `conf/gravitino.conf`. You can
configure the Gravitino server by modifying this file. Basic configurations
have already been added to this file. All the configurations are listed in
[Gravitino Server Configurations](./gravitino-server-config.md).
+ ```text
+ |── ...
+ └── distribution/package
+ |── bin/
+ | ├── gravitino.sh # Gravitino server
Launching scripts.
+ | └── gravitino-iceberg-rest-server.sh # Gravitino Iceberg REST
server Launching scripts.
+ |── catalogs
+ | └── hadoop/ # Apache Hadoop catalog
dependencies and configurations.
+ | └── hive/ # Apache Hive catalog
dependencies and configurations.
+ | └── jdbc-doris/ # JDBC doris catalog
dependencies and configurations.
+ | └── jdbc-mysql/ # JDBC MySQL catalog
dependencies and configurations.
+ | └── jdbc-postgresql/ # JDBC PostgreSQL catalog
dependencies and configurations.
+ | └── kafka/ # Apache Kafka PostgreSQL
catalog dependencies and configurations.
+ | └── lakehouse-iceberg/ # Apache Iceberg catalog
dependencies and configurations.
+ | └── lakehouse-paimon/ # Apache Paimon catalog
dependencies and configurations.
+ |── conf/ # All configurations for
Gravitino.
+ | ├── gravitino.conf # Gravitino server and
Gravitino Iceberg REST server configuration.
+ | ├── gravitino-iceberg-rest-server.conf # Gravitino server
configuration.
+ | ├── gravitino-env.sh # Environment variables,
etc., JAVA_HOME, GRAVITINO_HOME, and more.
+ | └── log4j2.properties # log4j configuration for
the Gravitino server and Gravitino Iceberg REST server.
+ |── libs/ # Gravitino server
dependencies libraries.
+ |── logs/ # Gravitino server and
Gravitino Iceberg REST server logs. Automatically created after the server
starts.
+ |── data/ # Default directory for
the Gravitino server to store data.
+ |── iceberg-rest-server/ # Gravitino Iceberg REST
server package and dependencies libraries.
+ └── scripts/ # Extra scripts for
Gravitino.
+ ```
-#### Configure the Apache Gravitino server log
+### Initialize the RDBMS (Optional)
-The Gravitino server log configuration file is `conf/log4j2.properties`.
Gravitino uses Log4j2 as the Logging system. You can
[Log4j2](https://logging.apache.org/log4j/2.x/) to do the log configuration.
+If you want to use the relational backend storage, you need to initialize the
RDBMS. For details on initializing the RDBMS, see [How to use relational
backend storage](./how-to-use-relational-backend-storage.md).
-#### Configure the Apache Gravitino server environment
+### Configure the Gravitino server
-The Gravitino server environment configuration file is
`conf/gravitino-env.sh`. Gravitino exposes several environment variables. You
can modify them in this file.
+The `conf/gravitino.conf` file provides basic configurations of the Gravitino
server. To configure the Gravitino server, you can update this file. For a full
list of the Gravitino server configurations, see [Gravitino Server
Configurations](./gravitino-server-config.md).
Review Comment:
Ditto
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
