Simulation Launcher User Guide

Version 2012.1

User Guide

Proprietary notice

Copyright (c) 2012 Schlumberger. All rights reserved. Reproduction or alteration without priorwritten permission is prohibited, except as allowed under applicable law.

Use of this product is governed by the License Agreement. Schlumberger makes no warranties,express, implied, or statutory, with respect to the product described herein and disclaims withoutlimitations any warranties of merchantability or fitness for a particular purpose.

Trademarks & service marks

"Schlumberger," the Schlumberger logotype, and other words or symbols used to identify theproducts and services described herein are either trademarks, trade names, or service marks ofSchlumberger and its licensors, or are the property of their respective owners. These marks maynot be copied, imitated, or used, in whole or in part, without the express prior written permission oftheir owners. In addition, covers, page headers, custom graphics, icons, and other designelements may be service marks, trademarks, and/or trade dress of Schlumberger and may not becopied, imitated, or used, in whole or in part, without the express prior written permission ofSchlumberger.

Simulation Launcher User Guide

Table of Contents1 Introduction ................................................................................................................. 1

1.1 Starting Simulation Launcher for the First Time ........................................................................ 11.2 User Interface ................................................................................................................................. 11.3 Menu Bar ........................................................................................................................................ 2

1.3.1 File Pull-down Menu ............................................................................................................ 21.3.2 Configuration Pull-down Menu ............................................................................................ 31.3.3 Window Pull-down Menu ..................................................................................................... 31.3.4 Help ..................................................................................................................................... 3

2 Quick Start Guide ........................................................................................................ 42.1 Launching a Simulation ................................................................................................................ 4

2.1 Host file ..................................................................................................................................2.1.1 Advanced Tab ..................................................................................................................... 5

2.2 Displaying Simulation Results ..................................................................................................... 62.2.1 Command Line Options ...................................................................................................... 72.2.2 Message Filter ..................................................................................................................... 7

2.3 Launching an ECLIPSE Pre/Post Program .................................................................................. 72.4 Launching an SIS Program ........................................................................................................... 72.5 Launching a Manual ...................................................................................................................... 8

3 Administration Tasks ................................................................................................. 93.1 Adding a Group .............................................................................................................................. 93.2 Renaming a Group ......................................................................................................................... 93.3 Removing a group ......................................................................................................................... 93.4 Adding a Program ........................................................................................................................ 103.5 Properties for Simulators ............................................................................................................ 103.6 Properties for ECLIPSE Pre/Post ............................................................................................... 113.7 Properties for Manuals ................................................................................................................ 123.8 Properties for an SIS Application or Other Program ................................................................ 123.9 Rename a Program ...................................................................................................................... 133.10 Remove a Program ...................................................................................................................... 13

4 Simulation History .................................................................................................... 14


i

5 Settings ...................................................................................................................... 155.1 Simulation Launcher Settings .................................................................................................... 155.2 ECLRUN Settings ......................................................................................................................... 165.3 EnginFrame Settings ................................................................................................................... 175.4 Queues Settings .......................................................................................................................... 17

5.4.1 Add or Delete a Queue ..................................................................................................... 185.4.2 Set the Default Queue ....................................................................................................... 18

6 Configuration File ..................................................................................................... 197 Appendix .................................................................................................................... 21

7.1 Optional Utility Programs ........................................................................................................... 217.1.1 Adding and Running Utilities via Simulation Launcher ...................................................... 217.1.2 Running from command line ............................................................................................. 217.1.3 RESQML to GSG Converter ............................................................................................. 22

Description ..................................................................................................................... 22Characteristics ............................................................................................................... 22Convert from Simulation Launcher ................................................................................ 23Alternative Option: Convert from Command Line .......................................................... 23

Index ............................................................................................................................................................ 25


ii

1Introduction

The Simulation Launcher is Windows based software for running the ECLIPSE, FrontSim andINTERSECT simulators and pre and post processors. The user interface is based on the MicrosoftWindows standards on buttons and dialogs. This makes the Simulation Launcher familiar to themajority of reservoir engineers today and ensures efficient usage of the application.The Simulation Launcher uses a utility called ECLRUN to run the programs mentioned. TheSimulation Launcher supports the following simulation combinations: Remote Linux/UNIX system with the LSF (Load Sharing Facility from Platform Computing)

queue system. Local submission to MS HPC on Windows. Local queue system on Windows.

1.1 Starting Simulation Launcher for the First TimeThe Simulation Launcher is installed automatically when the simulators are installed. A desktopshortcut is provided and can also be located using the Start menu.When the Simulation Launcher is started for the first time, it takes a little while to start. The reasonfor this is because the Simulation Launcher is checking which programs are installed on yourmachine. Once this process has finished a configuration file called SimLaunchConfig.xml iscreated in your user application data area. This file contains the data necessary to create programshortcuts to the programs you can use.The next time Simulation Launcher starts, it does not create a new configuration file if one exists,and so should start faster.

1.2 User InterfaceThe user interface is designed using Microsoft Windows standards to give a familiar look and feel.The Simulation Launcher consists of three main parts: The Launcher pane has the same look and feel as the Windows Explorer. Each program has an

associated icon and these can be organized into Groups.


Introduction 1

The Display window displays the fields needed to run the selected program selected and toprovide information about the program's associated properties. The status of a selectedsimulation is also displayed within this window.

The Simulation History pane displays the history of simulations that were launched by the userdirectly with Simulation Launcher or ECLRUN.

Figure 1.1. Simulation Launcher

1.3 Menu BarThe pull-down menus are listed on the Menu bar at the top of the window, and should be familiarfor most users. To open a pull-down menu click on the menu with the left mouse button. To perform any of the functions in the menu, click on it with the left mouse button.

1.3.1 File Pull-down MenuNew Group

Creates a new group in the Launcher pane.New Program

Allows you to choose a program that you want to add to the Launcher pane.


Introduction 2

ExitCloses the application.

1.3.2 Configuration Pull-down MenuSettings

Includes options for the simulation launcher, ECLRUN, EnginFrame and Queues forremote submission jobs.

SimulatorsResets the Simulators group back to factory defaults.

ECLIPSE Pre/Post ProgramsResets the ECLIPSE Pre/Post Programs group back to factory defaults.

1.3.3 Window Pull-down MenuClose All Windows

Closes all active tabs that are open.

Note: Each tab that is currently displayed is also available from this menu.

1.3.4 HelpDiagnostics

Shows system information for troubleshootingManual

Opens the Simulation Launcher User Guide in Adobe Acrobat.About

Displays the application's details, such as version, proprietary information and a shortdescription.


Introduction 3

2Quick Start Guide

2.1 Launching a SimulationThe 2011.1 release of Simulation Launcher introduced a simple queuing mechanism to restrict thenumber of jobs (instances of ECLRUN) that are running at the same time. This mechanism wasintroduced to reduce the performance effect that launching lots of instances of ECLRUN at thesame time could have on the machine on which they are running. The queuing system applies tosimulators only and is enabled by default (to disable it, clear the Enable local queuingsystem check box on the Simulation Launcher tab of the Settings window). The number ofjobs that can run at the same time is controlled by the value of EclNJobs (see ECLRUN Settings(p.16) for more details).The following procedure explains how to run a simulation using the Simulation Launcher.1. Select a Simulator from the Simulators group.2. Click on Add Dataset and then browse for the dataset you wish to use. You can select multiple

datasets from the browse screen.3. Select a queue from the dropdown list.

Local will run the simulation on your machine. If you have set up other queues, these will also be available for selection. See Add or delete

a queue (p.18).4. Select a version from the dropdown list.

Latest will work out the most up to date installed version of the simulator you have chosenon your machine or the remote machine

Alternatively a version number can be typed into the box.5. Click on Run.As a result the job(s) are either submitted to the Eclrun local queuing system (if enabled) orlaunched directly. In case of the former, the job(s) will wait until the currently running instances ofECLRUN finish, so making place for the pending ones (the number of pending simulations isdisplayed on the status bar in the bottom-left corner of the main window).


Quick Start Guide 4

If you launch a simulation for processing on a remote server(s) and you do not supply a user nameand password, Simulation Launcher queries ECLRUN to see if it is setup to work in password-lessmode. If it is setup this way, you are not prompted for a password. You can also enter your username and password details in the Queues setup window in Simulation Launcher in which case,you do not need to supply the information when you launch a simulation. Except for these twocases, you will be prompted for a user name and password for remote submission if you don'tprovide them explicitly.

Notes: The process of checking whether ECLRUN is setup to support a password-less connection is

done in FILE_EXISTS mode. For more information, refer to the ECLRUN User Guide. If you are running INTERSECT then you will also have to select the number of processors that

you want to use. Enabling and disabling the Eclrun local queuing system requires restarting Simulation

Launcher. Changing the value of EclNJobs does not affect the Eclrun local queuing system until

Simulation Launcher is restarted. By closing the Simulation Launcher application, you stop any pending job from being launched.

The jobs are not automatically re-launched if the Simulation Launcher has been reopened.

Host fileWhen submitting a parallel job or a set of parallel jobs, a shared host file can be specified in one oftwo ways: Selecting an existing host file with the Browse button (which is on the Select tab of the

Summary window of the selected simulator). Manually adding -m hostfile to ECLRUN's command line options for the selected simulator

(see Advanced Tab (p.5) for more details). hostfile must be either a relative or absolutepath to an existing host file on the local machine.

The host file that has been selected with the Browse button can then be edited by clicking on theEdit button. Selection can be cancelled by clicking on Clear button.

Notes: The chosen host file will be used for all the selected simulation input files, without checking

whether the file's format or contents are correct. The Edit button opens the selected host file using the default application associated with the

host file's file extension.

2.1.1 Advanced TabThe Advanced tab allows you to further customize the way that you want to run the simulation.


Quick Start Guide 5

Override Default ExeOn a 64 bit machine, if a 64 bit simulator exists, this is used by default to run thesimulation. However, you might want to run the 32 bit simulator instead, and this optionallows you to do this.

Notes: This option is only available for use with the Schedule program. This option is not enabled if your operating system is 32 bit because a 64 bit

executable will not work.

Edit Command Line OptionsThis allows you to pass additional commands to ECLRUN. See the ECLRUN User Guidefor further information.

2.2 Displaying Simulation ResultsIf you have started a new simulation or selected a dataset from the Simulation History (seeSimulation History (p.14)) a new tab opens.The selected tab displays the contents of the message file. This tab has a number of buttons whichinclude:Open Log

Displays the screen output from the Simulator in your chosen editor for .LOG files.Open PRT

Displays the PRT file in your chosen editor for .PRT files.Update

Performs a check on the status of the simulation and updates any displayed results (thismay take some time if you are running the simulation remotely). If the simulation hasfailed, aborted or finished then this button is disabled.

Terminate/Run If the simulation is still running you can stop the process. If the simulation is not running this button displays Run. This allows you to run the

simulation again, using the syntax specified in the Command Line Options box. With Debug Mode, if you check this option and click on Run a command console is

displayed with the debug information from the ECLRUN instance running thesimulation. This information can be used to provide information to SchlumbergerSupport if you have problems running datasets.

Automatically update every X mins. Performs the same function as Update at thespecified intervals.You can change the default interval. See Simulation LauncherSettings (p.15).


Quick Start Guide 6

2.2.1 Command Line OptionsCommand Line Options displays the command used to run the simulation.

2.2.2 Message FilterThe Message Filter allows you to search for specific text within displayed simulation results. Bydefault you see all messages type within the grid; these can be filtered by check/unchecking theappropriate message types.

2.3 Launching an ECLIPSE Pre/Post ProgramThe following procedure explains how to run an ECLIPSE Pre/Post program.1. Select FloGrid, for example, from the ECLIPSE Pre/Post Group2. Click on Browse and then select a start directory. The ECLIPSE Pre/Post program uses this as

the initial directory.3. Select a version from the dropdown list.4. If you select Latest this runs the most recent version of the chosen program on your machine.5. Click on Run.

This launches the selected program in another window.Override Default Exe

On a 64 bit machine, a 64 bit version of the program is used by default if it exists.However, you may want to run the 32 bit version instead. This option allows you to do this.

Notes: This option is only available for use with the Schedule program. This option is not enabled if your operating system is 32 bit because a 64 bit

executable will not work.

2.4 Launching an SIS ProgramThe following procedure explains how to run an SIS program.1. Select an SIS program from the launcher pane.2. Select how you wish to run the program depending on the input options specified for that

program.3. Click on Run. This will launch the program.

To add an SIS application see Adding a Program (p.10).


Quick Start Guide 7

2.5 Launching a ManualThe following procedure explains how to display a manual.1. Select Manuals from the launcher pane2. Select a version of the manual set to view from the dropdown list3. Click on Run. This displays the selected manual set.

Note: Adobe Acrobat is required to view the manuals. It is on the installation DVD.


Quick Start Guide 8

3Administration Tasks

You can carry out the following tasks in the Launcher pane.

3.1 Adding a GroupGroups are a convenient way to organize programs in the Simulation Launcher. For example youcan create a Results Viewer group that contains the FloViz and ECLIPSE Office programs.1. To add a Group use one of the following methods:

On the File menu, point to New, and then click New Group. Right-click on existing group, and then click on Add Group. Right-click on empty space in the Launcher pane, and then click on Add Group.

2. After adding a group you can enter a new group name. Make sure that the group names areunique.

3.2 Renaming a Group1. In the Launcher pane, right-click the group you want to rename.2. Click Rename.3. Type the new group name, and then press Enter.

3.3 Removing a group1. In the Launcher pane, right-click the group you want to remove.2. Click Remove.3. Click Yes to confirm the deletion of the group and all of its contents.

Note: If you remove a group that has associated programs, these programs are only deletedfrom the Launcher pane and are not deleted from your system.


Administration Tasks 9

3.4 Adding a ProgramYou can add programs to the Launcher pane. These can either be copies of the default set ofprograms that you have customized or you can add other SIS applications.1. To add a Program use one of the following methods:

On the File menu, point to New, and then click New Program. Right-click on existing group, and then click on Add Program.

2. Select the program you wish to add and click on Add Program. The programs available to add will depend upon what programs you have installed on your

local computer. The Other option in the list allows you to add any other SIS application.Clicking on Add Program displays the properties for the program.

3.5 Properties for SimulatorsThis displays the details of the program and allows you customize the display. You can view the properties of a simulator by right-clicking on the simulator, and then pressing

Properties.When you view the properties of one of the simulators the following will be displayed:

Name of Program allows you to change the name of the program. The Submit, Fetch (load results), and Kill (abort) Commands define the way the Simulation

Launcher administers simulations. Words surrounded by % are variables. The Simulation Launcher uses these variables as

commands when a simulation is run. They allow you to select, for example, the datafile to beused, the queue and the server on which to submit the simulation. All variables are optionalwith the exception of %DATAFILE%.

Variables surrounded by [ ] are only written if Simulation Launcher has a non-blank valuefor the variable enclosed. [] cannot be used with %DATAFILE%.

Recognized variables are:

Variable Definition%DATAFILE% Name of the data file for the simulation. You must give a value for this variable.%VERSION% Version of the simulator to run%SERVER% Machine to which to submit the simulation%USERID% Userid on the %SERVER%%PASSWORD% Password on the %SERVER%%QUEUE% Name of queue in LSF or other queuing system



Variable Definition%OPTIONS% Any options that you want to pass to ECLRUN, the queuing system and the

executable. (See "Command syntax" in the "ECLRUN User Guide".)Table 3.1: Simulation Launcher VariablesDefault Start Directory

This is the initial directory that you will see when you click on Add a Dataset (seeLaunching a simulation (p.4))If this is disabled it means you have chosen to use the parent directory of the last data fileused for that simulator. This behavior is the default. If you wish to specify a defaultdirectory go to the Settings tab (see Simulation Launcher Settings (p.15)).

Default VersionAllows you set the default version of the selected program.

Default QueueAllows you set the default queue for the selected program.

Command Line ParametersAllow you to store command line options that are passed to ECLRUN using the %OPTIONS% variable

3.6 Properties for ECLIPSE Pre/PostThis shows the details of the program and allows you to customize the properties. You can view the properties of a program by right-clicking on the program, and then selecting

Properties.When you view the properties of one of the ECLIPSE Pre/Post the following will be displayedName of Program

Allows you to change the name of the program.Start Command

Defines the way that Simulation Launcher launches the program. Words surrounded by % are variables. They are replaced by Simulation Launcher when

a simulation is run depending on the queue that has been selected and otherinformation that you enter in the Simulation Launcher.

Sequences surrounded by [ ] are only written if Simulation Launcher has a non-blankvalue for the variable enclosed.

Recognized variables are:

Variable Definition%STARTDIR% Name of the directory the program will open files from%VERSION% Version of the simulator to run



Variable Definition%OPTIONS% Any options that you want to pass to ECLRUN, the queuing system and the

executable. (See "Command syntax" in the "ECLRUN User Guide".)Table 3.2: ECLIPSE Pre/Post Product VariablesDefault Start Directory

this is the initial directory that you will see when you click on Browse (see Launching aECLIPSE Pre/Post program (p.7)).If this is disabled it means you have chosen to use the last directory selected for thatprogram this behavior is the default. If you wish to specify a default directory go to theSettings tab (see Simulation Launcher Settings (p.15)) .

VersionsAllows you to set the default version of the selected program.

3.7 Properties for ManualsThis shows the details of the program and allows you to change the default manual to view. You can view the properties of a program by right-clicking on the manual, and then selecting

Properties.When you view the properties of one of the manuals the following will be displayed:Name of Program

Allows you to change the name of the program.Manual to View

Allows you to change the default manual you would like to view.

3.8 Properties for an SIS Application or Other ProgramThis shows the details of the program and allows you to change the program you would like tostart. You can view the properties of a program by right-clicking on it, and then selecting Properties.When you view, add or edit the properties of one of the SIS programs or Other programs thefollowing will be displayed;Name of Program

Allows you to change the name of the program.Program to Run

The path to the executable that you would like to start from the Simulation Launcher.Command Line Parameters

Allow you to enter any options that you would like to pass to the executable selectedabove. There are special parameters which the Simulation Launcher recognizes andreplaces with values specified by the user.



Words surrounded by % are variables, replaced by Simulation Launcher when a program is run,according to selections made by the user.

Sequences surrounded by [ ] are only written if Simulation Launcher has a non-blank valuefor the variable enclosed.

Variable Definition[%FILE%] Will be replaced with the file the user has selected[%FOLDER%] Will be replaced with the startup directory the user has chosen

Table 3.3: SIS Program VariablesInput Settings

Allows you to specify the inputs of a program with any of the following settings: Can accepta file, Can accept a folder and Can run with no input.

Note: If you select either Can accept a file or Can accept a folder you will need to input theSIS Program Variables into the Command Line Parameters in the correct positionsassociated with that program.

File ExtensionsIf your program accepts a file you may also want to add the file extensions that theprogram supports. These should be typed in the following format, if the filename issim.pet you should type in pet.

3.9 Rename a Program1. In the Launcher pane, right-click the program you want to rename.2. Click Rename.3. Type the new program name, and then press Enter.

3.10 Remove a Program1. In the Launcher pane, right-click the program you want to remove.2. Click Remove.3. Click Yes to confirm the deletion of the program

Note: If you remove a program, it is not deleted from your system, but simply removed from theLauncher pane.



4Simulation History

You can carry out the following tasks in the Launcher pane.The default number of items for the history is 300. This can be changed in the SimulationLauncher Settings (see Simulation Launcher Settings (p.15)). When this number is reached,Simulation Launcher deletes the oldest finished simulation from the list. Checking or unchecking the View column displays a new tab with the current status and results

of the simulation (see Display simulation results (p.6)). Double-clicking on a row opens a new tab and double clicking again on the same row closes

the tab. By clicking the Update button, the results are updated.

Note: You cannot update the results if a tab with the results is already open. You need to clickupdate on the tab itself.

By clicking on the Delete button the history item is deleted from the list.

Note: You cannot remove the history item if a tab with the results is already open. You need toclose the tab first.


Simulation History 14

5Settings

You can change the settings by clicking on the settings in the Configuration pull down menu. TheSettings dialog includes options for changing the: Simulation Launcher Settings ECLRUN Settings Enginframe settings Queue definitions (for remote job submission).

5.1 Simulation Launcher SettingsNetwork Configuration File

Allows you add a network configuration file which contains settings for the SimulationLauncher (see Configuration File (p.19))

Display Local SimulationDisplays a command console when running a simulation locally

Interval checkThe default number in minutes between checks on the Simulation Results tab.

Number of Items in History FileNumber of items to display in the Simulation History pane

Application Startup DirectoryFor each Simulator and ECLIPSE Pre/Post program, the last directory selected will be theinitial directory used when the user clicks on browse for those programs. By deselectingthis option you can specify the default directory for each program.

Enable local queuing systemThis option enables (if selected) or disables the Eclrun local queuing system. Thequeuing system is built into Simulation Launcher to control the number of instances ofECLRUN that are running at the same time (see Launching a Simulation (p.4) for moredetails). This is not related to the Local Queue mechanism implemented in ECLRUN (see


Settings 15

the ECLRUN User Guide for more details). If the local queuing system is enabled then thenumber of instances of ECLRUN that are launched at once can be modified by the Numberof instances of ECLRUN running concurrently numeric box. The minimumsetting is 1 and the maximum is 16 (it defaults to 5).

Default version (ECLDEFVER)Default version of a program to run (only applies to ECLIPSE or INTERSECT relatedapplications, such as Pre/Post, simulators). This value is not verified (it can be potentiallypointing to a non-existent version). This default version is to be used when user leaves'latest' in the 'Select Version' filed on the summary/select window.

5.2 ECLRUN SettingsEnable License Check For Local Windows Simulations

Jobs will only then be executed when all the required resources (licenses/processors) areavailable.TRUE - use license aware scheduling, FALSE - do not use license aware scheduling.

Local Parallel AuthenticationSetting NoAuthentication /LocalHost. Sets Intel MPI to allow local parallel jobs to runwithout first having a to register a password in an encrypted format in the registry.Setting Authentication Required / Multiple Machines requires you to enter a password forrunning locally or on multiple hosts using parallel processing.

Number of Simulation Processes to Run Concurrently (EclNJobs)Currently this is the number of simulations that can be run at once on your local Windowsmachine. It defaults to the real number of CPU cores available (maximum of 4) if it is notenabled. Only enable this option if you want to override the default behavior of ECLRUN(See "Configuration" in the "ECLRUN User Guide").

Intel MPI PathECLRUN automatically detects the installation of the Intel MPI. However, if for somereason ECLRUN cannot detect the path, you can enter the path in this box.

Queue System syntax: server_1:[LSF|CCS],,server_n:[LSF,CCS].If the specified submission server is on the list, ECLRUN ignores the default mechanism ofchoosing the remote queue system. This variable is intended for future expansion. In thisversion of ECLRUN it has no effect, as this version of ECLRUN always uses LSF whensubmitting to a remote queue.

Note: CCS denotes Microsoft HPC.

Enable FloGrid to 'Save And Restore'Enables or disables the 'Save And Restore' option in FloGrid.


Settings 16

Enable HDF Conversion (after each simulation)HDF is a new format of simulation summary file (.h5 file extension). The file is convertedfrom the standard simulation summary file. The conversion step is performed by defaultafter each simulation. The .h5 file is used by Petrel 2011.1 onwards.

5.3 EnginFrame SettingsEnginframe Path

This is the last part of web address of the EnginFrame Web Service which follows the portnumber. Defaults to 'enginframe'.

Enginframe PortThis is the port number under which the EnginFrame Web Service is available on a remoteserver. Defaults to '8080'.

Enginframe use SSLIndicates whether a secured or unsecured connection of the EnginFrame Web service isrequired.

5.4 Queues SettingsName

A name for the queue definition. This will be listed in the drop-down menu of queues whensubmitting a simulation.

ServerThe server address for the machine where the simulation should be submitted. Leaveempty for local runs. Replaces %SERVER% in a command.

Remote QueueQueue for the remote server machine. Replaces %QUEUE% in a command. When this isclicked to populate the drop-down list, it is automatically filled with LSF queue names onlyif valid Server Name, Userid and Password entries are provided and the specified user hasaccess to LSF queues on the server. A queue name can be also typed directly into thefield avoiding auto-detect.

Queue optionsThe contents of this box are passed directly to the queuing system submission command(bsub for LSF, qsub for PBS Pro / Torque and job submit for Microsoft HPC) throughthe --queueparameters ECLRUN command line option. Data typed into this box is notparsed or validated. Queue parameters are defined per queue (they are not sharedbetween queues).

Note: There is no need to type the --queueparameters option explicitly into the field asthis will be added automatically at submission time.


Settings 17

Userid and PasswordReplaces %USERID% and %PASSWORD% in a command. This information is only kept untilSimulation Launcher exits, and you will need to retype the userid and password when youre-run Simulation Launcher.

Note: From 2012.1 onwards, the user's password is not strictly required if the user has setup password-less connections. See Launching a Simulation (p.4) for more details.

Notes: If you tick the check box Use same logon for all servers, you only need to enter the Userid

and Password once. Otherwise, each queue that uses a different server will need the Useridand Password to be entered

The queue name drop-down list is filled in automatically only when pointing to a server with avalid LSF installation and the specified user has access to the queues.

Queue name auto-detection runs every time the 'Remote Queue' drop down list is populated.

5.4.1 Add or Delete a Queue To add a queue, click the Add a new queue button and fill in its details in the boxes on the right

of the dialog. To delete a queue, select it in the list on the left and click the Remove selected queue button.

5.4.2 Set the Default Queue Select the required default queue in the list and click the Default button below the list. The

queue that is selected as default will be used for new simulation runs.


Settings 18

6Configuration File

All the groups and programs in the Launcher pane and settings of the Simulation Launcher arestored in a configuration file.The first time you run Simulation Launcher and exit, the file is created in the folder%USERPROFILE%\Application Data\Schlumberger\Simulation Launcher

If %USERPROFILE% has not been changed on your system, this in practice means that the folder isin one of these locations: Windows XP: C:\Documents and Settings\username\Application Data

\Schlumberger\Simulation Launcher Windows Vista or 7: C:\Users\username\AppData\Roaming\Schlumberger

\Simulation Launcher Or C:\Users\username\AppData\Local\ Schlumberger\Simulation

LauncherThe file is called SimLaunchConfig.xml. To distribute standardized settings you can make acommon version of this file for all users.1. First of all set up the Simulation Launcher correctly for one user.2. Then make a copy of this user's SimLaunchConfig.xml file and distribute it to the

%ALLUSERSPROFILE% of the target machines. The possible locations for %ALLUSERSPROFILE%are (unless the machine's system administrator has changed the defaults): Windows XP: C:\Documents and Settings\All Users\Application Data

\Schlumberger\Simulation Launcher Windows Vista or 7: C:\Users\username\AppData\Roaming\Schlumberger

\Simulation Launcher3. You could also copy the SimLaunchConfig.xml file to a network location which is

accessible to all users. Make this file read-only if you do not want them to be able to edit thefile. This allows you to administer the settings for the Simulation Launcher for all of your users.


Configuration File 19

For example you may want to add or remove queues and this can be done from the network filerather than visiting each user individually.

4. To apply the network configuration file to an end-user from Simulation Launcher Settings(see Simulation launcher settings (p.15)) you can browse to this location, select this file andrestart the Simulation Launcher to apply these settings.

Simulation Launcher can read all three configuration files: user, all user and network. SimulationLauncher merges the configuration files on startup. Any setting of the same name defined in thenetwork file will override those in the All User file, and both will override settings of the same namedefined in the User file.In some cases some settings will be read-only because they exist in network or All User file andcannot be changed. The Diagnostics dialog will display each of the configuration files if they existand also the merged configuration file in memory. This can be useful for support personnel.All settings can be changed using the Simulation Launcher. However, there is one setting you haveto change directly within the xml file to stop users changing the settings:True

Change this setting to False to prevent users changing the settings.

Note: By setting this to False, editing all these features will be disabled. A system administratormay want to do this in the network or All User configuration files to prevent the user customizingthe Simulation Launcher.


Configuration File 20

7Appendix

7.1 Optional Utility ProgramsThere are several utility programs included with the ECLIPSE Suite. For example the RESQML toGSG Converter utility converts data between the RESQML (Reservoir Characterization MarkupLanguage) and GSG (Generic Simulation Grid) formats.The full list of the supported utilities is shown below: $convert Converts formatted / unformatted ECLIPSE output $convertgrid Converts between . GRID and . EGRID formats $expand Merge INCLUDE files into master file $extract Extract subset of data from ECLIPSE output $fill Corner point geometry generation $glkread Checks the contents of a Stratamodel binary . glk file $postp Converts Text file to PostScript $pseudo Pseudo generation $rescueconvert Converts from older versions to RESCUE version 19 format $resqml_gsg_converter Converts between RESQML and GSG formats

7.1.1 Adding and Running Utilities via Simulation LauncherYou can use the Add Program option to add programs and utilities to the Simulation Launcher(see Adding a Program (p.10)).

7.1.2 Running from command lineFor PC systems, it is recommended that the software is launched using the Simulation Launcher. Itis also possible to run the simulators and other programs from the command line using ECLRUN.For information, please refer to the "ECLRUN User Guide".


Appendix 21

It is also possible to run the software by opening a command prompt and running the appropriatescript.It is advisable to call the help file before running a macro for the first time.Syntax: $ [arguments...] where arguments are any of the following: -data directory directory containing data -help displays this information -local use config file in directory -over use master config file -second identifier run identifier -ver version run requested version of

7.1.3 RESQML to GSG ConverterDescriptionThe RESQML to GSG Converter utility exchanges the contents between the two fileformats: .RESQML and .GSG.RESQML (Reservoir Characterization Markup Language) is the exchange format for transferringearth model data between applications in a vendor neutral, open, and simple format fromEnergistics and its RESQML Special Interest Group (RESQML SIG). This release uses Version 1.1of the RESQML standard.GSG (Generic Simulation Grid) is a binary grid format supported by the following simulators:ECLIPSE 100, ECLIPSE 300, FrontSim, and INTERSECT.By using the RESQML to GSG Converter utility, it is easier to access large model data stored inGSG files and modify values in the converted RESQML.The data that are transferred include grid geometry, properties, and non-neighbor connections(NNCs). Well, fault, and horizon data will not be converted. These are not in GSG but are inRESQML.

CharacteristicsThe first release of the RESQML to GSG Converter utility is limited by the functionality offered byV1.1 of RESQML and overlaps the GSG requirements needed for input to ECLIPSE andINTERSECT simulators. This release focuses on: Support for Win64 Support for single reservoir Support for structured grid, but not unstructured grid Support for single poro, dual poro, dual poro dual perm systems Support for Cartesian local grid refinement, but not radial local grid refinement Only SI units are supported in RESQML ECLIPSE reserved names for properties must be used, unrecognized names will not be unit

converted No support for converter in Linux, GSGs produced in by converter is platform independent


Appendix 22

No support for coarsened local grid refinement No support for thermal models

Convert from Simulation LauncherTo add the converter utility for the first time, see Adding a Program (p.10) for more details.To run the converter utility from Simulation Launcher, follow instruction at Launching an SISProgram (p.7).To convert to a RESQML format, a file with the .GSG extension is required. The files"data_gsg.resqml" and "data_gsg.resqml.h5" will be created in the same directory as the"data.GSG" file.When "data.resqml" and "data.resqml.h5" (if Hierarchical Data Format is used) are provided, thefile "data_resqml.gsg" will be created in the same directory as the "data.resqml" and"data.resqml.h5" files. A summary report of the contents of the file "data_resqml.gsg" will bedisplayed.Modifying OptionsTo modify options:1. Right click the RESQML to GSG Converter in the Launcher pane under Utilities group and

choose Properties for modification.2. Modify the Command Line Parameters as needed.Convert RESQML to GSGThe options available are related to converting the units. The default unit in the output GSG isMETRIC. To use convert to other units, modify the Command Line Parameters as to one of thefollowing options: [%FILE%] -f (the output GSG will be in FIELD units) [%FILE%] -l (the output GSG will be in LAB units) [%FILE%] -p (the output GSG will be in PVT_Metric units)Convert GSG to RESQMLThere is only one option available to obtain an XML file. The default is producing a convertedRESQML in HDF5 format. Two files will be created in the default option (.resqml and .resqml.h5)while only .resqml will be produced when adding the x option to Command Line Parameters as:[%FILE%] -x (the output RESQML format)

Alternative Option: Convert from Command LineConvert from "bin" Folder1. Locate the RESQML2GSGConverter program in ECLIPSE or INTERSECT directory, i.e. bin

\pc_x86_64\RESQML2GSGConverter.exe2. Locate the file you wish to convert (with extension .RESQML or .GSG). i.e. path\data.GSG3. Run it from the command line to convert data.GSG.


Appendix 23

cd bin\pc_x86_64

RESQML2GSGConverter.exe path\data.GSG [-x]

RESQML2GSGConverter.exe path\ data.resqml [-f] [-p] [-l]

Convert as "Macro"1. Locate the file you wish to convert (with extension .RESQML or .GSG). i.e. path\data.GSG2. Run it from the command line to convert data.GSG.$resqml_gsg_converter path\data.GSG [-x] $resqml_gsg_converter path\data.resqml [-f] [-p] [-l]


Appendix 24

IndexAAdministration ............................................................... 9Advanced tab ............................................................... 4

CCommand Line Options ................................................ 6Configuration ................................................................ 3Configuration file ........................................................ 19

EECLRUN Settings ....................................................... 16EnginFrame settings .................................................. 17EPP Product Variables ............................................... 11EPP Program ............................................................... 7

FFile ................................................................................ 2

GGroup: Adding .............................................................. 9Group: Renaming ......................................................... 9

LLauncher settings ....................................................... 15

MManual .................................................................... 8, 12Menu Bar ...................................................................... 2Message filter ............................................................... 6

OOther Application ........................................................ 12

PProgram: Adding ........................................................ 10Program: Removing ................................................... 13

Program: Renaming ................................................... 13Properties ............................................................. 1012

QQueue Settings ........................................................... 17

SSettings dialog ............................................................ 15Simulation History .................................................. 6, 14Simulation Launcher ..................................................... 1simulators ..................................................................... 4Simulators .................................................................. 10SIS Application ........................................................... 12SIS Program ................................................................. 7

UUser Interface ............................................................... 1Utility programs .......................................................... 21

WWindow menu ............................................................... 3


25

BookshelfSimulation Launcher User Guide Version 2012.1Table of Contents1 Introduction1.1 Starting Simulation Launcher for the First Time1.2 User Interface1.3 Menu Bar1.3.1 File Pull-down Menu1.3.2 Configuration Pull-down Menu1.3.3 Window Pull-down Menu1.3.4 Help

2 Quick Start Guide2.1 Launching a Simulation2.1.1 Advanced Tab

2.2 Displaying Simulation Results2.2.1 Command Line Options2.2.2 Message Filter

2.3 Launching an ECLIPSE Pre/Post Program2.4 Launching an SIS Program2.5 Launching a Manual

3 Administration Tasks3.1 Adding a Group3.2 Renaming a Group3.3 Removing a group3.4 Adding a Program3.5 Properties for Simulators3.6 Properties for ECLIPSE Pre/Post3.7 Properties for Manuals3.8 Properties for an SIS Application or Other Program3.9 Rename a Program3.10 Remove a Program

4 Simulation History5 Settings5.1 Simulation Launcher Settings5.2 ECLRUN Settings5.3 EnginFrame Settings5.4 Queues Settings5.4.1 Add or Delete a Queue5.4.2 Set the Default Queue

6 Configuration File7 Appendix7.1 Optional Utility Programs7.1.1 Adding and Running Utilities via Simulation Launcher7.1.2 Running from command line7.1.3 RESQML to GSG ConverterDescriptionCharacteristicsConvert from Simulation LauncherModifying OptionsConvert RESQML to GSGConvert GSG to RESQML

Alternative Option: Convert from Command LineConvert from "bin" FolderConvert as "Macro"

Index