CommunityData:Hyak migration (ikt to mox): Difference between revisions

From CommunityData
(moved content in from another page)
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= Instructions for migration =
== Ikt to Mox (2020) home directories ==
You're responsible for moving your home directories from Ikt to Mox. To do so, follow these instructions:
=== 1. on IKT: prepare your homedirectory ===
First, go through and delete the things you don't want in your home directory. the program ncdu is installed on ikt and it will show you detailed information of what is taking up space. go through and recursively delete thing you don't want. if you want to archive things on cold storage, you can do that too by putting compressed tar files in /com/STAGING-cold_storage (we're strongly encouarged to ensure that each file is more than 100MB).
There are likely many hidden files as well. You can see those with "ls -a".
=== 2. on IKT: make a tarball of your home directory ===
You will need to make a tarball of your home directory and store it in <code>/com/STAGING-bbcp</code>
{{note}} change every instance of "'''<YOURUWNETID>'''" to your NetID (e.g., "makohill") before running the instructions below
<syntaxhighlight lang='bash'>
$ ssh login2.hyak.uw.edu
$ cd /usr/lusers
$ tar cvf /com/STAGING-bbcp/<YOURUWNETID>_ikt_homedir.tar <YOURUWNETID>
</syntaxhighlight>
=== 3. on IKT: copy the file over to your new homedirectory on MOX ===
<syntaxhighlight lang='bash'>
$ cd /com/STAGING-bbcp
$ hyakbbcp <YOURUWNETID>_ikt_homedir.tar mox1.hyak.uw.edu:/usr/lusers/<YOURUWNETID>/
</syntaxhighlight>
=== 4. on MOX: unpack you new data ===
Run the following:
<syntaxhighlight lang='bash'>
$ cd /usr/lusers/<YOURUWNETID>
$ tar xvf <YOURUWNETID>_ikt_homedir.tar --transform 's/^<YOURUWNETID>/ikt_homedir/'
$ rm ~/<YOURUWNETID>_ikt_homedir.tar
</syntaxhighlight>
This will create a new directory called <code>ikt_homedir</code> in my home directory on mox. I'll then go through and move out the things from <code>ikt_homedir</code> into <code>../</code> your new home dirctory.
Or just leave them there if you want.
= Coordination and Checklists =
This page is a list of things that we want to do to migrate from ikt to mox.  
This page is a list of things that we want to do to migrate from ikt to mox.  


Line 23: Line 69:
!Who needs to do it
!Who needs to do it
|-
|-
|2019-12-15
|2020-01-17
|Collect list of software to install on Mox
|Collect list of software to install on Mox
|Everyone
|Everyone
|-
|-
|2020-01-05
|2020-02-01
|Install software on mox and setup shared .bashrc
|Install software on mox and setup shared .bashrc
|Nate (possibly with help from Sayamindu + Mako)
|Nate (possibly with help from Sayamindu + Mako)
|-
|-
|2020-01-06
|2020-02-15
| Test setup on Mox
| Test setup on Mox
| Everyone (Especially Kaylea)
| Everyone (Especially Kaylea)
|-
|-
|2020-01-13
|2020-03-01
|Start primarily using Mox
|Start primarily using Mox
| Everyone
| Everyone
Line 58: Line 104:
=== Add packages you want below! ===  
=== Add packages you want below! ===  


* zsh
[X] zsh
* Spark 2.4
 
* Python 3.7
[X] Spark 2.4
* R 3.5.2
 
* moreutils 0.62 (seems like at least some of the moreutils are broken (i.e. parallel))
[X] Python 3.7
* emacs 25
Installed Anoconda and created a minimal anaconda environment to speed up startup time. This seems like the easiest way to get an optimized python installation.
* p7zip 16.02
 
* htop 2.2.0
[X] R 3.6.2
* pandoc 2.2.1
 
[X] moreutils 0.62 (seems like at least some of the moreutils are broken (i.e. parallel))
 
[X] emacs 25
 
[X] p7zip 16.02
 
[X] htop 2.2.0
 
[X] pandoc 2.2.1
 
[X] gcc 4.9+


=== RStudio Server ===  
=== RStudio Server ===  
It could be nice to run an RStudio server on the interactive node to provide a nicer IDE for working interactively on hyak compared to Jupyter notebooks or editing in the terminal. If this isn't feasible then we should use kibo for this purpose instead.
It could be nice to run an RStudio server on the interactive node to provide a nicer IDE for working interactively on hyak compared to Jupyter notebooks or editing in the terminal. If this isn't feasible then we should use kibo for this purpose instead.
== Etherpad link ==
https://etherpad.wikimedia.org/p/cdsc_hyak_migration_todo


== Scheduler Options ==
== Scheduler Options ==

Latest revision as of 23:20, 30 July 2024

Instructions for migration[edit]

Ikt to Mox (2020) home directories[edit]

You're responsible for moving your home directories from Ikt to Mox. To do so, follow these instructions:

1. on IKT: prepare your homedirectory[edit]

First, go through and delete the things you don't want in your home directory. the program ncdu is installed on ikt and it will show you detailed information of what is taking up space. go through and recursively delete thing you don't want. if you want to archive things on cold storage, you can do that too by putting compressed tar files in /com/STAGING-cold_storage (we're strongly encouarged to ensure that each file is more than 100MB).

There are likely many hidden files as well. You can see those with "ls -a".

2. on IKT: make a tarball of your home directory[edit]

You will need to make a tarball of your home directory and store it in /com/STAGING-bbcp

Note Note: change every instance of "<YOURUWNETID>" to your NetID (e.g., "makohill") before running the instructions below

$ ssh login2.hyak.uw.edu
$ cd /usr/lusers
$ tar cvf /com/STAGING-bbcp/<YOURUWNETID>_ikt_homedir.tar <YOURUWNETID>

3. on IKT: copy the file over to your new homedirectory on MOX[edit]

$ cd /com/STAGING-bbcp
$ hyakbbcp <YOURUWNETID>_ikt_homedir.tar mox1.hyak.uw.edu:/usr/lusers/<YOURUWNETID>/

4. on MOX: unpack you new data[edit]

Run the following:

$ cd /usr/lusers/<YOURUWNETID>
$ tar xvf <YOURUWNETID>_ikt_homedir.tar --transform 's/^<YOURUWNETID>/ikt_homedir/'
$ rm ~/<YOURUWNETID>_ikt_homedir.tar

This will create a new directory called ikt_homedir in my home directory on mox. I'll then go through and move out the things from ikt_homedir into ../ your new home dirctory. Or just leave them there if you want.

Coordination and Checklists[edit]

This page is a list of things that we want to do to migrate from ikt to mox.

  1. Copy data (only raw data, data that we are using in current and future projects)
  2. Backup other data?
  3. Copy code (Everyone copy their own user directory)
  4. Create a shared .bashrc that everyone will load. This will provide us with a shared environment (python, R, other packages, useful aliases).

Hyak Migration Working Group

  1. Mako
  2. Kaylea
  3. Nate
  4. Sayamindu
  5. Jeremy
  6. Jim?

Time Table[edit]

Hyak migration schedule
Date Task to be done Who needs to do it
2020-01-17 Collect list of software to install on Mox Everyone
2020-02-01 Install software on mox and setup shared .bashrc Nate (possibly with help from Sayamindu + Mako)
2020-02-15 Test setup on Mox Everyone (Especially Kaylea)
2020-03-01 Start primarily using Mox Everyone
2020-05-01 Evacuate Ikt! It's the end! Everyone

Shared environment design[edit]

We will use custom modules to maintain installations of software that we use. Sometimes the hyak team already provides a module that we need (i.e. up-to-date R and Python) then we should prefer these packages so we don't have to do the work of compiling and packaging the modules. But if we want to be on the cutting edge of python and R we'll be in the business.

Since I (Nate) typically develop code on my laptop before running it on hyak. I think it is ideal if our Hyak environment maintains versions of software that are equivalent to those included in Debian Buster whenever possible. Ideally we will even provide modules for important R and Python packages (e.g. spark, ggplot, pandas) so that we can keep versions consistent and stable over time.

We'll create a list of packages that people can expect to be loaded in their environments and load them in the shared .bashrc.

We'll also provide a shared .bash_aliases that provide common commands for interacting with slurm.

List of modules we'll maintain on Hyak (WIP)[edit]

We can get a list of packages from /gscratch/com/local/bin on Ikt.

Add packages you want below![edit]

[X] zsh

[X] Spark 2.4

[X] Python 3.7 Installed Anoconda and created a minimal anaconda environment to speed up startup time. This seems like the easiest way to get an optimized python installation.

[X] R 3.6.2

[X] moreutils 0.62 (seems like at least some of the moreutils are broken (i.e. parallel))

[X] emacs 25

[X] p7zip 16.02

[X] htop 2.2.0

[X] pandoc 2.2.1

[X] gcc 4.9+

RStudio Server[edit]

It could be nice to run an RStudio server on the interactive node to provide a nicer IDE for working interactively on hyak compared to Jupyter notebooks or editing in the terminal. If this isn't feasible then we should use kibo for this purpose instead.

Etherpad link[edit]

https://etherpad.wikimedia.org/p/cdsc_hyak_migration_todo

Scheduler Options[edit]

It might be a good idea to ask the hyak folks to configure the scheduler for our partition so that we can request specific quantities of memory or cpus in our jobs. (Hyak Wiki)

This might be particularly useful if we don't get more nodes soon because it allows us to chunk up nodes into smaller pieces.

Getting more nodes[edit]

We have funding in the ecology grant (and maybe other sources of funding as well) that we can use to purchase additional Mox capacity. Let's keep track of plans around that to try to minimize the gap from the time we lose Ikt nodes until we get more Mox nodes.