Installation Guide. Rev05 WellWhiz 3

Transcription

1 Installation Guide Rev05 WellWhiz 3

2 Contents 1. Introduction System Requirements Licensing Downloading WellWhiz Software installation Extract installation Installing WellWhiz Installing CMG (IMEX) Install Dongle Driver Check installation Restart computer License application and installation Apply for License Install License Troubleshooting Contact and Support

3 1. Introduction This guide describes the system requirements and installation procedures of standalone versions of software package WellWhiz major release 3. Standalone versions of WellWhiz are licensed with a dongle or with a standalone license key that is connected to your computer. This document does therefore not describe the system requirements and installation procedures of WellWhiz with a floating network license. For details about licensing, see section 3. Licensing. It is recommended that you install WellWhiz on a Windows 7 64 bit version machine. Full recommendations with regards to computer specifications are included in the next section. If you have a problem which the troubleshooting section at the end of this document does not answer, please contact WellWhiz support. More information on the software package can be found on WellWhiz is a product from Fracture Technologies Ltd. For more information about Fracture Technologies Ltd., see 2. System Requirements Please note that even though WellWhiz 3.X has been successfully installed, tested and run on systems with minimum system requirements this guide is based on using the recommended requirements. The Windows and installation steps shown in this guide are shown when using a 64 bit version of Windows 7. The Windows and installation steps on other operating systems may vary slightly. If WellWhiz is installed on Microsoft Vista, installation issues specific to Microsoft Vista are described in Docs/Installation issues with Vista.doc. WellWhiz is a computationally demanding piece of software and hence it is strongly recommended to utilise a computer with recommended requirements or better. Please make sure that the graphics card specifically has good OpenGL compatibility for use with Java 3D. Minimum System Requirements 1) Minimal 2.0 GHz dual core main processor 2) Dedicated 3D-display hardware, with at least 16 MB of graphics memory 3) 2+ GB of system RAM 4) Windows XP or younger 5) 2+ GB of free disk space 6) MS Excel Recommended System Requirements 3

4 Intel Core i7 or equivalent main processor Dedicated 3D-display hardware, with 64 MB of graphics memory 4+ GB of system RAM 64 bit version of Windows GB of free disk space MS Excel Licensing This document describes installation of standalone versions of WellWhiz 3.X. With standalone licenses there are two options: A license for a single computer alone: This is the simplest of all options, but with this option WellWhiz can only be used on the computer that was used for generating the licensing information (or hostid, see 6.1 Apply for License). Furthermore, if some of the hardware of the computer is replaced such as the hard disk drive, the license might no longer work. Licensing using a dongle: a dongle is a USB stick with a hardware key that must be physically inserted in a free USB slot of your computer when the software is going to be used. It requires the installation of driver software. However, with this option, the WellWhiz license is not limited to a specific computer, but to the dongle. So in this case WellWhiz can be installed and used on more than one computer. The third option, a floating network license is not described in this document. With this option, one can check out a WellWhiz license from a pool of licenses from a network license server. For a floating network license send an to WellWhiz support and request the network version of this installation guide. Contact details of WellWhiz support are provided in section 4. Downloading WellWhiz 1) First check your system. For this, click with the left Mouse Button on Start, with the right mouse button on Computer and select Properties at the bottom of the context menu. In the top section, the Windows version is shown, in the System section, the system type is given. These installation instructions assume that the system is a 64 bit version of Windows 7. If this is not the case, you may proceed, but take into account that the Windows shown may vary slightly from the one shown in the guide, and if your system is 32 bit, one of the Windows will not be shown during the installation of CMG (IMEX). In addition, check if the installed memory is 2 GB or more. If installed memory is less than 2 GB consider installing WellWhiz on a different machine. 2) Open website 4

5 3) Click on the Login tab and login as Customer (case sensitive) with the password that we provide in a separate . Note that this password is also case sensitive. 4) When logged in as Customer, select in the tab Downloads menu item the Download Latest Release menu item. 5

6 5) This link directs you to a page with the details about the release and links to download various files. File 1: Installation guide for WellWhiz - this manual File 2: WellWhiz installation file A The WellWhiz section of the installation. If you are using a recent installation of WellWhiz and are downloading a new release you might be able to re-use your older version of the B file. File 3: WellWhiz (CMGL) installation file B The CMGL section of the installation. Please note that when this is not downloaded a version of this section will need to be on the computer you are installing the software on. 6) If you click the Download link, the browser asks you whether you want to Open or Save the release. Choose Save and download the files to your system. 6

7 5. Software installation In this section, the CMG, WellWhiz and (optionally) dongle driver software is installed. In next section, section 6. License application and installation, the WellWhiz and CMG(IMEX) license administration is handled and subsequently installed. If installation doesn t proceed as described in this section, refer to section 7, Troubleshooting. This section contains solutions to some common problems. If that doesn t help, please send an to WellWhiz support. Details of WellWhiz support are given in section 5.1 Extract installation Extract the folders and files from the downloaded two compressed (zipped) folders and extract the contained WellWhiz-release-reprise folder to your desktop. The two compressed files both contain a folder with the name WellWhiz-release-reprise.3.4 or similar name. By extracting to the same folder (e.g. Desktop) the folders will be merged as intended. Note: Ensure both the folders are extracted in the same folder and once completed the folder WellWhiz-release-image-reprise.3.4 should contain a folder named CMGL. With older Window versions, you may need to install an unzip program such as WinZip or 7z in order to do so, with new Windows systems, you can do a right click, and select Extract All. Double click on the extracted WellWhiz installation folder (WellWhiz-release-reprise.3.4) to produce a Windows Explorer window. The explorer window will show a list of subdirectories, a support file with the extension.dll, and a list of enumerated Windows batch files with extension.bat. Software installation is carried out by executing the following steps. Apart from the last step, each step starts with executing a Window batch command. The steps and associated Window batch commands are listed here: 1) Install WellWhiz (1_Setup_WellWhiz.bat) 2) Install CMG(IMEX) (2_Setup_CMG_Programs.bat) 3) Optionally, install the dongle driver (3_Setup_Dongle_Driver.bat) 4) Check Installation (4_Check_Setup.bat) 5) Restart computer Each batch command opens a Windows command window with the customary black background. Leave this command window open until the command executed in the command window has finished completely. When the installation command has finished, Press any key to continue is shown and the command window may be closed. Activate the command window (i.e. click on the window to make it active), and press in any key. 7

8 5.2 Installing WellWhiz Double-click on 1_Setup_WellWhiz.bat. We recommend that you accept all defaults during installation in order to avoid difficulties and wait until the following window has appeared. Click on Finish to finish the installation of WellWhiz and close the batch window. 5.3 Installing CMG (IMEX) When installing CMG software, a sequence of screens is shown. On nearly each one of them, accept the default values unless there are good reasons not to do so. Please refer to Docs\Using CMG Setup.pdf in the installation directory for further details. Double click on 2_Setup_CMG_Programs.bat in order to install the reservoir simulator of CMG. This will open the following window: 8

9 Click on Next to continue the installation. Please read the license agreement and Click Yes to accept and continue the installation. Press Next after reading the information to continue the installation. 9

10 Complete the following screen with companies/users credentails and click Next to continue the installation. On the select licensing type screen please select your type of license. Dongle and computer licenses will require Standalone to be selected. Please click on Next after the selection to continue the installation. Note: Options Network License Client and Network License Server are used for a floating network license, and are not covered in this document. In this screen, do not use the default, but select Use the CMG Job Service to Schedule Simulation Jobs. Click Next after the selection to continue the installation. 10

11 This window opens when you install WellWhiz on a system with a 64 bit OS. This window allows one to install only the 64 bit version of IMEX or both the 32 and 64 bit versions. When installing WellWhiz on a 32 bit OS, this window is skipped. Select Install Win_x64 only and click Next after the selection to continue the installation. The Choose Desitination Location screen allows you to select the location where the software will be installed. It is recommended that you use the default location. Click Next after the selection to continue the installation. Once all settings are completed please click on Install to start. The installation of the software consists of a couple of steps after which the next window will be displayed. 11

12 In this screen, do not select the default (Yes), but select No. The hostid is generated later in the installation procedure. On the final CMG (IMEX) installation screen do not select the default option, but select: No, I will restart my computer later. Installation includes a restart later in the procedure. Finally close the open command window opened by 2_Setup_CMG_Programs.bat. 5.4 Install Dongle Driver A variety of methods for licensing is available for running WellWhiz, but as explained in section 3. Licensing, only the standalone licensing versions are described in this guide. When a computer license is required, the installation step of this section is not necessary and can be omitted. Continue with section 5.5 Check installation. 12

13 In case you want to use a dongle, locate and double click on 3_Setup_Dongle_Driver.bat. The following sequence of installation windows will appear. Please follow the instruction on the screen and click on Next to continue installation of the dongle driver. Please read the license agreement carefully and select I accept the license agreement before clicking Next to continue the installation. Please click Next to start the installation of the dongle driver. 13

14 When the dongle driver is installed successfully the following window will appear. Please click on Finish to complete the installation process. 5.5 Check installation To verify that all components of the software package WellWhiz are successfully installed please locate and double click on 4_Check_Setup.bat. Upon successful installation the following screen content will appear. Please refer to the troubleshoot section of this document if any other message appears. Alternative please contact for help and support on installation issues. 5.6 Restart computer Now restart the computer. If you are plan to use a dongle license, please make sure insert the dongle is inserted in your computer before restarting the computer. Continue then with section 6. License application and installation. 14

15 6. License application and installation 6.1 Apply for License If a dongle license is required, please make sure you the dongle was inserted in a free USB slot of your computer. If not, do so now, and restart the computer. If alternatively a standalone computer license is required, but a dongle is inserted in a USB slot, make sure the dongle is removed from your computer. The license will be specifically for the dongle if a dongle is inserted in your computer. 1) Locate and double click on 5_Apply_For_License.bat. The following window will appear. 2) Fill out all requested details, and click on Save to Text File and save this file to a temporary directory. Note: If using a dongle please confirm the dongle number is included in the host id information screen (red box). 3) the created and saved HostID text file to shaidar@fracturetechnologies.com requesting the type of license for WellWhiz. 4) The license file will be submitted to you by (filename.lic) and once received the installation of the file can be continued. 15

16 6.2 Install License Note: When installing a dongle license it is again important that the dongle is inserted in an USB slot before the computer was turned on. 1) When receiving the license file by save the file on a know location. Please note that the file might be required in the future and hence it is strongly recommended to keep a copy in a different location. The license file is a file with a.lic extension. 2) Click on Start All Programs WellWhiz 3.X Install license with the right mouse button and choose Run as administrator and the following window will appear. Note: It is not always necessary to run the Install License utility as administrator, but if you don t in some cases you may come across a permission denied error. Note: There are other ways in which to install a license, but the way it is described here, is the most assured way of installing a license. 3) Press (1) Load license file and use the browser that appears to navigate to the license file that was provided. The license file location will become visible in the top bar. 4) Press (2) Install license. The following window will appear. 16

17 5) Read this window and press the button I have now read this and want to continue. 6) The default internet browser with then present the page Reprise License Server Administration page. 17

18 Note: If this step fails, check if Problem 4, section 7, Troubleshooting, solves your problem, else contact WellWhiz support. Details are provided in section 18

19 7) Select in the left pane of the page the button Reread/Restart Servers. Then the following window is shown: 8) Enter cmgl in the input box in the middle of the page and select the button below the input box Reread/Restart Servers. Note: not replacing all with cmgl means that you restart all servers, also ones that have nothing to do WellWhiz, if such servers are present. 9) After the message that a RESTART command is sent to the server is shown, select the Status button in the left pane and compare the screen with the screen given below. 19

20 10) If the line at the bottom of the screen looks like what is shown here, licensing works. Congratulations! WellWhiz is now successfully installed, please restart the computer. 11) To run WellWhiz select Windows Start All Programs WellWhiz3.x WellWhiz 3.x 64bit. Note: if instructions on how to use WellWhiz are required it is recommended to run the WellWhiz tutorial (Help Tutorial in the WellWhiz program), or from the manual located in the software or in Windows Start All Programs WellWhiz3.x WellWhiz 3.x Help. The WellWhiz-release-reprise folder with the installed release from your desktop can be deleted. It is recommended to retain the zip file for future installations of the package. We also recommend reading the included or provided release notes for your installed version. 20

21 7. Troubleshooting Problem 1: Solution: I can not see the Install License utility file in the WellWhiz folder On 32bit OS versions, the Install License utility is sometimes located in the Windows Start All Programs WellWhiz3.x Absolete folder. Problem 2: Solution: My dongle license does not load after selecting the license file If after you start WellWhiz, you fail to load a license and your license requires a dongle, make sure that the dongle was in the computer before you restarted the computer. You cannot check out a license if you insert the dongle after you restarted the computer. Problem 3: Solution: The help file in the software is showing blank screens If the accessing the help manual via Help Manual in the WellWhiz program, or from Windows Start All Programs WellWhiz3.x WellWhiz 3.x Help fails, the help file can also be found in: C:/Program Files (x86)/wellwhiz3.x/manual/html/ WellWhizManualWhole.html, if C:/Program Files (x86)/wellwhiz3.x/ is the location where you installed WellWhiz. You can open this path in a browser. Problem 4: Solution: You cannot connect to the Reprise License Server Administrator webpage. If you cannot connect to the Reprise License Server Administrator webpage, this usually means that an older version of the Reprise License Administrator server is installed. As explained in the following window: 21

22 You can then start the Reprise License Administrator by typing in: instead of the usual: Note: If you indeed have got an older version of the Reprise License Administrator, some buttons may be missing from the webpage in comparison to the windows shown in the guide. Problem 5: Solution: If you use big datasets, you can run into a Java heap memory exceeded error. WellWhiz runs usually with a heap space of 800 MB. You can increase this number by copying ww64.bat of your WellWhiz installation directory into a personal folder and replace in the line: set XMX64=800m 800m with a larger number, e.g.: set XMX64=2000ms If your system contains 4 GB, it is here safe to use 2000m. Note: you can also adapt ww64.bat in the installation directory, but for that you need administrator privileges. 22

23 Problem 6: Solution: WellWhiz cannot find Microsoft Excel. If WellWhiz was unable to find Microsoft Excel, proceed as follows: 1) Start WellWhiz. 2) Select File Options and then the File Locations tab. 3) Use the Browse button right from the Spreadsheet Invocation label to search for Microsoft Excel, or fill the absolute path of Microsoft Excel directly in the input field right from the button. 4) Press on the Test locations button. If all locations including the spreadsheet program are found, the Not yet tested label changes into Files have been verified, else an error is produced. Note: If the installation directory of CMG(IMEX) is the recommended C:\Program Files (x86)\cmg, WellWhiz searches for Microsoft Excel in C:\Program Files (x86)\microsoft Office\Office, C:\Program Files (x86)\microsoft Office\Office10, C:\Program Files (x86)\microsoft Office\Office11, C:\Program Files (x86)\microsoft Office\Office12 and C:\Program Files\Microsoft Office\Office14 in the order given. If Microsoft Excel is not in any of those paths, you must use the solution in order to specify the path yourself. Problem 7: Solution: The WellWhiz console reports: PROBLEM: Cannot find simulation results. Rerun the simulation, but you just did a simulation. This error may be due to long file or pathnames. CMG(IMEX) like most Windows programs limits path names to just 260 characters. So it may happen that when appending the suffix _results.txt for the results file to the WellWhiz dataset, this limit is exceeded. Limiting the length of path names is then the obvious solution, but the following trick is easier to implement: 1) Left click on Windows Start and open with cmd.exe a Windows command shell in the Search programs and files box. 2) Type then in the Windows command shell the command: subst h: C:/_your_/_very_/_long_/_path_/_name_/ with h is a drive letter that is not already in use by the system. You can then refer to your very long path name with just the drive letter h, in essence sidestepping the whole issue. Note: If you restart your computer, the drive substitution is erased. If you want to keep the drive substitution after a restart, create a batch file with the substitute command, and paste a shortcut to that batch file to Windows Start All Programs Startup. 23

24 Problem 8: WellWhiz stops suddenly overnight due to unknown reason. Solution: It may happen that RLM license server stops overnight. If you possess administrator priviledges, you can prevent this from happening by adapting services.msc. 1) Left click on Windows Start and type services.msc in the Search programs and files box. 2) Click with the right mouse button on CMGL RLM Services, 3) and select the Recovery tab, and set the failure options of each failure to Restart the Service: 24

25 8. Contact and Support For troubleshooting and general support, please contact WellWhiz support on: Tel: Fax: Web: In order to request or update a license, send the HostID text file generated in section 6.1 Apply for License to Sami Haidar at: shaidar@fracturetechnologies.com. 25