Petra.ini

  

The Petra.ini initialization file controls installation-wide settings like notifications and licensing as well as important administrative functions, including controlling who can delete wells or change map projections.

This file isn't created automatically, so it's necessary to either create it from scratch or copy the sample Petra.INI located in the PetraSRV\PARMS folder.  To affect a single project, save Petra.ini inside a projects root directory.  To affect every project used on a Petra installation, save Petra.ini to the Petra installation directory.

[GENERAL]

The General section sets a few system-wide options on how Petra interacts with external programs and services.

AllowRememberLogin

– This option sets whether Petra provides an option to remember the last user logon.  Setting this option to NO disables caching the user name and password.

ShowWebsite

– By default, Petra has a link to the download website built into the Help dropdown on the top of the Main Module.  Setting this option to NO disables this link.

Notify

– Setting this option to YES hides the license expiration notice shown during startup.

MJDelaySec

– This option sets the length of time (in seconds) that Petra waits and retries to receive direct connect raster logs from MJ LogSleuth

AdminPswd

– This option sets a password on the entire project.  Only users with the password can open the project.

LICUncNames

– Setting this option to “YES” forces Petra to use UNC (Universal Naming Convention) paths rather than LFS (Local File System) when working with log or map images. UNC syntax describes network paths with double slashes and names (such as \\ComputerName\SharedFolder\Resource), while LFS syntax uses drive letters.

UserApplName

– Petra can launch an external application and pass the selected well UWI to it.  This option sets how the application’s name appears in Petra's menu.  Note that this entry has a maximum of 30 characters.  This option can be overridden by a client’s geoplus.ini file.

UserApplPath

- This option sets the path and filename of the external application.  This option can be overridden by a client’s geoplus.ini file.

BingMap

– This option overrides the default URL for Bing maps available on the Location tab of the Main Module.  The default is http://www.bing.com/maps/

Bing_WGS84_DatumShift

– Bing’s maps use the WGS84 reference datum.  By default, Petra recalculates the LatLons from the project reference datum into WGS84 before it sends the LatLon to Google maps.  Setting this option to NO forces Petra to send the raw LatLons directly from the project.

SaveDefaultProjection

– Setting this option to YES prevents any user from creating a system-wide default map projection file.  Note that these files are kept in the system parms folder as DefProjection.BIN or DefProjection1.BIN.

AllowUserProjection

– Setting this option to NO prevents users from creating user-defined coordinate systems under the Standard. Coordinate System tab in the Map Projection Settings window.

BkgndScan

– Setting this option toYES will tell Petra to scan every project's well locations to compute the LatLon extents.  These limits are stored in each project's INI file.

BkgndScanTime –

This option sets the amount of time (in minutes) Petra waits between project extent scans.  By default, Petra waits 30 minutes.

SkipUpdateCheck

– By default, Petra checks for newer versions at every startup.  Setting this option to YES skips this check.

AllowPrivateMode

- Setting this option to "YES" will allow users to run Private Mode locally.  Setting this option to "NO" will disallow private mode.

HideLoginDialog=YES/NO

- Setting this option to "YES" will attempt to hide the Login screen when possible, such as when the "Remember My Password" option is selected or when using Active Directory.  Note that the login screen will still appear when Petra needs a username and password.
Example

[GENERAL]

SHOWWEBSITE=NO Prevents users from using link to www.geoplus.com WEB Site

; NOTIFY=NO Turns off Maintenance Expiration message

; MJDELAYSEC=15 – Sets Petra’s delay for MJ LogSleuth

; ADMINPSWD=SFTY3RD – Sets an administrative password for the project

; LICUNCNAMES=YES - Used to allow UNC names for LIC files.

USERAPPLNAME=Company Document Manager

USERAPPLPATH=\\geoapps\welldocs\software\mgr.exe

; MODIFYPLACESBAR=NO

; BINGMAP= http://maps.bing.com/maps

; BINGLE_WGS84_DatumShift=NO

; SaveDefaultProjection=NO

; AllowUserProjection=NO

; BKGNDSCAN=YES

; BKGNDSCANTIME=30

; SKIPUPDATECHECK=YES

[USERSOURCE]

By default, Petra treats all users in a project equally.  All users have the power to delete or change all data and to change map projections in short, all users have the power to irreparably destroy a project.   The UserSource section creates a system of user source codes that effectively limits what an individual can do.  Only administrators can delete wells, change the reference datum or coordinate system, globally delete data, or modify any tops other than their own.

To change user names while inside a project, select Main: Project > Settings > Set User Source Code… and enter the appropriate user name.  

Enabled

– This option enables administrators and regular users.  Set this to 2 to enable administrators.

Blanks

– This option controls how formation tops with blank source codes are handled.  When this option is set to 0, all users can modify a top with a blank source code.  When this option is instead set to 1, only administrators can modify a top with a blank source code.

Adminlist

– This line sets the user source codes for administrators.  Administrative users should be separated by commas with no spaces.  In the example below, “tdw,bob,hlm” sets three users as administrators: tdw, bob, and  hlm.  
Example

[USERSOURCE]

; BLANKS=0 - everyone can modify a top if it has a blank source code

; BLANKS=1 - no one can modify a top if it has a blank source code unless

; they are a member of the ADMINLIST

;

ENABLED=1

BLANKS=1

ADMINLIST=tdw,bob,hlm

[LOGARC]

This section onfigures how Petra retrieves logs with LogTech software.

Program –Normally, Petra uses the user registry to find the LOGARC retrieve executable.  This option overrides the pathway for the LOGarcve.exe

Example[LOGARC]

PROGRAM=\\geoapps\LOGARC\LOGarcve.exe

General Notice Settings

[NOTICE]

Petra can display a couple of different kinds of notices.  The broadcast notice displays for a few seconds when Petra first starts up, while the kill notice warns users for a few seconds before Petra forcibly shuts down.

NotifyKill

Though most of the formatting like text size and color is controlled by the actual document, Petra.INI has a few additional settings that change how the kill notification works.

  • KillWaitSec—Sets the number of seconds the kill notice will display before closing Petra.  
  • KillSound1—Sets the filename and pathway of the sound file that plays when the notice first appears.
  • KillSound2—Sets the filename and pathway of the sound file that plays once per second while the kill notice is counting down.
  • KillSound3—Sets the filename and pathway of the sound file that plays when the kill notice closes and forcibly shuts down Petra.
  • Backcolor—Sets the RGB values for both the kill notice and the broadcast notice background.  By default, this option is set to 255, 255, 255 for white.  In the example below, the values for other colors are added as comments.

User Broadcast Notice

Though most of the formatting like text size and color is controlled by the actual document, Petra.INI has a few additional settings that change how the broadcast notification works.

  • UBCWaitSec—Sets the length of the notice in seconds.  Users can close the notice at any time with the Close button on the bottom of the notice.
  • SoundFile—Adds a sound file that plays whenever the notification opens.  Set the path and file name of the wave file, or just the name of the wave file if it's in the installation directory.
Example

[NOTICE]

;SOUNDFILE=<wave file>

UBCWAITSEC=30

 

KILLSOUND1=<wave file> Sound file to play when notice appears

KILLSOUND2=<wave file> Sound file to play once per second

KILLSOUND3=<wave file> Sound file to play when removing notice

KILLWAITSEC=30         Seconds to display user notice before closing

 

BACKCOLOR=255,255,255    

; BACKCOLOR=250,0,0      Red

; BACKCOLOR=250,40,70    Pink

; BACKCOLOR=0,255,0      Green

; BACKCOLOR=0,0,255      Blue

; BACKCOLOR=255,255,0    Yellow

; BACKCOLOR=40,135,250   Light blue

; BACKCOLOR=212,212,212  Light Grey

; BACKCOLOR=255,255,255  White

[NETLOGIN]

The Netlogin section controls FlexLM licensing and stores a record of users entering and exiting Petra projects.

FlexLM

FlexLM

Set this option to YES to enable a FlexLM license.

FlexLMLicPath

– This option sets the FlexLM port and machine hostname.

FlexLMDataLic

– This option enables Petra "data access" licenses for data transfer. By default, data transfer occupies a Petra license.

Project Access Log

The project access log keeps a record of users logging into and out of the projects used on the specific Petra installation.   This file is ordered bottom to top, with the most recent activity at the beginning of the file and the oldest activity at the bottom.

  Note that this file can be easily cut and archived - Petra will create a new "LogFileName" the next time someone logs in or out of Petra.

Example

Larry Harvey,8/28/2006 5:22:52 PM,Closed:

c:\geoplus1\projects\SoonerDemo

Larry Harvey,9/5/2006 3:43:02 PM,Opened:

c:\geoplus1\projects\SoonerDemo

LogProjectAccess Turns on the logging feature.  Set this option to YES, and establish a valid file pathway with the LogProjectAccess option to start logging.

LogFileName Sets the pathway for the Note all users must have read/write access to this log file.

Example

[NETLOGIN]

;------------------------------------------------------

; to enable network flexlm licensing use the following

; two keywords. Needed is the Port and machine hostname

; where flexlm is running.

;

FLEXLM=ENABLED

FLEXLMLICPATH=27000@petraserver

FLEXLMDATALIC=YES

 

;-----------------------------------------------------

; ****LOGIN LOG FILE****

; Network version login monitoring log file. This file

; will contain date-time stamp of each time a user

; acquires or is denied a Petra network license.

;-----------------------------------------------------

; uncomment and put path to common location that

; all users have read/write access to

;

LogFileName=\\server1\petrasrv\petralogin.txt

;

; set LogProjectAccess=YES to have the user's project name added to

; the login file to track opening and closing Petra projects LogProjectAccess=YES

[IMPORT]

LASPath

Sets the default folder path for importing LAS files.

RasterPath

Sets the default folder path for importing raster logs and calibration files.

[IHS (US) raster logs]

IHSLogNDXRootFolder

Sets the path of the folder containing the LIC and TIF files.  

IHSLogNDXDBFolder

Sets the path of the folder containing the IHS catalog database files (tblLogs.dat and tblLogs.idx)

[LICCat.exe]

LicCatalog

Sets the path and name of the catalog database file (DBIsamdatabase with no extension) created by LICCat.exe. This catalog can be used for batch import of LIC files.
Example

[IMPORT]

LASPATH=

RASTERPATH=

IHSLOGNDXROOTFOLDER= H:\LOGDATA

IHSLOGNDXDBFOLDER=H:\LOGDATA\IHS_ENERGY\Rock Mountains\database\

LICCATALOG=

[MAPTEXT]

The MapText section sets a message that is printed at the bottom of every Petra-produced map.  This can be useful for displaying a copyright or disclaimer.

TextHt

– This option sets height of the text.  Petra uses 0.065 inches by default, which works out to be about a 5 point font.
Position

– This sets the relative position of the text along the bottom of the map.  This option accepts LEFT, CENTER, RIGHT. by default, Petra uses “CENTER.
Line X

– This option sets the actual text and can actually set several lines (e.g. Line1, Line2, Line3…)
Example

[MAPTEXT]

TEXTHT=.1

POSITION=LEFT

LINE1=Property of XYZ Energy

LINE2=Copyright 2011

LINE3=All Rights Reserved

[ENERDEQ]

The ENERDEQ section controls how Petra accesses the US part of IHS Direct Connect.  These parameters are usually only needed for intranet installs of the data server or if your company has a proprietary version of the IHS database.

URL

– This option sets the URL of the IHS Web Services server.

WELL_IMPORT_XML_TIMEOUT_SECS

Amount of time to wait for xml file to be downloaded in seconds

WELL_IMPORT_RETRIES

After initial download failure, how many times to retry

WELL_IMPORT_RETRY_DELAY_SECS

How long to wait between retry attempts in seconds

RASTER_IMPORT_XML_TIMEOUT_SECS

Amount of time to wait for xml file to be downloaded in seconds

RASTER_IMPORT_RETRIES

After initial download failure, how many times to retry

RASTER_IMPORT_RETRY_DELAY_SECS

How long to wait between retry attempts in seconds
Example

[ENERDEQ]

url=https://webservices1-2.ihsenergy.com/WebServices

WELL_IMPORT_XML_TIMEOUT_SECS=900

WELL_IMPORT_RETRIES=10

WELL_IMPORT_RETRY_DELAY_SECS=60

RASTER_IMPORT_XML_TIMEOUT_SECS=300

RASTER_IMPORT_RETRIES=5

RASTER_IMPORT_RETRY_DELAY_SECS=60

[IHSCAN]

The IHSCAN section controls how Petra accesses the Canadian part of IHS Direct Connect.  These parameters are usually only needed for intranet installs of the data server or if your company has a proprietary version of the IHS databases.

  • For NAD27 projects, when HIST22=NO (or is blank) Petra downloads the most recent well locations based on the ATS2.6 grid for Alberta, the BC2.0 grid for British Columbia, the MLI07 grid for Manitoba, and the STS25 grid for Saskatchewan. Setting HIST22=YES will force Petra to download historical well locations based on the ATS2.2 grid.
  • For NAD83 projects, well locations are only available in BCTS20 for British Columbia, MST0305 for Alberta, MTS10 for Manitoba and STS25 for Saskatchewan. Setting HIST22=YES does not apply for projects in NAD83.

WELLSERVER

Sets the URL of the Canadian IHS Web Services server.

WELLPORT

Sets the port address of the Canadian IHS well data server.

SERVER

Sets the server address of the Canadian IHS well data server.

PORT

Sets the port address of the Canadian IHS well data server.

HIST22

Canadian well locations can have slightly different locations based on different versions of the Alberta Township System (for example, ATS2.6 vs ATS2.2).  By default, Direct Connect uses the most up-to-date grid.  This option instead requests well locations (when available) based on the older AST2.2 grid.  

The HIST22 setting will be reported at the top of all log files for Canadian Direct Connect well data downloads.

Example

[IHSCAN]

;SERVER=petra.ihsenergy.com

;PORT=5557

;WELLSERVER=petra.ihsenergy.com

;WELLPORT=555

;CANADACHGDATE=YES

[WMS]

The WMS section creates a predefined list of WMS servers.  Petra can store multiple server names, usernames, passwords, and descriptions in different “groups.Each group is separated by a numerical suffix at the end of each option (shown as a# in the descriptions below).  Put another way, for each different WMS server url, username, password, and description, put a different number at the end of the option.   These numerical suffixes don't need to be consecutive, in order, or start at 1; they just need to be different for different servers.  

URL#

Sets the URL address of the WMS server.

Description#

Creates a description of the server.  This description can be up to 256 characters.

User#

Sets the username for the WMS server.  Many servers don’t require a username or password authentication.  When working with these servers, leave the user name and password blank.

Password#

Sets the password for the specified username for the WMS server.  Many servers don't require a username or password authentication.  When working with these servers leave the user name and password blank.  

ConnectTimeout

Sets a timeout in msec when connecting to WMS service.
Example

[WMS]

url1= http://130.88.200.176/ecwp/ecw_wms.dll?request=GetCapabilities&service=wms

user1=RFROST                

password1=SFTY3RD

description1=Image Web Server

url2= http://198.96.62.209/wms/cascader?REQUEST=getCapabilities&service=wms

description2=Fusion

ConnectTimeout=5000

[DEFAULT]

The DEFAULT section sets company-wide settings to control Petra Map Module default settings.  It's sometimes necessary to reset the Map Module (Main: Project > Settings > ResetModule before these options take effect in existing projects.

Map_DirSurvEnable

– This option sets the default for how directional wells are displayed in the Map Module.  Setting this option to “TRUE” turns on directional wells, while FALSE turns off directional wells.

An individual user can always change their specific setting with Map: Wells > Directional Survey > Enable

Map_OvlyAutoSaveMins

– This option sets the default length of time in minutes between when Petra automatically saves the overlay file.

Map_OvlyAutoSaveLvls

– This option sets the total number of backup autosaved overlays.

Map_GridDir

Sets the pathway to a default grid folder.
Example

[DEFAULT]

MAP_DIRSURVENABLE=FALSE

MAP_OVLYAUTOSAVEMINS=60

MAP_OVLYAUTOSAVELVLS=1

MAP_GRIDDIR=c:\geoplus1\datanewgrid

[HTTP]

The HTTP section allows an administrator to set company-wide settings for accessing the internet.  These parameters are not required to be entered.

ConnectTimeout

Sets an optional timeout when connecting.  The default is 60,000 msec.

SendTimeout

Sets an optional timeout when sending request.   The default is 30,000. msec.

ReceiveTimeout

Sets an optional timeout when receiving response.  Default is 30,000 msec.
Example

[HTTP]

ConnectTimeout=120000

SendTimeout=60000

ReceiveTimeout=60000