MineScape 4.119 Install Guide_ 2009

(1)

MineScape 4.119

Installation and Setup

(2)

Step by Step Flowchart

1. Set up Permissions

2. Install Oracle

Only required if the Geological Database (GDB) module is required. Refer to page 39 to 51.

3. Install Hummingbird Exceed

Refer pages 8 to 14.

4. Install Hummingbird Exceed 3D

5. Configuration of Hummingbird Exceed

6. Create MineScape Directories

Refer page 27.

7. Install Mincom MineScape

8. Set up MineScape Environment Variables

Refer pages 35 and 36.

9. Configure Nutcracker

Refer to pages 37 and 38.

(4)

1 Permissions Set Up

You may need to consult with you Network Administrators to discuss/arrange changes to the user permissions. We have found the Permissions Set Up below is satisfactory for the majority of MineScape installations.

To check/update the permissions:

1. In Windows, go to Start / Control Panel. 2. Open User Accounts

3. If the user name appears in the list: a. Highlight the User. b. Select Properties

(5)

MineScape 4.119 Install guide_ 2009 5 c. In the Properties window, select Other and choose the Administrators group, or the

group for all MineScape Users if it exists.

4. If the user name does not appear in the list: a. Select Add.

b. Enter the User name and Domain (or select using Browse). c. Select Next.

(6)

d. Select Other, and choose the Administrators group, or the group for all MineScape users if it exists

(7)

3 MineScape setup on a server

3.1 Installation and setup of Hummingbird Exceed

For installation and setup of the software package Exceed on a server please use the procedure described in section 4.1 in this manual.

3.2 MineScape Server installation

3.2.1 Prerequisites

Before proceeding with the MineScape installation, ensure that:

 You are installing MineScape on Windows 2000 Server or Windows Server 2003 only.

 You are logged in to the machine as Administrator during installation or that you have Administrator privileges.

 You have a minimum of 40Gb of free disk space (based on data storage requirements).

 You have a minimum of 2Gb of memory (If installing the GDB module, as much memory as technically possible should be made available).

 Network card.

 You have uninstalled all previous versions of MineScape and ensure that all MineScape program files have been deleted (recommended).  The following folders have been created:

 <disc name>:\Temp – for temporary files.

E.g. С:\Temp (in many cases such folder will exist already).  < disc name >:\Projects – for MineScape projects.

E.g. С:\Projects.

 < disc name >:\Minsite – for MineScape setup files. E.g. C:\Minsite.

3.2.2 MineScape Installation

To start MineScape installation, enter the MineScape installation disk and allow the installation to begin.

If the installation does not start up automatically, double click on Setup.exe located in the root of the MineScape installation disc:

(8)

2. Read through the Pre-requisites and press Next:

3. Enter the installation key, supplied with the installation disk. After the key is entered in press Next:

Note: leaving this field blank will automatically initiate a server installation.

(9)

(10)

4. Select the MineScape installation directory. In many cases the default installation directory can be used, in this case press Next. If this directory needs to be changed, press Browse. Press Next when ready:

5. Select the MineScape installation type. Select type Server and press Next:

Note: You will not see this screen if no Installation Key was entered in step 3.

(11)

MineScape 4.119 Install guide_ 2009 11 6. After the installation is complete the MineScape Release Notes will be

displayed. Read and close these at your leisure.

Complete the installation by selecting Finish on the Installation Complete screen: The installation will require a restart.

(12)

4 MineScape installation on a work station

4.1 Installation and setup of Hummingbird Exceed

MineScape requires third party Windows emulations software to be installed on any machine where the MineScape application is to be open. Exceed is the supported software for use with MineScape.

4.1.1 Exceed installation

To install Exceed

1. Enter the Exceed Installation disk and allow the start-up to begin.

If the Exceed installation screen does not appear, locate and run Msetup.exe on the installation disc/directory.

The following menu will open. 2. Select Install Exceed.

(13)

MineScape 4.119 Install guide_ 2009 13 4. The installation language selection window will open. Select the

appropriate language and Press ОК.

5. The Exceed installation wizard will start. Press Next.

(14)

7. Enter the User Name and Organization name. Leave selected Anyone

who uses this computer. Press Next.

8. Check the Exceed installation directory. If necessary change it using the button Change. Press Next when ready.

(15)

MineScape 4.119 Install guide_ 2009 15 9. Select Shared User Directory and press Next.

(16)

11. Select Run Exceed X server during installation and press Next.

12. Press Install.

(17)

MineScape 4.119 Install guide_ 2009 17 14. To complete the installation, the PC must be rebooted. Press Yes on the

reboot screen.

4.1.2 Exceed 3D installation

To install Exceed

1. Enter the Exceed Installation disk and allow the start-up to begin. If the Exceed installation screen does not appear, locate and run Msetup.exe on the installation disc/directory.

The following menu will open. 2. Select Install Exceed 3D:

(18)

3. Select Personal installation:

4. The installation language selection window will open. Select the appropriate language and press ОК.

(19)

MineScape 4.119 Install guide_ 2009 19 6. Select I accept the terms in the License Agreement and press Next:

(20)

8. Select Typical and press Next:

9. Leave the Cache options as they are defaulted. Press Next.

(21)

MineScape 4.119 Install guide_ 2009 21 11. The installation may take some time. After it is complete, press Finish.

(22)

4.1.3 Exceed setup after installation

4.1.3.1 General settings

a. Start Exceed

Exceed settings panel will open:

b. Right mouse click on Exceed icon on the taskbar. Select Tools from the menu and then Hide main icon in the submenu:

(23)

MineScape 4.119 Install guide_ 2009 23 After this the Exceed icon can be found in lower bottom corner in system tray. Right mouse click on the icon enables the Exceed settings menu.

Note: Exceed settings panel, which opened after the Exceed first start, can be closed after this step.

c. Right mouse click on Exceed in sys tray. In the menu select Tools >>

(24)

X Server settings menu opens. All the following steps for Exceed set-up will be done in this window:

d. Select Exceed 3D and GLX. Ensure, all items are selected, except

Overlay Support:

To save the changes and return to the main menu press in the upper tool bar.

e. Select Display and Video from the main menu. On tab Screen 0 ensure the radio button Fit Window to Display is selected:

(25)

MineScape 4.119 Install guide_ 2009 25 On tab Common Settings deselect the item Close Warning on Exit:

On tab Advanced Settings select following item.

(26)

f. In the main menu select Other Server Settings. On tab Performance select Save Unders and SaveBits.

To save the changes and return to main menu press .

(27)

MineScape 4.119 Install guide_ 2009 27  Click the Macro Bindings button

 Next to the Wheel Up/Down section under the Assigned Wheel macros, click the button with three dots on it to select a macro.  Select Add a new macro

 Name the macro WheelUp. Select Start record, push the “i”, and then select Stop record.

 Repeat this step to create a macro named WheelDown using the “o” button instead.

Ok to allocate the wheel Up and wheel Down movements to the macros just created.

(28)

Press OK and return to main menu press .

Select C:\ProgramFiles\Mincom\MineScape4.118\MinApps\environ\gti.cfg, open the gti.cfg file with a text editor such as text pad or WordPad and add the following text below the current list of key mappings.

'~Alt ~Meta <Key>osfPageUp : gtiScale(1.1)' '~Alt ~Meta <Key>osfPageDown : gtiScale(0.9)'

It may be easier to copy two existing key mapping text lines and modify these to keep the correct format.

(29)

MineScape 4.119 Install guide_ 2009 29 Save the gti file and re-open MineScape and test it if it works.

h. Close the Х Server settings window by selecting File >> Exit.

Note: Exceed session will continue. Access to Exceed can be obtained right mouse click on Exceed icon in the sys tray and selecting the needed menu item.

(30)

4.2 MineScape installation

4.2.1 Create Directories

Before installation of MineScape the following folders must be created:  <disc name>:\Temp – for temporary files. E.g. С:\Temp (in many

cases such folder will exist already).

 < disc name >:\Projects – for MineScape projects. E.g. С:\Projects.  < disc name >:\Minsite – for MineScape setup files. E.g. C:\Minsite.

4.2.2 MineScape installation

To start MineScape installation, double click on Setup.exe on the MineScape installation disc or directory and then follow the steps below:

(31)

MineScape 4.119 Install guide_ 2009 31 2. Press Next:

(32)

4. On the next screen select the MineScape installation directory. In many cases the default installation directory can be used, in this case press Next. If this directory needs to be changed, press Browse. After finish press Next:

5. On next screen the MineScape installation type must be selected. Select type Custom and press Next.

(33)

MineScape 4.119 Install guide_ 2009 33 7. In the next window you need to select the name for MineScape in

Windows program list. In most cases you can use the default name and press Next. Otherwise change the name in Program Folders and press Next:

(34)

8. Select the MineScape temporary files folder created in step 5. If needed, change it using Browse button. Press Next.

9. On the next screen select the MineScape projects directory, which was created during 5. If needed, edit it using Browse button. Press Next:

(35)

MineScape 4.119 Install guide_ 2009 35 10. Select Oracle report storage folder. In most cases the default location

will be used. To use it just press Next:

11. Select the used version of Oracle. Version 9i is recommended even if Oracle won’t be used. Then press Next.

(36)

Press Next

Press Next to install.

12. After the installation is complete, the following Nutcracker message may be displayed.

(37)

MineScape 4.119 Install guide_ 2009 37 13. Press Next to continue

(38)

15. Press Next to continue

(39)

MineScape 4.119 Install guide_ 2009 39 17. Press Install to start the installation

(40)

The following window appears and the Release Notes are displayed Press OK to close the message

(41)

MineScape 4.119 Install guide_ 2009 41 Select Yes and Finish

(42)

4.2.3 Environment variables settings

MineScape needs some environment variables to be set up. Part of them will be created during the MineScape installation. Part needs to be created manually.

Right mouse click on My Computer and select Properties from the menu:

(43)

MineScape 4.119 Install guide_ 2009 43 You need the System Variables list (the lower):

Following variables need to be here:

 MIN_ROOT=<drive name>:\Projects (e.g. C:\projects)  MIN_SITE=< drive name >:\Minsite

 MIN_TMP=< drive name >:\Temp (e.g. C:\temp)

If any of these variables is missing, than create it. Pres New. Type in the

Variable name and Variable value, where multiple values can be separated

by sign ‘;’. Press ОК. E.g.:

If you need to change the variable, select one by clicking on it with mouse and press Edit. Edit it and press ОК to save the changes.

(44)

4.3 NutCracker settings

1. Open Windows Control Panel. Start >> Settings>> Control Panel (Windows XP Start >> Control Panel) and select configure MKS Toolkit:

.

2. Select tab Runtime Settings. In field Category select XWindow System Settings from the list.

3. On panel XServer Settings select the option Other. Press Browse next to

Program and select the path to C:\Program Files\Hummingbird\Connectivity\12.00\Exceed\exceed.exe. Ensure the Use Network Connection box is checked:

(45)

MineScape 4.119 Install guide_ 2009 45 Press ОК to save the changes and close the window.

(46)

5 ORACLE installation for the geological database GDB

5.1 Oracle Database installation and settings

5.1.1 Oracle Database installation

Oracle 9i Enterprise edition consists of three discs. During the installation following requests will be displayed:

Insert the requested disc in drive and press ОК.

1. To install Oracle Database insert first disc Oracle 9i Enterprise Edition in the drive. The installation menu appears on screen. Select Install/Deinstall Products:

(47)

MineScape 4.119 Install guide_ 2009 47 2. Following form will open:

If Oracle was installed on the machine already, by pressing Installed Products you can check which product and version is it. (If you want to change any installed product, you don’t need to uninstall it first. By pressing Next, the installation program will do the change). Press Next.

3. On the next screen select the Oracle distribution location and folder Oracle_Home, where the main Oracle files will be stored. In most cases you can use the default locations. In this case press Next. Otherwise change the locations and press Next.

(48)

4. Select the option Oracle 9i Database 9.2.0.1.0. Press Next.

5. Select the option Enterprise Edition for Server installation

6. Select the option Personal Edition for workstation installation. Press Next.

7. Select the option General Purpose and press Next.

8. Press Next.

9. On following screen the default database name for the installation must be entered.. In field Global Database Name type the name. TEMPLATE as the database name. Don’t change the SID field. Press

(49)

MineScape 4.119 Install guide_ 2009 49 10. The folder name for the database data files must be supplied. To use the

default path press Next. Otherwise change it using Browse and then press Next.

(50)

11. On next screen the languages used in the database must be specified. Select the option Choose one of the common character sets. From the list select Default. Press Next.

12. Following windows shows the list of products, which will be installed or uninstalled. If everything is OK, so press Install, to start the installation:

(51)

MineScape 4.119 Install guide_ 2009 51 After installation, Oracle would conduct some test automatically. It is recommended that these test to run successfully.

(52)

(53)

5.1.2 Oracle Database settings

5.1.2.1 GDB Environment variables set up ORACLE_HOME = D:\oracle\ora92

Nb: the value must be the same as the path for main Oracle files storage you entered during the installation

.

The procedure for viewing, editing and creation of system variables is described in section.2.2.3.

PATH

Ensure this includes $ORACLE_HOME/bin

Check Perl:

Go to a cmd window and type perl, if nothing happens, then this is good. If there are error messages, then append: To the environment variable PATH

D:\oracle\ora92\Apache\perl\5.00503\bin\MSWin32-x86

Example PATH variable:

%SystemRoot%\system32;%SystemRoot%;C:\Oracle\Ora92\bin;C:\Program

Files\Oracle\jre\1.1.8\bin;%ORACLE_REPORT_HOME%\Bin;C:\Oracle\Ora92\Apache\perl\5.00503\ bin\MSWin32-x86

MIN_TMP

C:\Temp or C:\Tmp if Temp directory already exists on computer. MIN_ORADATA

D:\oracle\oradata

Nb: this is the storage location for the database control files.

TNS_ADMIN

D:\oracle\ora92\network\admin

(54)

5.1.2.2 ORACLE sqlnet.ora and tnsnames.ora files

Find file sqlnet.ora in folder ORACLE_HOME\network\admin, where ORACLE_HOME is the value of system variable ORACLE_HOME. So if you used ORACLE_HOME as described above, file sqlnet.ora will be located in folder C:\oracle\ora92\network\admin. Open this text file for editing. Right click on this file and select Open>Select the program from the list and from the offered programs select Wordpad. Uncheck the box Always use the selected program to

open this kind of file and press ОК.

In the text editor add the following line:

NAMES.DEFAULT_DOMAIN = world

Save the changes using menu File>> Save: example of sqlnet.ora

# SQLNET.ORA Network Configuration File: D:\oracle\ora92\network\admin\sqlnet.ora # Generated by Oracle configuration tools.

SQLNET.AUTHENTICATION_SERVICES= (NTS)

NAMES.DIRECTORY_PATH= (TNSNAMES, ONAMES, HOSTNAME) NAMES.DEFAULT_DOMAIN=world

The tnsnames.ora file contains an entry for each database that needs to be accessed by GDB. It must exist locally on every workstation that is using GDB. The file is updated automatically when a database is created. If a database is created on the server, the new tns file is accessed by having the TNS_ADMIN environment variable pointing to the server.

(55)

MineScape 4.119 Install guide_ 2009 55 example of tnsnames.ora

# TNSNAMES.ORA Network Configuration File: D:\oracle\ora92\network\admin\tnsnames.ora # Generated by Oracle configuration tools. TEMPLATE =

(DESCRIPTION = (ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = A020326)(PORT = 1521)) ) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = TEMPLATE) ) ) INST1_HTTP = (DESCRIPTION = (ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = A020326)(PORT = 1521)) ) (CONNECT_DATA = (SERVER = SHARED) (SERVICE_NAME = MODOSE) (PRESENTATION = http://HRService) ) ) EXTPROC_CONNECTION_DATA = (DESCRIPTION = (ADDRESS_LIST =

(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC0)) ) (CONNECT_DATA = (SID = PLSExtProc) (PRESENTATION = RO) ) ) eh2007.world = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP) (HOST = A020326) (PORT = 1521) ) (CONNECT_DATA = (SID = eh2007) ) )

(56)

5.1.2.3 ORA_DBA Group

When Oracle is installed the ORA_DBA group is automatically added on the local computer. This can be accessed via My Computer (right click) manage.

(57)

MineScape 4.119 Install guide_ 2009 57 Anyone who needs to have administrative access to the database via the Administration menu in GDB must be added to this group on the local workstation they are working from.

The Administration menu of GDB allows for database creation and backup (export) or restoration (import).

(58)

5.1.2.4 Oracle Uninstall Steps Steps to uninstall Oracle:

1. Uninstall all Oracle components using Oracle Universal Installer CD. 2. Stop all oracle services

3. Clean up environment variables

4. Run regedit.exe through CMD window and delete all registry entries for all Oracle products. In HKEY_LOCAL_MACHINE/SOFTWARE/ORACLE keys,

HKEY_LOCAL_MACHINE/SYSTEM/CONTROL SET 001/002/003/ENUM/ROOT. Find all possible oracle registry keys and delete them. Be careful, if you make any mistakes they can be quite destructive.

5. Reboot your machine

6. Delete “C:\Oracle” directory or whatever is your ORACLE_HOME 7. Delete “C:\Program files\Oracle” directory

8. Empty the contents in “C:\temp” directory 9. Empty recycle bin.