https://github.com/c4rO-0/jobage

a job management tool for cluster scheduling systems. support: IBM Spectrum LSF Slurm Workload Manager
https://github.com/c4rO-0/jobage

Last synced: about 2 months ago
JSON representation

a job management tool for cluster scheduling systems. support: IBM Spectrum LSF Slurm Workload Manager

• Host: GitHub
• URL: https://github.com/c4rO-0/jobage
• Owner: c4rO-0
• License: mpl-2.0
• Created: 2022-01-05T08:51:52.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-10-28T09:18:25.000Z (almost 2 years ago)
• Last Synced: 2024-06-29T13:33:07.061Z (3 months ago)
• Language: Shell
• Homepage:
• Size: 1.8 MB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# jobage 

a job-management tool with nice printing for cluster scheduling systems.

remember only one set of commands for all the systems.

author : C4r-bs

---

## view

### lsf 

![jbq_q](./img/jbg_q_lsf.png)

### slurm

![jbq_q](./img/jbq_q_slurm.png)

## progress 

|       | bash  | zsh   |

| ----- | ----- | ----- |

| lsf   | done  | done  |

| slurm | done  | done  |

| PBS   | doing | -     |

## install

### 1. clone or download 

   **git clone :**

   ```shell

   git clone https://github.com/c4rO-0/jobage.git

   ```

   or

   ```shell

   git https://gitee.com/C4r/jobage.git

   ```

   **download:** 

   gitee : https://gitee.com/bsplu/scripts/repository/archive/master.zip

   github : https://codeload.github.com/c4rO-0/jobage/zip/refs/heads/master

### 2. start to run

**Temporarily working**

```bash

source where_is_jobage/main.sh

```

**Always working**

add `source where_is_jobage/main.sh` to `~/.bashrc`.

if `zsh` is used, add `source where_is_jobage/main.sh` to `~/.zsh`.

***Specify working path***

only suggested for users having single linux account

```shell

source main.sh --jbg_prefix path

```

path is the specific working path, default is `$HOME/.local/jobage`

***Debug mod***

```shell

source main.sh --jbg_debug 

```

open debug mod. more details will be printed.

### 3. test

**run**

```shell

jbg.help

```

**working** output like

![check_failed](./img/check_working.png)

**failed** output like

![check_failed](./img/check_failed.png)

please make sure that one of `bqueues/squeue` can run on your system.

## usage

1. all commands run like `jbg.XXX`

2. run `jbg.help` to get a summary help information

3. run `jbg.XXX -h` get a help information for the command XXX.

### command available

| command             | behavior                        |

| ------------------- | ------------------------------- |

| jbg.q               | quary queue information         |

| jbg.qh              | quary queue history information |

| jbg.kill [num/grep] | kill job                        |

| jbg.sub             | submit job                      |

| jbg.cd              | go to the path of job           |

## custom 

1. on setting: copy setting file to jobage working directory:

``` bash

mkdir -p "$_jobage_wPath";

cp "$_jobage_default_setting" "$_jobage_setting";

source main.sh

```

2. edit setting file:

  

``` shell

vi "$_jobage_setting";

```

3. off setting (if wanted):

  

``` shell

rm "$_jobage_setting";

```

## todo list

-[ ] auto-generate scripts.