Skip to content

Commit

Permalink
deploy updates
Browse files Browse the repository at this point in the history
  • Loading branch information
@novoselt
novoselt committed Dec 2, 2023
1 parent f3e95c0 commit d18eee6
Show file tree
Hide file tree
Showing 6 changed files with 20 additions and 11 deletions.
16 changes: 13 additions & 3 deletions _sources/compute_server.rst.txt
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,11 @@ The GPU support is extensive, offering variants including A100 80GB, A100 40GB,
Examples of Compute Server Uses
-------------------------------

You may find something useful, at least some inspiration, in our growing `collection of tutorials <https://github.com/sagemathinc/cocalc-howto/blob/main/README.md>`_ that make use of compute servers.
You may find something useful, at least some inspiration, in our growing `collection of tutorials <https://github.com/sagemathinc/cocalc-howto/blob/main/README.md>`_ that make use of compute servers. You can either read them or follow along video versions. Here William explains how to run Google Colab environment on compute servers and use either Tensorflow or PyTorch:

.. raw:: html

<center><iframe width="640" height="360" src="https://www.youtube.com/embed/kcxyShH3wYE?si=rGZEWZgs6XbOF38u" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></center>

----------------------------
Creating a Compute Server
Expand All @@ -37,7 +41,13 @@ You will be prompted to select the desired software image and optionally one or

If you are going to write code using CUDA libraries, choose the "Cuda Toolkit" image. If you want to accelerate PyTorch computations with a GPU, choose the "PyTorch" image. If you want to use SageMath, choose the "SageMath" image. Note that image selection does depend on the presence of a GPU.

Adjust the hardware parameters according to your needs. Take some time to look over the options! Note that you will be able to edit CPU and RAM when the machine if off, so if you don't quite know what you need - make a guess! If it turns out that you need something more or less powerful, you can easily make an adjustment. The disk size can be increased even when the machine is running. Unfortunately, you currently can't move the machine from one region or zone to another unless it is deprovisioned, and the prices do depend on the region - this may change in the future.
Adjust the hardware parameters according to your needs. Take some time to look over the options! Note that you will be able to edit CPU and RAM when the machine if off, so if you don't quite know what you need - make a guess! If it turns out that you need something more or less powerful, you can easily make an adjustment. For example, in this video William uses a machine with 60 CPU cores and 240GB of RAM to build SageMath from source in under 18 minutes:

.. raw:: html

<center><iframe width="640" height="360" src="https://www.youtube.com/embed/b8e8qq-KWbA?si=Y9N6ZtcVKo3fD9Fn" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></center>

After the build is done, William changes the machine type to have only 2 CPU cores and 8GB of RAM - such a machine is very cheap to run even 24/7! The disk size can be increased even when the machine is running. Unfortunately, you currently can't move the machine from one region or zone to another unless it is deprovisioned, and the prices do depend on the region - this may change in the future.

Start your compute server!

Expand All @@ -56,7 +66,7 @@ If you want to use the Linux command line, e.g., compilers, etc., create a termi

If you chose the "CUDA Toolkit", then the "nvcc" command will be available for compiling .cu code. See `this tutorial <https://github.com/sagemathinc/cocalc-howto/blob/main/cuda.md>`_ for details.

If you need to edit the files during your computations on the compute server, remember to click the "Sync" button at the top left of the terminal for the files to get copied to your compute server:
When you edit files via CoCalc interface, they are synced to the compute server automatically. However, if you are using vim or some other tool in a terminal, you may need to click the "Sync" button at the top left for the files to get copied to your compute server:

.. figure:: img/compute_server_syncing.png
:width: 60%
Expand Down
1 change: 0 additions & 1 deletion _sources/teaching-instructors.rst.txt
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,6 @@ There are several reasons why you should consider conducting a course on CoCalc:
* **Managed platform:** no time is wasted setting up, maintaining, backing up and securing a flaky platform. Instead, you can sleep while CoCalc ensures everything runs smoothly 24/7.
* **Focus on helping students:** Jump right into a student's file and assist via a chat on the side.
* **Proven track record:** CoCalc is used for teaching since 2013 in hundreds of courses by tens of thousands of students.
* **Open source:** CoCalc itself and every software it offers is open-source. Say good-bye to vendor lock-in, hidden licensing fees, and proprietary black boxes.
* **Student work is isolated:** Each student does course work in a separate project.

.. toctree::
Expand Down
9 changes: 5 additions & 4 deletions compute_server.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -134,8 +134,8 @@
<p>The GPU support is extensive, offering variants including A100 80GB, A100 40GB, L4, and T4 GPUs with finely configured software stacks. These stack images include SageMath, Google Colab, Julia, PyTorch, Tensorflow and CUDA Toolkit, accommodating a versatile range of uses. The compute servers come at highly competitive pricing, particularly for spot instances.</p>
<section id="examples-of-compute-server-uses">
<h2><a class="toc-backref" href="#id6" role="doc-backlink">Examples of Compute Server Uses</a><a class="headerlink" href="#examples-of-compute-server-uses" title="Permalink to this heading"></a></h2>
<p>You may find something useful, at least some inspiration, in our growing <a class="reference external" href="https://github.com/sagemathinc/cocalc-howto/blob/main/README.md">collection of tutorials</a> that make use of compute servers.</p>
</section>
<p>You may find something useful, at least some inspiration, in our growing <a class="reference external" href="https://github.com/sagemathinc/cocalc-howto/blob/main/README.md">collection of tutorials</a> that make use of compute servers. You can either read them or follow along video versions. Here William explains how to run Google Colab environment on compute servers and use either Tensorflow or PyTorch:</p>
<center><iframe width="640" height="360" src="https://www.youtube.com/embed/kcxyShH3wYE?si=rGZEWZgs6XbOF38u" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></center></section>
<section id="creating-a-compute-server">
<h2><a class="toc-backref" href="#id7" role="doc-backlink">Creating a Compute Server</a><a class="headerlink" href="#creating-a-compute-server" title="Permalink to this heading"></a></h2>
<p>Navigate to the project where you intend to use a compute server. Click on the “Servers” button on the left side of the screen and select “Create Compute Server”:</p>
Expand All @@ -147,7 +147,8 @@ <h2><a class="toc-backref" href="#id7" role="doc-backlink">Creating a Compute Se
</figure>
<p>You will be prompted to select the desired software image and optionally one or more GPUs.</p>
<p>If you are going to write code using CUDA libraries, choose the “Cuda Toolkit” image. If you want to accelerate PyTorch computations with a GPU, choose the “PyTorch” image. If you want to use SageMath, choose the “SageMath” image. Note that image selection does depend on the presence of a GPU.</p>
<p>Adjust the hardware parameters according to your needs. Take some time to look over the options! Note that you will be able to edit CPU and RAM when the machine if off, so if you don’t quite know what you need - make a guess! If it turns out that you need something more or less powerful, you can easily make an adjustment. The disk size can be increased even when the machine is running. Unfortunately, you currently can’t move the machine from one region or zone to another unless it is deprovisioned, and the prices do depend on the region - this may change in the future.</p>
<p>Adjust the hardware parameters according to your needs. Take some time to look over the options! Note that you will be able to edit CPU and RAM when the machine if off, so if you don’t quite know what you need - make a guess! If it turns out that you need something more or less powerful, you can easily make an adjustment. For example, in this video William uses a machine with 60 CPU cores and 240GB of RAM to build SageMath from source in under 18 minutes:</p>
<center><iframe width="640" height="360" src="https://www.youtube.com/embed/b8e8qq-KWbA?si=Y9N6ZtcVKo3fD9Fn" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe></center><p>After the build is done, William changes the machine type to have only 2 CPU cores and 8GB of RAM - such a machine is very cheap to run even 24/7! The disk size can be increased even when the machine is running. Unfortunately, you currently can’t move the machine from one region or zone to another unless it is deprovisioned, and the prices do depend on the region - this may change in the future.</p>
<p>Start your compute server!</p>
</section>
<section id="using-a-compute-server">
Expand All @@ -160,7 +161,7 @@ <h2><a class="toc-backref" href="#id8" role="doc-backlink">Using a Compute Serve
</figcaption>
</figure>
<p>If you chose the “CUDA Toolkit”, then the “nvcc” command will be available for compiling .cu code. See <a class="reference external" href="https://github.com/sagemathinc/cocalc-howto/blob/main/cuda.md">this tutorial</a> for details.</p>
<p>If you need to edit the files during your computations on the compute server, remember to click the “Sync” button at the top left of the terminal for the files to get copied to your compute server:</p>
<p>When you edit files via CoCalc interface, they are synced to the compute server automatically. However, if you are using vim or some other tool in a terminal, you may need to click the “Sync” button at the top left for the files to get copied to your compute server:</p>
<figure class="align-center" id="id3">
<a class="reference internal image-reference" href="_images/compute_server_syncing.png"><img alt="Sync Button for a Compute Server" src="_images/compute_server_syncing.png" style="width: 60%;" /></a>
<figcaption>
Expand Down
2 changes: 1 addition & 1 deletion searchindex.js
View file

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion sitemap.xml
View file
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
<?xml version='1.0' encoding='utf-8'?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><url><loc>https://doc.cocalc.com/en/compute_server.html</loc></url><url><loc>https://doc.cocalc.com/en/contents.html</loc></url><url><loc>https://doc.cocalc.com/en/service_options.html</loc></url><url><loc>https://doc.cocalc.com/en/genindex.html</loc></url><url><loc>https://doc.cocalc.com/en/search.html</loc></url></urlset>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><url><loc>https://doc.cocalc.com/en/compute_server.html</loc></url><url><loc>https://doc.cocalc.com/en/contents.html</loc></url><url><loc>https://doc.cocalc.com/en/service_options.html</loc></url><url><loc>https://doc.cocalc.com/en/teaching.html</loc></url><url><loc>https://doc.cocalc.com/en/teaching-instructors.html</loc></url><url><loc>https://doc.cocalc.com/en/genindex.html</loc></url><url><loc>https://doc.cocalc.com/en/search.html</loc></url></urlset>
1 change: 0 additions & 1 deletion teaching-instructors.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,6 @@
<li><p><strong>Managed platform:</strong> no time is wasted setting up, maintaining, backing up and securing a flaky platform. Instead, you can sleep while CoCalc ensures everything runs smoothly 24/7.</p></li>
<li><p><strong>Focus on helping students:</strong> Jump right into a student’s file and assist via a chat on the side.</p></li>
<li><p><strong>Proven track record:</strong> CoCalc is used for teaching since 2013 in hundreds of courses by tens of thousands of students.</p></li>
<li><p><strong>Open source:</strong> CoCalc itself and every software it offers is open-source. Say good-bye to vendor lock-in, hidden licensing fees, and proprietary black boxes.</p></li>
<li><p><strong>Student work is isolated:</strong> Each student does course work in a separate project.</p></li>
</ul>
<div class="toctree-wrapper compound">
Expand Down

0 comments on commit d18eee6

Please sign in to comment.