One place for hosting & domains

      OneClick

      How to Deploy Percona Monitoring and Management (PMM) with One-Click Apps


      Updated by Linode

      Contributed by
      Linode

      Marquee image for How to Deploy Percona Monitoring and Management (PMM) with One-Click Apps

      Percona (PMM) One-Click App

      Percona Monitoring and Management (PMM) is an open-source tool which provides a GUI powered by Grafana for monitoring and managing MySQL, MariaDB, PostgreSQL, and MongoDB databases. You can use PMM to easily observe important metrics, logging, and statistics related to your databases and the hosts they run on. Additionally, it includes a number of tools which can help to optimize your database’s performance, manage all database instances, and track and identify potential security threats. Linode’s Percona (PMM) One-Click App deploys a Linode with PMM installed and ready for you to begin monitoring your databases.

      PMM Architecture Overview

      The PMM tool uses a client-server model which makes it easy to scale monitoring across several databases hosted on various remote hosts. See the table below to better understand how each PMM component fits into the context of Linode’s Percona (PMM) One-Click App.

      Component Description
      PMM Server The Percona (PMM) One-Click App deploys an instance of the PMM Server, which includes the Grafana web interface to visualize all the data collected from the databases it monitors.
      PMM Client You will need to install the PMM Client on any Linode that hosts a database that you would like to monitor. The PMM Client will help you connect to the PMM Server and relay host and database performance metrics to the PMM Server.

      Note

      Deploy a Percona (PMM) One-Click App

      Linode’s One-Click App Marketplace allow you to easily deploy software on a Linode using the Linode Cloud Manager. To access Linode’s One-Click App Marketplace:

      1. Log in to your Linode Cloud Manager account.

      2. From the Linode dashboard, click on the Marketplace button in the left-hand navigation menu.

      3. The Linode creation page will appear, with the One-Click and Marketplace tabs pre-selected.

      4. Under the Select App section, select the app you would like to deploy:

        Select a One-Click App to deploy

      5. Once you have selected the app, proceed to the app’s Options section and provide values for the required fields.

      Percona (PMM) Options

      Configuration Description
      Hostname The hostname to assign to your new Linode. Required.

      Linode Options

      The following configuration options are possible for your Linode server:

      Configuration Description
      Select an Image Debian 10 and Ubuntu 20.04 are currently the only images supported by the Percona (PMM) One-Click App. Required.
      Region The region where you would like your Linode to reside. In general, it’s best to choose a location that’s closest to you. For more information on choosing a DC, review the How to Choose a Data Center guide. You can also generate MTR reports for a deeper look at the network routes between you and each of our data centers. Required.
      Linode Plan Your Linode’s hardware resources. Percona recommends roughly 1 GB of storage on your PMM Server for each database node you would like to monitor. For more information on Percona’s system requirements see their official documentation. If you decide that you need more or fewer hardware resources after you deploy your app, you can always resize your Linode to a different plan. Required.
      Linode Label The name for your Linode, which must be unique between all of the Linodes on your account. This name will be how you identify your server in the Cloud Manager’s Dashboard. Required.
      Root Password The primary administrative password for your Linode instance. This password must be provided when you log in to your Linode via SSH. It must be at least 6 characters long and contain characters from two of the following categories: lowercase and uppercase case letters, numbers, and punctuation characters. Your root password can be used to perform any action on your server, so make it long, complex, and unique. Required.

      When you’ve provided all required Linode Options, click on the Create button. Your PMM app will complete installation anywhere between 1-5 minutes after your Linode has finished provisioning.

      Software Included

      The Percona (PMM) One-Click App will install the following required software on your Linode:

      Software Description
      Docker Docker is used to containerize PMM.
      Grafana Grafana is the visualization tool used by PMM to provides charts, graphs, and alerts for the databases that are being monitored.
      pmm-admin pmm-admin is a command-line tool used to manage PMM Clients.

      Note

      Currently, Linode does not manage software and systems updates for One-Click Apps. It is up to the user to perform routine maintenance on software deployed in this fashion.

      Getting Started after Deployment

      Access your PMM Server’s Grafana Dashboard

      After the PMM Server has finished installing, you will be able to access its Grafana dashboard over http:// and your Linode’s IPv4 address. To find your Linode’s IPv4 address:

      1. Click on the Linodes link in the sidebar. You will see a list of all your Linodes.

      2. Find the Linode you just created when deploying your app and select it.

      3. Navigate to the Networking tab.

      4. Your IPv4 address will be listed under the Address column in the IPv4 table.

      5. Copy and paste the IPv4 address into a browser window. Ensure you are using http://.

      6. You will see the PMM Home Dashboard actively monitoring your server:

        Percona Home Page

      Installing the PMM Client

      To begin monitoring a database node, you will need to install the PMM Client on the Linode that hosts your database and connect the node to the PMM Server.

      Note

      The PMM Server deployed with Linode’s Percona (PMM) One-Click App is compatible with PMM Client version 1.
      1. Connect to your Linode via SSH.

      2. Update your system’s software.

        Debian or Ubuntu:

        sudo apt-get update && apt-get upgrade
        

        CentOS:

        sudo yum update
        
      3. Install the PMM Client (version 1):

        Debian or Ubuntu:

        sudo apt-get install pmm-client
        

        CentOS:

        sudo yum install pmm-client
        
      4. Connect your database node to the PMM Server. Replace 192.0.2.0 with your PMM Server’s IPv4 address.

        Note

        sudo pmm-admin config --server 192.0.2.0
        

        Once complete, you should see a similar output:

          
        OK, PMM server is alive.
        
        PMM Server      | 192.0.2.0
        Client Name     | li222-111
        Client Address  | 192.0.2.1
              
        

      Monitor a Database Instance

      Once your database node and your PMM Server are communicating, the final step is to add your database instance to be monitored by your PMM Server. These steps are completed on your Database node.

      1. Connect to your Linode via SSH.

      2. Add your database instance to be monitored by your PMM Server. This command will add a MySQL database instance to be monitored. You can replace mysql with the database type that your node is hosting (i.e. postgresql or mongodb). See Percona’s Managing PMM Client documentation for details.

        pmm-admin add mysql
        

        Your Percona dashboard should now be monitoring your MySQL service.

        https://www.linode.com/perconafinal.png

        Note

      Next Steps

      The Percona Monitoring Management Tool is very powerful and can be configured to monitor and display various pieces of your database instances. Once you have completed the basic configurations outlined in this guide, you should review Percona’s documentation to learn more about the PMM tool. Here are some suggested topics:

      This guide is published under a CC BY-ND 4.0 license.



      Source link

      How to Deploy Nextcloud on Linode with One-Click Apps


      Updated by Linode

      Contributed by
      Linode

      Installing Nextcloud OCA

      Nextcloud is an open source solution to file hosting and sharing. With Nextcloud, you can synchronize files from a local computer to the Linode server and share them with collaborators. Nextcloud’s customizable security features and intuitive user interface help to keep files safe and easy to manage.

      Before You Begin

      While a Domain Name is not strictly required, it is recommended. If you plan to use a domain name for the deployment, complete the following steps:

      1. Create a Linode API v4 access token. The Nextcloud One-Click App needs a Linode API v4 token to create a domain name system (DNS) record for the Nextcloud instance.

      2. Register (purchase) a domain name.

      3. Set the domain name to use Linode’s name servers. You need to do this on the domain registrar’s website and then wait up to 24 hours for the change to take effect.

      Deploy a NextCloud One-Click App

      Linode’s One-Click App Marketplace allow you to easily deploy software on a Linode using the Linode Cloud Manager. To access Linode’s One-Click App Marketplace:

      1. Log in to your Linode Cloud Manager account.

      2. From the Linode dashboard, click on the Marketplace button in the left-hand navigation menu.

      3. The Linode creation page will appear, with the One-Click and Marketplace tabs pre-selected.

      4. Under the Select App section, select the app you would like to deploy:

        Select a One-Click App to deploy

      5. Once you have selected the app, proceed to the app’s Options section and provide values for the required fields.

      NextCloud Options

      Field Description
      MySQL database root password The root user’s password for the Nextcloud database. Required.
      MySQL user password Your new MySQL user’s password. Required.

      Advanced Options

      LAMP Stack Options
      Field Description
      MySQL database username The name of a new MySQL user to create. If no value is provided, the user is named nextcloud. Required.
      MySQL database name The name to assign to the Nextcloud instance’s MySQL database. If no value is provided, the database is named nextcloud. Required.
      Linode Server Security Options
      Field Description
      Linode limited sudo username The username for a new limited user account with sudo privileges. Advanced Configuration.
      Linode limited user password The password for the new limited user account. Advanced Configuration.
      SSH Public Key A public key belonging to the user that accesses the Linode. If you do not have an authentication key-pair see the Securing Your Server guide for steps on creating one. Advanced Configuration.
      Enable passwordless sudo Enable passwordless sudo access for the limited user account. Advanced Configuration.
      Disable root access Disable root user access for the Linode server. Advanced Configuration.
      Domain Options
      Field Description
      Linode API v4 token The Linode API v4 token is required to create a domain name system (DNS) record for the Nextcloud instance. See the Getting Started with the Linode API guide to learn how to generate an API token. Advanced Configuration.
      Linode hostname The hostname to assign to the Linode server. If no value is provided, the hostname is set as nextcloud. Advanced Configuration.
      Domain name The domain name to use when creating a DNS record for the Linode. The One-Click app creates a subdomain named nextcloud. You can access the Nextcloud instance using the nextcloud subdomain; for example, www.nextcloud.example.com. Advanced Configuration.
      Admin email address The email address to use for the Nextcloud instance’s admin user. Advanced Configuration.
      Enable SSL Enable a free HTTPS CertBot SSL certificate on the Nextcloud domain. If you do not provide a value, no is set by default. Advanced Configuration.
      Timezone The timezone to use for the Linode server. If you do not provide a value, the Linode data center’s timezone is used. Refer to TZ database names for possible timezone values. Advanced Configuration.

      Linode Options

      After providing the app specific options, provide configurations for the Linode server:

      Configuration Description
      Select an Image Debian 10 is currently the only image supported by the Nextcloud One-Click App, and it is pre-selected on the Linode creation page. Required.
      Region The region where you would like the Linode to reside. In general, it’s best to choose a location that is closest to you. For more information on choosing a DC, review the How to Choose a Data Center guide. You can also generate MTR reports for a deeper look at the network routes between the Linode server and each of our data centers. Required.
      Linode Plan Your Linode’s hardware resources. You should select a Linode plan type based on the amount of data you would like to store on the Nextcloud instance. You can always resize your Linode to a different plan later if you feel you need to increase or decrease the system resources. Required.
      Linode Label The name for the Linode server, which must be unique between all of the Linodes on your account. This name helps you identify the server in the Cloud Manager’s Dashboard. Required.
      Add Tags A tag to help organize and group the Linode resources. Tags can be applied to Linodes, Block Storage Volumes, NodeBalancers, and Domains.
      Root Password The primary administrative password for the Linode instance. This password must be provided when you log in to the Linode using SSH. It must be at least 6 characters long and contain characters from two of the following categories: lowercase and uppercase case letters, numbers, and punctuation characters. The root password can be used to perform any action on the server, so make it long, complex, and unique. Required.

      When you’ve provided all required Linode Options, click the Create button.

      Note

      Your Nextcloud app completes installation anywhere between 5-7 minutes after your Linode has finished provisioning. It is recommended that you wait the full 5-7 minutes prior to beginning the steps in the Getting Started after Deployment section of this guide. You may experience unexpected behavior if you begin those steps while your Nextcloud instance is still being deployed and setup by the One-Click App on the Linode instance.

      Getting Started after Deployment

      Log Into Your Nextcloud Instance

      1. Open a browser window and navigate to the Nextcloud instance’s domain. For example, enter nextcloud.example.com into the browser, replacing example.com with the value of your own domain. If you do not install the App with a domain name, the domain is the public IP address of the Linode appended with a forward slash and “nextcloud. For example, 192.168.17.43/nextcloud/.

      2. Create a Nextcloud admin account by providing values in the presented form.

        Create a Nextcloud admin account.

      3. In the Storage & database section, provide the MySQL database values that you used in the Nextcloud Options section.

        Provide your MySQL database values

      4. Click the Finish setup button to complete the configuration. The set up takes a couple of minutes to complete. The Nextcloud Hub page appears where you can upload files to the Nextcloud server.

        Nextcloud Hub

      Next Steps

      Note

      Currently, Linode does not manage software and systems updates for One-Click Apps. It is up to the user to perform routine maintenance on software deployed in this fashion.

      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.

      This guide is published under a CC BY-ND 4.0 license.



      Source link

      How to Deploy Django with One-Click Apps


      Updated by Linode

      Contributed by
      Linode

      Django One-Click App

      Django is a web development framework for the Python programing language. It enables rapid development, while favoring pragmatic and clean design. Django was initially developed for use in a newspaper’s website division, and as a result the Django framework is very well suited to developing content-centric applications. It’s also very flexible in its ability to facilitate many complex content management operations.

      Deploy Django One-Click App

      One-Click Apps allow you to easily deploy software on a Linode using the Linode Cloud Manager. To access Linode’s One-Click Apps:

      1. Log in to your Linode Cloud Manager account.

      2. From the Linode dashboard, click on the Create button in the top right-hand side of the screen and select Linode from the dropdown menu.

      3. The Linode creation page will appear. Select the One-Click tab.

      4. Under the Select App section, select the app you would like to deploy:

        Select a One-Click App to deploy

      5. Once you have selected the app, proceed to the app’s Options section and provide values for the required fields.

      The Django Options section of this guide provides details on all available configuration options for this app.

      Django Options

      You can configure your Django App by providing values for the following fields:

      Field Description
      Django APP Name Name for the Django application. This field cannot have spaces. Required.
      Django USER Username for your Django application. Required.
      Django Password Password for the Django USER. Required.
      Django USER email Email address for the Django USER. The format for the email must be in the form [email protected] Required.

      Linode Options

      After providing the app specific options, provide configurations for your Linode server:

      Configuration Description
      Select an Image Debian 9 is currently the only image supported by Django One-Click Apps, and it is pre-selected on the Linode creation page. Required.
      Region The region where you would like your Linode to reside. In general, it’s best to choose a location that’s closest to you. For more information on choosing a DC, review the How to Choose a Data Center guide. You can also generate MTR reports for a deeper look at the network routes between you and each of our data centers. Required.
      Linode Plan Your Linode’s hardware resources. Django can be supported on any size Linode, but we suggest you choose a Linode plan that reflects how many resources you plan on using. For small applications, a 1GB Nanode is sufficient. If you decide that you need more or fewer hardware resources after you deploy your app, you can always resize your Linode to a different plan. Required.
      Linode Label The name for your Linode, which must be unique between all of the Linodes on your account. This name will be how you identify your server in the Cloud Manager’s Dashboard. Required.
      Root Password The primary administrative password for your Linode instance. This password must be provided when you log in to your Linode via SSH. It must be at least 6 characters long and contain characters from two of the following categories: lowercase and uppercase case letters, numbers, and punctuation characters. Your root password can be used to perform any action on your server, so make it long, complex, and unique. Required.

      When you’ve provided all required Linode Options, click on the Create button. Your Django app will complete installation anywhere between 2-5 minutes after your Linode has finished provisioning.

      Getting Started after Deployment

      Access Django

      After Django has finished installing, you will be able to access your Django site at your Linode’s IPv4 address, for instance: https://yourlinodeip:8000.

      1. To find your Linode’s IPv4 address. Click on the Linodes link in the sidebar. You will see a list of all your Linodes.

      2. Find the Linode you just created when deploying your app and select it.

      3. Navigate to the Networking tab.

      4. The IP address will be displayed under the Address column in the IPv4 table.

      5. Copy and paste the IPv4 address into a browser window followed by :8000. You should see the Django test page appear.

        Django Test Page

      6. Once you have verified that you can access your Django site via the browser, you can log in using the admin credentials you created when deploying your app. Update the address in the browser to: https://yourlinodeip:8000/admin.

        Login to your Django site.

      7. Once logged in, you will have access to the Admin console. Now you can begin configuring your site.

        Django Admin Console

      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.

      This guide is published under a CC BY-ND 4.0 license.



      Source link