CEMDPS Disconnected Client Installation Instructions

marlinlineInternet and Web Development

Oct 31, 2013 (3 years and 5 months ago)

50 views

1

CEMDPS Disconnected Client Installation Instructions


This document contains installation and setup instructions for the CEMDPS
Disconnected Client Application.


The CEMDPS
D
isconnected
C
lient
A
pplication is a web application deployed on Apache
Tomcat ser
ver version 1.1.1.3.

It also contains Sun JDK version 1.4.1.

The database
used for the client application is Microsoft Access.

The client application is accessed
using Internet Explorer
.


Requirements
of

the CEMDPS Disconnected Client

Before using the C
EMDPS Disconnected Client you must have the following:



A DEP Greenport account (username and password)

and assigned access to the
CEMDPS Online application.



The ability to extract files from a zip file onto your local computer.

2


Initial Setup of the
Disco
nnected
Client Application

Step 1


Installing the
Disconnected
Client Application


The disconnected client application is contained in a zip file called
cemdps_client.zip
.
This file will be made available to you through download from a DEP website or by
receiving it on a CD or DVD. Once in possession of this file, it will be
copied and
unzipped to
a

location
your local computer where you want the application to run from.
You must have a file archive and compression utility (or zip utility) for Microsoft

Windows

(
WinZip
, PKZip, etc.)
in order to install the application.


To
copy and
extract the disconnected client application:


1.

In Windows Explorer, right
-
click on the
downloaded
cemdps_client.zip

file and
e
xtract the contents to
an installation folder on
your hard drive (Recommended
installation folder:
C:
\
Program Files)
.


The extraction creates a folder called
cemdps_client

underneath the
installation

folder
.


Step 2


Downloading Configuration and Code Files


Note:

You must have a valid DEP Greenport a
ccount and access to the CEMDPS Online
application prior to initiating this step.

Contact the
Continuous Emission Monitoring Section (
Bureau of Air Quality, Division of
Source Testing and Monitoring
)

if you do not have a valid Greenport account and wish
to
begin using the CEMDPS Disconnected Client application.


To start using the disconnected client application, the application needs:




The current configuration of the facility, which is stored and maintained on the
DEP server

in the CEMDPS Online applic
ation
.



The internal DEP codes, which are also stored and maintained in the DEP server.


The process of downloading these files and updating your client application is called
synchronization.


To download the most recent configuration and code files from

the DEP server:


3


1.

Log on to the DEP Greenport (
www.depgreenport.state.pa.us
)

4


2.

Click on the CEMs button to enter the CEMDPS Online application.


5


3.

Click on the
Create Synchronization Files

link

that
appears in the menu panel
displayed on the left side of the Facility Home Page
.

Clicking this link takes you
to the
Download Synchronization Files

page, which contains
the following
two
links:



Configuration Synchronization File and



Internal DEP Codes Sync
hronization File

6


4.

Click on the
Configuration Synchronization File

link to download the latest
configuration file.

The
File Download

dialog asks if you want to open or save the
file.

7


5.

Click the
Save

button to save the configuration file to your computer.

8


6.

Navigate to the location on your hard drive where you want to save the file and
click the
Save

button. The saved file is named
ConfigurationXX.dep
, where XX
is
the CEMDPS

facility ID.


The next step is to
download the internal DEP codes file.

7.

Back in t
he
Download Synchronization Files

page, click the
Internal DEP Codes
Synchronization File

link to download the latest internal DEP codes file.

9


8.

Repeat steps 4 and 5 to save the internal DEP codes file to your computer.

The
saved file is named InternalCod
esXX.dep, where XX is your
CEMDPS
facility
ID.

10


11


9.

At the completing the download of the configuration and codes file you must
logout of the CEMDPS Online application. Click on the Logout link in the
bottom right hand corner of the page.

10.

Logout of the DEP

Greenport.

Step 3


Starting and Synchronizing the Disconnected Client
Application


After downloading the configuration and internal DEP codes files, you must start the
client application and load the current files. This process is called synchronization
.


1.

In Windows Explorer, navigate to the
C:
\
Program Files
\
cemdps_client

folder
and double
-
click the batch file called
startserver.bat
. This starts the Tomcat
server and displays a command window.


Important Note:

Do not do anything else until the server c
ompletes the
initialization process.

The command
window

will

display a line similar to the line
below when it has completed startup.


“tomcat
-
4.1.31
\
conf
\
jk2.properties”

12


The command window must stay open while you work in the disconnected client
applicat
ion.

Do not close the command window until you are finished using the
application.




2.

In the
cemdps_client

folder, double
-
click the batch file called
LaunchApplication.bat
.

This
will start the CEMDPS Disconnected Client
application.

13



3.

Click on the
Sync
hronize Internal DEP Codes

button to open the page called
Internal DEP Codes Synchronization
.

14


4.

Click the
Yes, I would like to continue

checkbox to continue the synchronization
process and overwrite your current internal DEP codes with the file you
downloa
ded in the previous section (Step 2


Downloading Configuration and
Code Files).

5.

Click the
Browse

button and navigate to the internal DEP codes file you
downloaded from the online CEMDPS application. The file is named
InternalCodesXX
.dep, where XX is your

CEMDPS
facility ID.

15


6.

Click the
Open

button. The file and path display in the
Internal DEP Codes
Synchronization File

text box in the
Internal DEP Codes Synchronization

page.

16


7.

Click on the
Synchronize

button.


Once the synchronization is complete, a
con
firmation message appears in the
Internal DEP Codes Synchronization

screen.




17

8.

Click on the
Disconnected Client Setup

link at the top of the confirmation page
to return to the client application’s introduction page.

The next step is
to
synchronize config
uration data.


9.

Click the
Synchronize Configuration Data

button to open the
Configuration
Synchronization

page.

18


10.

Click the
Yes, I would like to continue

checkbox to continue the synchronization
process and overwrite your current configuration file with th
e file you
downloaded in the previous section (Step 2


Downloading Configuration and
Code Files).

11.

Click the
Browse

button and navigate to configuration file you downloaded from
the online CEMDPS application.

The file is named ConfigurationXX.dep, where
X
X is your facility ID.

19


12.

Click the
Open

button. The file and path
will
display in the
Configuration
Synchronization File

text box in the
Configuration Synchronization

page.

20


13.

Click on the
Upload

button.

Once the synchronization is complete, a
confirmatio
n message appears in the
Configuration Synchronization

page.

21



Step 4


Using the Application


Once the installation and synchronization are complete, you can start using the
application.


1.

If you are not already on the application’s introduction page, cli
ck the
Disconnected Client Setup

link at the top of the page to go to the introduction
page.

22


2.

On the introduction page, click the
Enter Application

button.

This opens the
home page of the CEMDPS client application, which is similar to the CEMDPS
O
nline h
ome page.

23


3.

The CEMDPS Disconnected Client home page (listed above) is the starting point
for entering and updating monitoring plans and
test and reporting data.

Stopping the Disconnected Client Application


1.

To exit the Disconnected Client application simp
ly close your browser by
selecting File/Close from the menu or by clicking on the X in the top right corner
of the browser screen.

2.

To stop the server command window, double
-
click
stopserver.bat

in the
cemdps_client
folder on your hard drive to close the cl
ient application.

Note:

Under the normal Windows environment, you can close the client
application simply by closing your browser and the server command window. In
some systems, closing the server command window may generate an error. If
your system cre
ates an error message when closing the command window,
double
-
click
stopserver.bat

in the
cemdps_client
folder on your hard drive to
close the client application.


24

Common
Disconnected
Client Application Procedures

The procedures under
Initial Setup

above m
ust all be completed the first time you install
and use the CEMDPS disconnected client application. The following sections contain
common procedures and other information pertaining to using the client application after
the initial setup.


Starting the Cl
ient Application


Follow the steps below whenever you want to start the client application:


1.

In Windows Explorer, navigate to the
C:
\
Program Files
\
cemdps
_client

folder
and double
-
click the batch file called
startserver.bat
. This starts the Tomcat
server a
nd displays a command window.


Important Note:

Do not do anything else until the server completes the
initialization process.

The command
window

will

display a line similar to the line
below when it has completed startup.


“tomcat
-
4.1.31
\
conf
\
jk2.propert
ies”


The command window must stay open while you work in the disconnected client
application.

Do not close the command window until you are finished using the
application




25



2.

In the
cemdps_client

folder, double
-
click the batch file called
LaunchApplica
tion.bat
.
This will start the CEMDPS Disconnected Client
application.


26



3.

To begin using the system c
lick the
Enter Application

button.

This opens the
home page of the CEMDPS client application, which is similar to the CEMDPS
online application’s home pa
ge.

27



Stopping the
Disconnected
Client Application


1.

To exit the Disconnected Client application simply close your browser by
selecting File/Close from the menu or by clicking on the X in the top right corner
of the browser screen.

2.

To stop the server comma
nd window, double
-
click
stopserver.bat

in the
cemdps_client
folder on your hard drive to close the client application.

Note:

Under the normal Windows environment, you can close the client
application simply by closing your browser and the server command w
indow. In
some systems, closing the server command window may generate an error. If
your system creates an error message when closing the command window,
double
-
click
stopserver.bat

in the
cemdps_client
folder on your hard drive to
close the client appli
cation.


Synchronizing the
Disconnected
Client Application


28

After the initial setup of the client application, you must periodically synchronize the
application with the CEMDPS online application as internal DEP codes and your
facility’s configuration chan
ge
s
. Specifically, perform a synchronization when:




Y
ou
r request for changes to your

facility’s configuration
ha
s

been approved or
certified by DEP
(e.g.:
addition of a new
CEMS)


The sections of this document entitled
Step 2


Downloading Configuration a
nd Code
Files

and

Step 3


Starting and Synchronizing the Disconnected Client Application

contain the procedures for downloading the latest internal DEP codes file and
configuration file from the online CEMDPS system and applying them to your
disconnected
application.


General Notes on using the Disconnected Client
Application


1.

Using the Disconnected Client application to process multiple facilities
.

The Disconnected client is limited to processing configuration and report data for
one facility at a time.

I
n the situation where multiple facilities need to be processed, a second
Disconnected Client application should be installed on the local hard drive.

Use facility specific folder names under the Program F
iles folder on the C:
\

drive
when installing the app
lication for multiple facilities.

2.

Installing new versions of the Disconnected Client application.

Current work on a monitoring plan or quarterly report data must be uploaded to
the CEMDPS Online system before installing a new version of the Disconnected
Cl
ient application.

When a new version of the application is installed the database is refreshed back
to empty. Data that existed before the upgrade will be purged.

Depending on the nature of the upgrade, the database can be moved to a safe
location before
the upgrade and moved back to the
cemdps_client

folder after the
upgrade.

3.

The Disconnected Client does not support the attaching of supporting
documentation files.

If it is necessary to provide DEP with supporting documentation
,
these files
should

be uploa
ded to the CEMDPS Online system after uploading monitoring
plan or report data that was generated using the Disconnected Client.