jhpce 0.0.2

A package for using python to work on the Johns Hopkins Joint High performance Computing Exchange

jhpce-python

This is a repository to apply and use JHPCE cluster management locally in python.

Dependencies

To install the dependencies listed in the requirements.txt file, you can use the following command:

pip install -r requirements.txt

Loading

Until it gets put on pypi, you can load with (for example)

from jhpce.jhpce.module import *
from jhpce.jhpce.keygen import *

where you're in the root directory of the jhpce-python.

Public/private key pairs

If you don't already have a private key / public key pair. We require a password on our private key. You can generate a public private key par with the command:

key = keygen("id_jhpce", "****")

where **** is your desired password. This will print out a public key text that you need to paste into ~/.ssh/authorized_keys on jhpce.

You should only need to generate your key once, do not save your password in plain text and do not commit your keys to a public repo

Given that you have private key, one can load a key with

key = loadkey('filename')

The path to the filename needs to be the full path if it's not in the current working directory.

DO NOT ACCIDENTALLY COMMIT AND PUSH YOUR PRIVATE KEY OR PASSWORD TO A GITHUB REPO

Establishing a connection

From the root directory of this repo. One can establish a connection witih

## Establish a connection, key is as above
con = jhpce("USERNAME", key)
## It keeps track of a local directory
con.local_set_repo("DIRECTORY ON LOCAL")
## It can execute some remote commands
con.remote_ls(return_as_pd = True)
## It can set a remote directory
con.remote_set_dir("DIRECTORY ON CLUSTER")
## Read the slurm queue
out = con.remote_squeue()['stdout']