-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* feature/adds july 2024 marketplace deploy docs * update _index.md * add apache spark doc, alphabetize * PR review 1 - no Valkey * Valkey * Update index.md * add valkey + openbao to dict * delay spark * valecheck * Formatting changes --------- Co-authored-by: Anna Bracha <[email protected]> Co-authored-by: Matthew Wildman <[email protected]>
- Loading branch information
3 people
authored
Aug 5, 2024
1 parent
d8c8e0a
commit 2b531aa
Showing
9 changed files
with
460 additions
and
13 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
113 changes: 113 additions & 0 deletions
113
docs/products/tools/marketplace/guides/apache-cassandra-cluster/index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,113 @@ | ||
| --- | ||
| title: "Deploy Apache Cassandra Cluster through the Linode Marketplace" | ||
| description: "Apache Cassandra is an open-source, distributed NoSQL database management system designed for handling large amounts of data across many commodity servers, providing high availability with no single point of failure. Cassandra offers robust support for clusters with asynchronous masterless replication allowing low-latency operations for all clients. " | ||
| published: 2024-08-05 | ||
| keywords: ['nosql','database', 'marketplace', 'cassandra'] | ||
| tags: ["ubuntu","marketplace", "database", "linode platform", "cloud manager", "ssl", "cloud storage", "high availability", "compute storage"] | ||
| external_resources: | ||
| - '[About Apache Cassandra](https://cassandra.apache.org/)' | ||
| - '[Apache Cassandra Documentation](https://cassandra.apache.org/doc/latest/cassandra/architecture/overview.html)' | ||
| --- | ||
|
|
||
| ## Cluster Deployment Architecture | ||
|
|
||
| Create a highly available Apache Cassandra cluster through the Linode Marketplace. Apache Cassandra is an open-source, distributed NoSQL database management system designed for handling large amounts of data across many commodity servers, providing high availability with no single point of failure. Cassandra offers robust support for clusters with asynchronous masterless replication, allowing low-latency operations for all clients. | ||
|
|
||
| ## Deploying a Marketplace App | ||
|
|
||
| {{% content "deploy-marketplace-apps-shortguide" %}} | ||
|
|
||
| {{% content "marketplace-verify-standard-shortguide" %}} | ||
|
|
||
| {{< note >}} | ||
| **Estimated deployment time:** Your Apache Cassandra cluster should be fully installed within 10-15 minutes after the Compute Instance has finished provisioning. | ||
| {{< /note >}} | ||
|
|
||
| ## Configuration Options | ||
|
|
||
| - **Supported distributions:** Ubuntu 22.04 LTS | ||
| - **Suggested minimum plan:** All plan types and sizes can be used. For best results, a minimum of 8GB Dedicated CPU or Shared Compute Instance is recommended. | ||
|
|
||
| ### Apache Cassandra Options | ||
|
|
||
| - **[Linode API Token](/docs/products/tools/api/guides/manage-api-tokens/#create-an-api-token):** The provisioner node uses an authenticated API token to create the additional components to the cluster. This is required to fully create the Apache Cassandra cluster. | ||
|
|
||
| {{% content "marketplace-required-limited-user-fields-shortguide" %}} | ||
|
|
||
| {{% content "marketplace-special-character-limitations-shortguide" %}} | ||
|
|
||
| - **Cassandra Database User:** Enter your database super username for the Cassandra cluster. | ||
|
|
||
| - **Number of clients connecting to Cassandra:** The number of clients that will be connecting to the cluster. The application will create SSL certificates for your clients that need to connect to the cluster. The number of clients should be an integer equal or greater than 1. | ||
|
|
||
| - **Cassandra cluster size:** The size of the Cassandra cluster | ||
|
|
||
| - **Country or Region:** Enter the country or region for you or your organization. | ||
|
|
||
| - **State or Province:** Enter the state or province for you or your organization. | ||
|
|
||
| - **Locality:** Enter the town or other locality for you or your organization. | ||
|
|
||
| - **Organization:** Enter the name of your organization. | ||
|
|
||
| - **Email Address:** Enter the email address you wish to use for your certificate file. | ||
|
|
||
| ## Getting Started After Deployment | ||
|
|
||
| This Marketplace App creates a 3-5 node cluster using Apache Cassandra. Authentication to the cluster is secured via a user-supplied username. The default `cassandra` database role is removed and superseded by the new user role provided by the client. In addition, cluster communication is secured via SSL/TLS with self-signed keystores. | ||
|
|
||
| Both certificates and keystores can be found on every node in the `/etc/cassandra/ssl` directory. Only the first Cassandra server will have client certificates. This playbook also creates *_n_* amount of client certificates so that applications can connect to the Cassandra cluster. | ||
|
|
||
| ### Connecting to Cassandra | ||
|
|
||
| Connect to Cassandra using `cqlsh` using client or server certificates. You will need 4 components to connect to the cluster: | ||
|
|
||
| - Username and password created by the playbook. You can find the credentials in `/home/$SUDO_USER/.credentials`, where `$SUDO_USER` is your sudo user created during deployment. | ||
| - Client certificate | ||
| - Client key | ||
| - CA certificate | ||
|
|
||
| 1. On the client node, create the `/home/$SUDO_USER/cassandra_ssl` directory, where `$SUDO_USER` is your sudo user created during deployment. | ||
|
|
||
| 2. From the first Cassandra node, securely transfer the following files and directories: `/etc/cassandra/ssl/cert/client1.crt`, `/etc/cassandra/ssl/key/client1.key`, and `/etc/cassandra/ssl/ca/ca.crt` to the `/home/$SUDO_USER/cassandra_ssl` directory on the client node. | ||
|
|
||
| 3. Create a Cassandra resource file to use our client certificate. Create the `/home/$SUDO_USER/.cassandra` directory. In the `.cassandra` directory, create a `cqlshrc` file with the following content: | ||
|
|
||
| ``` | ||
| [connection] | ||
| ssl = true | ||
| factory = cqlshlib.ssl.ssl_transport_factory | ||
| [ssl] | ||
| certfile = /home/$SUDO_USER/cassandra_ssl/ca.crt | ||
| userkey = /home/$SUDO_USER/cassandra_ssl/client1.key | ||
| usercert = /home/$SUDO_USER/cassandra_ssl/client1.crt | ||
| validate = true | ||
| ``` | ||
| 4. Connect to one of the Cassandra servers using `cqlsh`: | ||
| ```command | ||
| cqlsh 192.168.139.160 -u superuser --ssl | ||
| ``` | ||
| Replace `192.168.139.160` with the private IP address of one of the Cassandra nodes and `superuser` with the Cassandra database user you provided when deploying the cluster. Once you are connected, enter the password from `/home/$SUDO_USER/.credentials` at the prompt to authenticate to the cluster. | ||
| ```output | ||
| Connected to Cassandra Cluster at 192.168.139.160:9042 | ||
| [cqlsh 6.1.0 | Cassandra 4.1.5 | CQL spec 3.4.6 | Native protocol v5] | ||
| Use HELP for help. | ||
| superadmin@cqlsh> | ||
| ``` | ||
|
|
||
| You can distribute the remainder of client certificates to the rest of the nodes. | ||
|
|
||
| ## Software Included | ||
|
|
||
| The Apache Cassandra Marketplace App installs the following software on your Linode: | ||
|
|
||
| | **Software** | **Description** | | ||
| |:--------------|:------------| | ||
| | [**Apache Cassandra**](https://cassandra.apache.org/) | Open Source NoSQL Database. | | ||
| | [**UFW**](https://help.ubuntu.com/community/UFW) | Uncomplicated Firewall | | ||
|
|
||
| {{% content "marketplace-update-note-shortguide" %}} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,63 @@ | ||
| --- | ||
| description: "Deploy InfluxDB on a Linode Compute Instance. InfluxDB is a high-performance time series database designed to handle massive volumes of data with ease." | ||
| keywords: ['time series database','monitoring','analytics','data'] | ||
| tags: ["marketplace", "linode platform", "cloud manager"] | ||
| published: 2024-08-05 | ||
| modified_by: | ||
| name: Linode | ||
| title: "Deploy InfluxDB through the Linode Marketplace" | ||
| external_resources: | ||
| - '[InfluxData](https://www.influxdata.com/)' | ||
| authors: ["Linode"] | ||
| --- | ||
|
|
||
| [InfluxDB](https://www.influxdata.com/) is a high-performance time series database designed to handle massive volumes of data with ease. Its intuitive query language and powerful visualization capabilities make it the go-to choice for monitoring, analytics, and IoT applications. | ||
|
|
||
| ## Deploying a Marketplace App | ||
|
|
||
| {{% content "deploy-marketplace-apps-shortguide" %}} | ||
|
|
||
| {{% content "marketplace-verify-standard-shortguide" %}} | ||
|
|
||
| {{< note >}} | ||
| **Estimated deployment time:** InfluxDB should be fully installed within 5-10 minutes after the Linode has finished provisioning. | ||
| {{< /note >}} | ||
|
|
||
| ## Configuration Options | ||
|
|
||
| - **Supported distributions:** Ubuntu 22.04 LTS | ||
| - **Suggested plan:** All plan types and sizes can be used. | ||
|
|
||
| ### InfluxDB Options | ||
|
|
||
| - **Email address** *(required)*: Enter the email address to use for generating the SSL certificates. | ||
| - **Admin Username** *(required)*: Username for InfluxDB admin. | ||
| - **Organization Name** *(required)*: Name of the InfluxDB organization. | ||
| - **Bucket Name** *(required)*: Name of initial InfluxDB bucket. | ||
|
|
||
| {{% content "marketplace-required-limited-user-fields-shortguide" %}} | ||
|
|
||
| {{% content "marketplace-custom-domain-fields-shortguide" %}} | ||
|
|
||
| {{% content "marketplace-special-character-limitations-shortguide" %}} | ||
|
|
||
| ## Getting Started after Deployment | ||
|
|
||
| ### Accessing the InfluxDB Server | ||
|
|
||
| 1. Access InfluxDB's welcome page by launching your preferred web browser and navigating to either the custom domain designated during deployment or your Linode's rDNS domain, such as `192-0-2-17.ip.linodeusercontent.com`. If you need assistance in finding your Linode's IP addresses and rDNS information, refer to the [Managing IP Addresses](/docs/products/compute/compute-instances/guides/manage-ip-addresses/) guide for detailed instructions. | ||
|
|
||
|  | ||
|
|
||
| 1. Enter the username `admin` and the generated password provided in the compute instance's `/home/$SUDO_USER/.credentials` file. This lets you access the dashboard and begin using InfluxDB. | ||
|
|
||
|  | ||
|
|
||
| ### More Information | ||
|
|
||
| You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials. | ||
|
|
||
| - [InfluxData](https://www.influxdata.com/) | ||
| - [InfluxDB Documentation](https://docs.influxdata.com/influxdb/v2/) | ||
|
|
||
| {{% content "marketplace-update-note-shortguide" %}} |
Binary file added
BIN
+103 KB
docs/products/tools/marketplace/guides/influxdb/influxdb_dashboard.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.