dimas-b commented on code in PR #2267: URL: https://github.com/apache/polaris/pull/2267#discussion_r2534647310
########## site/content/in-dev/unreleased/getting-started/_index.md: ########## @@ -23,22 +23,83 @@ type: docs weight: 101 --- -There are several options for getting started with Apache Polaris. +This guide will help you get started with Apache Polaris using the binary distribution, which is the fastest way to set up a Polaris server. -To quickly try out Apache Polaris, please use the [quickstart guide](./quick-start). For other examples, please see below. +## Prerequisites -## Docker Compose Examples -Each of the proceeding Docker Compose examples provides a complete working environment with detailed instructions. +Before you begin, ensure you have the following: -### Next Steps +- Java SE 21 or higher installed +- Verify Java installation: -1. Check & install dependencies -2. Choose the way you want to deploy Polaris -3. Create a catalog -4. Check Using Polaris page +```bash +java -version +``` -### Getting Help +## Step 1: Download and Extract the Binary Distribution -- Documentation: https://polaris.apache.org -- GitHub Issues: https://github.com/apache/polaris/issues -- Slack: [Join Apache Polaris Community](https://join.slack.com/t/apache-polaris/shared_invite/zt-2y3l3r0fr-VtoW42ltir~nSzCYOrQgfw) +1. Visit the [Apache Polaris downloads page](https://polaris.apache.org/downloads/). + +2. Download the latest binary distribution (tar.gz file) and extract it to your desired directory: + +```bash +tar -xzf apache-polaris-1.0.0-incubating-bin.tar.gz +``` + +## Step 2: Configure Polaris + +Navigate to the extracted directory: + +```bash +cd apache-polaris-1.0.0-incubating-bin +``` + +Configure Polaris using environment variables or system properties. For example: + +```bash +export POLARIS_JAVA_OPTS="-Dquarkus.http.port=8080" +export POLARIS_JAVA_OPTS="-Dpolaris.persistence.type=relational-jdbc" +export POLARIS_JAVA_OPTS="-Xms512m -Xmx1g -Dquarkus.http.port=8080" Review Comment: Each line overwrites the previous setting, does it not? Is that intended? It could be confusing to users 🤔 ########## site/content/in-dev/unreleased/getting-started/_index.md: ########## @@ -23,22 +23,83 @@ type: docs weight: 101 --- -There are several options for getting started with Apache Polaris. +This guide will help you get started with Apache Polaris using the binary distribution, which is the fastest way to set up a Polaris server. -To quickly try out Apache Polaris, please use the [quickstart guide](./quick-start). For other examples, please see below. +## Prerequisites -## Docker Compose Examples -Each of the proceeding Docker Compose examples provides a complete working environment with detailed instructions. +Before you begin, ensure you have the following: -### Next Steps +- Java SE 21 or higher installed +- Verify Java installation: -1. Check & install dependencies -2. Choose the way you want to deploy Polaris -3. Create a catalog -4. Check Using Polaris page +```bash +java -version +``` -### Getting Help +## Step 1: Download and Extract the Binary Distribution Review Comment: We have this (based on tar) and https://polaris.apache.org/in-dev/unreleased/getting-started/quick-start/ (based on docker). Would it make sense to move this section into a sub-page parallel to the docker-compose example? -- 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]
