Differences between revisions 1 and 77 (spanning 76 versions)

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

This page describes the installation of these packages.

1. Configuring your package manager to receive Dynare packages

This should be done only before the first installation.

Packages are available from two sources:

Official Debian and Ubuntu archives
Dynare repository

Depending on your version of Debian or Ubuntu, and the version of Dynare you want, you will want to choose one or the other of these two sources.

1.1. From official Debian and Ubuntu archive

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

The status of the package can be monitored on the Debian Package Tracking System.

Status of the packages as of 2012-10-13:

Distribution	Version of Dynare	Version of Octave used by the package
Debian Squeeze 6.0 (stable)	4.1.2	3.2
Debian Wheezy 7.0 (testing)	4.3.0	3.6
Debian Sid (unstable)	4.3.0	3.6
Debian experimental	4.3.1	3.6
Ubuntu Lucid Lynx 10.04	4.0.4	3.2
Ubuntu Natty Narwhal 11.04	4.1.3	3.2
Ubuntu Oneiric Ocelot 11.10	4.2.1	3.2
Ubuntu Precise Pangolin 12.04	4.2.4	3.2
Ubuntu Quantal Quetzal 12.10	4.3.0	3.6

If you want to use these sources, you don't need to do anything: they are already configured in your package manager.

$/!\$ Under Debian, you may however need to select the "contrib" section in your package sources, in order to get MATLAB support.

1.2. From Dynare repository

Status of the packages as of 2012-06-21:

Distribution	Version of Dynare	Version of Octave used by the package	APT source line
Debian "Squeeze" 6.0	4.3.0	3.2	`deb http://www.dynare.org/debian squeeze main contrib`

$/!\$ We used to provide custom binaries for recent Ubuntu releases, but we had to discontinue this due to lack of manpower. Feel free to contact SébastienVillemot if you want to contribute some binaries.

1.2.1. 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 -

1.2.2. Adding the correct APT line to your package sources

Then you need to give one "APT line" to your package manager; this line is given in the previous table, and depends 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 APT line, then click "Add Source"
or manually, by editing your /etc/apt/sources.list with a text editor (as root), and adding the apt line

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:

addpath /usr/share/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 1 as of 2008-06-20 13:11:09 → 
  Size: 4256
  Editor: SébastienVillemot
  Comment:
+   ← Revision 77 as of 2012-10-14 14:35:12 → ⇥
  Size: 4755
  Editor: SébastienVillemot
  Comment: Cosmetic changes
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-= Installing Dynare on Debian or Ubuntu =
+#pragma section-numbers on
 Line 3:
-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 (which are expected to be updated regularly).
+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 ==
+This page describes the installation of these packages.
 Line 7:
-=== On Debian GNU/Linux ===

Packages are available for Lenny (the current testing and future stable distribution). They should also work on Sid (the unstable distribution).

The Etch (the current stable distribution, version 4.0) is not supported, since it does not provide Octave version 3.

Binaries are only available for the i386 architecture at this time. See below how to recompile the package if you use another architecture.

=== On Ubuntu ===

Package are available for Hardy Heron (Ubuntu version 8.04). No other distribution is supported.

Binaries are only available for the i386 architecture at this time. See below how to recompile the package if you use another architecture.

== Adding the correct repository to APT sources ==
+= Configuring your package manager to receive Dynare packages =
-Line 25:
+Line 11:
-=== On Debian GNU/Linux ===
+Packages are available from two sources:
 * Official Debian and Ubuntu archives
 * Dynare repository
-Line 27:
+Line 15:
-Edit your {{{/etc/apt/sources.list}}} (as root), and add the following two lines:
+Depending on your version of Debian or Ubuntu, and the version of Dynare you want, you will want to choose one or the other of these two sources.

== From official Debian and Ubuntu archive ==

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

The status of the package can be monitored on the [[http://packages.qa.debian.org/dynare|Debian Package Tracking System]].

Status of the packages as of 2012-10-13:

|| '''Distribution''' || '''Version of Dynare''' || '''Version of Octave used by the package''' ||
|| Debian Squeeze 6.0 (stable) || 4.1.2 || 3.2 ||
|| Debian Wheezy 7.0 (testing) || 4.3.0 || 3.6 ||
|| Debian Sid (unstable) || 4.3.0 || 3.6 ||
|| Debian experimental || 4.3.1 || 3.6 ||
|| Ubuntu Lucid Lynx 10.04 || 4.0.4 || 3.2 ||
|| Ubuntu Natty Narwhal 11.04 || 4.1.3 || 3.2 ||
|| Ubuntu Oneiric Ocelot 11.10 || 4.2.1 || 3.2 ||
|| Ubuntu Precise Pangolin 12.04 || 4.2.4 || 3.2 ||
|| Ubuntu Quantal Quetzal 12.10 || 4.3.0 || 3.6 ||

If you want to use these sources, you don't need to do anything: they are already configured in your package manager.

/!\ Under Debian, you may however need to select the "contrib" section in your package sources, in order to get MATLAB support.

== From Dynare repository ==

Status of the packages as of 2012-06-21:

|| '''Distribution''' || '''Version of Dynare''' || '''Version of Octave used by the package''' || '''APT source line''' ||
|| Debian "Squeeze" 6.0 || 4.3.0 || 3.2 || {{{deb http://www.dynare.org/debian squeeze main contrib}}} ||

/!\ We used to provide custom binaries for recent Ubuntu releases, but we had to discontinue this due to lack of manpower. Feel free to contact SébastienVillemot if you want to contribute some binaries.

=== 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}}}):
-Line 29:
+Line 61:
-deb http://www.dynare.org/debian lenny main contrib
deb-src http://www.dynare.org/debian lenny main
+sudo wget -O - http://www.dynare.org/dynare.public.key | sudo apt-key add -
-Line 33:
+Line 64:
-=== On Ubuntu ===
+=== Adding the correct APT line to your package sources ===
-Line 35:
+Line 66:
-Edit your {{{/etc/apt/sources.list}}} (with sudo), and add the following two lines:
+Then you need to give one "APT line" to your package manager; this line is given in the previous table, and depends 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 APT line, then click "Add Source"
 * or manually, by editing your {{{/etc/apt/sources.list}}} with a text editor (as root), and adding the apt line

= 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

= Using Dynare =

== Under MATLAB ==
You need to specify the correct path:
-Line 37:
+Line 90:
-deb http://www.dynare.org/ubuntu hardy main contrib
deb-src http://www.dynare.org/ubuntu hardy main
+addpath /usr/share/dynare/matlab
-Line 41:
+Line 93:
-== Installing the package(s) ==

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}}}.

The package {{{dynare}}} 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 compiled for Octave.

Since the {{{dynare}}} package does not contain optimized dynamic libraires compiled for Matlab, you should install one of the two {{{dynare-matlab*}}} for full performance under Matlab:
 * the {{{dynare-matlab7.4}}} package was compiled with Matlab 7.4 (2007a), and *may* work with older releases
 * the {{{dynare-matlab7.5}}} package was compiled with Matlab 7.5 (2007b), and *may* work with newer releases

Note that your package manager will display a security warning, due to the lack of digital signature on the packages. This is normal, and you should just ignore the warnings. Digitally-signed packages will be made available in the future.


For the moment, the packages don't contain any documentation nor any example or test MOD-file. This should change in the near future.

Don't forget to regularly run your package manager to get the most recent version of Dynare.

== Using Dynare ==

You can run Dynare from Octave or Matlab, by adding the correct path at runtime:
{{{
addpath /usr/lib/dynare/matlab
}}}
And just call:
+Then, launch Dynare with:
-Line 69:
+Line 98:
-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 71:
+Line 100:
-== Compiling the package from source ==
+You don't need to add a path, it's automatically configured.
-Line 73:
+Line 102:
-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 77:
+Line 104:
-apt-src install dynare
+dynare filename.mod
-Line 79:
+Line 106:
-(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.