Differences between revisions 17 and 108 (spanning 91 versions)

Precompiled binary packages of Dynare are available for Debian and Ubuntu distributions of GNU/Linux. These packages work with both Octave and MATLAB.

1. Available versions

Dynare is available in Debian and Ubuntu as an official package.

The status of the package can be monitored on the Debian Tracker.

Status of the packages as of 2018-02-03:

Distribution	Version of Dynare	Version of Octave used by the package
Debian Jessie 8 (oldstable)	4.4.3	3.8
Debian Stretch 9 (stable)	4.4.3	4.0
Debian Sid (unstable)	4.5.4	4.2
Ubuntu Trusty Tahr 14.04 (LTS)	4.4.1	3.8
Ubuntu Xenial Xerus 16.04 (LTS)	4.4.3	4.0

$/!\$ Under Debian, you need to select the "contrib" section in your package sources if you want MATLAB support.

$/!\$ These packages are guaranteed to be compatible with the version of Octave installed on your system. However, it may happen that your version of MATLAB is too recent for these packages (since MATLAB is not part of the release cycle of Debian and Ubuntu); if you experience inexplicable crashes/problems with MATLAB, then consider compiling Dynare from source.

2. Installing the packages

There are three packages which you may want to install:

dynare: base package, containing a fully functional installation of Dynare for Octave under /usr/share/dynare/matlab
dynare-matlab: install this package if you are using MATLAB, in order to recompile the MEX files. You will be asked a few questions by your package manager (such as the location where you installed MATLAB)
dynare-doc: documentation (HTML and PDF manual, PDF userguide, example MOD files, ...). They are installed under /usr/share/doc/dynare-doc/. The manual and the userguide are also registered:
- in the DHelp/DWWW system, in the "Science/Mathematics" section
- in Rarian (the online help system in Gnome and KDE), in the "Education/Mathematics" section

3. Using Dynare

3.1. Under MATLAB

You need to specify the correct path, which depends on the version of Dynare.

For Dynare 4.4.2 and older:

addpath /usr/share/dynare/matlab

For Dynare 4.4.3 and later:

addpath /usr/lib/dynare/matlab

Then, launch Dynare with:

dynare filename.mod

3.2. Under Octave

You don't need to add a path, it's automatically configured.

Then, launch Dynare with:

dynare filename.mod

DynareWiki: InstallOnDebianOrUbuntu (last edited 2018-05-16 15:37:23 by SébastienVillemot)

-  ⇤ ← Revision 17 as of 2008-09-24 10:20:17 → 
  Size: 6098
  Editor: SébastienVillemot
  Comment:
+   ← Revision 108 as of 2018-05-16 15:37:23 → ⇥
  Size: 2561
  Editor: SébastienVillemot
  Comment: Drop reference to the now discontinued unofficial Debian packages
-Deletions are marked like this.
+Additions are marked like this.
 Line 3:
-Since Dynare 4.0.0, precompiled binaries packages and source packages are available for Debian and Ubuntu distributions of GNU/Linux. These packages work with both Octave and Matlab. They are available through standard package repositories.
+Precompiled binary packages of Dynare are available for Debian and Ubuntu distributions of GNU/Linux. These packages work with both Octave and MATLAB.
 Line 5:
-= Availability =
+= Available versions =
 Line 7:
-== On Debian GNU/Linux ==
+Dynare is available in Debian and Ubuntu as an official package.
 Line 9:
-Packages are available for Lenny (the current testing and future stable distribution). They should also work on Sid (the unstable distribution).
+The status of the package can be monitored on the [[https://tracker.debian.org/pkg/dynare|Debian Tracker]].
 Line 11:
-The Etch (the current stable distribution, version 4.0) is not supported, since it does not provide Octave version 3.
+Status of the packages as of 2018-02-03:
 Line 13:
-Binaries are available for the i386 and amd64 architectures. See below for how to recompile the package if you use another architecture.
+|| '''Distribution''' || '''Version of Dynare''' || '''Version of Octave used by the package''' ||
|| Debian Jessie 8 (oldstable) || 4.4.3 || 3.8 ||
|| Debian Stretch 9 (stable) || 4.4.3 || 4.0 ||
|| Debian Sid (unstable) || 4.5.4 || 4.2 ||
|| Ubuntu Trusty Tahr 14.04 (LTS) || 4.4.1 || 3.8 ||
|| Ubuntu Xenial Xerus 16.04 (LTS) || 4.4.3 || 4.0 ||
-Line 15:
+Line 20:
-== On Ubuntu ==
+/!\ Under Debian, you need to select the "contrib" section in your package sources if you want MATLAB support.
-Line 17:
+Line 22:
-Packages are available for Hardy Heron (Ubuntu version 8.04). No other distribution is supported.

Binaries are available for the i386 and amd64 architectures. See below for how to recompile the package if you use another architecture.

= Configuring your package manager to receive Dynare packages =

This should be done only before the first installation.

== Importing the cryptographic signing key ==

First, for security reasons, you should download the archive signing key, which is used to authenticate Dynare packages.

There are two ways of doing it:
 * via the graphical Synaptic package manager
   * first download [http://www.dynare.org/dynare.public.key], and save it somewhere
   * then launch Synaptic, go to the "Settings" menu, and click on "Repositories"
   * go to "Authentication" tab, and click on "Import Key file"
   * select the {{{dynare.public.key}}} file that you have downloaded, and click OK
 * or manually, by typing the following in a command line (assuming you have installed {{{wget}}}):
{{{
sudo wget -O - http://www.dynare.org/dynare.public.key | sudo apt-key add -
}}}

== Adding the correct APT lines to your package sources ==

Then you need to give two "APT lines" to your package manager; these lines are given in the following subsections (depending on your distribution).

For adding them, you can either do it:
 * via the graphical Synaptic package manager:
   * go to the "Settings" menu, and click on "Repositories"
   * go to "Third-party software" tab and click on "Add"
   * you will be asked for an APT line: copy/paste the first APT line (which begins with "deb"), then click "Add Source"
   * repeat the process for the second APT line (which begins with "deb-src")
 * or manually, by editing your {{{/etc/apt/sources.list}}} with a text editor (as root), and adding the two apt lines

=== APT lines for Debian "Lenny" ===

{{{
deb http://www.dynare.org/debian lenny main contrib
deb-src http://www.dynare.org/debian lenny main
}}}

=== APT lines for Ubuntu "Hardy" ===

{{{
deb http://www.dynare.org/ubuntu hardy main contrib
deb-src http://www.dynare.org/ubuntu hardy main
}}}
+/!\ These packages are guaranteed to be compatible with the version of Octave installed on your system. However, it may happen that your version of MATLAB is too recent for these packages (since MATLAB is not part of the release cycle of Debian and Ubuntu); if you experience inexplicable crashes/problems with MATLAB, then consider compiling Dynare from source.
-Line 68:
+Line 26:
-Using your favorite package manager (apt-get, aptitude, synaptic), update your package list. You should now see three new packages: {{{dynare}}}, {{{dynare-matlab7.4}}} and {{{dynare-matlab7.5}}}.
+There are three packages which you may want to install:
-Line 70:
+Line 28:
-The {{{dynare}}} package contains a fully functional installation of Dynare for both Octave and Matlab. The installation is made under {{{/usr/lib/dynare}}}. The package contains: the preprocessor, the M-files, and the optimized dynamic libraries for Octave.

Since the {{{dynare}}} package does not contain optimized dynamic libraires for Matlab, you should install one of the two {{{dynare-matlab*}}} for full performance under Matlab:
 * if you have Matlab 7.5 (R2007b) or 7.6 (R2008a), install the {{{dynare-matlab7.5}}} package
 * if you have Matlab 7.4 (R2007a), install the {{{dynare-matlab7.4}}} package
 * if your Matlab version is strictly older than 7.4 (R2007a), there is currently no binary package; we may provide one in the future. In the meantime, a workaround is explained in this [http://www.cepremap.cnrs.fr/juillard/mambo/index.php?option=com_forum&Itemid=95&page=viewtopic&p=3377#3377 forum message].

The packages also contain documentation (HTML and PDF manual, PDF userguide, and other documents). These are installed in {{{/usr/share/doc/dynare}}}. The manual and the userguide are also registered in the DHelp system, and in scroolkeeper (the online help system in Gnome and KDE).

For the moment, the packages don't contain any example MOD-file, but this should change in the near future.

Don't forget to regularly run your package manager to get the most recent version of Dynare.
+ * {{{dynare}}}: base package, containing a fully functional installation of Dynare for Octave under {{{/usr/share/dynare/matlab}}}
 * {{{dynare-matlab}}}: install this package if you are using MATLAB, in order to recompile the MEX files. You will be asked a few questions by your package manager (such as the location where you installed MATLAB)
 * {{{dynare-doc}}}: documentation (HTML and PDF manual, PDF userguide, example MOD files, ...). They are installed under {{{/usr/share/doc/dynare-doc/}}}. The manual and the userguide are also registered:
    * in the DHelp/DWWW system, in the "Science/Mathematics" section
    * in Rarian (the online help system in Gnome and KDE), in the "Education/Mathematics" section
-Line 85:
+Line 36:
-You can run Dynare from Octave or Matlab, by adding the correct path at runtime:
+== Under MATLAB ==
You need to specify the correct path, which depends on the version of Dynare.

For Dynare 4.4.2 and older:
{{{
addpath /usr/share/dynare/matlab
}}}

For Dynare 4.4.3 and later:
-Line 89:
+Line 48:
-Under Octave, you may also want to type:
{{{
mark_as_command dynare
}}}
-Line 99:
+Line 55:
-Under Octave, it is possible to create a startup file which adds the correct path at every start. See DynareOctave on this topic and on other Octave-specific issues.
+== Under Octave ==
-Line 101:
+Line 57:
-= Compiling the package from source =
+You don't need to add a path, it's automatically configured.
-Line 103:
+Line 59:
-You can be interested in recompiling the packages, especially if binaries for your architecture are not available.

Download and unpack the source in the current directory by typing:
+Then, launch Dynare with:
-Line 107:
+Line 61:
-apt-src install dynare
+dynare filename.mod
-Line 109:
+Line 63:
-(you may be asked the root password for installing packages necessary for the building process)

This should have created a {{{dynare-???}}} directory, where {{{???}}} is the current version number. Go into that directory, and type:
{{{
dpkg-buildpackage -b -uc
}}}
This should build the {{{dynare-???}}} package (in a {{{.deb}}} file), and also the {{{dynare-matlab7.4}}} (resp. {{{dynare-matlab7.5}}}) package if you have Matlab 7.4 (resp. 7.5) intalled under {{{/usr/local/matlab74}}} (resp. {{{/usr/local/matlab75}}}). You can tune the {{{debian/rules}}} file if your Matlab installation is located at another place.

''Note'': if you want to become the official Dynare package builder for your favourite architecture, please contact Dynare authors and we will distribute your binaries.