diff --git a/ci/requirements.txt b/ci/requirements.txt index 9703701d05f..bae594ed182 100644 --- a/ci/requirements.txt +++ b/ci/requirements.txt @@ -3,5 +3,5 @@ scrapy==1.5.1 pytest>=3.3.0 tabulate>=0.8.2 python-frontmatter>=0.4.2 -twisted==18.4.0 +twisted==19.2.1 attrs>=17.4.0 \ No newline at end of file diff --git a/ci/vale/dictionary.txt b/ci/vale/dictionary.txt index 53855802a5c..213a6d1deb2 100644 --- a/ci/vale/dictionary.txt +++ b/ci/vale/dictionary.txt @@ -219,6 +219,7 @@ csum csv ctools ctrl +cuda cyberduck cyg cygwin @@ -721,6 +722,7 @@ logwatch longview lookups loopback +lspci lsd lst lsyncd @@ -901,6 +903,7 @@ noninteractive nonprivileged nonrecursive nosync +nouveau novell npm npmjs @@ -1063,6 +1066,7 @@ python3 pythonic qmail qmgr +quadro qualys quickconnect quicklisp @@ -1140,6 +1144,7 @@ rubygems ruleset rulesets rundir +runfile runlevels runtime runtimes @@ -1202,6 +1207,7 @@ sfproject sfroot sftp sha256 +shader shadowsocks sharded sharding diff --git a/ci/vale/styles/Linode/Terms.yml b/ci/vale/styles/Linode/Terms.yml index 74326d97d95..2751dd20533 100644 --- a/ci/vale/styles/Linode/Terms.yml +++ b/ci/vale/styles/Linode/Terms.yml @@ -3,13 +3,13 @@ message: Use '%s' instead of '%s'. level: error ignorecase: true swap: - '(?:LetsEncrypt|Let''s Encrypt)': Let's Encrypt - '(?:ReHat|RedHat)': RedHat - 'Mac ?OS ?X': Mac OS X - 'mongoDB': MongoDB - 'node[.]?js': Node.js - 'Post?gr?e(?:SQL)': PostgreSQL - 'java[ -]?scripts?': JavaScript + "(?:LetsEncrypt|Let's Encrypt)": Let's Encrypt + "(?:ReHat|RedHat)": RedHat + "Mac ?OS ?X": Mac OS X + "mongoDB": MongoDB + "node[.]?js": Node.js + "Post?gr?e(?:SQL)": PostgreSQL + "java[ -]?scripts?": JavaScript automattic: Automattic centOS: CentOS cloudflare: Cloudflare @@ -18,7 +18,7 @@ swap: gentoo: Gentoo homebrew: Homebrew linode cli: Linode CLI - linode manager: Linode Manager + linode manager: Linode Manager linode: Linode longview: Longview macOS: macOS @@ -33,3 +33,5 @@ swap: yaml: YAML urls: URLs uris: URIs + Cuda: CUDA + gpu: GPU diff --git a/docs/platform/linode-gpu/_index.md b/docs/platform/linode-gpu/_index.md new file mode 100644 index 00000000000..245ab028599 --- /dev/null +++ b/docs/platform/linode-gpu/_index.md @@ -0,0 +1,5 @@ +--- +description: 'Linodes with dedicated GPUs accelerate highly specialized applications such as machine learning, AI, and video transcoding.' +title: 'Linode GPU Instances' +show_in_lists: true +--- diff --git a/docs/platform/linode-gpu/getting-started-with-gpu/copy-cuda-installer-download-link.png b/docs/platform/linode-gpu/getting-started-with-gpu/copy-cuda-installer-download-link.png new file mode 100644 index 00000000000..2df32c15057 Binary files /dev/null and b/docs/platform/linode-gpu/getting-started-with-gpu/copy-cuda-installer-download-link.png differ diff --git a/docs/platform/linode-gpu/getting-started-with-gpu/copy-driver-download-link.png b/docs/platform/linode-gpu/getting-started-with-gpu/copy-driver-download-link.png new file mode 100644 index 00000000000..e516f6d1079 Binary files /dev/null and b/docs/platform/linode-gpu/getting-started-with-gpu/copy-driver-download-link.png differ diff --git a/docs/platform/linode-gpu/getting-started-with-gpu/cuda-downloads-select-target-platform.png b/docs/platform/linode-gpu/getting-started-with-gpu/cuda-downloads-select-target-platform.png new file mode 100644 index 00000000000..2d862239160 Binary files /dev/null and b/docs/platform/linode-gpu/getting-started-with-gpu/cuda-downloads-select-target-platform.png differ diff --git a/docs/platform/linode-gpu/getting-started-with-gpu/cuda-installer.png b/docs/platform/linode-gpu/getting-started-with-gpu/cuda-installer.png new file mode 100644 index 00000000000..174d076ec29 Binary files /dev/null and b/docs/platform/linode-gpu/getting-started-with-gpu/cuda-installer.png differ diff --git a/docs/platform/linode-gpu/getting-started-with-gpu/index.md b/docs/platform/linode-gpu/getting-started-with-gpu/index.md new file mode 100644 index 00000000000..bcd6291309d --- /dev/null +++ b/docs/platform/linode-gpu/getting-started-with-gpu/index.md @@ -0,0 +1,214 @@ +--- +author: + name: Linode + email: docs@linode.com +description: 'Getting Started with Linode GPU Instances.' +keywords: ["GPU", "AI", "Machine Learning", "Video Encoding", "Linode GPU"] +license: '[CC BY-ND 4.0](http://creativecommons.org/licenses/by-nd/4.0/)' +aliases: [] +published: 2019-06-05 +title: Getting Started with Linode GPU Instances +modified_by: + name: Linode +--- + +This guide will help you get your Linode GPU Instance up and running on a number of popular distributions. To prepare your Linode, you will need to install NVIDIA's proprietary drivers using [NVIDIA's CUDA Toolkit](https://developer.nvidia.com/cuda-toolkit). + +When using distributions that are not fully supported by CUDA, like Debian 9, you can install the NVIDIA driver without the CUDA toolkit. To only install the NVIDIA driver, complete the [Before You Begin](#before-you-begin) section and then, move on to the [Manual Install](#manual-install) section of this guide. + +For details on the CUDA Toolkit's full feature set, see the [official documentation](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html#introduction). + +{{< disclosure-note "Why do NVIDIA's drivers need to be installed?" >}} +Linode has chosen not to bundle NVIDIA's proprietary closed-source drivers with its standard Linux distribution images. While some operating systems are packaged with the open source [Nouveau](https://nouveau.freedesktop.org/wiki/) driver, the NVIDIA proprietary driver will provide optimal performance for your GPU-accelerated applications. +{{< /disclosure-note >}} + +## Before You Begin + +1. Follow our [Getting Started](https://www.linode.com/docs/getting-started/) and [Securing Your Server](https://www.linode.com/docs/security/securing-your-server/) guides for instructions on setting up your Linodes. + +1. Make sure that your GPU is currently available on your deployed Linode: + + lspci -vnn | grep NVIDIA + + You should see a similar output confirming that your Linode is currently running a NVIDIA GPU. The example output was generated on Ubuntu 18.04. Your output may vary depending on your distribution. + + {{< output >}} +00:03.0 VGA compatible controller [0300]: NVIDIA Corporation TU102GL [Quadro RTX 6000/8000] [10de:1e30] (rev a1) (prog-if 00 [VGA controller]) +    Subsystem: NVIDIA Corporation Quadro RTX 6000 [10de:12ba] +{{< /output >}} + + {{< note >}} +Depending on your distribution, you may need to install lspci manually first. On current CentOS and Fedora systems, you can install this utility with the following command: + + sudo yum install pciutils +{{< /note >}} + +1. Move on to the next section to [install the dependencies](#install-dependencies) that NVIDIA's drivers rely on. + +## Install NVIDIA Driver Dependencies + +Prior to installing the driver, you should install the required dependencies. Listed below are commands for installing these packages on many popular distributions. + +1. Find your Linode's distribution from the list below and install the NVIDIA driver's dependencies: + + ### Ubuntu 18.04 + + sudo apt-get install build-essential + + ### Debian 9 + + sudo apt-get install build-essential + sudo apt-get install linux-headers-`uname -r` + + ### CentOS 7 + sudo yum install kernel-devel-$(uname -r) kernel-headers-$(uname -r) + sudo yum install wget + sudo yum -y install gcc + + ### OpenSUSE + zypper install gcc + zypper install kernel-source + +1. After installing the dependencies, reboot your Linode from the [Cloud Manager](https://cloud.linode.com). Rebooting will ensure that any newly installed kernel headers are available for use. + + +## NVIDIA Driver Installation + +After installing the required dependencies for your Linux distribution, you are ready to install the NVIDIA driver. If you are using Ubuntu 18.04, CentOS 7, and OpenSUSE, proceed to the [Install with CUDA](#install-with-cuda) section. If you are using Debian 9, proceed to the [Install Manually](#install-manually) section. +### Install with CUDA + + In this section, you will install your GPU driver using [NVIDIA's CUDA Toolkit](https://developer.nvidia.com/cuda-toolkit). + For a full list of native Linux distribution support in CUDA, see the [CUDA toolkit documentation](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html#system-requirements). + +1. Visit the [CUDA Downloads Page](https://developer.nvidia.com/cuda-downloads) and navigate to the **Select Target Platform** section. + +1. Provide information about your target platform by following the prompts and selecting the appropriate options. Once complete, you will gain access to the correct download link for the CUDA Toolkit installer. Use the table below for guidance on how to respond to each prompt: + + | **Prompt** | **Selection** | + |--------|-----------| + | Operating System | Linux | + | Architecture | x86_64 | + | Distribution | Your Linode's distribution | + | Version | Your distribution's version | + | Installer type | runfile (local) | + + A completed set of selections will resemble the example: + + ![CUDA Downloads Page - Select Target Platform](cuda-downloads-select-target-platform.png "CUDA Downloads Page - Select Target Platform") + +1. A **Download Installer** section will appear below the **Select Target Platform** section. The green **Download** button in this section will link to the installer file. Copy this link to your computer's clipboard: + + ![Copy Download Link](copy-cuda-installer-download-link.png "Right click to copy the download link for the installer") + +1. On your Linode, enter the `wget` command and paste in the download link you copied. This example shows the syntax for the command, but you should make sure to use the download link appropriate for your Linode: + + wget https://developer.nvidia.com/compute/cuda/10.1/Prod/local_installers/cuda_10.1.168_418.67_linux.run + +1. After wget completes, run your version of the installer script to begin the installation process: + + sudo sh cuda_*_linux.run + + {{< note >}} +The installer will take a few moments to run before generating any output. +{{< /note >}} + +1. Read and accept the License Agreement. + +1. Choose to install the CUDA Toolkit in its entirety or partially. To use your GPU, you only need to install the driver. Optionally, you can choose to install the full toolkit to gain access to a set of tools that will empower you to create GPU-accelerated applications. + + To only install the driver, uncheck all options directly below the Driver option. This will result in your screen resembling the following: + + ![Cuda Installer](cuda-installer.png "Cuda Installer") + +1. Once you have checked your desired options, select **Install** to begin the installation. A full install will take several minutes to complete. + + {{< note >}} + +Installation on CentOS and Fedora will fail following this step, because the installer requires a reboot to fully remove the default Nouveau driver. If you are running either of these operating systems, reboot the Linode, run the installer again, and your installation will be successful. + +{{< /note >}} + +1. When the installation has completed, run the `nvidia-smi` command to make sure that you're currently using your NVIDIA GPU device with its associated driver: + + nvidia-smi + + You should see a similar output: + + +-----------------------------------------------------------------------------+ + | NVIDIA-SMI 418.67 Driver Version: 418.67 CUDA Version: 10.1 | + |-------------------------------+----------------------+----------------------+ + | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | + | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | + |===============================+======================+======================| + | 0 Quadro RTX 6000 Off | 00000000:00:03.0 Off | Off | + | 34% 57C P0 72W / 260W | 0MiB / 24190MiB | 0% Default | + +-------------------------------+----------------------+----------------------+ + + +-----------------------------------------------------------------------------+ + | Processes: GPU Memory | + | GPU PID Type Process name Usage | + |=============================================================================| + | No running processes found | + +-----------------------------------------------------------------------------+ + + In the output, you can see that the driver is installed and functioning correctly, the version of CUDA attributed to it, and other useful statistics. + +### Install Manually + +This section will walk you through the process of downloading and installing the latest NVIDIA driver on Debian 9. This process can also be completed on another distribution of your choice, if needed: + +1. Visit NVIDIA's [Driver Downloads Page](https://www.nvidia.com/Download/index.aspx?lang=en-us). + +1. Make sure that the options from the drop-down menus reflect the following values: + + | **Prompt** | **Selection** | + |--------|-----------| + | Product Type | Quadro | + | Product Series | Quadro RTX Series | + | Product | Quadro RTX 8000 | + | Operating System | Linux 64-bit | + | Download Type | Linux Long Lived Driver | + | Language | English (US) | + + The form will look as follows when completed: + + ![NVIDIA Drivers Download Form](nvidia-drivers-download-form.png "NVIDIA Drivers Download Form") + +1. Click the **Search** button, and a page will appear that shows information about the driver. Click the green **Download** button on this page. The file will not download to your computer; instead, you will be taken to another download confirmation page. + +1. Copy the link for the driver installer script from the green **Download** button on this page: + + ![Copy Download Link](copy-driver-download-link.png "Right click to copy the download link for the installer") + +1. On your Linode, enter the `wget` command and paste in the download link you copied. This example shows the syntax for the command, but you should make sure to use the download link you copied from NVIDIA's site: + + wget http://us.download.nvidia.com/XFree86/Linux-x86_64/430.26/NVIDIA-Linux-x86_64-430.26.run + +1. After wget completes, run your version of the installer script on your Linode. Follow the prompts as necessary: + + sudo bash NVIDIA-Linux-x86_64-*.run + +1. Select `OK` and `Yes` for all prompts as they appear. + +1. Once the installer has completed, use `nvidia-smi` to make sure that you're currently using your NVIDIA GPU with its associated driver: + + nvidia-smi + + You should see a similar output: + + +-----------------------------------------------------------------------------+ + | NVIDIA-SMI 430.26 Driver Version: 430.26 CUDA Version: 10.2 | + |-------------------------------+----------------------+----------------------+ + | GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC | + | Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. | + |===============================+======================+======================| + | 0 Quadro RTX 6000 Off | 00000000:00:03.0 Off | Off | + | 34% 59C P0 1W / 260W | 0MiB / 24220MiB | 6% Default | + +-------------------------------+----------------------+----------------------+ + + +-----------------------------------------------------------------------------+ + | Processes: GPU Memory | + | GPU PID Type Process name Usage | + |=============================================================================| + | No running processes found | + +-----------------------------------------------------------------------------+ diff --git a/docs/platform/linode-gpu/getting-started-with-gpu/nvidia-drivers-download-form.png b/docs/platform/linode-gpu/getting-started-with-gpu/nvidia-drivers-download-form.png new file mode 100644 index 00000000000..646bc246ca3 Binary files /dev/null and b/docs/platform/linode-gpu/getting-started-with-gpu/nvidia-drivers-download-form.png differ diff --git a/docs/platform/linode-gpu/why-linode-gpu/index.md b/docs/platform/linode-gpu/why-linode-gpu/index.md new file mode 100644 index 00000000000..85b62e31b29 --- /dev/null +++ b/docs/platform/linode-gpu/why-linode-gpu/index.md @@ -0,0 +1,89 @@ +--- +author: + name: Linode + email: docs@linode.com +description: 'Use Cases for Linode GPU Instances' +keywords: ["GPU","Linode GPU", "How to use GPU", "Machine Learning", "AI", "Deep Learning", "grub"] +license: '[CC BY-ND 4.0](http://creativecommons.org/licenses/by-nd/4.0/)' +aliases: [] +published: 2019-06-12 +title: Use Cases for Linode GPU Instances +modified_by: + name: Linode +--- + +## What are GPUs? + +GPUs (Graphical Processing Units) are specialized hardware originally created to manipulate computer graphics and image processing. GPUs are designed to process large blocks of data in parallel making them excellent for compute intensive tasks that require thousands of simultaneous threads. Because a GPU has significantly more logical cores than a standard CPU, it can perform computations that process large amounts of data in parallel, more efficiently. This means GPUs accelerate the large calculations that are required by big data, video encoding, AI, and machine learning. + +### The Linode GPU Instance +Linode GPU Instances include NVIDIA Quadro RTX 6000 GPU cards with Tensor, ray tracing (RT), and CUDA cores. Read more about the NVIDIA RTX 6000 [here](https://www.nvidia.com/content/dam/en-zz/Solutions/design-visualization/technologies/turing-architecture/NVIDIA-Turing-Architecture-Whitepaper.pdf). + +## Use Cases +### Machine Learning and AI + +Machine learning is a powerful approach to data science that uses large sets of data to build prediction algorithms. These prediction algorithms are commonly used in “recommendation” features on many popular music and video applications, online shops, and search engines. When you receive intelligent recommendations tailored to your own tastes, machine learning is often responsible. Other areas where you might find machine learning being used is in self-driving cars, process automation, security, marketing analytics, and health care. + +AI (Artificial Intelligence) is a broad concept that describes technology designed to behave intelligently and mimic the cognitive functions of humans, like learning, decision making, and speech recognition. AI uses large sets of data to learn and adapt in order to achieve a specific goal. GPUs provide the processing power needed for common AI and machine learning tasks like input data preprocessing and model building. + +Below is a list of common tools used for machine learning and AI that can be installed on a Linode GPU instance: + +- [TensorFlow](https://www.tensorflow.org) - a free, open-source, machine learning framework, and deep learning library. Tensorflow was originally developed by [Google](http://google.com) for internal use and later fully released to the public under the Apache License. + +- [PyTorch](https://pytorch.org/) - a machine learning library for Python that uses the popular GPU optimized [Torch](https://en.wikipedia.org/wiki/Torch_(machine_learning)) framework. + +- [Apache Mahout](https://mahout.apache.org/) - a scalable library of machine learning algorithms, and a distributed linear algebra framework designed to let mathematicians, statisticians, and data scientists quickly implement their own algorithms. + +### Big Data + +Big data is a discipline that analyzes and extracts meaningful insights from large and complex data sets. These sets are so large and complex that they require specialized software and hardware to appropriately capture, manage, and process the data. When thinking of big data and whether or not the term applies to you, it often helps to visualize the “three Vs”: + +- **Volume:** Generally, if you are working with terabytes, exabytes, petabytes, or more amounts of information you are in the realm of big data. + + +- **Velocity:** With Big Data, you’re using data that is being created, called, moved, and interacted with at a high velocity. One example is the real time data generated on social media platforms by its users. + +- **Variety:** Variety refers to the many different types of data formats with which you may need to interact. Photos, video, audio, and documents can all be written and saved in a number of different formats. It is important to consider the variety of data that you will collect in order to appropriately categorize it. + +GPUs can help give Big Data systems the additional computational capabilities they need for ideal performance. Below are a few examples of tools which you can use for your own big data solutions: + +- [Hadoop](https://hadoop.apache.org/) - an Apache project that allows the creation of parallel processing applications on large data sets, distributed across networked nodes. + +- [Apache Spark](https://spark.apache.org/) - a unified analytics engine for large-scale data processing designed with speed and ease of use in mind. + +- [Apache Storm](https://storm.apache.org/) - a distributed computation system that processes streaming data in real time. + +### Video Encoding + +Video Encoding is the process of taking a video file's original source format and converting it to another format that is viewable on a different device or using a different tool. This resource intensive task can be greatly accelerated using the power of GPUs. + + - [FFmpeg](https://developer.nvidia.com/ffmpeg) - a popular open-source multimedia manipulation framework that supports a large number of video formats. + +### General Purpose Computing using CUDA + +CUDA (Compute Unified Device Architecture) is a parallel computing platform and API that allows you to interact more directly with the GPU for general purpose computing. In practice, this means that a developer can write code in C, C++, or many other supported languages utilizing their GPU to create their own tools and programs. + +If you're interested in using CUDA on your GPU Linode, see the following resources: + + - [NVIDIA's Library of Documentation](https://docs.nvidia.com/cuda/) + + - [Introduction to CUDA](https://devblogs.nvidia.com/easy-introduction-cuda-c-and-c/) + + - [NVIDIA's CUDA exercise repository](https://github.com/csc-training/CUDA/tree/master/exercises) + +### Graphics Processing + +One of the most traditional use cases for a GPU is graphics processing. Transforming a large set of pixels or vertices with a shader or simulating realistic lighting via ray tracing are massive parallel processing tasks. Ray tracing is a computationally intensive process that simulates lights in a scene and renders the reflections, refractions, shadows, and indirect lighting. It's impossible to do on GPUs in real-time without hardware-based ray tracing acceleration. The Linode GPU Instances offers real-time ray tracing capabilities using a single GPU. + +New to the NVIDIA RTX 6000 are the following shading enhancements: + +- Mesh shading models for vertex, tessellation, and geometry stages in the graphics pipeline +- Variable Rate Shading to dynamically control shading rate +- Texture-Space Shading which utilizes a private memory held texture space +- Multi-View Rendering allowing for rendering multiple views in a single pass. + +## Where to Go from Here + +If you are ready to get started with Linode GPU, our [Getting Started with Linode GPU Instances](/docs/platform/linode-gpu/getting-started-with-gpu/) guide walks you through deploying a Linode GPU Instance and installing the GPU drivers so that you can best utilize the use cases you've read in this guide. + +To see the extensive array of Docker container applications available, check out [NVIDIA's site](https://ngc.nvidia.com/catalog/landing). Note: To access some of these projects you need an NGC account.