diff --git a/chapters/introduction.qmd b/chapters/introduction.qmd index f438d45..6fe3df7 100644 --- a/chapters/introduction.qmd +++ b/chapters/introduction.qmd @@ -1,9 +1,11 @@ -# Introduction +# Overview + +## Introduction The FRB-CESAB server **Rossinante** is dedicated to *medium* performance scientific computing (see @tbl-hardware for hardware specification). -It runs under the Operating System (OS) **Debian 12** (Bookworm). +It runs under the GNU/Linux distribution **Debian 12** (Bookworm). **When do you want to use Rossinante?** @@ -26,35 +28,57 @@ It runs under the Operating System (OS) **Debian 12** (Bookworm). : Hardware specifications {#tbl-hardware} -You can run programs implemented in R, Python, Julia, Shell script, C, C++, etc. -directly from a terminal or using Web clients like [RStudio Server](https://support.posit.co/hc/en-us/articles/200552306-Getting-Started) or -[Jupyter Notebook](https://jupyter.org/). +You can run programs implemented in R, Python, Shell script, C, C++, etc. +directly from a terminal, using Web clients like [RStudio Server](https://support.posit.co/hc/en-us/articles/200552306-Getting-Started) or +inside [Docker](https://www.docker.com/) containers. ::: {.callout-important} ## Important No job scheduling system (e.g. SLURM, Torque) has been installed. This means -that you can launch jobs whenever you want. However you are invited to read -@sec-good-practices (Good practices). +that you can launch jobs whenever you want. However you are invited to respect some rules +(@sec-good-practices). ::: +## Storage + +You have access to four personal directories: + +- `/home/you/` +- `/media/sancho/you` (external drive) +- `/media/seagate/you` (external drive) +- `/media/cervantes/you` (external drive) + +You can create, edit and remove any files/directories you want inside these directories. + +::: {.callout-important} +## Important + +Rossinante is **not a storage server**. The 30 TB of storage are shared +among all users. You can store large datasets to run yours +analyses, but once you're done, please remove these files. + +**There is no backup system!** You are responsible for your data. +::: + -**What are the available software?** -- [`R`](https://cran.r-project.org/) (latest version) -- [`RStudio Server`](https://www.rstudio.com/products/rstudio/download-server/) -- [`Python 3`](https://www.python.org/) (latest version) +## Available software + +- [`R`](https://cran.r-project.org/) -- Scientific computing (among others) +- [`RStudio Server`](https://www.rstudio.com/products/rstudio/download-server/) -- Web interface for R +- [`Python 3`](https://www.python.org/) -- Scientific computing (among others) - [`pip3`](https://pip.pypa.io/) -- Python packages managers -- [`Pandoc`](https://pandoc.org/) -- [`Quarto`](https://quarto.org/) -- [`git`](https://git-scm.com/) -- [`make`](https://www.gnu.org/software/make/) -- [`Docker`](https://www.docker.com/) +- [`Pandoc`](https://pandoc.org/) -- Universal document converter +- [`Quarto`](https://quarto.org/) -- Scientific publishing system +- [`git`](https://git-scm.com/) -- Version control system +- [`make`](https://www.gnu.org/software/make/) -- Project compilation +- [`Docker`](https://www.docker.com/) -- Containerization -And some useful utilities: +## Useful utilities - [`FFmpeg`](https://ffmpeg.org/) -- Transcoding multimedia files - [`ImageMagick`](https://imagemagick.org) -- Image manipulation program @@ -68,35 +92,16 @@ And some useful utilities: - [`tree`](http://mama.indstate.edu/users/ice/tree/) -- Recursive directory listing program - [`curl`](https://curl.se/) and [`wget`](https://www.gnu.org/software/wget/manual/wget.html) -- Download managers - [`zip`](https://linuxize.com/post/how-to-zip-files-and-directories-in-linux/) and [`unzip`](https://linuxize.com/post/how-to-unzip-files-in-linux/) -- ZIP files managers -- [`zsh`](https://www.zsh.org/) - Unix shell (alternative to Bash) - -**Can you do everything you want on Rossinante?** +- [`zsh`](https://www.zsh.org/) -- Unix shell (alternative to Bash) -No! - -Rossinante has only **one administrator**. Regular user, -like you, has limited permissions. - -You have access to four personal directories: - -- `/home/you/` -- `/media/sancho/you` (external drive) -- `/media/seagate/you` (external drive) -- `/media/cervantes/you` (external drive) +## Missing software If you need to use a non-installed software, please contact the administrator. + Note that each user has a personal R library in which he/she can install every R packages he/she wants (independently of other users). For Python, packages are shared among all users (except if you work with virtual environments **[recommended]**). -::: {.callout-important} -## Important - -Rossinante is **not a storage server**. Its limited storage is shared -among all users. You can store large dataset to run yours -analyses, but once you've finished, please remove these files. -**There is no backup system!**. You are responsible for your data. -:::