Differences

This shows you the differences between two versions of the page.

--- doc:user:tutorials:installation [2015/01/07 10:14] – boman
+++ doc:user:tutorials:installation [2024/03/01 16:17] (current) – boman
@@ Line 1: / Line 1: @@
 ====== How to install Metafor? ======
-===== Running the Installer =====
+===== Video =====
-This video shows how to install Metafor on a Windows PC.
+This video shows how to install Metafor on a PC running Windows.
-<html>
+<WRAP centeralign column 100%>
-<iframe width="853" height="480" src="//www.youtube.com/embed/14Wt2mst3B0" frameborder="0" allowfullscreen></iframe>
+{{url>https://www.youtube.com/embed/14Wt2mst3B0 noborder allowfullscreen}}
-</html>
+</WRAP>
-Installers are available on eCampus website for the following platforms:
-  * Windows 7/8 x64
-  * Other Windows or Windows 7/8 x86
-  * Ubuntu 14.04
-MacOS users: Please use a [[https://www.virtualbox.org/|VirtualBox]] (ask for help).
+===== Download the installer =====
-{{ :doc:user:tutorials:padlock.jpg?nolink&200|}}
-Procedure:
-  * Run the installer and follow the instructions.
-  * Install the Visual 2012 C++ runtime libraries if they are not present on your system.
-  * Run Metafor (desktop link)
-  * Click on the padlock in order to import the license file (''metafor.lic'')
-  * Restart Metafor
+Installers are available for Windows, Linux and macOS on this website: [[teaching:private:start|]]
-On Windows, just use the setup program.
+{{ :doc:user:tutorials:padlock.jpg?nolink&200|}}
-  * Towards the end, it is possible to install Visual C++ 2012 Microsoft run-time libraries (do so if you do not know what it is).
+===== Step-by-step Procedure =====
-  * Python is automatically installed with Metafor. Do not install it.
-On Linux/Unix, uncompress a tarball.
+  * Run the installer and follow the instructions.
+  * Install the Visual 2015 C++ runtime libraries if they are not present on your system.
+  * Run Metafor (desktop link).
+  * Click on the padlock in order to import the license file (''metafor.lic'').
+  * Restart Metafor.
+===== Where is Metafor? =====
-===== License =====
+By default, all the files are located in ''C:\Program Files\Metafor''
-By default, the installation program will use a "student" license which allows the user to build simulations with 5000 nodes at most.
+{{ :doc:user:tutorials:what_is_installed.jpg?nolink&200|}}
-If more nodes are needed (e.g. for Final-Year Projects), Metafor requires a license (''metafor.lic'' file to be copied in the user directory - ''C:\Users\UserName'' on recent Windows, ''C:\Documents and Settings\UserName'' on XP, directory ''~'' on Linux).
+===== What is installed? =====
-To request a license, the MAC address of the computer that will run Metafor must be provided. The easiest way to get it is click on the padlock icon in the GUI (Graphical User Interface). Use the "Import" function of the padlock dialog in order to import the new license file or copy it manually to the location mentioned above.
+Have a quick look at the files installed in ''C:\Program Files\Metafor''.
-Finally, restart Metafor, so the program can read the new license file.
+  * ''Metafor'': Binary files (*.exe, *.dll, etc.).
+  * ''.../apps'': Lots of examples (input files).
+  * ''.../metafor.ltas.ulg.ac.be'': Offline documentation (html files).
+  * ''.../python'': Local installation of python.
+  * ''.../toolbox'': Python toolbox of Metafor.
+  * ''.../wrap'': Python/C++ interface.
-===== Metafor Files =====
-When installing Metafor on a computer, several directories are created:
-{{ doc:user:fichiersinstall.png |doc:user:fichiersinstall.png }}
-    * **doc** : a snapshot of the online documentation, corresponding to the installed version of Metafor.
-    * **oo_meta** : this directory contains Metafor and its files, described below
-    * **redist** : VC++ 2012 run-time installer.
-The main program of Metafor (''Metafor.exe'') and its [[doc:user:general:glossaire#DLL|DLLs]] are located in ''oo_meta''. There, you can find three folders, corresponding to some Python "[[doc:user:general:glossaire#module|modules]]" (a module is a Python concept similar to packages in Java, or simply to libraries) :
-    * **oo_meta/apps** : contains a  [[doc:user:general:glossaire#batterie|series of test cases]]. It is a set of Python files, sorted in a tree structure. To each file corresponds a [[doc:user:general:glossaire#test case]] (so each test case is a Python [[doc:user:general:glossaire#module]]).
-    * **oo_meta/toolbox** : contains Python modules which defines useful functions that will be used to create test cases. For instance, one can be used to create some simple geometries, others define some material laws, loadings, ... This directory ''toolbox'' also contains a module named ''utilities'', which includes all the main functions used to call Metafor (function ''meta'' (to start a simulation), ''vizu'' (to view a mesh), ''restart'' (to restart a simulation) ...).
-    * **oo_meta/wrap** : contains modules from the "wrapper". Those modules define the classes used by Metafor ("shadow classes") with Python. They link together Python and the [[doc:user:general:glossaire#C++]] code compiled within Metafor. The user should not bother himself with those files.
-\\
-\\
-Now that Metafor has been installed, we must check that everything is working well.
-⇒ [[doc:user:tutorials:premiertest|Graphical Interface]]
-\\