|
|
# Download #
|
|
|
# Downloading or updating #
|
|
|
|
|
|
Whatever your operating system, `git` is needed to download the
|
|
|
user version of LMGC90.
|
|
|
Whatever your operating system, `git` software is needed. If you did not installed it check
|
|
|
again the [prerequisites] (https://git-xen.lmgc.univ-montp2.fr/lmgc90/lmgc90_user/wikis/prerequisites)
|
|
|
|
|
|
The prefered operating system to use LMGC90 is [Linux or MacOS](#linversion)
|
|
|
Due to some flaws of our web server, the graphical interfaces of Git usually do not work. Thus you must
|
|
|
use some terminal commands (on Linux or MacOs, start a terminal, on Windows start the `Git BASH` program).
|
|
|
This should be fixed by next version, some keep some hope !
|
|
|
|
|
|
There is a possibility to use on [Windows](#winversion)
|
|
|
* [Downloading] (#downloading)
|
|
|
* [Updating] (#updating)
|
|
|
|
|
|
## <a name=linversion>Linux and MacOS</a> ##
|
|
|
|
|
|
If `git` is not already installed, use your package manager to install it.
|
|
|
|
|
|
### Installing git ###
|
|
|
|
|
|
- Ubuntu/Debian
|
|
|
|
|
|
In a terminal run:
|
|
|
|
|
|
```shell
|
|
|
sudo apt-get install git
|
|
|
```
|
|
|
|
|
|
- OpenSuse
|
|
|
|
|
|
In a terminal run:
|
|
|
## <a name=downloading>Downloading</a> ##
|
|
|
|
|
|
In your terminal create a directory in which you will download LMGC90 software
|
|
|
```shell
|
|
|
sudo zypper install git
|
|
|
cd ~/Desktop
|
|
|
mkdir LMGC90
|
|
|
cd LMGC90
|
|
|
```
|
|
|
The choice to put it int the `Desktop/LMGC90` directory here is purely an example, you should put it in any directory of your covenience provided that
|
|
|
you have read/write access on it.
|
|
|
|
|
|
- CentOS
|
|
|
|
|
|
In a terminal run:
|
|
|
|
|
|
Then to download the software run:
|
|
|
```shell
|
|
|
sudo yum install git
|
|
|
export GIT_SSL_NO_VERIFY=True
|
|
|
git clone https://git-xen.lmgc.univ-montp2.fr/lmgc90/lmgc90_user.git
|
|
|
```
|
|
|
|
|
|
- MacOS
|
|
|
|
|
|
In a terminal run:
|
|
|
This should create a directory *lmgc90_user* which will contain the following subdirectories:
|
|
|
* *src* : the sources of LMGC90 software
|
|
|
* *examples* : the user examples working with the sources
|
|
|
* *manuals* : a list of manuals/documentation for the software in pdf format
|
|
|
* *docs* : the html documentation generated from the sources
|
|
|
|
|
|
```shell
|
|
|
sudo port install git
|
|
|
```
|
|
|
|
|
|
### Downloading LMGC90 ###
|
|
|
## <a name=updating>Updating</a> ##
|
|
|
|
|
|
In a terminal run the following commands:
|
|
|
If you modified some of the files (for instance the notebook), you must put them back in their original state
|
|
|
before updating them. So if you want to keep your modifications, you must first rename those files.
|
|
|
|
|
|
To get the list of modified files you can either use a graphical interface of Git. Or in the terminal, after
|
|
|
going to right directory (in Windows you can just right-clic in the `lmgc90_user` directory and select `open with Git BASH`),
|
|
|
the run:
|
|
|
```shell
|
|
|
git reset --hard origin/master
|
|
|
export GIT_SSL_NO_VERIFY=True
|
|
|
git clone https://git-xen.lmgc.univ-montp2.fr/lmgc90/lmgc90_user.git
|
|
|
```
|
|
|
|
|
|
This should create a directory *lmgc90_user*. Once the previous line has been run, all next `git` commands should be run from this *lmgc90_user* directory.
|
|
|
|
|
|
To update to the latest state run from a terminal in your *lmgc90_user*:
|
|
|
|
|
|
```
|
|
|
git pull origin master
|
|
|
```
|
|
|
|
... | ... | @@ -75,49 +61,3 @@ The proper way to do that would be to get the self-signed certificate in the PEM |
|
|
```
|
|
|
git config http.sslCAInfo path_to_your_pem_file
|
|
|
``` |
|
|
|
|
|
## <a name=winversion>Windows</a> ##
|
|
|
|
|
|
### Installing git ###
|
|
|
|
|
|
If you do not have a `git` client already installed on your system, download it
|
|
|
from [here](https://git-scm.com/downloads) and then install it.
|
|
|
|
|
|
### Downloading LMGC90 ###
|
|
|
|
|
|
Currently the graphical interface provided with the `git` software cannot be used
|
|
|
to download LMGC90. The only available way is to use a terminal, to do this run
|
|
|
the `Git BASH` software recently installed. This will open a black window in which
|
|
|
you will be able to run commands executed when typing the *return* key.
|
|
|
|
|
|
First you must choose a directory in which you will download the software. In this example
|
|
|
let's say that a *LMGC90* directory has been created on the desktop. You must run the
|
|
|
following commands to place the terminal in the corresponding directory:
|
|
|
|
|
|
```shell
|
|
|
cd Desktop/LMGC90
|
|
|
```
|
|
|
|
|
|
Then to download:
|
|
|
|
|
|
```shell
|
|
|
export GIT_SSL_NO_VERIFY=True
|
|
|
git clone https://git-xen.lmgc.univ-montp2.fr/lmgc90/lmgc90_user.git
|
|
|
```
|
|
|
|
|
|
If web server security is an issue for you, check [here](#secissue).
|
|
|
|
|
|
This should create a directory *lmgc90_user*. Once the previous line has been run, all next `git` commands should be run from this *lmgc90_user* directory.
|
|
|
|
|
|
To update to the latest state run from a terminal in your *lmgc90_user*:
|
|
|
|
|
|
```
|
|
|
git pull origin master
|
|
|
```
|
|
|
|
|
|
# Install #
|
|
|
|
|
|
Please read the README.md file
|
|
|
[here](https://git-xen.lmgc.univ-montp2.fr/lmgc90/lmgc90_user/blob/master/README.md)
|
|
|
or in your version.
|
|
|
|