-------------------------------------------------- About OpenFOAM Windows Version(2.4.0) -------------------------------------------------- OpenFOAM windows version is based on Linux container technology which allows user to run same executable in Linux/Windows. In Windows a light weight virtual box is used to create environment which allow creating and working on container possible. OpenFOAM installer will install OpenFOAM working environment. The installa- tion area will have a pdf document with name "OF_Windows_Guide.pdf" in Document folder i.e as C:\Program Files(x86)\ESI\OpenFOAM\Documents\ which consist more information about setup and other details ============================= Paraview: ============================== Paraview, a freely available postprocessing tool, can be used to postprocess the OpenFOAM results. Please note that Paraview has not been bundled with OpenFOAM windows installer. Please download and install paraview from follo- wing page http://www.paraview.org/download/ ==================== PreRequisites ====================== 1. Hardware assisted virtulization should be in enabled mode. Please note: If virtualization is not enabled, please enable it from BIOS mode and then reboot your system twice before procceding with installtion In windows 7, one can check whether hardware assisted virtualization is switched on by running utility provided by Microsoft. https://www.microsoft.com/en-us/download/details.aspx?id=592#filelist In windows 8, it can be checked via task manager. 2. Powershell version 2 and above should be installed(It comes by default in Windows Machine i.e Windows7 and Windows8 ). In can you have virtual box running,it is suggested to stop the virtual box and put any running image in it in poweroff mode. ============================ Installation Procedure ============================= 1. User need to click on the OpenFOAM-installer to install the OpenFOAM environment for windows. Installation will install docker(docker, virtualBox, Git) and install OpenFOAM working enviorment on it (Loading image can take time depending on your system memory. So please, have patience and donot close the terminal) 2. Once installation is done, User need to click on "OF_Create_Env" shortcut in Desktop . A shell window will pop up and close which will create desired enviornment for user. This has to be mandatory done first time. 3. Once the environment is set user can click "OpenFOAM_Start" shortcut in Desktop to start OpenFOAM environment. (Press enter in terminal , if bash shell takes long time to start) ======================== Uninstallation Procedure ======================== 1. Go to Control-Panel-> Program(Uninstall the program ) and click on OpenFOAM-installation to uninstall the OpenFOAM windows environment. 2. User need to remove these file manually to complete the whole uninstallation C:\Users\$UserName\.boot2docker C:\Users\$UserName\.ssh C:\Users\$UserName\.VirtualBox C:\Users\$UserName\VirtualBox VMs/boot2docker-vm 3. User need to uninstall the third party tool i.e docker manually by themselves. ============================================================ OpenFOAM : Working with OpenFOAM and Working Folder ============================================================ 1. Please note that once you have sucessfully installed the OpenFOAM windows environment. Then you need to click on short cut OF_Env_Create from Desktop once only. After that you can click on OpenFOAM_start Shortcut from Desktop to enter the working environment 2. Please note that working folder that appear inside the container is shared folder with username i.e C:\Users\Adam . All content inside Adam will be available inside container. 3. User need to copy their case or tutorial in workingDir which correspond to C:\User\UserName . Please note user cannot run tutorial supplied with OpenFOAM in their present location but need to copy them in workingDir first and then run it 4. Postprocessing : i) To do the postprocessing, user need to install paraview seprately as mentioned in starting of README file. ii)Once user has completed the simulation, a file with suffix (.foam) like "casename.foam" has to be created inside the case. User can create file by using command 'touch a.foam' inside case folder. iii)User can launch Paraview and browse inside folder and open the file with suffix (.foam i.e as a.foam ) to visualize case. ================== TroubleShooting Guide =================== 1.In case shortcut does not work for you. i)Check whether virtualization is enabled or not . (See instruction above) 2. My installation is taking too long time i) If installer is taking long time while loading the image i.e the message says this step would install OpenFOAM image. - The time taken usually depend on memory allocated to Virtual box for boot2docker-vm Generally, it is half of your system memory by default.It is better to wait to complete the operation. (15-20 minutes in takes with 4GB RAM) -In case it is taking more time ,follow the below procedure (Not suggested though) a)close the terminal. Let another window popup which say 'wrapping the installation' . Let it complete . b)Right click over VirtualBox and open as admin mode. Make sure that it boot2docker-vm is in poweroff mode and close it. c)Open The virtual box again in user mode and select boot2docker-vm and click on setting and increase memory allocated to 3/4 of maximum . Click on Ok to save setting c)Uninstall the OpenFOAM from control panel . d)Install openfoam in windows. This time cancel boot2docker installation and let other step proceed as ususally. 2. Please refer to OF_Windows_Guide.pdf in installation folder under Document folder for more details 3. In case there is problem with installation and you want to reinstall it. a)Uninstall docker,virtualbox and Git from control Panel. (If while uninstalling some git library is not deleted . Make sure to delete them after restarting your system). Also after uninstallation, check whether C:\ProgramFiles(86)\Git is empty or not . if not please reboot system and delete files inside Git folder. b)delete this files C:\Users\$UserName\.boot2docker C:\Users\$UserName\.ssh C:\Users\$UserName\.VirtualBox C:\Users\$UserName\VirtualBox VMs/boot2docker-vm If some file is not deleted(giving message that they are being used by VBox* : then go to task manager and kill VBox* process which are using them) c) Restart your system : Run the OpenFOAM Windows Installer