Merge branch 'master' into cyberduck

Gemfile

 source "https://rubygems.org"
 
-gem "jekyll-rtd-theme", "~> 2.0.10"
+gem "jekyll-rtd-theme", git: "https://github.com/StarHPC/jekyll-rtd-theme"
 
 gem "github-pages", group: :jekyll_plugins
 

README.md

@@ -17,12 +17,18 @@ code examples are provided under the [MIT](https://opensource.org/licenses/MIT)
 
 ### Install build tools and dependencies.
 
+<details> 
+	<summary>Liquid 4.0.3</summary>
+
 > [!WARNING]
-> Due to Liquid not being updated to work with Ruby 3.2.x, **make sure you have Ruby 3.1.x or older installed**.
+> If you have the latest dependencies installed, the following does not apply anymore.
+> 
+> The original `jekyll-rtd-theme` 2.0.10 required `github-pages` 209, which effectively capped the version of Liquid to 4.0.3.
+> Due to Liquid 4.0.3 and older not being updated to work with Ruby 3.2.x, Ruby 3.1.x or older was required for Liquid 4.0.3.
 > https://talk.jekyllrb.com/t/liquid-4-0-3-tainted/7946/18
 > 
 > #### With Cygwin
-> As of this writing (8/8/2024), Cygwin provides Ruby versions 2.6.4-1 and 3.2.2-2. Make sure to install the former. Additionally, the version of bundler supplied with Ruby 2.6 is too old and the version of RubyGems is too new. *After installing the following dependencies*, you must then install the correct versions of RubyGems and bundler manually:
+> As of 8/8/2024, Cygwin provided Ruby versions 2.6.4-1 and 3.2.2-2. You would need to make sure to install the former. As the version of bundler supplied with Ruby 2.6 is too old and the version of RubyGems is too new, the correct versions of RubyGems and bundler would need to be installed manually after installing all the other dependencies:
 > ```
 > gem update --system 3.2.3
 > gem install bundler -v 2.1.4
@@ -31,6 +37,8 @@ code examples are provided under the [MIT](https://opensource.org/licenses/MIT)
 > bundler -v
 > ```
 
+</details>
+
 To allow building of native extensions, install `ruby-devel`, `gcc`, and `make`.
 
 Install `libxml2`, `libxml2-devel`, `libxslt`, `libxslt-devel`, `libiconv`,
@@ -58,6 +66,10 @@ want to try running `bundle update` or removing `Gemfile.lock` and then running
 git clone https://github.com/starhpc/docs.git star-docs
 cd star-docs
 gem install bundler
+bundle config set --local path ~/.bundler  # Optionally specify where to install gems (SO Q&A #8257833).
+                                           # Otherwise, bundler may attempt to install gems system-wide,
+                                           # e.g. /usr/share/gems, depending on your GEM_HOME
+                                           # (see SO Q&A #11635042 and #3408868).
 bundle install
 bundle exec jekyll serve
 ```

help/faq.md

@@ -63,14 +63,37 @@ Yes. Please see `/software/python_r_perl`.
 
 ### How can I check my disk quota and disk usage?
 
-repquota prints a summary of the disc usage and quotas for the specified file systems.
+To check the disk quota of your home directory ( /home/username ), you can use the repquota command which prints a summary of the disc usage and quotas for the specified file systems.
 
     $ /usr/sbin/repquota -a -s
     $                    Block limits                 File limits
     $ User              used    soft    hard  grace    used   soft  hard  grace
     $ cchave6    --     116M   1024M   1280M           1922      0     0
 
-If you want to see the quota on the home directory where the file system is ext4, the quota information is stored in files named aquota.user and aquota.group at the root of filesystem.
+Here,
+
+Soft Limit -> This is a warning threshold. A user can exceed this limit temporarily, but they must reduce usage back under this limit within a "grace period."
+
+Hard Limit -> This is the absolute maximum disk space or number of files a user can use. The user cannot exceed this limit at all.
+
+Grace Period -> The amount of time a user is allowed to exceed the soft limit before they are required to get back under it. If this period expires, the soft limit becomes enforced like a hard limit.
+
+File limits (inodes) -> These limit the number of files a user can create, regardless of their size.
+
+
+
+To check the quota of the main project storage (parallel file system - /fs1/proj/<project>), you can use this command:
+
+    $ mmlsquota -j <fileset_name> <filesystem_name>
+
+The -j option specifies that you are querying a fileset. Filesets in GPFS are similar to directories that can have independent quota limits.
+
+fileset_name -> This is the name of the fileset whose quota you want to check.
+
+filesystem_name -> The name of the GPFS filesystem in which the fileset resides.
+
+example: mmlsquota -j project_fileset gpfs1
+
 
 ### How many CPU hours have I spent?
 

index.md

@@ -9,4 +9,4 @@ Please see the [Quick Start Guide]({{site.baseurl}}{% link quickstart/quickstart
 
 ## Getting help
 
-First, please read [how to write good support requests]({{site.baseurl}}{% link help/writing-support-requests.md %}). Then shoot us an email.
+First, please read [how to write good support requests]({{site.baseurl}}{% link help/writing-support-requests.md %}). Then [contact us]({{site.baseurl}}{% link help/contact.md %}).

quickstart/quickstart.md

@@ -87,5 +87,5 @@ Project-specific directories may be created upon request for shared storage amon
 
 To make proper use of the cluster, please familiarize yourself with the basics of using Slurm, fundamental HPC concepts, and the cluster's architecture.
 
-You may be familiar with the `.bashrc`, `.bash_profile`, or `.cshrc` files for environment customization. To support different environments needed for different software packages, environment modules are used. Modules allow you to load and unload various software environments tailored to your computational tasks.
+You may be familiar with the `.bashrc`, `.bash_profile`, or `.cshrc` files for environment customization. To support different environments needed for different software packages, [environment modules]({{site.baseurl}}{% link software/env-modules.md %}) are used. Modules allow you to load and unload various software environments tailored to your computational tasks.
 

software/virtual-env.md

 # Virtual Environment Guide
 
-Managing software dependencies and configurations can be challenging in an HPC environment. Users often need different versions of the same software or libraries, leading to conflicts and complex setups. Virtual environments provide a solution by allowing users to isolate their project and its dependencies. This simplifies the setup process, ensures that users have the correct software environment for their applications, and reduces conflicts and errors caused by incompatible software versions. This guide provides different methods for installing or simulating virtual environments in multiple languages including Python, R, Julia, Rust, C, C++, and other languages. This will allow you to create projects in isolated environments that will not require root or sudo access.
+Managing software dependencies and configurations can be challenging in an HPC environment. Users often need different versions of the same software or libraries, leading to conflicts and complex setups. [Environment modules]({{site.baseurl}}{% link software/env-modules.md %}) provide a solution by allowing users to dynamically modify their shell environment using simple commands. This simplifies the setup process, ensures that users have the correct software environment for their applications, and reduces conflicts and errors caused by incompatible software versions. Environment modules work on the same principle as virtual environments, i.e. the manipulation of environment variables. If an environment module is not available for a given version you need, you can instead create a virtual environment using the standard version manager tools provided with many common languages. Virtual environments allow for managing different versions of lanugages and dependencies independent of the system version or other virtual environments, so they are often used by developers to isolate dependencies for different projects.
+
+This guide provides different methods for creating virtual environments and managing dependencies accross multiple languages including Python, R, Julia, Rust, C, C++, and others. This allows you to create projects in isolated environments and install dependencies without the use of root or sudo access.
 
 ## Python