MineScape 4.119 Install Guide - 2009

MineScape 4.
119
Installation and Setup
September 2009
Mincom Limited Pty Ltd
All rights reserved
Step By Step Manual

Exceed, MineScape and Oracle
Contents
1
Step by Step Flowchart..................................................................................................3

1. Set up Permissions....................................................................................................3
2. Install Oracle.............................................................................................................. 3
3. Install Hummingbird Exceed......................................................................................3
4. Install Hummingbird Exceed 3D.................................................................................3
5. Configuration of Hummingbird Exceed......................................................................3
6. Create MineScape Directories...................................................................................3
7. Install Mincom MineScape.........................................................................................3
8. Set up MineScape Environment Variables.................................................................3
9. Configure Nutcracker.................................................................................................3
10.
Test........................................................................................................................ 3
Permissions Set Up........................................................................................................4
MineScape setup on a server.........................................................................................7

3.1
Installation and setup of Hummingbird Exceed..........................................................7
3.2
MineScape installation...............................................................................................7
3.2.1
Prerequisites.......................................................................................................7
3.2.2
MineScape Installation........................................................................................7
MineScape installation on a work station...................................................................10

4.1
Installation and setup of Hummingbird Exceed........................................................10
4.1.1
Exceed installation............................................................................................10
4.1.2
Exceed 3D installation......................................................................................18
4.1.3
Exceed setup after installation..........................................................................23
4.1.3.1 General settings...............................................................................................23
4.2
MineScape installation.............................................................................................31
4.2.1
Create Directories.............................................................................................31
4.2.2
MineScape installation......................................................................................31
4.2.3
Environment variables settings.........................................................................43
4.3
NutCracker settings.................................................................................................45
ORACLE installation for the geological database GDB.............................................47

5.1
Oracle Database installation and settings................................................................47
5.1.1
Oracle Database installation.............................................................................47
5.1.2
Oracle Database settings.................................................................................54
5.1.2.1 GDB Environment variables set up...................................................................54
5.1.2.2 ORACLE sqlnet.ora and tnsnames.ora files.....................................................55
5.1.2.3 ORA_DBA Group..............................................................................................57
5.1.2.4 Oracle Uninstall Steps......................................................................................59
Step By Step Manual

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.
10.
Test
328340851.doc
Step By Step Manual

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
Step By Step Manual

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.
328340851.doc
Step By Step Manual

d. Select Other, and choose the Administrators group, or the group for all MineScape
users if it exists
Note: If you require Oracle, User name should also appear as a part of ORA_DBA group
Step By Step Manual

3 MineScape setup on a server

1.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.
1.2
MineScape Server installation
1.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.
1.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:
1. On the Welcome screen press Next:
328340851.doc
Step By Step Manual

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.
8
Step By Step Manual

328340851.doc
Step By Step Manual

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.
10
Step By Step Manual

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.
5.
328340851.doc
11
Step By Step Manual

2 MineScape installation on a work station

2.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.
2.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.
Error: Reference source not found
3. Select Personal installation.
4. The installation language selection window will open. Select the
appropriate language and Press .
5. The Exceed installation wizard will start. Press Next.
6. Select I accept the terms in the License Agreement and press Next.
12
Step By Step Manual

7. Enter the User Name and Organization name. Leave selected Anyone
who uses this computer. Press Next.
Error:
Reference
source
not
found
8. Check the Exceed installation directory. If necessary change it using the
button Change. Press Next when ready.
328340851.doc
13
Step By Step Manual

9. Select Shared User Directory and press Next.

10. Select Typical setup and press Next.
14
Step By Step Manual

11. Select Run Exceed X server during installation and press Next.
12. Press Install.
13. The installation may take some times.. After it is complete press Finish.
14. To complete the installation, the PC must be rebooted. Press Yes on the
reboot screen.
2.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:
328340851.doc
15
Step By Step Manual

3. Select Personal installation:

4. The installation language selection window will open. Select the
appropriate language and press .
5. The Exceed 3D installation wizard will start when you press Next.
16
Step By Step Manual

6. Select I accept the terms in the License Agreement and press Next:
Error:
Reference
source
not
found
7. Enter the User Name and Organization information. Press Next:
Error:
Reference
source
not
328340851.doc
found
17
Step By Step Manual

8. Select Typical and press Next:

9. Leave the Cache options as they are defaulted. Press Next.
10. Press Install.
11. The installation may take some time. After it is complete, press Finish.
Press Yes to reboot the machine when ready.
18
Step By Step Manual

2.1.3 Exceed setup after installation

2.1.3.1
General settings
a. Start Exceed
Exceed settings panel will open:
Error:
Reference
source
not
found
b. Right mouse click on Exceed icon on the taskbar. Select Tools from the
menu and then Hide main icon in the submenu:
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 >>
Configuration
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:
Error:
Reference
source
not
To save the changes and return to the main menu press

tool bar.
328340851.doc
found
in the upper
19
Step By Step Manual

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

On tab Common Settings deselect the item Close Warning on Exit:
On tab Advanced Settings select following item.
Error: Reference source not foundTo save the changes and return to main
menu press
again.
f.
In the main menu select Other Server Settings.

On tab Performance select Save Unders and SaveBits.
Error: Reference source not foundTo save the changes and return to main
menu press
g. Select Mouse Keyboard and other input devices in the main menu.
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.
20
Step By Step Manual


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
'~Alt ~Meta <Key>osfPageDown
: gtiScale(1.1)'
: gtiScale(0.9)'
It may be easier to copy two existing key mapping text lines and modify
these to keep the correct format.
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.
328340851.doc
21
Step By Step Manual

2.2
MineScape installation
2.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.
2.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:
1. Press Next:
22
Step By Step Manual

2. Press Next:
3. Enter the licence key provided by Mincom. After it press Next:
328340851.doc
23
Step By Step Manual

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.
24
Step By Step Manual

6. Select the modules (check the boxes) you want to install and press Next:
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:
328340851.doc
25
Step By Step Manual

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:
26
Step By Step Manual

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 wont be used. Then press Next.
328340851.doc
27
Step By Step Manual

Press Next
Press Next to install.

28
Step By Step Manual

12. After the installation is complete, the following Nutcracker message

may be displayed.
Press OK to update the NutCracker version and follow the process
13. Press Next to continue
14. Select Modify option an press Next to continue
328340851.doc
29
Step By Step Manual

30
Step By Step Manual

17. Press Install to start the installation
328340851.doc
31
Step By Step Manual

18. Press Finish to finish the process.
The following window appears and the Release Notes are displayed
Press OK to close the message
32
Step By Step Manual

19. Once the installation is complete, request for Workstation to be restarted

will be displayed.
Select Yes and Finish
328340851.doc
33
Step By Step Manual

2.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:
Error:
Reference
source
not
found
Select the Advanced tab and click on Environment Variables:
Error:
Reference
source
not
found
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.
After finishing the work press and save all changes on variables.
34
Step By Step Manual

2.3
NutCracker settings
1.
Open Windows Control Panel. Start >>

Settings>> Control Panel (Windows XP Start >> Control Panel) and
select configure MKS Toolkit:
Error: Reference source not found.

Select tab Runtime Settings. In field
Category select XWindow System Settings from the list.
2.
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:

Press to save the changes and close the window.
328340851.doc
35
Step By Step Manual

3 ORACLE installation for the geological database GDB

3.1
Oracle Database installation and settings
3.1.1 Oracle Database installation

Oracle 9i Enterprise edition consists of three discs. During the installation
following requests will be displayed:
Error:
Reference
source
not
found
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:
Error: Reference source not foundError: Reference source not found
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 dont 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.
4.
9.2.0.1.0. Press Next.
Select the option Oracle 9i Database

36
Step By Step Manual

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. Dont change the SID field. Press
Next.
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.
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:

After installation, Oracle would conduct some test automatically. It is
recommended that these test to run successfully.
328340851.doc
37
Step By Step Manual

13. After the installation is finished press Exit. Press Yes to confirm the exit.
3.1.2 Oracle Database settings

3.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
38
Step By Step Manual

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
Nb: this points to the location of critical Oracle control files for database access.
328340851.doc
39
Step By Step Manual

3.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.
40
Step By Step Manual

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)
)
)
328340851.doc
41
Step By Step Manual

3.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.
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).
3.1.2.4
Oracle Uninstall Steps
Steps to uninstall Oracle:

42
Step By Step Manual

1.
2.
3.
4.
5.
6.
7.
8.
9.
Uninstall all Oracle components using Oracle Universal Installer CD.

Stop all oracle services
Clean up environment variables
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.
Reboot your machine
Delete C:\Oracle directory or whatever is your ORACLE_HOME
Delete C:\Program files\Oracle directory
Empty the contents in C:\temp directory
Empty recycle bin.
328340851.doc
43

MineScape 4.119 Install Guide - 2009

Uploaded by

Copyright:

Available Formats

MineScape 4.119 Install Guide - 2009

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

MineScape 4.119 Install Guide - 2009

Uploaded by

Copyright:

Available Formats

MineScape 4.

Step By Step Manual

Step by Step Flowchart..................................................................................................3

Permissions Set Up........................................................................................................4

MineScape setup on a server.........................................................................................7

MineScape installation on a work station...................................................................10

ORACLE installation for the geological database GDB.............................................47

Step By Step Manual

Step by Step Flowchart

Install Hummingbird Exceed

Install Hummingbird Exceed 3D

Configuration of Hummingbird Exceed

Create MineScape Directories

Install Mincom MineScape

Set up MineScape Environment Variables

Step By Step Manual

3. If the user name appears in the list:

Step By Step Manual

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

Step By Step Manual

Step By Step Manual

3 MineScape setup on a server

Installation and setup of Hummingbird Exceed

MineScape Server installation

<disc name>:\Temp for temporary files.

1.2.2 MineScape Installation

Step By Step Manual

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

Step By Step Manual

Step By Step Manual

4. Select the MineScape installation directory. In many cases the default

Step By Step Manual

6. After the installation is complete the MineScape Release Notes will be

Step By Step Manual

2 MineScape installation on a work station

Installation and setup of Hummingbird Exceed

2.1.1 Exceed installation

Step By Step Manual

Step By Step Manual

9. Select Shared User Directory and press Next.

Step By Step Manual

2.1.2 Exceed 3D installation

Step By Step Manual

3. Select Personal installation:

Step By Step Manual

Step By Step Manual

8. Select Typical and press Next:

Step By Step Manual

Error: Reference source not found

2.1.3 Exceed setup after installation

To save the changes and return to the main menu press

Step By Step Manual

Error: Reference source not found

In the main menu select Other Server Settings.

Click the Macro Bindings button

Error: Reference source not found

Step By Step Manual

Error: Reference source not found