We provide pre-built binaries of RMBlast as a convenience to save users the
expense of compiling RMBlast from source themselves. Although we include the
same binaries as in NCBI's builds, they are not intended to be used as a
general-purpose BLAST+ distribution.
At this time our macOS binaries are not signed nor notarized. The first time
you run each program in the package, you may first need to "Allow" it in
"System Settings -> Security and Privacy", then confirm you want to "Open"
it. For more details see https://support.apple.com/en-us/HT202491
(scroll down to "How to open an app that hasn't been notarized or is from an
unidentified developer"). You can also compile the programs from source, or
download the binaries with a program (e.g. 'curl') which does not yet implement
this security feature.
We do not build binaries for all platforms. If your platform is unsupported
or the binaries do not work on your machine, please compile RMBlast from source
instead (instructions below).
Latest Release: 2.14.1
To use the the pre-built binaries:
NOTE: If you are using an older Linux distribution (e.g. Ubuntu 20.04) that does not have GLIBC 2.34 or newer, please use the "Linux (Older OS versions)" package.
- Download Pre-compiled Package:
Download the RMBlast package for your platform:
- Unpack RMBlast Distribution:
Unpack the distribution in a place that will be accessible to RepeatMasker ( ie. /usr/local ).
- cd /usr/local
- tar zxvf rmblast-2.14.1-x64-linux.tar.gz
- Configure RepeatMasker/RepeatModeler:
To use the new search engine with RepeatMasker or RepeatModeler, run/re-run the
configure program in the RepeatMasker directory and the configure program in
the RepeatModeler directory.
To compile from source:
- Download NCBI Blast+ and rmblast patch file:
ncbi-blast-2.14.1+-src.tar.gz
isb-2.14.1+-rmblast.patch.gz
- Install Dependencies:
You will need a C++ compiler and essential build tools such as make and autotools.
- Debian and derivatives (Ubuntu, Mint, etc.): apt install build-essential
- Fedora: yum groupinstall "Development Tools"
Other missing dependencies might be detected by the configure step later, depending on your operating system.
- Unpack Distribution:
Unpack the distribution in your home directory or in a temporary location ( i.e. /tmp ).
- cd /mytmp/location/
- tar zxvf ncbi-blast-2.14.1+-src.tar.gz
- gunzip isb-2.14.1+-rmblast.patch.gz
- Patch:
- cd ncbi-blast-2.14.1+-src
- patch -p1 < ../isb-2.14.1+-rmblast.patch
- Build:
To compile the programs for installation in /usr/local/rmblast run:
- cd ncbi-blast-2.14.1+-src/c++
- ./configure --with-mt --without-debug --without-krb5 --without-openssl --with-projects=scripts/projects/rmblastn/project.lst --prefix=/usr/local/rmblast
- make
- make -j can be used to parallelize the build on multiprocessor systems, e.g. make -j2 to dedicate two cores to the build process.
- make install
- Configure RepeatMasker/RepeatModeler:
To use the new search engine with RepeatMasker or RepeatModeler, run/re-run the configure program in the RepeatMasker directory and the configure program in the RepeatModeler directory.
Previous Release: 2.14.0
To use the the pre-built binaries:
- Download Pre-compiled Package:
Download the RMBlast package for your platform:
- Unpack RMBlast Distribution:
Unpack the distribution in a place that will be accessible to RepeatMasker ( ie. /usr/local ).
- cd /usr/local
- tar zxvf rmblast-2.14.0-x64-linux.tar.gz
- Configure RepeatMasker/RepeatModeler:
To use the new search engine with RepeatMasker or RepeatModeler, run/re-run the
configure program in the RepeatMasker directory and the configure program in
the RepeatModeler directory.
To compile from source:
- Download NCBI Blast+ and rmblast patch file:
ncbi-blast-2.14.0+-src.tar.gz
isb-2.14.0+-rmblast.patch.gz
- Install Dependencies:
You will need a C++ compiler and essential build tools such as make and autotools.
- Debian and derivatives (Ubuntu, Mint, etc.): apt install build-essential
- Fedora: yum groupinstall "Development Tools"
Other missing dependencies might be detected by the configure step later, depending on your operating system.
- Unpack Distribution:
Unpack the distribution in your home directory or in a temporary location ( i.e. /tmp ).
- cd /mytmp/location/
- tar zxvf ncbi-blast-2.14.0+-src.tar.gz
- gunzip isb-2.14.0+-rmblast.patch.gz
- Patch:
- cd ncbi-blast-2.14.0+-src
- patch -p1 < ../isb-2.14.0+-rmblast.patch
- Build:
To compile the programs for installation in /usr/local/rmblast run:
- cd ncbi-blast-2.14.0+-src/c++
- ./configure --with-mt --without-debug --without-krb5 --without-openssl --with-projects=scripts/projects/rmblastn/project.lst --prefix=/usr/local/rmblast
- make
- make -j can be used to parallelize the build on multiprocessor systems, e.g. make -j2 to dedicate two cores to the build process.
- make install
- Configure RepeatMasker/RepeatModeler:
To use the new search engine with RepeatMasker or RepeatModeler, run/re-run the configure program in the RepeatMasker directory and the configure program in the RepeatModeler directory.
RMBlast Usage Statistics Reporting
Starting with NCBI BLAST+ version 2.11.0, the standalone command-line tools
report usage statistics back to NCBI including program version, values of some
command-line parameters, and the sizes of databases and queries. Sequence data
is not included among these statistics. This data is used for quality
monitoring and to gauge the usage of BLAST+ executables by the community. More
information about this system and an example of collected data is available at
https://www.ncbi.nlm.nih.gov/books/NBK563686/.
Because RMBlast is primarily intended for use with RepeatMasker and
RepeatModeler, we make changes to usage reporting in both our source/patch and
binary distributions:
- Usage statistics are sent to the repeatmasker.org web server, instead of to NCBI.
- The programs do not collect or submit a database name ("db_name"). Names of
sequence files used with RepeatMasker and RepeatModeler are usually chosen by
users or automatically generated and are neither necessary nor useful for us to
collect.
Similarly to NCBI, we use these statistics for the purpose of quality
monitoring and to gauge the popularity of RMBlast.
If you wish to opt out of this usage reporting for any reason, you can set the
environment variable BLAST_USAGE_REPORT=false. On Unix-like systems, this can
be done with the "export" or "setenv" commands depending on your shell. For
more details and information on other methods to opt out, see NCBI's
documentation of this feature at
https://www.ncbi.nlm.nih.gov/books/NBK563686/.
|
Arian Smit - Institute for Systems Biology
Robert Hubley - Institute for Systems Biology
Jeb Rosen - Institute for Systems Biology
National Center for Biotechnology Information ( NCBI )
And special thanks to:
Tom Madden,
Christiam Camacho,
George Coulouris,
Denis Vakatov,
Aaron Ucko,
Ning Ma
from NCBI for allowing me to bug them with questions about
the BLAST source code, assistance with finding resources,
and lending an ear to a tired programmer.
This work is funded by NHGRI grant # RO1 HG002939
|