tengqm commented on code in PR #49: URL: https://github.com/apache/gravitino-site/pull/49#discussion_r1986904613
########## docs/getting-started/index.md: ########## @@ -0,0 +1,250 @@ +--- +title: "Getting started with Apache Gravitino" +slug: /getting-started +license: "This software is licensed under the Apache License version 2." +--- + +There are several options for getting started with Apache Gravitino. + +<!--Docker option--> +Installing and configuring Hive and Trino can be a little complex. +If you are unfamiliar with the technologies, using Docker might be a good choice. +There are pre-packaged containers for Gravitino, Apache Hive, Apache Hadoop, +Trino, MySQL, PostgesSQL, and others, +check [installing Gravitino playground](./playground.md) for more details. + +<!--Build from source--> +This page guides you through the process to download and install Gravitino +from source. + +1. [Prepare environment](#environment-preparation) + - Deploy and run Gravitino on [Amazon Web Service (AWS)](#aws) + - Deploy and run Gravitino on [Google Compute Platform (GCP)](#gcp) + - Run Gravitino on [your own machine](#local-workstation) +1. [Install Gravitino](#install-gravitino) +1. [Start Gravitino](#start-gravitino) +1. [Install Apache Hive](#install-apache-hive) +1. [Interact with Apache Gravitino API](#interact-with-apache-gravitino-api) + +:::note +If you want to access the instance remotely, be sure to read +[Accessing Gravitino on AWS externally](./aws-remote-access.md). +::: + +## Environment preparation + +### AWS + +To work in an AWS environment, follow these steps: + +1. In the AWS console, launch a new instance. + Select `Ubuntu` as the operating system and `t2.xlarge` as the instance type. + Create a key pair named *Gravitino.pem* for SSH access and download it. + Allow HTTP and HTTPS traffic if you want to connect to the instance remotely. + Set the Elastic Block Store storage to 20GiB. + Leave all other settings as their defaults. + Other operating systems and instance types may work, but are not be fully tested. + +1. Start the instance and connect to it via SSH using the downloaded `.pem` file: + + ```shell + ssh ubuntu@<IP_address> -i ~/Downloads/Gravitino.pem + ``` + + **Note**: you may need to adjust the permissions on your `.pem` file using + `chmod 400` to enable SSH connections. + +1. Update the Ubuntu OS to ensure it's up-to-date: + + ```shell + sudo apt update + sudo apt upgrade + ``` + + <!--TODO: need Red Hat commands?--> + You may need to reboot the instance for all changes to take effect. + +1. Install the Java Development Kit (JDK), Java 8, 11 and 17 are supported. Review Comment: Will use a period. Thx. -- 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: commits-unsubscr...@gravitino.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
