Sample Data
for Oracle Utilities
Mobile Workforce Management V2.0.X
Installation Guide
CONFIDENTIAL
NAVTEQ Sample Data Installation Guide for Oracle Mobile Workforce Management
Table of Contents
1
Introduction ............................................................................................................................ 1
2
Prerequisites........................................................................................................................... 1
3
Installation .............................................................................................................................. 1
3.1
3.2
3.3
3.4
3.5
3.6
3.7
3.8
NAVTEQ
General Information ........................................................................................................................1
Extract the files from the zip file and work from that directory .........................................................2
From an Oracle privileged account, create the NAVTEQ_UTIL user ..............................................2
Grant privileges to use the tablespace to the NAVTEQ_UTIL user.................................................2
From the operating system command prompt, import the data.......................................................2
Log in as NAVTEQ_UTIL and create map metadata ......................................................................3
Make Sure the Geocoder is Working ..............................................................................................3
Set up the Router............................................................................................................................4
ii
CONFIDENTIAL
NAVTEQ Sample Data Installation Guide for Oracle Mobile Workforce Management
Revision History
NAVTEQ
Version
Date
Comments
1.0
02/11/2010
Created – Dan Abugov
2.0
03/07/2011
Dan Abugov
iii
CONFIDENTIAL
NAVTEQ Sample Data Installation Guide for Oracle Mobile Workforce Management
1
Introduction
This document describes the installation process for the NAVTEQ ODF data for use by Oracle
Utilities Mobile Workforce Management.
AL
The data is delivered preconfigured for use with Oracle Locator and Oracle Spatial by the
Oracle Utilities product. The sample includes Mapping, Geocoding, and Routing content.
The data includes high-level boundaries for North America.
Detailed information is only
included for the area highlighted in green on the cover page map.
TI
The installation is a zip file which contains a set of files:
• NAVTEQ_Util_Sample.dmp – Dump file containing the data
• NAVTEQ_Sample_InstallGuide.pdf
EN
• setup.txt – File with examples of all commands required for installation
• A directory with NAVSTREETS MapInfo Tab files
Prerequisites
ID
2
• The Oracle database version must be at least 11.1
• For mapping Oracle Fusion Middleware 11g MapViewer is required
NF
• Space considerations:
The installation of the Oracle database portion of this content requires approximately
400MB
V2.0.x
3
Installation
3.1
CO
• This data is designed to be used with Oracle Utilities Mobile Workforce Management
General Information
The data set to be loaded into Oracle is delivered in:
•
A single dump file in NAVTEQ’s Oracle Delivery Format (ODF) that will be imported
into an Oracle 11.1.0.7 database or higher
•
A file named mwm-demo.mal, which is a specific MWM format
The directions for importing the dump file are included in this document.
All of the
commands shown in this document are shown in the file setup.txt, which is included in the
downloaded zip file.
The directions for loading the .mal file can be found in the Oracle Mobile Workforce
Management Installation Guide.
NAVTEQ
1
CONFIDENTIAL
NAVTEQ Sample Data Installation Guide for Oracle Mobile Workforce Management
Typically the process consists of copying the mwm-demo.mal file to a data directory on the
ORS server, configuring the system to use the file, then restarting the process control
service.
AL
If you encounter any issues with mwm-demo.mal please log on to
http://support.oracle.com. Navigate to the Knowledge tab. There you can enter ‘Oracle
Utilities Mobile Workforce Management’ in the ‘Find Product by Name’ field. This will filter
your knowledge results to the MWM product only.
3.2
EN
TI
If you do not find a solution to your issue, you may click on the Service Requests tab and
use the ‘Create SR’ button to create a Service Request. If you do not have a valid customer
identifier with Oracle, you may call Oracle Support at your local toll-free number (800-2231711 for the US, or visit Oracle.com to find the toll-free number for your region).
Extract the files from the zip file and work from that directory
First, extract the files in the data set to a directory of your choosing. This directory is a
temporary directory that can be deleted when the installation is done.
ID
Set your default directory to that directory.
The setup.txt file has examples of all commands used in this document.
3.3
NF
Note the information in the brackets <> will be replaced by your specific data file location.
From an Oracle privileged account, create the NAVTEQ_UTIL user
While logged in as the SYS or SYSTEM user, create the NAVTEQ_UTIL user:
CO
-- create the user
grant connect,resource to NAVTEQ_UTIL identified by <NAVTEQ_UTIL_PWORD>;
3.4
Grant privileges to use the tablespace to the NAVTEQ_UTIL user
The user’s default table space is set to the USERS tablespace below:
-- set the NAVTEQ_UTIL user's default table space and allow
-- full use of the tablespace
alter user NAVTEQ_UTIL default tablespace USERS quota unlimited on USERS;
3.5
From the operating system command prompt, import the data
From the command line interface or using your favorite tool for importing Oracle data,
import the dump file:
imp NAVTEQ_UTIL/<NAVTEQ_UTIL_PWORD> file= NAVTEQ_Util_Sample.dmp full=y
NAVTEQ
2
CONFIDENTIAL
NAVTEQ Sample Data Installation Guide for Oracle Mobile Workforce Management
3.6
Log in as NAVTEQ_UTIL and create map metadata
The import procedure creates tables called SDO_MAPS, SDO_CACHED_MAPS, SDO_THEMES, and
SDO_STYLES.
views,
which
This is the data that will be used to populate Oracle’s mapping metadata
are
USER_SDO_MAPS,
USER_SDO_CACHED_MAPS,
USER_SDO_THEMES,
and
AL
USER_SDO_STYLES. These commands are also shown in the file setup.txt.
Connect to the database as the NAVTEQ_UTIL user and then move the data to Oracle’s map
metadata tables:
TI
sqlplus NAVTEQ_UTIL/<NAVTEQ_UTIL_PWORD>
insert into user_sdo_cached_maps
select * from sdo_cached_maps;
insert into user_sdo_styles
select * from sdo_styles;
commit;
ID
insert into user_sdo_themes
select * from sdo_themes;
EN
insert into user_sdo_maps
select * from sdo_maps;
3.7
NF
Do not forget to type “commit;” at the end of the procedure.
Make Sure the Geocoder is Working
CO
Run the following queries to ensure the Oracle Geocoder is properly using the NAVTEQ
content:
select sdo_gcdr.geocode('NAVTEQ_UTIL',sdo_keywordarray('1217 East 23rd St',
'Cleveland, OH 44114'), 'US','DEFAULT')
from dual;
--SDO_GCDR.GEOCODE('NAVTEQ_UTIL',SDO_KEYWORDARRAY('1217EAST23RDST','CLEVELAND,
------------------------------------------------------------------------------ SDO_GEO_ADDR(0, SDO_KEYWORDARRAY(), NULL, 'E 23RD St', NULL, NULL,
-- 'Cleveland', NULL, 'OH', 'US', '44114', NULL, '44114', NULL, '1217',
-- '23RD', 'ST', 'F', 'F', 'E', NULL, 'R', .714285714, 107375418,
-- '????#ENUT?B281CP?',1,'DEFAULT',-81.678656,41.5115486,'???10001010??000?')
select sdo_gcdr.geocode('NAVTEQ_UTIL',sdo_keywordarray('825 N main st',
'Orrville, oh'), 'US','DEFAULT')
from dual;
--SDO_GCDR.GEOCODE('NAVTEQ_UTIL',SDO_KEYWORDARRAY('825NMAINST','ORRVILLE,OH'),
------------------------------------------------------------------------------ SDO_GEO_ADDR(0, SDO_KEYWORDARRAY(), NULL, 'N Main St', NULL, NULL,
-- 'Orrville', NULL, 'OH', 'US', '44667', NULL, '44667', NULL, '825', 'MAIN',
-- 'ST', 'F', 'F', 'N', NULL, 'L', .244897959, 106517557, '????#ENUT?B281CP?',
NAVTEQ
3
CONFIDENTIAL
NAVTEQ Sample Data Installation Guide for Oracle Mobile Workforce Management
-- 1, 'DEFAULT', -81.76406, 40.8468914, '???10001010??004?')
ID
EN
TI
AL
CREATE OR REPLACE FUNCTION GEO_ADDR_FROM_INTERSECTION(
STREET1 VARCHAR2,
STREET2 VARCHAR2,
SETTLEMENT VARCHAR2,
REGION VARCHAR2,
COUNTRY VARCHAR2,
MATCHMODE VARCHAR2)
RETURN SDO_GEO_ADDR
AS
GEO_ADDR SDO_GEO_ADDR ;
BEGIN
GEO_ADDR := SDO_GEO_ADDR() ;
GEO_ADDR.STREETNAME := STREET1 ;
GEO_ADDR.INTERSECTSTREET := STREET2 ;
GEO_ADDR.SETTLEMENT := SETTLEMENT ;
GEO_ADDR.COUNTRY := REGION ;
GEO_ADDR.COUNTRY := COUNTRY ;
GEO_ADDR.MATCHMODE := MATCHMODE ;
RETURN GEO_ADDR ;
END;
/
NF
SELECT GC.RESULT.LONGITUDE, GC.RESULT.LATITUDE, GC.RESULT.MATCHCODE
FROM (SELECT SDO_GCDR.GEOCODE_ADDR('NAVTEQ_UTIL',
GEO_ADDR_FROM_INTERSECTION(
'Easton rd', 'higgins dr', 'Norton', 'OH','US', 'EXACT')) RESULT
FROM DUAL) GC;
3.8
CO
--RESULT.LONGITUDE RESULT.LATITUDE RESULT.MATCHCODE
------------------ --------------- -----------------81.64825
41.03001
1
Set up the Router
The router data is set up to work directly out-of-the-box for Oracle 11.1
installations.
For Oracle 11.2 and higher, complete the following:
sqlplus system/PW4SYSTEM
CREATE OR REPLACE DIRECTORY SDO_ROUTER_LOG_DIR AS 'c:\TEMP\Log';
GRANT READ, WRITE ON DIRECTORY SDO_ROUTER_LOG_DIR TO MDSYS;
call dbms_java.grant_permission('MDSYS', 'java.io.FilePermission',
'c:\TEMP\Log/*', 'read,write');
GRANT READ, WRITE ON DIRECTORY SDO_ROUTER_LOG_DIR TO NAVTEQ_UTIL;
call dbms_java.grant_permission('NAVTEQ_UTIL', 'java.io.FilePermission',
'c:\TEMP\Log/*', 'read,write');
set pages 5000
SELECT * FROM DBA_JAVA_POLICY WHERE GRANTEE IN ('MDSYS','NAVTEQ_UTIL')
NAVTEQ
4
CONFIDENTIAL
NAVTEQ Sample Data Installation Guide for Oracle Mobile Workforce Management
AND TYPE_NAME='java.io.FilePermission';
SELECT * FROM ALL_TAB_PRIVS WHERE GRANTEE IN ('MDSYS','NAVTEQ_UTIL')
AND TABLE_NAME='SDO_ROUTER_LOG_DIR';
AL
grant create view to NAVTEQ_UTIL;
exit;
sqlplus NAVTEQ_UTIL/<NAVTEQ_UTIL_PWORD>
TI
CALL MDSYS.SDO_ROUTER_PARTITION.CREATE_ROUTER_NETWORK
('NAVTEQ_UTIL_RN_Q310.log','NAVTEQ_UTIL_RN_Q310');
CO
NF
ID
EN
commit;
exit;
NAVTEQ
5
CONFIDENTIAL
