installation manual ami-g3 system - inogate · installation manual ami-g3 system for windows...

35
Installation Manual AMI-G3 System For Windows Stand-alone Version Hexing Electrical Co., Ltd. www.hxgroup.cn [2013.3]

Upload: trinhminh

Post on 20-Jan-2019

215 views

Category:

Documents


0 download

TRANSCRIPT

Installation Manual

AMI-G3 System

For Windows Stand-alone Version

Hexing Electrical Co Ltd wwwhxgroupcn

[20133]

System Installation Manual-AMI-G3 2 35

Introduction

Range of validity

The present installation manual applies to the system software specified on the title page

Purpose

The installation manual contains all the information required for installation and maintenance

of the system software

Target group

The contents of this installation manual are intended for qualified personnel of energy supply

companies responsible for installation and maintenance of the system software

Hexing Electrical reserves the right of final interpretation

System Installation Manual-AMI-G3 3 35

Table of Contents

INTRODUCTION 2

1 SYSTEM LOGICAL STRUCTURE 5

2 SYSTEM DEPLOYMENT DIAGRAM 6

3 SYSTEM INSTALLATION REQUIREMENT 6

31 SERVER CONFIGURATION 6

32 SOFTWARE INSTALLATION ENVIRONMENT 7

4 OPERATING SYSTEM INSTALLATION CONFIGURATION 7

5 DATABASE INSTALLATION CONFIGURATION 7

51 CHECK JRE 7

52 INSTALLATION PROCESS 8

53 INSTALL SQL TOOL 20

6 DATA INITIALIZATION 20

61 LOGIN DATABASE AS ldquoSYSrdquo USER 20

62 DELETE USER 20

63 EXECUTE ldquoCREATE TABLE SPACErdquo SCRIPT 20

64 CREATE USER 21

65 LOGIN AS NEW USER 21

66 EXECUTE ldquoCREATE TABLErdquo SCRIPT(258) 21

67 EXECUTE CREATE PARTITION TABLE SCRIPT(16) 21

68 EXECUTE CREATE SEQUENCE SCRIPT(51) 21

69 EXECUTE CREATE VIEW SCRIPT (4 IN TOTAL) 22

610 EXECUTE CREATE TYPE SCRIPT (1) 22

611 EXECUTE CREAT PACKAGE SCRIPT (12 IN TOTAL) 22

612 CHECK IF THERE IS INVALID OBJECT 22

613 EXECUTE BELOW SCRIPT TO DISABLE FOREIGN KEY LIMITATION 23

614 IMPORT DATA 23

615 EXECUTE BELOW SCRIPT TO ENABLE FOREIGN KEY LIMITATION 24

616 ANALYZE IMPORTED DATA TABLES 24

617 DELETE JOB 24

618 EXECUTE CREATE JOB SCRIPT(7) 25

7 JDK INSTALLATION 26

71 INSTALLATION PACKAGE 26

72 COMPRESSED PACKAGE INSTALLATION 29

8 COMMUNICATION SERVICE DEPLOYMENT 29

81 FE CONFIGURATION 29

82 BP CONFIGURATION 29

83 GATE CONFIGURATION 30

System Installation Manual-AMI-G3 4 35

84 PORT CONFIGURATION 30

85 DP CONFIGURATION (SCHEDULED CALL) 31

86 DR CONFIGURATION (RECALL ) 31

9 WEB SERVICE INSTALLATION AND DEPLOYMENT (TOMCAT) 31

91 WEB SERVICE INSTALLATION 31

92 WEB APPLICATION DEPLOYMENT 31

93 WEB APPLICATION START-UP 33

System Installation Manual-AMI-G3 5 35

1 System Logical Structure

Figure 1 System Logical Structure

System Installation Manual-AMI-G3 6 35

2 System Deployment Diagram

Data Collection Communications Platform

AMI Web

DataBase

UserUser

BPBP

GateGate

GPRS Meter

WEBWEB

DBDB

GPRS Lan

LAN

Browser

LAN

FEFE

Lan

GPRS

Concenterator

Figure 2 System Deployment Diagram

3 System Installation Requirement

31 Server Configuration

No Item Configuration requirement QTY

1 Database server

PC Server or Minicomputer Server cluster

Memory 2G

CPU Dual-core

Hard disk ge300G

1

2 Communication

front-end processor

PC Server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

3 Communication

gateway

PC server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

4 Application Server

PC server

Memory 2G

CPU Dual-core

1

System Installation Manual-AMI-G3 7 35

Hard disk ge 200G

5 Hand Held Unit From Hexing 2

6 Meter PC software From Hexing 2

Figure 3 Server configuration

Note for the current pilot project communication gateway and communication front-end

processor can be arranged on the same server but memory of this server shall be no less than

4G However if database is also installed on this server its memory shall be no less than 8G

Meanwhile the server used for communication gateway must be able to connect to Internet or

VPN network to realize GPRS communication between meter and data concentrator

32 Software Installation Environment

No Item Requirement

1 Operating system Windows sever 2003 version or above

2 JDK Version 16 or above

3 Tomcat Version 60 or above

4 Oracle Version 10g or above Oracle11g is recommended

Figure 4 Software Installation Environment

4 Operating System Installation Configuration

Installation process will not be introduced here

Configuration Shall support remote control function so that engineers can make remote

debugging and maintenance

5 Database Installation Configuration

Below is an example for installation of Oracle11g database For other versionrsquos database the

interface might be a bit different with here but the installation process is similar

51 Check JRE

Oracle11g requires version JRE13 or above If the JRE version is too low error information as

System Installation Manual-AMI-G3 8 35

below will prompt during installation process

Please enter httpwwwjavasoftcom to download new version JRE and then install Oracle

database

52 Installation Process

Firstly do NOT tick in above red circuled part and then clickldquoNextrdquo

If below error information prompt ignore it and click ldquoYesrdquo to continue

System Installation Manual-AMI-G3 9 35

Select ldquoCreate and configure a databaserdquo

Select ldquoServer Classrdquo

System Installation Manual-AMI-G3 10 35

Select ldquoSingle instance database installaitonrdquo

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 2 35

Introduction

Range of validity

The present installation manual applies to the system software specified on the title page

Purpose

The installation manual contains all the information required for installation and maintenance

of the system software

Target group

The contents of this installation manual are intended for qualified personnel of energy supply

companies responsible for installation and maintenance of the system software

Hexing Electrical reserves the right of final interpretation

System Installation Manual-AMI-G3 3 35

Table of Contents

INTRODUCTION 2

1 SYSTEM LOGICAL STRUCTURE 5

2 SYSTEM DEPLOYMENT DIAGRAM 6

3 SYSTEM INSTALLATION REQUIREMENT 6

31 SERVER CONFIGURATION 6

32 SOFTWARE INSTALLATION ENVIRONMENT 7

4 OPERATING SYSTEM INSTALLATION CONFIGURATION 7

5 DATABASE INSTALLATION CONFIGURATION 7

51 CHECK JRE 7

52 INSTALLATION PROCESS 8

53 INSTALL SQL TOOL 20

6 DATA INITIALIZATION 20

61 LOGIN DATABASE AS ldquoSYSrdquo USER 20

62 DELETE USER 20

63 EXECUTE ldquoCREATE TABLE SPACErdquo SCRIPT 20

64 CREATE USER 21

65 LOGIN AS NEW USER 21

66 EXECUTE ldquoCREATE TABLErdquo SCRIPT(258) 21

67 EXECUTE CREATE PARTITION TABLE SCRIPT(16) 21

68 EXECUTE CREATE SEQUENCE SCRIPT(51) 21

69 EXECUTE CREATE VIEW SCRIPT (4 IN TOTAL) 22

610 EXECUTE CREATE TYPE SCRIPT (1) 22

611 EXECUTE CREAT PACKAGE SCRIPT (12 IN TOTAL) 22

612 CHECK IF THERE IS INVALID OBJECT 22

613 EXECUTE BELOW SCRIPT TO DISABLE FOREIGN KEY LIMITATION 23

614 IMPORT DATA 23

615 EXECUTE BELOW SCRIPT TO ENABLE FOREIGN KEY LIMITATION 24

616 ANALYZE IMPORTED DATA TABLES 24

617 DELETE JOB 24

618 EXECUTE CREATE JOB SCRIPT(7) 25

7 JDK INSTALLATION 26

71 INSTALLATION PACKAGE 26

72 COMPRESSED PACKAGE INSTALLATION 29

8 COMMUNICATION SERVICE DEPLOYMENT 29

81 FE CONFIGURATION 29

82 BP CONFIGURATION 29

83 GATE CONFIGURATION 30

System Installation Manual-AMI-G3 4 35

84 PORT CONFIGURATION 30

85 DP CONFIGURATION (SCHEDULED CALL) 31

86 DR CONFIGURATION (RECALL ) 31

9 WEB SERVICE INSTALLATION AND DEPLOYMENT (TOMCAT) 31

91 WEB SERVICE INSTALLATION 31

92 WEB APPLICATION DEPLOYMENT 31

93 WEB APPLICATION START-UP 33

System Installation Manual-AMI-G3 5 35

1 System Logical Structure

Figure 1 System Logical Structure

System Installation Manual-AMI-G3 6 35

2 System Deployment Diagram

Data Collection Communications Platform

AMI Web

DataBase

UserUser

BPBP

GateGate

GPRS Meter

WEBWEB

DBDB

GPRS Lan

LAN

Browser

LAN

FEFE

Lan

GPRS

Concenterator

Figure 2 System Deployment Diagram

3 System Installation Requirement

31 Server Configuration

No Item Configuration requirement QTY

1 Database server

PC Server or Minicomputer Server cluster

Memory 2G

CPU Dual-core

Hard disk ge300G

1

2 Communication

front-end processor

PC Server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

3 Communication

gateway

PC server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

4 Application Server

PC server

Memory 2G

CPU Dual-core

1

System Installation Manual-AMI-G3 7 35

Hard disk ge 200G

5 Hand Held Unit From Hexing 2

6 Meter PC software From Hexing 2

Figure 3 Server configuration

Note for the current pilot project communication gateway and communication front-end

processor can be arranged on the same server but memory of this server shall be no less than

4G However if database is also installed on this server its memory shall be no less than 8G

Meanwhile the server used for communication gateway must be able to connect to Internet or

VPN network to realize GPRS communication between meter and data concentrator

32 Software Installation Environment

No Item Requirement

1 Operating system Windows sever 2003 version or above

2 JDK Version 16 or above

3 Tomcat Version 60 or above

4 Oracle Version 10g or above Oracle11g is recommended

Figure 4 Software Installation Environment

4 Operating System Installation Configuration

Installation process will not be introduced here

Configuration Shall support remote control function so that engineers can make remote

debugging and maintenance

5 Database Installation Configuration

Below is an example for installation of Oracle11g database For other versionrsquos database the

interface might be a bit different with here but the installation process is similar

51 Check JRE

Oracle11g requires version JRE13 or above If the JRE version is too low error information as

System Installation Manual-AMI-G3 8 35

below will prompt during installation process

Please enter httpwwwjavasoftcom to download new version JRE and then install Oracle

database

52 Installation Process

Firstly do NOT tick in above red circuled part and then clickldquoNextrdquo

If below error information prompt ignore it and click ldquoYesrdquo to continue

System Installation Manual-AMI-G3 9 35

Select ldquoCreate and configure a databaserdquo

Select ldquoServer Classrdquo

System Installation Manual-AMI-G3 10 35

Select ldquoSingle instance database installaitonrdquo

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 3 35

Table of Contents

INTRODUCTION 2

1 SYSTEM LOGICAL STRUCTURE 5

2 SYSTEM DEPLOYMENT DIAGRAM 6

3 SYSTEM INSTALLATION REQUIREMENT 6

31 SERVER CONFIGURATION 6

32 SOFTWARE INSTALLATION ENVIRONMENT 7

4 OPERATING SYSTEM INSTALLATION CONFIGURATION 7

5 DATABASE INSTALLATION CONFIGURATION 7

51 CHECK JRE 7

52 INSTALLATION PROCESS 8

53 INSTALL SQL TOOL 20

6 DATA INITIALIZATION 20

61 LOGIN DATABASE AS ldquoSYSrdquo USER 20

62 DELETE USER 20

63 EXECUTE ldquoCREATE TABLE SPACErdquo SCRIPT 20

64 CREATE USER 21

65 LOGIN AS NEW USER 21

66 EXECUTE ldquoCREATE TABLErdquo SCRIPT(258) 21

67 EXECUTE CREATE PARTITION TABLE SCRIPT(16) 21

68 EXECUTE CREATE SEQUENCE SCRIPT(51) 21

69 EXECUTE CREATE VIEW SCRIPT (4 IN TOTAL) 22

610 EXECUTE CREATE TYPE SCRIPT (1) 22

611 EXECUTE CREAT PACKAGE SCRIPT (12 IN TOTAL) 22

612 CHECK IF THERE IS INVALID OBJECT 22

613 EXECUTE BELOW SCRIPT TO DISABLE FOREIGN KEY LIMITATION 23

614 IMPORT DATA 23

615 EXECUTE BELOW SCRIPT TO ENABLE FOREIGN KEY LIMITATION 24

616 ANALYZE IMPORTED DATA TABLES 24

617 DELETE JOB 24

618 EXECUTE CREATE JOB SCRIPT(7) 25

7 JDK INSTALLATION 26

71 INSTALLATION PACKAGE 26

72 COMPRESSED PACKAGE INSTALLATION 29

8 COMMUNICATION SERVICE DEPLOYMENT 29

81 FE CONFIGURATION 29

82 BP CONFIGURATION 29

83 GATE CONFIGURATION 30

System Installation Manual-AMI-G3 4 35

84 PORT CONFIGURATION 30

85 DP CONFIGURATION (SCHEDULED CALL) 31

86 DR CONFIGURATION (RECALL ) 31

9 WEB SERVICE INSTALLATION AND DEPLOYMENT (TOMCAT) 31

91 WEB SERVICE INSTALLATION 31

92 WEB APPLICATION DEPLOYMENT 31

93 WEB APPLICATION START-UP 33

System Installation Manual-AMI-G3 5 35

1 System Logical Structure

Figure 1 System Logical Structure

System Installation Manual-AMI-G3 6 35

2 System Deployment Diagram

Data Collection Communications Platform

AMI Web

DataBase

UserUser

BPBP

GateGate

GPRS Meter

WEBWEB

DBDB

GPRS Lan

LAN

Browser

LAN

FEFE

Lan

GPRS

Concenterator

Figure 2 System Deployment Diagram

3 System Installation Requirement

31 Server Configuration

No Item Configuration requirement QTY

1 Database server

PC Server or Minicomputer Server cluster

Memory 2G

CPU Dual-core

Hard disk ge300G

1

2 Communication

front-end processor

PC Server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

3 Communication

gateway

PC server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

4 Application Server

PC server

Memory 2G

CPU Dual-core

1

System Installation Manual-AMI-G3 7 35

Hard disk ge 200G

5 Hand Held Unit From Hexing 2

6 Meter PC software From Hexing 2

Figure 3 Server configuration

Note for the current pilot project communication gateway and communication front-end

processor can be arranged on the same server but memory of this server shall be no less than

4G However if database is also installed on this server its memory shall be no less than 8G

Meanwhile the server used for communication gateway must be able to connect to Internet or

VPN network to realize GPRS communication between meter and data concentrator

32 Software Installation Environment

No Item Requirement

1 Operating system Windows sever 2003 version or above

2 JDK Version 16 or above

3 Tomcat Version 60 or above

4 Oracle Version 10g or above Oracle11g is recommended

Figure 4 Software Installation Environment

4 Operating System Installation Configuration

Installation process will not be introduced here

Configuration Shall support remote control function so that engineers can make remote

debugging and maintenance

5 Database Installation Configuration

Below is an example for installation of Oracle11g database For other versionrsquos database the

interface might be a bit different with here but the installation process is similar

51 Check JRE

Oracle11g requires version JRE13 or above If the JRE version is too low error information as

System Installation Manual-AMI-G3 8 35

below will prompt during installation process

Please enter httpwwwjavasoftcom to download new version JRE and then install Oracle

database

52 Installation Process

Firstly do NOT tick in above red circuled part and then clickldquoNextrdquo

If below error information prompt ignore it and click ldquoYesrdquo to continue

System Installation Manual-AMI-G3 9 35

Select ldquoCreate and configure a databaserdquo

Select ldquoServer Classrdquo

System Installation Manual-AMI-G3 10 35

Select ldquoSingle instance database installaitonrdquo

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 4 35

84 PORT CONFIGURATION 30

85 DP CONFIGURATION (SCHEDULED CALL) 31

86 DR CONFIGURATION (RECALL ) 31

9 WEB SERVICE INSTALLATION AND DEPLOYMENT (TOMCAT) 31

91 WEB SERVICE INSTALLATION 31

92 WEB APPLICATION DEPLOYMENT 31

93 WEB APPLICATION START-UP 33

System Installation Manual-AMI-G3 5 35

1 System Logical Structure

Figure 1 System Logical Structure

System Installation Manual-AMI-G3 6 35

2 System Deployment Diagram

Data Collection Communications Platform

AMI Web

DataBase

UserUser

BPBP

GateGate

GPRS Meter

WEBWEB

DBDB

GPRS Lan

LAN

Browser

LAN

FEFE

Lan

GPRS

Concenterator

Figure 2 System Deployment Diagram

3 System Installation Requirement

31 Server Configuration

No Item Configuration requirement QTY

1 Database server

PC Server or Minicomputer Server cluster

Memory 2G

CPU Dual-core

Hard disk ge300G

1

2 Communication

front-end processor

PC Server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

3 Communication

gateway

PC server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

4 Application Server

PC server

Memory 2G

CPU Dual-core

1

System Installation Manual-AMI-G3 7 35

Hard disk ge 200G

5 Hand Held Unit From Hexing 2

6 Meter PC software From Hexing 2

Figure 3 Server configuration

Note for the current pilot project communication gateway and communication front-end

processor can be arranged on the same server but memory of this server shall be no less than

4G However if database is also installed on this server its memory shall be no less than 8G

Meanwhile the server used for communication gateway must be able to connect to Internet or

VPN network to realize GPRS communication between meter and data concentrator

32 Software Installation Environment

No Item Requirement

1 Operating system Windows sever 2003 version or above

2 JDK Version 16 or above

3 Tomcat Version 60 or above

4 Oracle Version 10g or above Oracle11g is recommended

Figure 4 Software Installation Environment

4 Operating System Installation Configuration

Installation process will not be introduced here

Configuration Shall support remote control function so that engineers can make remote

debugging and maintenance

5 Database Installation Configuration

Below is an example for installation of Oracle11g database For other versionrsquos database the

interface might be a bit different with here but the installation process is similar

51 Check JRE

Oracle11g requires version JRE13 or above If the JRE version is too low error information as

System Installation Manual-AMI-G3 8 35

below will prompt during installation process

Please enter httpwwwjavasoftcom to download new version JRE and then install Oracle

database

52 Installation Process

Firstly do NOT tick in above red circuled part and then clickldquoNextrdquo

If below error information prompt ignore it and click ldquoYesrdquo to continue

System Installation Manual-AMI-G3 9 35

Select ldquoCreate and configure a databaserdquo

Select ldquoServer Classrdquo

System Installation Manual-AMI-G3 10 35

Select ldquoSingle instance database installaitonrdquo

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 5 35

1 System Logical Structure

Figure 1 System Logical Structure

System Installation Manual-AMI-G3 6 35

2 System Deployment Diagram

Data Collection Communications Platform

AMI Web

DataBase

UserUser

BPBP

GateGate

GPRS Meter

WEBWEB

DBDB

GPRS Lan

LAN

Browser

LAN

FEFE

Lan

GPRS

Concenterator

Figure 2 System Deployment Diagram

3 System Installation Requirement

31 Server Configuration

No Item Configuration requirement QTY

1 Database server

PC Server or Minicomputer Server cluster

Memory 2G

CPU Dual-core

Hard disk ge300G

1

2 Communication

front-end processor

PC Server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

3 Communication

gateway

PC server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

4 Application Server

PC server

Memory 2G

CPU Dual-core

1

System Installation Manual-AMI-G3 7 35

Hard disk ge 200G

5 Hand Held Unit From Hexing 2

6 Meter PC software From Hexing 2

Figure 3 Server configuration

Note for the current pilot project communication gateway and communication front-end

processor can be arranged on the same server but memory of this server shall be no less than

4G However if database is also installed on this server its memory shall be no less than 8G

Meanwhile the server used for communication gateway must be able to connect to Internet or

VPN network to realize GPRS communication between meter and data concentrator

32 Software Installation Environment

No Item Requirement

1 Operating system Windows sever 2003 version or above

2 JDK Version 16 or above

3 Tomcat Version 60 or above

4 Oracle Version 10g or above Oracle11g is recommended

Figure 4 Software Installation Environment

4 Operating System Installation Configuration

Installation process will not be introduced here

Configuration Shall support remote control function so that engineers can make remote

debugging and maintenance

5 Database Installation Configuration

Below is an example for installation of Oracle11g database For other versionrsquos database the

interface might be a bit different with here but the installation process is similar

51 Check JRE

Oracle11g requires version JRE13 or above If the JRE version is too low error information as

System Installation Manual-AMI-G3 8 35

below will prompt during installation process

Please enter httpwwwjavasoftcom to download new version JRE and then install Oracle

database

52 Installation Process

Firstly do NOT tick in above red circuled part and then clickldquoNextrdquo

If below error information prompt ignore it and click ldquoYesrdquo to continue

System Installation Manual-AMI-G3 9 35

Select ldquoCreate and configure a databaserdquo

Select ldquoServer Classrdquo

System Installation Manual-AMI-G3 10 35

Select ldquoSingle instance database installaitonrdquo

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 6 35

2 System Deployment Diagram

Data Collection Communications Platform

AMI Web

DataBase

UserUser

BPBP

GateGate

GPRS Meter

WEBWEB

DBDB

GPRS Lan

LAN

Browser

LAN

FEFE

Lan

GPRS

Concenterator

Figure 2 System Deployment Diagram

3 System Installation Requirement

31 Server Configuration

No Item Configuration requirement QTY

1 Database server

PC Server or Minicomputer Server cluster

Memory 2G

CPU Dual-core

Hard disk ge300G

1

2 Communication

front-end processor

PC Server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

3 Communication

gateway

PC server

Memory 2G

CPU Dual-core

Hard disk ge 200G

1

4 Application Server

PC server

Memory 2G

CPU Dual-core

1

System Installation Manual-AMI-G3 7 35

Hard disk ge 200G

5 Hand Held Unit From Hexing 2

6 Meter PC software From Hexing 2

Figure 3 Server configuration

Note for the current pilot project communication gateway and communication front-end

processor can be arranged on the same server but memory of this server shall be no less than

4G However if database is also installed on this server its memory shall be no less than 8G

Meanwhile the server used for communication gateway must be able to connect to Internet or

VPN network to realize GPRS communication between meter and data concentrator

32 Software Installation Environment

No Item Requirement

1 Operating system Windows sever 2003 version or above

2 JDK Version 16 or above

3 Tomcat Version 60 or above

4 Oracle Version 10g or above Oracle11g is recommended

Figure 4 Software Installation Environment

4 Operating System Installation Configuration

Installation process will not be introduced here

Configuration Shall support remote control function so that engineers can make remote

debugging and maintenance

5 Database Installation Configuration

Below is an example for installation of Oracle11g database For other versionrsquos database the

interface might be a bit different with here but the installation process is similar

51 Check JRE

Oracle11g requires version JRE13 or above If the JRE version is too low error information as

System Installation Manual-AMI-G3 8 35

below will prompt during installation process

Please enter httpwwwjavasoftcom to download new version JRE and then install Oracle

database

52 Installation Process

Firstly do NOT tick in above red circuled part and then clickldquoNextrdquo

If below error information prompt ignore it and click ldquoYesrdquo to continue

System Installation Manual-AMI-G3 9 35

Select ldquoCreate and configure a databaserdquo

Select ldquoServer Classrdquo

System Installation Manual-AMI-G3 10 35

Select ldquoSingle instance database installaitonrdquo

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 7 35

Hard disk ge 200G

5 Hand Held Unit From Hexing 2

6 Meter PC software From Hexing 2

Figure 3 Server configuration

Note for the current pilot project communication gateway and communication front-end

processor can be arranged on the same server but memory of this server shall be no less than

4G However if database is also installed on this server its memory shall be no less than 8G

Meanwhile the server used for communication gateway must be able to connect to Internet or

VPN network to realize GPRS communication between meter and data concentrator

32 Software Installation Environment

No Item Requirement

1 Operating system Windows sever 2003 version or above

2 JDK Version 16 or above

3 Tomcat Version 60 or above

4 Oracle Version 10g or above Oracle11g is recommended

Figure 4 Software Installation Environment

4 Operating System Installation Configuration

Installation process will not be introduced here

Configuration Shall support remote control function so that engineers can make remote

debugging and maintenance

5 Database Installation Configuration

Below is an example for installation of Oracle11g database For other versionrsquos database the

interface might be a bit different with here but the installation process is similar

51 Check JRE

Oracle11g requires version JRE13 or above If the JRE version is too low error information as

System Installation Manual-AMI-G3 8 35

below will prompt during installation process

Please enter httpwwwjavasoftcom to download new version JRE and then install Oracle

database

52 Installation Process

Firstly do NOT tick in above red circuled part and then clickldquoNextrdquo

If below error information prompt ignore it and click ldquoYesrdquo to continue

System Installation Manual-AMI-G3 9 35

Select ldquoCreate and configure a databaserdquo

Select ldquoServer Classrdquo

System Installation Manual-AMI-G3 10 35

Select ldquoSingle instance database installaitonrdquo

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 8 35

below will prompt during installation process

Please enter httpwwwjavasoftcom to download new version JRE and then install Oracle

database

52 Installation Process

Firstly do NOT tick in above red circuled part and then clickldquoNextrdquo

If below error information prompt ignore it and click ldquoYesrdquo to continue

System Installation Manual-AMI-G3 9 35

Select ldquoCreate and configure a databaserdquo

Select ldquoServer Classrdquo

System Installation Manual-AMI-G3 10 35

Select ldquoSingle instance database installaitonrdquo

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 9 35

Select ldquoCreate and configure a databaserdquo

Select ldquoServer Classrdquo

System Installation Manual-AMI-G3 10 35

Select ldquoSingle instance database installaitonrdquo

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 10 35

Select ldquoSingle instance database installaitonrdquo

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 11 35

Select ldquoAdvanced installrdquo

Choose among available languages and add needed languages

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 12 35

Select database edition make sure there is enough disk space

Choose installation directory of Oracle database

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 13 35

Select ldquoGeneral PurposeTransaction Processingrdquo

Input ldquoGlobal Database Namerdquo and ldquoSIDrdquo the default value is ldquoamirdquo

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 14 35

Select ldquoEnable Automatic Memory Managementldquo

Switch to ldquoCharacter setsrdquo TAB page and select ldquoUse Unicold (AL32UTF8)rdquo Click ldquoNextrdquo

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 15 35

Click ldquoNextrdquo

Fill in ldquoSpecify database file locationrdquo

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 16 35

Keep default setting and clickldquoNextrdquo

If choose ldquoUse dufferent passwords for these accountsrdquo input passwords one by one You can

also select ldquoUse the same password for all accountsrdquo

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 17 35

Perform prerequisite check If there is error information it will prompt in the relevant page

Remove error accordingly as per the instruction After check enter next interface

Click ldquoFinishrdquo to complete installation

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 18 35

This installation section might take a while please wait in patience

Wait until reaching 100 which means database installation is completed

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 19 35

Installation completed

Record EM URL ass shown in below red circle which will be used for Oracle management

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 20 35

53 Install SQL Tool

Install PLSQL Developer database SQL tool which is used for subsequent database

initialization installation process Download address is as below

httpwwworaclecomtechnetworkdeveloper-toolssql-developerdownloadsindexhtml

6 Data Initialization

Initialization process of system database script involves creation of table space So if table space

exists then skip step 3 execute the ldquocreate table space scriptrdquo operation Create database

account information username AMI password AMI (capitalized) If database is oracle11g

version the passwords are case sensitive

61 Login Database as ldquosysrdquo User

Execute under cmd command

Sqlplus syspasswrodconn as sysdba

Note Connection character ldquoconn rdquo needs to be configured by the user

62 Delete User

SQLgtdrop user AMI cascade

63 Execute ldquoCreate Table Spacerdquo Script

SQLgtCdatabasetablespacecreate_tablespacesql

Note When creating table space change the paths in ldquocreate_tablespacesqlrdquo to real path

Words in red as shown below shall be changed to time path

CREATE TABLESPACE HX_RW_2011 DATAFILE oracleoradataHX_RW_2011_01DBF SIZE

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 21 35

4097M EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO

64 Create User

SQLgt Cdatabaseusercreate_usersql

65 Login as New User

SQLgt conn AMIAMIconn

Note Connection character ldquoconn rdquo needs to be configured by the user

66 Execute ldquoCreate Tablerdquo Script(258)

SQL gtCdatabasetabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TABLE

AND tobject_name NOT IN(SELECT table_name FROM user_tab_partitions)

Check if it is 258

67 Execute Create Partition Table Script(16)

SQL gtC databasepart_tabletrisql

After create table script is executed execute below

SQL gt SELECT COUNT(DISTINCT table_name) cnt FROM user_tab_partitions

Check if it is 16

68 Execute Create Sequence Script(51)

SQLgtCdatabasesequencetrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 22 35

WHERE tOBJECT_TYPE = SEQUENCE

Check if the result is 51

69 Execute Create View Script (4 in total)

SQLgtCdatabaseviewtrisql

After execution execute below

SQLgtSELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = VIEW

Check if the result is 4

610 Execute Create Type Script (1)

SQLgtCdatabasetypetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE = TYPE

AND tOBJECT_NAME = ARRAY_VARCHAR2

Check if the result is 1

611 Execute Creat Package Script (12 in total)

SQLgtCdatabasepackagetrisql

After execution execute below

SQLgt SELECT COUNT() FROM user_objects t

WHERE tOBJECT_TYPE IN (PACKAGEPACKAGE BODY)

AND object_name NOT IN (PKG_IMITATE_DATA)

Check if the result is 12

612 Check if There Is Invalid Object

Use plsql developer tool to login AMI user

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 23 35

Open Tools---gtCompiled Invalid objects

Check if there is invalid object If there is invalid object recompile it

As shown in below picture

613 Execute Below Script to Disable Foreign Key Limitation

SQLgtCdatabaseimpdisable_fksql

614 Import Data

Under file Ddatabaseimp

Open ami_imptxt file

Change the data in first and second line as below

userid=AMIAMIconn

file=Cdatabaseimpamidmp

ldquoconnrdquo shall be changed to the actual configured connection string at site

Change the path of ldquoFilerdquointo actual path at site for amidmp

Under doc execute

Input imp parfile = Ddatabaseimpami_imptxt

Note path for ami_imptxt needs to be changed according to actual path

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 24 35

615 Execute Below Script to Enable Foreign Key Limitation

SQLgtCdatabaseimpenable_fksql

616 Analyze Imported Data Tables

Under sqlplus execute

SQLgtCdatabaseanalyze_tabtrisql

617 Delete Job

Use plsql developer tool to delete it

As shown in above figure find DBMS_Jobs on the left window of plsql developer Select job

you want to delete and right click ldquodroprdquo to delete them one by one

Note If it is the first time operation skip this step otherwise this step should be executed

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 25 35

618 Execute Create Job Script(7)

Under sqlplus execute

SQLgtCdatabasejobcreate_jobsql

After execution execute below

SQLgtselect COUNT() FROM user_jobs

Check if the result is 7

Till this step database operation is completed

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 26 35

7 JDK Installation

Two kinds of installation methods are available for JDK installation One is to download exe

installation package to install the other is to use the compressed package for installation

71 Installation Package

Download the package of JDK16 from this link httpjdk6javanetdownloadhtml

Click to install it

License Agreement selectldquoAcceptrdquo

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 27 35

Select the installation path

Installation process

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 28 35

Installation finished

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 29 35

72 Compressed Package Installation

Decompress the installation package directly to the corresponding directory in which there should

only be English words or numbers

8 Communication Service Deployment

81 FE Configuration

The configuration in application properties

1) fegprsclients=1270018087name=gprs1

This is the connection with gate(it matches with feserver in gate)

2) bpserver=10011name=bpSocketServer

this is the port of BP connection which should match bpfeclienturl in BP

3) uplogtable

For saving uplink report

4) downlogtable

For saving downlink report

5) wzuplogtable

For saving unknown report

82 BP Configuration

The configuration in application properties

1) bpfeclienturl =12700110011

This is IP and port of FE to connect BP And it matches bpserver=10011 in FE

2) bpwebserverport =7778

It is the port which connect with BP

3) bpbatchSize

This is the maximum quantity of batch saved data

4) bpdelaySecond

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 30 35

This is the delay time for saving data in batch

5) sysshowprofilecronExpression

This is the log print script strategy

6) bprefreshRtucronExpression

this is for timely taking synchronization record in terminal synchronization table and refresh

memory archives job

Note6789 items are not suggested to be modified

83 Gate Configuration

The configuration in application properties

1) gatetcpservers=3084name=gprs-t-1

This is the port connected with meters

2) feserver=8087name=fe-server

this is the port connected with FE which is corresponding to the above (1)

Note Server of the Gate should have a fixed internet IP or VPN net It ensures that meters can be

successfully connected with Gate application via GPRS

84 Port Configuration

WEBBPFEGATEMETER

1) WEB communicates with BP via the port bpwebserverport=7778 of BP

2) BP communicates with FE in BP the configuration is bpfeclienturl=12700110011 in FE the

configuration is bpserver=10011name=bpSocketServer

3) FE communicates with GATE in FE the configuration is

fegprsclients=172162512398087name=gprs1 In GATE the configuration is

feserver=8087name=fe-server

4) GATE communicates with meters in GATE the configuration is

gatetcpservers=3089name=gprs-t-1 and 3089 is written in the meters

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 31 35

85 DP Configuration (scheduled call)

Enter root directory of scheduled call and modify configurations in the file applicationproperties

1) modify bpclientsurl according to the configurations in bp and it should match that in bp

bpclientsurl=1270017778

2) modify scheduled call strategies in dlms protocol(whatrsquos the regular period for performing the

task)

dlmstaskinitcronExpression=0 1 0

86 DR Configuration (Recall )

Configuration in application properties

1) modify bpclientsurl according to configuration in bp and it should match that in bp

bpclientsurl=1270017778

9 Web Service Installation and Deployment (Tomcat)

91 Web Service Installation

Download Tomcat6 or senior version( zip format) decompress it into the corresponding directorty

Download link httparchiveapacheorgdisttomcattomcat-7v708bin

92 Web Application Deployment

Enter tomcat root directory

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 32 35

Set JAVA_HOME

Edit bincatalinabat file set the JAVA_HOME variables in the beginning of the file

set JAVA_HOME=cjdk160_17

jdk path shall be defined according to the actual directory

Set JVM memory parameters

set JAVA_OPTS=JAVA_OPTS -Xms512m ndashXmx1800m -XXPermSize=64m

-XXMaxPermSize=512m

amoung the part in red Xms is the minimum space that JVM takes Xmx is the maximum space

that JVM takes It is distributed according to the capacity of physical memory of system if the

memory capacity allows it is better to make the value of Xmx larger In the 32 bits operating

system the upper limit of Xms is 2048 for JVM

Set application patch

AmiWebxml

Copy the file AmiWebxml to the directory of confCatalinalocalhost

Edit the content as below

ltContext docBase=cAmiWeb gt

Modify the part in red parts to the complete path where the application package is

Link for this application is httpipportAmiWeb

Set Web application database connection

Enter Web root directory

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 33 35

Edit configuration documentsWEB-INFclassesresdatabaseproperties

databaseconnectionurl=jdbcoraclethin172162512391521ami

databaseconnectiondriver_class=oraclejdbcdriverOracleDriver

databaseconnectionusername=AMI4

databaseconnectionpassword=AMI4

databaseconnectioninitialPoolSize=5

databaseconnectionminPoolSize=5

databaseconnectionmaxPoolSize=20

Set the correct database connection information

Set Web and communication service information

Edit configuration file WEB-INFclassesresfaal-clientproperties

bpclientsurl=17216241487778name=bp1ampusage=0117216241487778name=bp2ampusage=0217216

241487778name=bp3ampusage=03

Modify the parameters in red IP and port of BP server

Task Service

zzrwhost=1721624148

zzrwport=7778

Modify the parameters in red IP and port of BP server

FE Service

feip=1721624148

feport=20002

Modify the parameters in red IP and port of FE server

93 Web Application Start-up

Enter Tomcat root directory

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 34 35

Enter bin directory click ldquostartupbatrdquo If it fails please check if the configuration information

of database connection is correct or not

NOTE Information in this document is subject to change without notice The information is

accurate at the time of printing (March 2013) copy Hexing Electrical

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco

System Installation Manual-AMI-G3 35 35

Hexing Electrical

Add Shangcheng Industrial Zone 1418 Moganshan Road Hangzhou China

TEL +86-571-28020767769

FAX +86-571-28029263

wwwhxgroupcn

markethxgroupco