-----------------------------------------------------------------------
<h1 align="center"> Q-Cloud User Documentation </h1>
-----------------------------------------------------------------------
## Setup
Before submitting any calculations, you will need to install and configure
the Q-Cloud command line interface:
```
python3 -m pip install qcloud_user
qcloud --configure
```
You will be prompted for several configuration values that can be obtained from
your Q-Cloud administrator. Alternatively, if your administrator has provided
these details in a file, then you can provide the file name as an argument:
```
qcloud --configure user_info.txt
```
You should have received an email with an initial password for your account,
and you will be prompted to change this the first time you attempt to submit a
job.
## Job Control
### Submitting Jobs
Use the `--submit` option to submit Q-Chem jobs to the cluster, e.g.:
```
qcloud --submit job1.inp job2.inp [...]
```
Several jobs can be submitted at the same time and they will be submitted with
the default queue parameters. If there are no compute nodes available, the
jobs will sit in the QUEUED state for a couple of minutes while a fresh compute
node is launched and configured. Once the queue has cleared, the compute nodes
will automatically shut down after the configure time frame (default is five minutes).
Jobs will be submitted with the default queue parameters which are determined
during the cluster setup (contact your QCloud administrator for details).
Scratch space is set explicitly, memory is determined by the instance type
selected and compute time is unlimited. If each job is run on a separate
instance (by requesting all the instance cores) then these are the relevant
default values.
If you want to override these values, or pass additional parameters to the SLUM
scheduler, then you can add these to the first line of the input file as you
would specify command line options to sbatch. For example: line of the Q-Chem
input file. For example, the following limits the job to 1 hour and memory to
4G:
```
--time=1:00:00 --mem=4G
$molecule
0 1
he
$end
$rem
...
```
The number of threads can be specified by using the `--ncpu` flag, for example:
```
qcloud --submit --ncpu 4 job1.inp
```
Note that if the number of threads specified exceeds the number of cores on
an individual compute node, the job will not run. Your QCloud administrator
will be able to inform you what this limit is.
If the job submission is successful, a unique job identifier will be returned:
```
[✓] Submitted job id gv6uqutvNmU0: helium
```
A local registry of these IDs is kept, so it is not essential to use them in the
commands below. However, they may be required to disambiguate multiple jobs
submitted with the same input file basename.
### Monitoring Jobs
To monitor the progress of jobs, use the `--status` option along with a string,
which could be the file name, job ID or substring:
```
qcloud --status <jobid|jobname>
```
The progress of jobs in the RUNNING state can be obtained using:
```
qcloud --tail <jobid|jobname>
```
A job in the QUEUED or RUNNING state can be cancelled, which will remove it from the queue:
```
qcloud --cancel <jobid|jobname>
```
### Downloading Results
Once a job in in the ARCHIVED state, it can be downloaded from the S3 bucket onto
the local machine:
```
qcloud --get <pattern>
```
The download will create a new directory with the same basename as the input file
containing the output from the calculation.
Jobs in the DOWNLOADED state can be cleared from the job registry on the local machine:
```
qcloud --clear <pattern>
```
Note that this does not remove the results from the S3 bucket.
If you want to remove the job from the registry regardless of status, use the
`--remove` option.
## Other commands
The following will give a full list of commands available using the CLI:
```
qcloud --help
```
## Troubleshooting
If you encounter additional problems not covered in this guide, please contact your
Q-Cloud administrator or email support@q-chem.com for assistance.
Raw data
{
"_id": null,
"home_page": "https://q-chem.com",
"name": "qcloud-user",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "qcloud, qchem, q-cloud, q-chem",
"author": "Andrew Gilbert",
"author_email": "\"Q-Chem Inc.\" <support@q-chem.com>",
"download_url": "https://files.pythonhosted.org/packages/23/8c/3cb198a7d5c658fcfed969fb55526e23e8dbac2a89550389ca471fd9d99a/qcloud_user-1.0.12.tar.gz",
"platform": null,
"description": "-----------------------------------------------------------------------\n\n<h1 align=\"center\"> Q-Cloud User Documentation </h1>\n\n-----------------------------------------------------------------------\n\n\n## Setup\n\nBefore submitting any calculations, you will need to install and configure\nthe Q-Cloud command line interface:\n```\npython3 -m pip install qcloud_user\nqcloud --configure\n```\nYou will be prompted for several configuration values that can be obtained from\nyour Q-Cloud administrator. Alternatively, if your administrator has provided\nthese details in a file, then you can provide the file name as an argument:\n```\nqcloud --configure user_info.txt\n```\nYou should have received an email with an initial password for your account,\nand you will be prompted to change this the first time you attempt to submit a\njob.\n\n\n## Job Control\n\n### Submitting Jobs\n\nUse the `--submit` option to submit Q-Chem jobs to the cluster, e.g.:\n```\nqcloud --submit job1.inp job2.inp [...]\n```\nSeveral jobs can be submitted at the same time and they will be submitted with\nthe default queue parameters. If there are no compute nodes available, the\njobs will sit in the QUEUED state for a couple of minutes while a fresh compute\nnode is launched and configured. Once the queue has cleared, the compute nodes\nwill automatically shut down after the configure time frame (default is five minutes).\n\nJobs will be submitted with the default queue parameters which are determined\nduring the cluster setup (contact your QCloud administrator for details).\nScratch space is set explicitly, memory is determined by the instance type\nselected and compute time is unlimited. If each job is run on a separate\ninstance (by requesting all the instance cores) then these are the relevant\ndefault values. \n\nIf you want to override these values, or pass additional parameters to the SLUM\nscheduler, then you can add these to the first line of the input file as you\nwould specify command line options to sbatch. For example: line of the Q-Chem\ninput file. For example, the following limits the job to 1 hour and memory to\n4G: \n```\n--time=1:00:00 --mem=4G\n$molecule\n0 1\nhe\n$end\n$rem\n...\n```\nThe number of threads can be specified by using the `--ncpu` flag, for example:\n```\nqcloud --submit --ncpu 4 job1.inp \n```\nNote that if the number of threads specified exceeds the number of cores on \nan individual compute node, the job will not run. Your QCloud administrator\nwill be able to inform you what this limit is.\n\nIf the job submission is successful, a unique job identifier will be returned:\n```\n[\u2713] Submitted job id gv6uqutvNmU0: helium\n```\nA local registry of these IDs is kept, so it is not essential to use them in the\ncommands below. However, they may be required to disambiguate multiple jobs\nsubmitted with the same input file basename.\n\n\n### Monitoring Jobs\n\nTo monitor the progress of jobs, use the `--status` option along with a string, \nwhich could be the file name, job ID or substring:\n```\nqcloud --status <jobid|jobname> \n```\n\nThe progress of jobs in the RUNNING state can be obtained using:\n```\nqcloud --tail <jobid|jobname> \n```\n\nA job in the QUEUED or RUNNING state can be cancelled, which will remove it from the queue:\n```\nqcloud --cancel <jobid|jobname>\n```\n\n### Downloading Results\n\nOnce a job in in the ARCHIVED state, it can be downloaded from the S3 bucket onto \nthe local machine:\n```\nqcloud --get <pattern> \n```\nThe download will create a new directory with the same basename as the input file \ncontaining the output from the calculation.\n\n\nJobs in the DOWNLOADED state can be cleared from the job registry on the local machine:\n```\nqcloud --clear <pattern> \n```\nNote that this does not remove the results from the S3 bucket.\nIf you want to remove the job from the registry regardless of status, use the\n`--remove` option.\n\n\n## Other commands\n\nThe following will give a full list of commands available using the CLI:\n```\nqcloud --help\n```\n\n## Troubleshooting\n\nIf you encounter additional problems not covered in this guide, please contact your \nQ-Cloud administrator or email support@q-chem.com for assistance.\n\n",
"bugtrack_url": null,
"license": "Confidential property of Q-Chem, Inc. Copyright (c) 1993 by Q-Chem, Inc. (unpublished) All rights reserved. The above copyright notice is intended as a precaution against inadvertent publication and does not imply publication or any waiver of confidentiality. The year included in the foregoing notice is the year of creation. This software product contains proprietary, confidential information and trade secrets of Q-Chem, Inc. and its licensors. No use may be made of this software except according to written agreement with Q-Chem, Inc. ",
"summary": "Q-Cloud CLI for users",
"version": "1.0.12",
"project_urls": {
"Homepage": "https://q-chem.com"
},
"split_keywords": [
"qcloud",
" qchem",
" q-cloud",
" q-chem"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "401ab5b5140bc6bc4ecaee218697c328f52b50ac2412c17c4f01c1f1bd78f31b",
"md5": "5d9bd3a2d2e8ae27a6cf3fd6deff9b8c",
"sha256": "df3c21c5e1fc26bd013622f6bfee7c6f6f251a6ef12bf7fe2808ab298f34b4b0"
},
"downloads": -1,
"filename": "qcloud_user-1.0.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5d9bd3a2d2e8ae27a6cf3fd6deff9b8c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 18067,
"upload_time": "2024-04-12T05:59:09",
"upload_time_iso_8601": "2024-04-12T05:59:09.551963Z",
"url": "https://files.pythonhosted.org/packages/40/1a/b5b5140bc6bc4ecaee218697c328f52b50ac2412c17c4f01c1f1bd78f31b/qcloud_user-1.0.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "238c3cb198a7d5c658fcfed969fb55526e23e8dbac2a89550389ca471fd9d99a",
"md5": "e4b79e1bba27875e4f42dfafd3cb3ca3",
"sha256": "7ee14910cbe51edd8557761f432dd209fadd3b1e39e1dad96e24b3c6e64f366f"
},
"downloads": -1,
"filename": "qcloud_user-1.0.12.tar.gz",
"has_sig": false,
"md5_digest": "e4b79e1bba27875e4f42dfafd3cb3ca3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 10844,
"upload_time": "2024-04-12T05:59:11",
"upload_time_iso_8601": "2024-04-12T05:59:11.441512Z",
"url": "https://files.pythonhosted.org/packages/23/8c/3cb198a7d5c658fcfed969fb55526e23e8dbac2a89550389ca471fd9d99a/qcloud_user-1.0.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-12 05:59:11",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "qcloud-user"
}
JSON