From ff5df5399e9cc8dd886f736e35d2a231a3949f12 Mon Sep 17 00:00:00 2001 From: Sid Choudhury Date: Tue, 17 Sep 2019 12:40:44 -0700 Subject: [PATCH] additional fixes for 2.0 --- docs/content/latest/comparisons/_index.md | 4 ++-- .../latest/deploy/cdc/2dc-replication.md | 2 +- .../latest/deploy/cdc/two-data-centers.md | 2 +- .../latest/deploy/kubernetes/rook-operator.md | 22 +++++++++---------- docs/content/latest/introduction.md | 13 ++++++----- .../latest/quick-start/binary/explore-ysql.md | 4 ++-- .../latest/quick-start/docker/explore-ysql.md | 4 ++-- .../latest/quick-start/explore-ysql.md | 8 ++----- .../quick-start/kubernetes/explore-ysql.md | 4 ++-- docs/content/latest/releases/v2.0.0.md | 6 ++++- docs/content/v1.0/_index.html | 2 +- docs/content/v1.1/_index.html | 2 +- docs/content/v1.2/_index.html | 2 +- docs/content/v1.3/_index.html | 2 +- 14 files changed, 40 insertions(+), 37 deletions(-) diff --git a/docs/content/latest/comparisons/_index.md b/docs/content/latest/comparisons/_index.md index de8c9af52737..6ae5cc8a49af 100644 --- a/docs/content/latest/comparisons/_index.md +++ b/docs/content/latest/comparisons/_index.md @@ -15,7 +15,7 @@ menu: ## Distributed SQL databases -Feature | [CockroachDB](cockroachdb/) | TiDB | Amazon Aurora | [MS Azure CosmosDB](azure-cosmos/) | [Google Cloud Spanner](google-spanner/) | Yugabyte DB +Feature | [CockroachDB](cockroachdb/) | TiDB | [Amazon Aurora](https://blog.yugabyte.com/comparing-distributed-sql-performance-yugabyte-db-vs-amazon-aurora-postgresql-vs-cockroachdb/) | [MS Azure CosmosDB](azure-cosmos/) | [Google Cloud Spanner](google-spanner/) | Yugabyte DB --------|-----------------|------------|----------------|----------------|-------------|----------- Horizontal write scalability (with auto sharding/rebalancing) | | | | | | Automated failover & repair | | | | | | @@ -43,7 +43,7 @@ Strongly-consistent secondary indexes | | | || | | Low, predictable p99 latencies | | || | | High data density| | || | | -API | MongoDB QL | Proprietary KV, MongoDB QL | Cassandra QL | Proprietary KV, Document | Cassandra QL, MongoDB QL | YCQL w/ Cassandra QL roots +API | MongoDB QL | Proprietary KV, MongoDB QL | Cassandra QL | Proprietary KV, Document | Cassandra QL, MongoDB QL | Yugabyte Cloud QL w/ native document modeling Open Source | | Apache 2.0 | Apache 2.0 | | | Apache 2.0 {{< note title="Note" >}} diff --git a/docs/content/latest/deploy/cdc/2dc-replication.md b/docs/content/latest/deploy/cdc/2dc-replication.md index c2d2d00ecbe8..5c3978bc6ef5 100644 --- a/docs/content/latest/deploy/cdc/2dc-replication.md +++ b/docs/content/latest/deploy/cdc/2dc-replication.md @@ -1,7 +1,7 @@ --- title: 2DC replication linkTitle: Replicate between 2 data centers -description: Replicating between two data centers +description: Replicating between 2 data centers beta: /faq/product/#what-is-the-definition-of-the-beta-feature-tag menu: latest: diff --git a/docs/content/latest/deploy/cdc/two-data-centers.md b/docs/content/latest/deploy/cdc/two-data-centers.md index 34e1b6d39d42..5cc5e58d6aaa 100644 --- a/docs/content/latest/deploy/cdc/two-data-centers.md +++ b/docs/content/latest/deploy/cdc/two-data-centers.md @@ -1,7 +1,7 @@ --- title: 2DC deployments linkTitle: 2DC deployments -description: 2-data center deployment with change data capture +description: 2-data center deployments beta: /faq/product/#what-is-the-definition-of-the-beta-feature-tag menu: latest: diff --git a/docs/content/latest/deploy/kubernetes/rook-operator.md b/docs/content/latest/deploy/kubernetes/rook-operator.md index fe12d248a545..fd1c2b2a8789 100644 --- a/docs/content/latest/deploy/kubernetes/rook-operator.md +++ b/docs/content/latest/deploy/kubernetes/rook-operator.md @@ -1,17 +1,19 @@ --- -title: Rook Yugabyte DB operator +title: Rook operator linkTitle: Rook operator -description: Rook Yugabyte DB operator +description: Rook operator menu: latest: identifier: rook-operator parent: deploy-kubernetes weight: 624 +isTocNested: true +showAsideToc: true --- [Rook](https://rook.io) is an open source, cloud-native storage orchestrator for Kubernetes, providing the platform, framework, and support that can turn Yugabyte DB clusters into self-managing, self-scaling, and self-healing storage services. Rook automates storage-layer tasks, including deployment, bootstrapping, configuration, provisioning, scaling, upgrading, migration, disaster recovery, monitoring, and resource management. -The [Rook Yugabyte DB operator](https://rook.io/docs/rook/v1.1/yugabytedb.html) is a custom controller that uses Custom Resource Definition (CRD) to extend the Kubernetes API and automate deploying, scaling, and managing Yugabyte DB clusters. Based on the _desired state_ that you specified in the CRD, the Rook operator observes (watching for changes in state and health), analyzes (comparing current to desired state), and acts (applying changes to the cluster) to maintain the desired state. For details, see [Yugabyte DB Cluster CRD](https://rook.io/docs/rook/v1.1/yugabytedb-cluster-crd.html) +The [Rook operator](https://rook.io/docs/rook/v1.1/yugabytedb.html) is a custom controller that uses Custom Resource Definition (CRD) to extend the Kubernetes API and automate deploying, scaling, and managing Yugabyte DB clusters. Based on the _desired state_ that you specified in the CRD, the Rook operator observes (watching for changes in state and health), analyzes (comparing current to desired state), and acts (applying changes to the cluster) to maintain the desired state. For details, see [Yugabyte DB Cluster CRD](https://rook.io/docs/rook/v1.1/yugabytedb-cluster-crd.html) ## Before you begin @@ -62,9 +64,9 @@ cluster/examples/kubernetes/yugabytedb Make a copy of the sample CRD file (`cluster.yaml`) and modify it as needed. For details on the configuration options, see [Yugabyte DB CRD](https://rook.io/docs/rook/v1.1/yugabytedb-cluster-crd.html). -## Create a simple YugabyteDB cluster +## Create a simple Yugabyte DB cluster -1. Create your YugabyteDB cluster by running the following command: +1. Create your Yugabyte DB cluster by running the following command: ```bash kubectl create -f cluster.yaml @@ -92,8 +94,8 @@ kubectl exec -it yb-tserver-rook-yugabytedb-0 /home/yugabyte/bin/ysqlsh -- -h yb For details on the YSQL API, see: -- [Explore Yugabyte SQL (YSQL)](https://docs.yugabyte.com/latest/quick-start/explore-ysql/#kubernetes) in the Quick Start section -- [Yugabyte Structured Query Language (YSQL)](https://docs.yugabyte.com/latest/api/ysql/) +- [Explore YSQL](../../../quick-start/explore-ysql/#kubernetes) +- [YSQL Reference](../../../api/ysql/) ## Cleanup @@ -106,7 +108,7 @@ kubectl delete -f cluster.yaml kubectl delete -f operator.yaml ``` -Manually delete any Persistent Volumes that were created for this YugabyteDB cluster. +Manually delete any Persistent Volumes that were created for this Yugabyte DB cluster. ## Troubleshooting @@ -116,15 +118,13 @@ If the cluster does not start, run following command to take a look at operator ```bash kubectl -n rook-yugabytedb-system logs -l app=rook-yugabytedb-operator - ``` ### Review the Yugabyte DB logs -If everything is OK in the operator logs, check the YugabyteDB logs for YB-Master and YB-TServer. +If everything is OK in the operator logs, check the Yugabyte DB logs for YB-Master and YB-TServer. ```bash kubectl -n rook-yugabytedb logs -l app=yb-master-rook-yugabytedb kubectl -n rook-yugabytedb logs -l app=yb-tserver-rook-yugabytedb - ``` diff --git a/docs/content/latest/introduction.md b/docs/content/latest/introduction.md index 1207b32ddaf6..fdd45e8bed68 100644 --- a/docs/content/latest/introduction.md +++ b/docs/content/latest/introduction.md @@ -24,13 +24,16 @@ showAsideToc: true --> -Yugabyte DB is a high-performance distributed SQL database for powering global, internet-scale applications. Built using a unique combination of high-performance document store, , per-shard distributed consensus replication and multi-shard ACID transactions (inspired by Google Spanner), Yugabyte DB serves both scale-out RDBMS and internet-scale OLTP workloads with low query latency, extreme resilience against failures and global data distribution. As a cloud native database, it can be deployed across public and private clouds as well as in Kubernetes environments with ease. +Yugabyte DB is a high-performance distributed SQL database for powering global, internet-scale applications. Built using a unique combination of high-performance document store, per-shard distributed consensus replication and multi-shard ACID transactions (inspired by Google Spanner), Yugabyte DB serves both scale-out RDBMS and internet-scale OLTP workloads with low query latency, extreme resilience against failures and global data distribution. As a cloud native database, it can be deployed across public and private clouds as well as in Kubernetes environments with ease. Yugabyte DB is developed and distributed as an [Apache 2.0 open source project](https://github.com/yugabyte/yugabyte-db/). ## What makes Yugabyte DB unique? -Yugabyte DB is a transactional database that brings together three must-have needs of cloud native microservices, namely SQL as a flexible query language, low-latency read performance and globally-distributed write scalability. Monolithic SQL databases offer SQL and low-latency reads but do not have ability to scale writes across multiple nodes and/or regions. Distributed NoSQL databases offer performance and write scalablility but give up on SQL semantics such as multi-key access, ACID transactions and strong consistency. +Yugabyte DB is a transactional database that brings together three must-have needs of cloud-native microservices, namely SQL as a flexible query language, low-latency read performance and globally-distributed write scalability. + +- Monolithic SQL databases offer SQL and low-latency reads but do not have ability to scale writes across multiple nodes and/or regions. +- Distributed NoSQL databases offer performance and write scalablility but give up on SQL semantics such as multi-key access, ACID transactions and strong consistency. Yugabyte DB feature highlights are listed below. @@ -38,7 +41,7 @@ Yugabyte DB feature highlights are listed below. - SQL [JOINs](../quick-start/explore-ysql/#3-joins) and [distributed transactions](../quick-start/explore-ysql/#4-distributed-transactions) that allow multi-row access across any number of shards at any scale. -- Transactional [document store](../architecture/concepts/docdb/) backed by self-healing, strongly consistent [replication](../architecture/concepts/docdb/replication/). +- Transactional [document store](../architecture/concepts/docdb/) backed by self-healing, strongly-consistent, synchronous [replication](../architecture/concepts/docdb/replication/). ### 2. High performance and massive scalability @@ -48,7 +51,7 @@ Yugabyte DB feature highlights are listed below. ### 3. Global data consistency -- [Global data distribution](../explore/global-distribution/) that brings consistent data close to users through multi-region and multi-cloud deployments. +- [Global data distribution](../explore/global-distribution/) that brings consistent data close to users through multi-region and multi-cloud deployments. Optional two-region multi-master and master-slave configurations powered by CDC-driven asynchronous replication. - [Auto-sharding & auto-rebalancing](../explore/auto-sharding/) to ensure uniform load across all nodes even for very large clusters. @@ -64,7 +67,7 @@ Yugabyte DB feature highlights are listed below. ### 6. Built-in enterprise features -- Starting [v1.3](https://blog.yugabyte.com/announcing-yugabyte-db-v1-3-with-enterprise-features-as-open-source/), only open source distributed SQL database to have built-in enterprise features such as Distributed Backups, Data Encryption, and Read Replicas. Upcoming features such as Change Data Capture and 2 Data Center Deployments are also included in open source. +- Starting [v1.3](https://blog.yugabyte.com/announcing-yugabyte-db-v1-3-with-enterprise-features-as-open-source/), Yugabyte DB is the only open-source distributed SQL database to have built-in enterprise features such as Distributed Backups, Data Encryption, and Read Replicas. Upcoming features such as [Change Data Capture](../deploy/cdc/cdc-architecture/) and [2 Data Center Deployments](../deploy/cdc/two-data-centers/) are also included in open source. ## What client APIs are supported by Yugabyte DB? diff --git a/docs/content/latest/quick-start/binary/explore-ysql.md b/docs/content/latest/quick-start/binary/explore-ysql.md index db7346f28020..82bf5cd9965b 100644 --- a/docs/content/latest/quick-start/binary/explore-ysql.md +++ b/docs/content/latest/quick-start/binary/explore-ysql.md @@ -5,8 +5,8 @@ $ ./bin/ysqlsh --echo-queries ``` ``` -ysqlsh (11.2) +ysqlsh (11.2-YB-2.0.0.0-b0) Type "help" for help. -postgres=# +yugabyte=# ``` diff --git a/docs/content/latest/quick-start/docker/explore-ysql.md b/docs/content/latest/quick-start/docker/explore-ysql.md index ff6688857167..4de22e5c1540 100644 --- a/docs/content/latest/quick-start/docker/explore-ysql.md +++ b/docs/content/latest/quick-start/docker/explore-ysql.md @@ -33,8 +33,8 @@ $ docker exec -it yb-tserver-n1 /home/yugabyte/bin/ysqlsh -h yb-tserver-n1 --ec ``` ``` -ysqlsh (11.2) +ysqlsh (11.2-YB-2.0.0.0-b0) Type "help" for help. -postgres=# +yugabyte=# ``` diff --git a/docs/content/latest/quick-start/explore-ysql.md b/docs/content/latest/quick-start/explore-ysql.md index 8fe3b75d8d6b..9d48be6095bb 100644 --- a/docs/content/latest/quick-start/explore-ysql.md +++ b/docs/content/latest/quick-start/explore-ysql.md @@ -94,15 +94,11 @@ orders.sql products.sql reviews.sql users.sql - Create a database. ```sql -postgres=> CREATE DATABASE yb_demo; +yugabyte=> CREATE DATABASE yb_demo; ``` ```sql -postgres=> GRANT ALL ON DATABASE yb_demo to postgres; -``` - -```sql -postgres=> \c yb_demo; +yugabyte=> \c yb_demo; ``` - Insert sample data diff --git a/docs/content/latest/quick-start/kubernetes/explore-ysql.md b/docs/content/latest/quick-start/kubernetes/explore-ysql.md index 9d6ea9d55105..c42eeb4ec8d2 100644 --- a/docs/content/latest/quick-start/kubernetes/explore-ysql.md +++ b/docs/content/latest/quick-start/kubernetes/explore-ysql.md @@ -32,8 +32,8 @@ $ kubectl exec -it yb-tserver-0 /home/yugabyte/bin/ysqlsh -- -h yb-tserver-0 -- ``` ``` -ysqlsh (11.2) +ysqlsh (11.2-YB-2.0.0.0-b0) Type "help" for help. -postgres=# +yugabyte=# ``` diff --git a/docs/content/latest/releases/v2.0.0.md b/docs/content/latest/releases/v2.0.0.md index 5bfe51658bb3..7e84590dae67 100644 --- a/docs/content/latest/releases/v2.0.0.md +++ b/docs/content/latest/releases/v2.0.0.md @@ -32,6 +32,10 @@ Released September 17, 2019. docker pull yugabytedb/yugabyte:2.0.0.0-b16 ``` +## Release Highlight + +[YSQL](../../api/ysql) is now generally available and is ready for production deployments. Details available in [Announcing Yugabyte DB 2.0 GA: Jepsen Tested, High-Performance Distributed SQL](https://blog.yugabyte.com/announcing-yugabyte-db-2-0-ga:-jepsen-tested,-high-performance-distributed-sql/ ). + ## File Format Change {{< note title="Note" >}} @@ -121,7 +125,7 @@ There are two ways to address the above note. [#2269](https://github.com/yugabyte/yugabyte-db/issues/2269) * Load balancer should not be considered idle when tablet remote bootstrap. [#2193](https://github.com/yugabyte/yugabyte-db/issues/2193) -* [YSQ]: Fix number of tablets created for system tables. +* [YSQL]: Fix number of tablets created for system tables. [#2293](https://github.com/yugabyte/yugabyte-db/issues/2293) * Reduce fan-out and use tablet invoker for writing data. * SerializableReadWriteConflict needs better success probability. diff --git a/docs/content/v1.0/_index.html b/docs/content/v1.0/_index.html index 3c4aea3b58d2..cba0bde49929 100644 --- a/docs/content/v1.0/_index.html +++ b/docs/content/v1.0/_index.html @@ -1,7 +1,7 @@ --- title: Yugabyte DB Docs description: Yugabyte DB Docs -headcontent: v1.2 — recommend upgrading to latest (v1.3) +headcontent: v1.0 — recommend upgrading to latest (v2.0) type: list image: /images/ybsymbol_original.png weight: 1 diff --git a/docs/content/v1.1/_index.html b/docs/content/v1.1/_index.html index a5c0271835c7..53a14241a5ab 100644 --- a/docs/content/v1.1/_index.html +++ b/docs/content/v1.1/_index.html @@ -1,7 +1,7 @@ --- title: Yugabyte DB Docs description: Yugabyte DB Docs -headcontent: v1.2 — recommend upgrading to latest (v1.3) +headcontent: v1.1 — recommend upgrading to latest (v2.0) type: list image: /images/ybsymbol_original.png weight: 1 diff --git a/docs/content/v1.2/_index.html b/docs/content/v1.2/_index.html index 2035f62d519f..68b8cd47c79e 100644 --- a/docs/content/v1.2/_index.html +++ b/docs/content/v1.2/_index.html @@ -1,7 +1,7 @@ --- title: Yugabyte DB Docs description: Yugabyte DB Docs -headcontent: v1.2 — recommend upgrading to latest (v1.3) +headcontent: v1.2 — recommend upgrading to latest (v2.0) type: list image: /images/ybsymbol_original.png weight: 1 diff --git a/docs/content/v1.3/_index.html b/docs/content/v1.3/_index.html index 2e0085088544..2d059fb5959c 100644 --- a/docs/content/v1.3/_index.html +++ b/docs/content/v1.3/_index.html @@ -1,7 +1,7 @@ --- title: Yugabyte DB documentation description: Yugabyte DB documentation -headcontent: v1.3, the latest stable version +headcontent: v1.3 — recommend upgrading to latest (v2.0) type: list image: /images/ybsymbol_original.png weight: 1