From a501c6c07b2542b04fdef3254551193fa8118e7e Mon Sep 17 00:00:00 2001 From: arcan1s Date: Sun, 12 Jan 2014 16:08:59 +0400 Subject: [PATCH] Added queued page --- projects/queued.html | 150 +++++++++++++++++++++++++++++++++++++++++++ robots.txt | 2 +- sitemap.xml | 4 ++ 3 files changed, 155 insertions(+), 1 deletion(-) create mode 100644 projects/queued.html diff --git a/projects/queued.html b/projects/queued.html new file mode 100644 index 0000000..d8d3f3e --- /dev/null +++ b/projects/queued.html @@ -0,0 +1,150 @@ + + + + + + queued + + + + + + + + +
+
+

queued

+

Daemon for starting jobs to queue of calculations

+

General information
+ Installation guide
+ How to use
+ Adding a job
+ Configuration
+ Links

+
+
+ +

Information

+

Daemon for starting jobs to queue of calculations. It was written as proof-of-concept.

+
$ queued --help
+Simple daemon written on BASH for starting jobs to queue of calculations
+
+Usage: queued [ -c /etc/queued.conf ] [ -v | --version ] [ -h | --help ]
+Parametrs:
+  -c               PATH     - path to configuration file. Default is '/etc/queued.conf'
+
+  -v   --version            - show version and exit
+  -h   --help               - show this help and exit
+
$ add_queued --help
+add_queued [ -c /etc/queued.conf ] [ -p NUM ] [ -u USER ] [ -h | --help ] /path/to/script
+
+Parameters:
+    -c               PATH     - path to configuration file. Default is '/etc/queued.conf'
+    -p               NUM      - job priority
+    -u               USER     - username
+    -h   --help               - show this help and exit
+ +

Developers and contributors

+
    +
  • Evgeniy Alekseev
    • +
+ +

License

+
    +
  • GPLv3
    • +
+ +

Installation

+ +

Instruction

+
    +

  • Download an archive with latest version of source files.

    • +

  • Extract it and install the application:

    +
    ./install.sh "/path/to/root/package"
    +

    If you want install it to / you must run it as root, e.g.:

    +
    sudo ./install.sh "/path/to/root/package"
    +

    If no path is specified it will be installed to / by default.

    • +
+ +

Dependencies

+

I want note that all were tested on latest version of dependencies.

+
    +
  • Bash (including awk, grep, sed)
    • +
  • systemd (optional, service file)
    • +
+ +

How to use

+

If you want to start the daemon just run

+
systemctl start queued
+

If you want to enable daemon autoload run

+
systemctl enable queued
+

But you may change path to configuration file or change parameters. To do it just copy (recommended) the source configuration file to new path

+
cp /etc/queued.conf /path/to/new/queued.conf
+

and edit it. Then copy the source service file to /etc:

+
cp /usr/lib/systemd/system/queued.service /etc/systemd/system/queued-my-profile.service
+

Replace following string in the file:

+
ExecStart=/usr/bin/queued
+

to

+
ExecStart=/usr/bin/queued -c /path/to/new/queued.conf
+ +

Adding a job

+
    +
  1. Create shell script with the command (e.g. it have a name script.sh)
    2. +
  2. Create priority file (script.sh.pr) with the job priority if it is needed
    3. +
  3. Create user file (script.sh.user) with the job username if it is needed
    4. +
  4. Copy files to $WORKDIR
    5. +
+

Also you may use add_queued.

+ +

Configuration

+

All settings are stored in /etc/queued.conf. After edit them you must restart daemon

+
systemctl restart queued
+ +

Options

+ + + + + + + + + + + + + + + + + + + + + + + + + +
WORKDIR

Full path to directory with source jobs. Default is /var/lib/queued/work. This directory must contain source scripts script-name, a priority file (it is not necessary) script-name.pr and a file with username (it is not necessary too) script-name.user.

JOBDIR

Full path to directory with running jobs. Default is /var/lib/queued/job. All job files will be moved here.

QUEUEFILE

Full path to file with queue list. Default is /var/lib/queued/queue.

PRIORITY

Default priority. Default is 0. The higher the value, the higher the priority of the task.

SLEEPTIME

Time interval in minutes. Default is 5.

STARTASUSER

Default user. Default is root. This user will own created files.

+ +

Links

+ + +
+ +
+ + + + diff --git a/robots.txt b/robots.txt index 94f5f01..bc4526b 100644 --- a/robots.txt +++ b/robots.txt @@ -1,8 +1,8 @@ User-agent: * Disallow: -Disallow: /cgi-bin/ Disallow: /javascripts/ Disallow: /stylesheets/ +Disallow: /params.json Disallow: /README.md Disallow: /TODO Sitemap: http://arcan1s.github.io/sitemap.xml diff --git a/sitemap.xml b/sitemap.xml index 810d6e7..046cc69 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -30,4 +30,8 @@ http://arcan1s.github.io/projects/git-etc.html 2014-01-12T11:33:16+00:00 + + http://arcan1s.github.io/projects/queued.html + 2014-01-12T11:33:16+00:00 + \ No newline at end of file