Differences

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

--- doc:user:tutorials:installation [2015/01/07 09:38] – [Installing Metafor] boman
+++ doc:user:tutorials:installation [2024/03/01 16:17] (current) – boman
@@ Line 1: / Line 1: @@
-====== Installing Metafor ======
+====== How to install Metafor? ======
 ===== Video =====
-This video shows how to install Metafor.
+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>
-\\
-===== Installing Metafor =====
+===== Download the installer =====
-On Windows, just use the setup program. Towards the end, it is possible to install Visual C++ 2012 Microsoft runtime libraries (do so if you do not know what it is).
-On Linux/Unix, just decompress a tarball.
+Installers are available for Windows, Linux and macOS on this website: [[teaching:private:start|]]
-===== License =====
+{{ :doc:user:tutorials:padlock.jpg?nolink&200|}}
+===== Step-by-step Procedure =====
-By default, the installation program will copy a "student" license which allows the user to build simulations with 5000 nodes at most.
+  * 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.
-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).
+===== Where is Metafor? =====
-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.
+By default, all the files are located in ''C:\Program Files\Metafor''
-Finally, restart Metafor, so the program can read the new license file.
+{{ :doc:user:tutorials:what_is_installed.jpg?nolink&200|}}
-===== A DLL went missing when installing Metafor =====
+===== What is installed? =====
-Metafor needs Python to run. Install the appropriate python version (it should be the one used to compile the Metafor version you are currently installing. The name of the missing DLL might help you find the right version).
+Have a quick look at the files installed in ''C:\Program Files\Metafor''.
+  * ''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 your version of Metafor. These pages are offline and will not be modified
-    * **oo_meta** : this directory contains Metafor and its files, described below
-    * **redist** : the setup of VC++ 2005 runtimes, if you did not install them earlier
-The executable file 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 will create a cube, another will define a material, a load, ... This directory ''toolbox'' 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]]
-\\