2010-06-05 23:03:39 +00:00
= Notes on how to release new version =
2011-07-18 16:29:37 +00:00
== alpha/beta/production ==
2014-09-22 16:26:25 +00:00
Check that documentation is updated (compare to web):
2011-07-18 16:29:37 +00:00
2015-03-22 13:14:50 +00:00
Fixet for 20150422
2011-12-21 23:17:49 +00:00
git diff last-release-commit
2011-07-18 16:29:37 +00:00
Unmodified beta since last version => production
2011-08-21 23:01:57 +00:00
Unmodified alpha since last version => beta
Modified => alpha
2011-07-18 16:29:37 +00:00
2010-06-05 23:03:39 +00:00
== Update version ==
configure.ac: AC_INIT([parallel], [20100422], [bug-parallel@gnu.org])
src/parallel: $Global::version = 20100422;
2013-04-11 19:55:33 +00:00
README: parallel-20130222
2014-05-23 17:57:04 +00:00
2010-06-05 23:03:39 +00:00
YYYYMMDD=`yyyymmdd`
2013-04-11 19:55:33 +00:00
perl -i -pe "s/20\d\d\d\d\d\d/$YYYYMMDD/" configure.ac
2010-06-05 23:03:39 +00:00
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/parallel
2010-09-06 22:15:53 +00:00
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/sql
2010-12-21 20:10:44 +00:00
perl -i -pe "/version/ and s/20\d\d\d\d\d\d/$YYYYMMDD/" src/niceload
2013-04-11 19:55:33 +00:00
perl -i -pe "s/parallel-20\d\d\d\d\d\d/parallel-$YYYYMMDD/" README
2010-06-05 23:03:39 +00:00
=== Autoconf/automake ===
rm -fr autom4te.cache aclocal.m4 config.h config.h.in config.log Makefile.in missing install-sh
rm -rf src/Makefile.in
autoreconf --install -W gnu
./configure
2010-12-21 17:08:16 +00:00
make -j && sudo make install
2010-06-05 23:03:39 +00:00
2010-11-13 13:57:39 +00:00
== Testsuite ==
2010-06-05 23:03:39 +00:00
2015-03-22 00:51:30 +00:00
cd testsuite; make mem; make
2010-06-05 23:03:39 +00:00
2010-07-18 02:17:49 +00:00
== Update NEWS ==
With the same things that goes in the announce mail
2010-06-05 23:03:39 +00:00
== Package ==
./configure
make dist
make dist-bzip2
2010-08-22 09:00:52 +00:00
== Test the package ==
2010-12-02 20:58:10 +00:00
YYYYMMDD=`yyyymmdd`
2010-08-22 09:00:52 +00:00
cp parallel-$YYYYMMDD.tar.bz2 /tmp
2011-01-19 15:25:25 +00:00
pushd /tmp
2010-08-22 09:00:52 +00:00
tar xjvf parallel-$YYYYMMDD.tar.bz2
cd parallel-$YYYYMMDD
2010-09-21 23:17:05 +00:00
./configure && make -j && sudo make -j install
2011-01-24 19:06:30 +00:00
pushd
2010-08-22 09:00:52 +00:00
2010-06-05 23:03:39 +00:00
== Upload ==
2015-01-21 21:24:23 +00:00
export YYYYMMDD=`yyyymmdd`
2015-04-22 23:16:59 +00:00
eval `gpg-agent --daemon`
2015-01-21 21:24:23 +00:00
make upload
2015-01-11 22:08:23 +00:00
2015-01-21 21:24:23 +00:00
# Only needed for alpha:
eval `gpg-agent --daemon`
2010-06-05 23:03:39 +00:00
cp doc/parallel.directive parallel-$YYYYMMDD.tar.bz2.directive
2010-06-16 03:03:52 +00:00
perl -i -pe "s/20\d\d\d\d\d\d/$YYYYMMDD/" parallel-*.tar.*directive
2013-06-22 13:58:45 +00:00
gpg --clearsign --yes parallel-$YYYYMMDD.tar.bz2.directive
2010-06-05 23:03:39 +00:00
2013-06-22 13:58:45 +00:00
(echo '#!/bin/bash';
echo;
echo "# To check the signature run:"
echo "# echo | gpg"
echo "# gpg --auto-key-locate keyserver --keyserver-options auto-key-retrieve parallel-$YYYYMMDD.tar.bz2.sig"
echo
echo "echo | gpg 2>/dev/null"
echo 'gpg --auto-key-locate keyserver --keyserver-options auto-key-retrieve $0'
echo 'exit $?'
2013-05-16 20:49:17 +00:00
echo
gpg -ab -o - parallel-$YYYYMMDD.tar.bz2
) > parallel-$YYYYMMDD.tar.bz2.sig
gpg --auto-key-locate keyserver --keyserver-options auto-key-retrieve parallel-$YYYYMMDD.tar.bz2.sig
2010-06-05 23:03:39 +00:00
2015-01-21 21:24:23 +00:00
../ftpsync/src/ftpsync parallel-$YYYYMMDD.tar.bz2{,.sig,*asc} ftp://ftp-upload.gnu.org/incoming/alpha/
2010-06-05 23:03:39 +00:00
2013-05-16 20:49:17 +00:00
2011-07-22 09:08:58 +00:00
== Update OpenSUSE build system ==
cd ~/privat/parallel/packager/obs
# Update version number
em home:tange/parallel/parallel.spec
2013-09-18 00:00:10 +00:00
2011-07-22 09:08:58 +00:00
find home:tange/parallel/* -type f | grep -v parallel.spec | parallel -Xj1 osc rm {}
# This should not create new files
osc up home:tange/parallel/
make
# Reload build-status:
https://build.opensuse.org/package/show?package=parallel&project=home%3Atange
2011-07-25 22:12:46 +00:00
# Check that one .deb (Debian 5.0) and one .rpm (CentOS) end with 'succeeded'
2011-07-22 09:08:58 +00:00
2010-09-01 13:26:45 +00:00
== Download and test ==
2015-02-22 14:21:00 +00:00
# Only needed for alpha (part of 'make upload')
2015-01-21 21:24:23 +00:00
2011-03-22 00:44:50 +00:00
YYYYMMDD=`yyyymmdd`
2011-01-19 15:25:25 +00:00
pushd /tmp
2011-09-08 08:53:26 +00:00
rm -rf parallel-${YYYYMMDD}*
2014-02-22 10:32:42 +00:00
# This can take 7 minutes
2015-01-21 21:24:23 +00:00
#while ! wget http://ftp.gnu.org/gnu/parallel/parallel-$YYYYMMDD.tar.bz2 ; do sleep 2; done
while ! wget http://alpha.gnu.org/gnu/parallel/parallel-$YYYYMMDD.tar.bz2 ; do sleep 2; done
2010-09-01 13:26:45 +00:00
tar xjvf parallel-$YYYYMMDD.tar.bz2
cd parallel-$YYYYMMDD
2010-11-15 19:14:27 +00:00
./configure
2010-09-01 13:26:45 +00:00
make -j && sudo make -j install
2011-02-02 15:36:29 +00:00
pushd
2013-07-22 10:54:02 +00:00
sudo cp /usr/local/bin/parallel /usr/local/bin/parallel-$YYYYMMDD
2010-09-01 13:26:45 +00:00
2010-06-08 14:13:20 +00:00
== Update website ==
http://www.gnu.org/software/parallel/
http://www.gnu.org/software/parallel/man.html
2010-12-21 17:08:16 +00:00
http://www.gnu.org/software/parallel/sql.html
http://www.gnu.org/software/parallel/sem.html
http://www.gnu.org/software/parallel/niceload.html
2010-06-08 14:13:20 +00:00
2013-09-20 23:25:06 +00:00
cp src/*.pdf src/*.html ../parallel-web/parallel
cp src/parallel.html ../parallel-web/parallel/man.html
2011-07-22 09:08:58 +00:00
pushd ../parallel-web/parallel
2010-09-05 22:48:28 +00:00
cvs up
2012-04-24 21:59:29 +00:00
cvs ci -m "New release"
2011-07-22 09:08:58 +00:00
pushd
2010-06-08 14:13:20 +00:00
2011-03-22 00:44:50 +00:00
== Commit released version ==
git diff
2013-09-18 00:00:10 +00:00
2015-01-21 21:39:22 +00:00
# Recheck OBS https://build.opensuse.org/package/show?package=parallel&project=home%3Atange
2014-03-23 00:07:18 +00:00
2014-04-09 03:11:51 +00:00
YYYYMMDD=`yyyymmdd`
2015-03-24 23:14:50 +00:00
TAG=MyTag
echo "Released as $YYYYMMDD ('$TAG')."
2015-04-27 18:56:34 +00:00
git commit -a -m "Released as $YYYYMMDD ('$TAG')"
2014-04-09 03:11:51 +00:00
git tag -s -m "Released as $YYYYMMDD ('$TAG')" $TAG
git tag -s -m "Released as $YYYYMMDD ('$TAG')" $YYYYMMDD
2014-07-26 11:17:13 +00:00
git push
2014-10-25 10:44:10 +00:00
git push origin $TAG
git push origin $YYYYMMDD
2014-08-24 15:19:17 +00:00
== Update documentation ==
Update version number + 1
Unmodified beta since last version => production
Unmodified alpha since last version => beta
Modified => alpha
2011-07-25 22:12:46 +00:00
== Update Savannah ==
2014-05-03 22:42:52 +00:00
file:///home/tange/privat/parallel/doc/release_new_version
2011-07-25 22:12:46 +00:00
Content from release mail:
https://savannah.gnu.org/news/submit.php?group=parallel
https://savannah.gnu.org/news/approve.php?group=parallel
2010-06-05 23:03:39 +00:00
== Update Freshmeat ==
2014-06-25 23:16:54 +00:00
// FreeCode is dying
2010-06-05 23:03:39 +00:00
http://freshmeat.net/projects/parallel/releases/new
2012-01-07 01:24:50 +00:00
== Update Diaspora Twitter ==
2010-11-13 16:04:58 +00:00
2015-02-01 13:38:26 +00:00
https://joindiaspora.com/stream
2014-08-14 22:12:23 +00:00
New release of #GNU Parallel pi․ dk/0 New in this release pi․ dk/2 See the intro videos pi․ dk/1
2013-09-18 00:00:10 +00:00
10 secs installation: wget -O - pi․ dk/3|bash
2010-11-13 16:04:58 +00:00
2012-01-24 20:53:25 +00:00
[x] Twitter
Aspect: Public
2010-11-13 16:04:58 +00:00
2013-09-20 23:25:06 +00:00
GNU Parallel - for people who live life in the parallel lane.
2010-06-05 23:03:39 +00:00
== Send announce ==
2010-06-25 23:56:14 +00:00
http://groups.google.com/group/comp.unix.shell/post
2013-06-30 16:11:36 +00:00
http://groups.google.com/group/comp.unix.admin/post
2010-06-14 22:05:47 +00:00
2011-04-23 12:01:22 +00:00
https://lists.gnu.org/mailman/admindb/bug-parallel
https://lists.gnu.org/mailman/admindb/parallel
2010-06-05 23:03:39 +00:00
<<<<<
2014-02-22 10:32:42 +00:00
file:///home/tange/privat/parallel/doc/release_new_version
2010-09-01 13:26:45 +00:00
from:tange@gnu.org
2012-01-07 01:24:50 +00:00
to:parallel@gnu.org, bug-parallel@gnu.org
2014-03-23 00:07:18 +00:00
cc:Tim Cuthbertson <tim3d.junk@gmail.com>,
2012-01-07 01:24:50 +00:00
Ludovic Courtès <ludo@gnu.org>, Markus Ammer <mkmm@gmx-topmail.de>,
Pavel Nuzhdin <pnzhdin@gmail.com>, Phil Sung <psung@alum.mit.edu>,
Michael Shigorin <mike@altlinux.org>,
Chris Howey <howeyc@gmail.com>,
Fethican Coşkuner <fethicanc@gmail.com>,
Rogério Brito <rbrito@ime.usp.br>,
Koen Vervloesem <koen@vervloesem.eu>,
R. Tyler Croy <tyler@monkeypox.org>,
2011-08-02 21:18:28 +00:00
kerick@shiftedbit.net, Christian Faulhammer <fauli@gentoo.org>,
2012-01-07 01:24:50 +00:00
Ryoichiro Suzuki <ryoichiro.suzuki@gmail.com>,
Jesse Alama <jesse.alama@gmail.com>
2010-06-05 23:03:39 +00:00
2015-05-21 21:32:15 +00:00
Subject: GNU Parallel 20150522 ('Nepal') released [stable]
2014-05-22 12:53:33 +00:00
2015-04-27 18:56:34 +00:00
GNU Parallel 20150522 ('Nepal') has been released. It is available for download at: http://ftp.gnu.org/gnu/parallel/
2014-04-19 08:11:32 +00:00
2015-05-21 21:32:15 +00:00
No new functionality was introduced so this is a good candidate for a stable release.
2014-05-23 17:57:04 +00:00
Haiku of the month:
2014-05-22 12:53:33 +00:00
2015-04-27 18:56:34 +00:00
Many jobs to run.
Idle cores is not your thing.
2015-04-17 21:51:45 +00:00
Use GNU Parallel.
2015-04-27 18:56:34 +00:00
-- Ole Tange
2014-03-21 21:39:54 +00:00
2014-05-23 17:57:04 +00:00
New in this release:
2014-05-22 12:53:33 +00:00
2015-05-21 21:32:15 +00:00
* Security: The security issue for --sshlogin + --fifo/--cat has been fixed. Thereby all issues with http://lists.gnu.org/archive/html/parallel/2015-04/msg00045.html have been fixed.
2015-03-16 18:51:08 +00:00
2015-05-21 21:32:15 +00:00
* Security: After further security analysis the issue fixed in 20150422 also fixed the problem for --tmux.
2015-04-27 18:56:34 +00:00
2015-05-21 21:32:15 +00:00
* GNU Parallel was cited in: CIDER: a pipeline for detecting waves of coordinated transcriptional regulation in gene expression time-course data http://biorxiv.org/content/biorxiv/early/2015/03/17/012518.full.pdf
2015-03-22 00:51:30 +00:00
2015-05-21 21:32:15 +00:00
* GNU Parallel was cited in: Building Genomic Analysis Pipelines in a Hackathon Setting with Bioinformatician Teams: DNA-seq, Epigenomics, Metagenomics and RNA-seq http://biorxiv.org/content/biorxiv/early/2015/05/05/018085.full.pdf
2010-12-21 17:08:16 +00:00
2015-05-21 21:32:15 +00:00
* GNU Parallel was cited in: Toward Enhanced Metadata Quality of Large-Scale Digital Libraries: Estimating Volume Time Range https://www.ideals.illinois.edu/bitstream/handle/2142/73656/186_ready.pdf
2015-04-22 22:15:23 +00:00
2015-04-27 18:56:34 +00:00
* GNU Parallel was cited in: Sequencing the cap-snatching repertoire of H1N1 influenza provides insight into the mechanism of viral transcription initiation http://nar.oxfordjournals.org/content/early/2015/04/20/nar.gkv333.full.pdf
2015-04-04 14:37:32 +00:00
2015-05-21 21:32:15 +00:00
* GNU Parallel was cited in: Genome assembly using Nanopore-guided long and error-free DNA reads http://www.biomedcentral.com/content/pdf/s12864-015-1519-z.pdf
2015-04-04 14:37:32 +00:00
2015-04-27 18:56:34 +00:00
* GNU Parallel was cited in: Contrasting regional architectures of schizophrenia and other complex diseases using fast variance components analysis http://biorxiv.org/content/biorxiv/early/2015/03/13/016527.full.pdf
2015-04-15 20:32:46 +00:00
2015-05-21 21:32:15 +00:00
* GNU Parallel was used (unfortunately with wrong citation) in: Comparing the CarbonTracker and TM5-4DVar data assimilation systems for CO2 surface flux inversions http://www.atmos-chem-phys-discuss.net/15/8883/2015/acpd-15-8883-2015-discussion.html
2015-04-04 14:37:32 +00:00
2015-04-27 18:56:34 +00:00
* GNU Parallel was used in: Gene Set Omic Analysis (GSOA) method https://bitbucket.org/srp33/gsoa
2015-03-28 11:14:30 +00:00
2015-05-21 21:32:15 +00:00
* A Quick and Neat :) Orchestrator using GNU Parallel http://www.elsotanillo.net/2015/05/a-quick-and-neat-orchestrator-using-gnu-parallel/
2015-04-27 18:56:34 +00:00
* Execute commands on multiple computers using GNU Parallel (setting up a cluster on the cheap) https://spectraldifferences.wordpress.com/2015/04/26/execute-commands-on-multiple-computers-using-gnu-parallel-setting-up-a-cluster-on-the-cheap/
2015-03-24 23:14:50 +00:00
2015-04-27 18:56:34 +00:00
* Functions and GNU parallel for effective cluster load management http://genomespot.blogspot.dk/2015/04/functions-and-gnu-parallel-for.html
2015-04-09 23:20:51 +00:00
2015-05-21 21:32:15 +00:00
* Use parallel processing to save time importing databases http://drupalsun.com/node/41854
* Run multiple ssh commands in parallel with GNU Parallel http://www.ameir.net/blog/archives/380-run-multiple-ssh-commands-in-parallel-with-gnu-parallel.html
* Importing huge databases faster https://www.lullabot.com/blog/article/importing-huge-databases-faster
* Run multiple ssh commands in parallel with GNU Parallel https://www.ameir.net/blog/archives/380-run-multiple-ssh-commands-in-parallel-with-gnu-parallel.html/comment-page-1
* Parallel? Gnu parallel! https://debian.pro/1834
2015-03-24 23:14:50 +00:00
* Bug fixes and man page updates.
2014-05-03 22:42:52 +00:00
GNU Parallel - For people who live life in the parallel lane.
2011-03-01 22:04:15 +00:00
2014-05-23 17:57:04 +00:00
2010-06-05 23:03:39 +00:00
= About GNU Parallel =
2014-01-25 22:29:25 +00:00
GNU Parallel is a shell tool for executing jobs in parallel using one or more computers. A job is can be a single command or a small script that has to be run for each of the lines in the input. The typical input is a list of files, a list of hosts, a list of users, a list of URLs, or a list of tables. A job can also be a command that reads from a pipe. GNU Parallel can then split the input and pipe it into commands in parallel.
2011-01-27 21:56:59 +00:00
2014-01-25 22:29:25 +00:00
If you use xargs and tee today you will find GNU Parallel very easy to use as GNU Parallel is written to have the same options as xargs. If you write loops in shell, you will find GNU Parallel may be able to replace most of the loops and make them run faster by running several jobs in parallel. GNU Parallel can even replace nested loops.
2010-06-05 23:03:39 +00:00
2014-01-25 22:29:25 +00:00
GNU Parallel makes sure output from the commands is the same output as you would get had you run the commands sequentially. This makes it possible to use output from GNU Parallel as input for other programs.
2010-06-05 23:03:39 +00:00
2014-01-25 22:29:25 +00:00
You can find more about GNU Parallel at: http://www.gnu.org/s/parallel/
2010-06-14 22:05:47 +00:00
2014-01-25 22:29:25 +00:00
You can install GNU Parallel in just 10 seconds with: (wget -O - pi.dk/3 || curl pi.dk/3/) | bash
2013-04-27 09:09:46 +00:00
2014-01-25 22:29:25 +00:00
Watch the intro video on http://www.youtube.com/playlist?list=PL284C9FF2488BC6D1
2013-09-18 00:00:10 +00:00
2014-01-25 22:29:25 +00:00
Walk through the tutorial (man parallel_tutorial). Your commandline will love you for it.
2010-06-14 22:05:47 +00:00
2014-01-25 22:29:25 +00:00
When using programs that use GNU Parallel to process data for publication please cite:
2011-03-14 16:37:30 +00:00
2014-01-25 22:29:25 +00:00
O. Tange (2011): GNU Parallel - The Command-Line Power Tool, ;login: The USENIX Magazine, February 2011:42-47.
2011-05-13 12:02:03 +00:00
2014-10-07 22:27:13 +00:00
If you like GNU Parallel:
* Give a demo at your local user group/team/colleagues
* Post the intro videos on Reddit/Diaspora*/forums/blogs/ Identi.ca/Google+/Twitter/Facebook/Linkedin/mailing lists
* Get the merchandise https://www.gnu.org/s/parallel/merchandise.html
* Request or write a review for your favourite blog or magazine
* Request or build a package for your favourite distribution (if it is not already there)
* Invite me for your next conference
If you use GNU Parallel for research:
* Please cite GNU Parallel in you publications (use --bibtex)
If GNU Parallel saves you money:
* (Have your company) donate to FSF https://my.fsf.org/donate/
2011-05-13 12:02:03 +00:00
= About GNU SQL =
2014-01-25 22:29:25 +00:00
GNU sql aims to give a simple, unified interface for accessing databases through all the different databases' command line clients. So far the focus has been on giving a common way to specify login information (protocol, username, password, hostname, and port number), size (database and table size), and running queries.
2011-05-13 12:02:03 +00:00
2014-01-25 22:29:25 +00:00
The database is addressed using a DBURL. If commands are left out you will get that database's interactive shell.
2011-05-13 12:02:03 +00:00
When using GNU SQL for a publication please cite:
2014-01-25 22:29:25 +00:00
O. Tange (2011): GNU SQL - A Command Line Tool for Accessing Different Databases Using DBURLs, ;login: The USENIX Magazine, April 2011:29-32.
2011-07-25 22:12:46 +00:00
= About GNU Niceload =
2014-01-25 22:29:25 +00:00
GNU niceload slows down a program when the computer load average (or other system activity) is above a certain limit. When the limit is reached the program will be suspended for some time. If the limit is a soft limit the program will be allowed to run for short amounts of time before being suspended again. If the limit is a hard limit the program will only be allowed to run when the system is below the limit.