.. Athena document is copyright 2016 Bruce Ravel and released under
The Creative Commons Attribution-ShareAlike License
http://creativecommons.org/licenses/by-sa/3.0/
Installing Demeter on the Mac
=============================
The Macintosh package uses `MacPorts `_ and
is currently at version 0.9.22.
.. admonition:: Note
Bruce does not own a Mac and cannot support Mac installation
problems. You should use the `mailing list
`_.
Short instructions
------------------
#. **Carefully** follow the steps to install Macports at
https://www.macports.org/install.php.
#. Open a new Terminal window and type the following:
.. code-block:: bash
sudo port install xorg-server demeter
It will take a while depending on your computer and network speed.
#. If this is your first time installing ``xorg-server``, log out and
log back in. This is needed to set the ``DISPLAY`` environment
variable.
#. If you have recently upgraded to a new version of the Mac operating
system, you must re-install all of MacPorts for the new OS. There
is no shortcut.
When installation of MacPorts is done, launch :demeter:`athena` by
typing the following in Terminal:
.. code-block:: bash
athena
Note: Make sure you are in a directory you have write permission to
(like your home directory) because hidden files are created at launch
time.
To update a previously installed version of :demeter:`demeter` to the
latest, open a Terminal window and do
.. code-block:: bash
sudo port selfupdate && sudo port upgrade demeter
If you are not using a system-wide MacPorts installation, running
commands as sudo is not necessary.
Troubleshooting problems on the Mac
-----------------------------------
**General problems**
Having trouble installing on your Mac computer? `This might help
`_
or you `might find help searching through the mailing list archives
`_.
**Plot window not appearing**
If installation has proceeded properly, but the plot window is not
appearing, `this might fix the problem
`_,
however it is unlikely that deglitching or the pluck buttons will
work with the aqua terminal.
**Failed to install libcxx**
According to `Wayne
`_
`Lukens
`_,
macports sometimes does not install all of the dependencies for
:demeter:`demeter`. You can solve this issue by loading the
dependencies separately. Do
.. code-block:: bash
sudo ports install libcxx
After that, try installing :demeter:`demeter` again.
Also, `Jean-Francois Gaillard
`_
offers this hint: "One thing that greatly improve the installation
of dependencies was to increase the number of files that can be open
at once. New versions of Mac OS X limit this nb to 256, if you
increase it to - let’s say to 1024 - in your session it should
help. To find out the max nb of files that you can open at once type
in a terminal
.. code-block:: bash
ulimit –a
and to increase the number type
.. code-block:: bash
ulimit –n1024
Please report problems with the MacPorts package to the `Ifeffit
mailing list `_.
.. admonition:: Note
Bruce does not own a Mac and cannot support Mac installation
problems. You should use the `mailing list
`_.