Update IBG 3: JSC Supercomputer HowTo authored by Johannes Keller's avatar Johannes Keller
......@@ -64,90 +64,7 @@ efficiently.
## Tips for first time users
As a first-time user, familiarize yourself with the following helpful commands and configurations to enhance your experience:
- `TAB` for command completion (and f.e. to quickly check if a command or file exists on the system).
- `Ctrl-r` to search through command history efficiently, facilitating the repetition of commands.
- `Ctrl-c` to cancel the execution of a command if needed.
If you find yourself stuck in a shell-opened program, try the following steps to exit the program:
1. Press `Ctrl-c`.
2. Press `Esc`.
3. Type `q`.
4. Type `:q`.
5. Type `:!q`.
6. Press `Ctrl-x` followed by `Ctrl-c`.
---
Every login starts with a clear environment. This means for every new connection:
- The `jutil` command - that sets various useful variables like `$SCRATCH` - is reset and has to be re-activated `jutil env activate -p <project>`.
- The default modules are loaded. For example, any `source loadenvs.Intel` commands or similar have to be repeated to load a specific module list.
- Any previously set variables e.g. `export VARIABLE=VALUE` are no longer set.
On the other hand, changes to `$HOME/.bashrc` will load automatically at login.
---
Add the following lines to `$HOME/.bashrc` to enhance your command line environment. They define a longer history and some nice alias commands (feel free to add to the list):
```shell=
export HISTFILE=~/.bash_history
export SAVEHIST=2000
export HISTSIZE=1000
# Aliases
alias ls='ls --color -o -h '
alias l='ls'
alias less='less -N'
alias dirs='dirs -v'
alias ..='cd ..'
alias ...='cd ../..'
alias ....='cd ../../..'
alias open='chmod go+r'
alias shut='chmod go-r'
alias myq="watch squeue -u $USER"
```
---
Add the following line to `$HOME/.bash_profile` to display more information in the command line prompt.
```shell=
export PS1="\n\[\e[30;1m\]\[\016\]l\[\017\](\[\e[33;1m\]\u@\h\[\e[30;1m\])-(\[\e[33;1m\]\j\[\e[30;1m\])-(\[\e[33;1m\]\@ \d\[\e[30;1m\])->\[\e[30;1m\]\n\[\016\]m\[\017\]-(\[\e[32;1m\]\w\[\e[30;1m\])-(\[\e[32;1m\]\$(/bin/ls -1 | /usr/bin/wc -l | /bin/sed 's: ::g') files, \$(/bin/ls -lah | /bin/grep -m 1 total | /bin/sed 's/total //')b\[\e[30;1m\])--> \[\e[0m\]"
```
---
Create a file named `$HOME/.gitconfig` with the following lines and adapt your name and email (ensure this information is suitable for public use). These configurations provide shortcuts for common Git commands:
```config
[user]
name = Albert Einstein
email = a.einstein@fz-juelich.de
[alias]
co = checkout
br = branch -vv
ci = commit
st = status
unstage = reset HEAD --
last = lg -1 HEAD
[core]
editor = vi
[push]
default = upstream
[credential]
helper = cache --timeout=36000
[diff]
tool = meld
[alias]
lg = !"git lg1-specific"
lg1 = !"git lg1-specific --all"
lg2 = !"git lg2-specific --all"
lg3 = !"git lg3-specific --all"
lg1-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset)%C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(bold yellow)%d%C(reset)'
lg2-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset)%C(bold green)(%ar)%C(reset)%C(bold yellow)%d%C(reset)%n''%C(white)%s%C(reset) %C(dim white)- %an%C(reset)'
lg3-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset)%C(bold green)(%ar)%C(reset) %C(bold cyan)(committed: %cD)%C(reset)%C(bold yellow)%d%C(reset)%n'' %C(white)%s%C(reset)%n''%C(dim white)- %an <%ae> %C(reset) %C(dim white)(committer: %cn<%ce>)%C(reset)'
```
https://gitlab.jsc.fz-juelich.de/sdlts/general-organisation/jsc-supercomputer-wiki-for-ibg-3/-/wikis/Tips-for-first-time-Users-of-JSC-Supercomputers
## Data handling
......
......