CELLTRAQ Battery Monitoring Software Instructions April 2009 167-000128A INNOVATION TECHNOLOGY QUALITY WORLDWIDE
Page 2 CELLTRAQ Overview CELLTRAQ CELLTRAQ is a web application that is used to monitor the health of batteries, generate reports, and notify users via email when thresholds have been crossed. The server side is Apache Tomcat 6 and the database is Microsoft SQL Server 2005. The client side is a general Web browser. Before you can use the CELLTRAQ system, you must install JDK, Apache Tomcat, SMTP Tester Interface and the CELLTRAQ application. You must also build the database. Wizard Installation CELLTRAQ requires that the Microsoft SQL Server 2005 database be installed prior to installation. If it is not installed, a free version is available on the CD and located in the SQL Server 2005 Express folder. To install SQL Server 2005 Express, please follow the instructions in the Installing SQL Server 2005 Express document. Installing JRE NOTE: For Microsoft Vista: Installation must be performed by a user with an Administrator account. User Account Control must also be disabled during installation. 1. Left click on the Windows START button and choose RUN. 2. Navigate to the CELLTRAQ CD. 3. Double-click on jre-6u10-windows-i586-p.exe to start the installation. The included Java programs will require Java Runtime Environment. 4. Proceed to running the installation wizard after JRE as been installed. Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527 www.midtronics.com
CELLTRAQ Running The Installation Wizard 1. Left click on the Windows START button and choose RUN. Page 3 2. Navigate to the CELLTRAQ CD. 3. Double-click on CELLTRAQ_Install_Wizard.jar to begin the installation. The Wizard welcome screen appears. Click NEXT to continue. 4. At the License Agreement window, after reading the Agreement, click in the box next to I Agree. You must check this box before the installation will proceed. www.midtronics.com Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527
Page 4 Click NEXT to continue. CELLTRAQ NOTE: The NEXT button will remain inactive until the I Agree box has been checked. 5. The Install JDK dialog box appears. Click on the Install JDK button to begin the installation process. At the end of the installation process the Sun Microsystems registration screen will appear. Registration is optional. Once JDK has been successfully installed, click NEXT to continue. You must install JDK before the NEXT button is enabled. NOTE: Do not restart the computer follow the successful installation of the JDK software. Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527 www.midtronics.com
CELLTRAQ 6. The Install Tomcat dialog box appears. Page 5 Click on the Install Tomcat button to begin the installation process. Once Tomcat has been successfully installed, click NEXT to continue. You must install Tomcat before the NEXT button is enabled. 7. The Install JDBC Driver dialog box appears. Click on the Install Driver button to begin the installation process. www.midtronics.com Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527
Page 6 CELLTRAQ Once the JDBC driver has been successfully installed, click NEXT to continue. You must install the driver before the NEXT button is enabled. 8. The Configure Environment Variables dialog box appears. Click on the Check System button to check your system for the executable needed to set environment variables. Click on the Set Variables button to configure the environmental variables. Once the variables have been successfully configured, click NEXT to continue. You must complete this step before the NEXT button will be enabled. Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527 www.midtronics.com
CELLTRAQ 9. The Install CELLTRAQ Application Server dialog box appears. Page 7 Click on the Install button to begin the installation process. Click NEXT to continue. You must complete this step before the NEXT button will be enabled. 10. The Database Setup dialog box appears. Complete STEP 1 and STEP 2 before continuing. Click NEXT to continue. www.midtronics.com Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527
Page 8 11. The software installation is now complete. CELLTRAQ The Installation Complete dialog box appears Click on the Start CELLTRAQ button to open the CELLTRAQ software. This will test CELLTRAQ to verify that the installation was successful After the installation has completed and Tomcat and the SMTP Tester Interface have started, open your web browser and test CELLTRAQ by typing in the following URL in your browser: http://localhost/celltraq/logon.jsp Click FINISH to complete the process. Attach Database Use the following procedure to attach the CELLTRAQ.mdf using the Management Studio. a. From the Windows START button navigate to Programs / Microsoft SQL Server 2005 / SQL Server Management Studio Express. (Connect using Window Authentication) b. Right Click on Database. c. Click Attach to attach CELLTRAQ Database. Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527 www.midtronics.com
CELLTRAQ Page 9 d. Click Add to navigate to directory of mdf located in the CELLTRAQ\ Database directory. Update server.xml (Optional) You can have the SQL server database on another server from the CELLTRAQ software. The server name must be changed in order for the software to function properly. servername is the address of the server to which you want to connect. This can be a DNS or IP address. It can also be a localhost or 127.0.0.1 for the local computer If not specified in the connection URL, the server name must be specified in the Properties collection. Once the CELLTRAQ software has been installed, there will be a file called server.xml that will need to be updated. On the line url= change localhost to match your server. The user name, password and port in the resource section of the server.xml document should match your database settings <Resource name= jdbc/celltraq type= javax.sql.datasource password= sa2005 driverclassname= com.microsoft.sqlserver.jdbc.sqlserverdriver maxidle= 30 maxwait= 5000 username= sa url= jdbc:sqlserver://localhost:1433;databasename=celltraq maxactive= 200 /> www.midtronics.com Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527
Page 10 Running Tomcat As A Service You have the option of running Tomcat as a service. CELLTRAQ 1. Navigate to the Windows Control Panel and double click on the Administrative Tools icon. 2. In the Administrative Tools window, locate Services and double click on it. 3. From the Services Window, locate Apache Tomcat and double click on it. 4. Within the Apache Tomcat dialog box, locate Startup type:. Select Automatic from the drop down menu. 5. Click OK to save your changes. Running SMTP TI As A Service. You have the option of running the SMTP Tester Interface as a service. 1. Navigate to the Windows Control Panel and double click on the Administrative Tools icon. 2. In the Administrative Tools window, locate Services and double click on it. 3. From the Services Window, locate Midtronics Tester Interface and double click on it. 4. Within the Midtronics Tester Interface dialog box, locate Startup type:. Select Automatic from the drop down menu. 5. Click OK to save your changes. Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527 www.midtronics.com
CELLTRAQ CELLTRAQ Administration Page 11 Login 1. Open your web browser and enter: http://localhost/celltraq/logon.jsp The CELLTRAQ User Login screen appears. 2. Log in to the Administration application using the default user name and password. User Name: Admin Password: Admin www.midtronics.com Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527
Page 12 License Key 1. Enter your license key that you received from Midtronics. CELLTRAQ 2. Press SAVE. The Mac Address of the CELLTRAQ Server and the maximum number of enabled users will appear. Email Server Change the email server information to represent your server. Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527 www.midtronics.com
CELLTRAQ Page 13 On this screen you also have the ability to customize the email notification alert. Dear Customer: The purpose of this e-mail is to ALERT you of a critical event, which has just occurred on your battery system. Total Warnings: 1 The alert of, Low Warning is present on your Battery Plant: Midtronics-BP; String: Cabinet-A; Battery: Battery 1 Due To: Measurement Type: Temperature Measurement Timestamp (GMT): 9/4/08 1:17 PM Measurement Value: 13 Celsius / 55 Fahrenheit Absolute Low Warning Threshold: 15 Celsius / 59 Fahrenheit Operating State: Normal Actions you should take at this time: Check heating unit is working properly. Raise room temperature to 25 degrees Celsius /77 degrees Fahrenheit. SNMP Traps Example Email Notification This feature allows the CELLTRAQ Server to send SNMP Traps when alerts occur. Enter the sender and destination IP Address. Low Warning is present on XXX Site; XXX BP; String 1; Battery 2 Due To: Voltage 11.87 Example SNMP Trap www.midtronics.com Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527
Page 14 Midtronics-MIB.txt CELLTRAQ -- ******************************************************* ********** -- MIDTRONICS-MIB: Midtronics Base Coordinator Unit MIB file -- -- June 2008, Happy Xu -- -- Copyright (c) 1983-2008, 2008 by Midtronics, Inc. -- All rights reserved. -- -- ******************************************************** ********* MIDTRONICS-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, TimeTicks, Counter32, snmpmodules, mib-2 FROM SNMPv2-SMI DisplayString, TestAndIncr, TimeStamp FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF; midtronics OBJECT IDENTIFIER ::= { enterprises 31049 } midtronicsmibmodule MODULE-IDENTITY LAST-UPDATED 20080710A -- 10 July 2007 ORGANIZATION Midtronics MIB Working Group CONTACT-INFO Happy Xu Postal: Midtronics, Inc. Noble Center 16E-1,Fu Zhong San road 1006, Shenzhen, Guangdong province China Phone: 86-755-82022034 Fax: 86-755-82022039 Email: zxu@midtronics.com DESCRIPTION This MIB is for adpating Celltraq to SNMP environment. REVISION 20080711A -- 11 July 2007 ::= { midtronics 3 } midtronicstrap OBJECT IDENTIFIER ::= { midtronics 7000 } alarmtrap NOTIFICATION-TYPE STATUS current DESCRIPTION Alarm info from Celltraq system. ::= { midtronicstrap 1 } END Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527 www.midtronics.com
CELLTRAQ Add User From the User tab, click the Add User button to add users. Page 15 You may add up to the maximum number permitted by your license key. Individuals with the role of Supervisor will have the ability to set user access rights within the CELLTRAQ application by clicking Admin on the toolbar. www.midtronics.com Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527
Page 16 Additional Screens Password CELLTRAQ The Change Admin Password screen is where you can change your password Thesaurus The Translatable Terms screen is where you can change the terminology for email alert notifications to terms that you or your customer may be used to. For example, in email notifications, the term High Alarm can be changed to Significant Alert. Recommended Action From this screen you can change the recommended actions for each alert type. About CELLTRAQ product information can be viewed from the About screen. This includes version information for CELLTRAQ, JDK and Tomcat. It also includes the maximum number of users allowed within CELLTRAQ. Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527 www.midtronics.com
CELLTRAQ Troubleshooting Page 17 Details concerning an error can be found by checking the exceptions information displayed in the Tomcat console window. Database can not reached Possible reasons: Database is not running Activate the start menu and click run, input telnet servername 1433. If you can see a blank and black window with a flashing cursor on the top left corner, then the database is running; otherwise, the database is not running. (The servername is the name of the computer where database is installed; 1433 is the default port. Update this if you re using another port.) JDBC is not installed correctly Cannot create PoolableConnectionFactory (Error establishing socket) Possible reasons: Port number not correct Check port number using the Server Network Utility. This port number needs to match the port number in the server.xml file With the Configuration Manager, verify that the TCP port assignment is 1433 www.midtronics.com Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527
Page 18 Adding CELLTRAQ As A Trusted Site (Exporting to Excel) CELLTRAQ To use the Export to Excel feature in CELLTRAQ, the CELLTRAQ Website must be added as a trusted site. Clipboard access will also need to be changed. 1. Navigate to CELLTRAQ Login Screen 2. In Internet Explorer, select Internet Options from the Tools menu. 3. Click on the Security tab. 4. Click on the Trusted sites icon. 5. Click on the Custom level... button. 6. Scroll down to Scripting. This option is usually towards the bottom of the window. 7. Under Allow Programmatic clipboard access option, check or select Enable. The default action is Prompt. This causes a pop-up message whenever there is any attempt to access the Clipboard. 8. Click OK. 9. Click the on Sites button. 10. Enter CELLTRAQ as a trusted site and click Add. The CELLTRAQ website should appear in the lists of trusted websites. 10. Click Close and then OK to exit Internet Options. Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527 www.midtronics.com
CELLTRAQ Installation Requirements for Microsoft Vista Page 19 1. The software installation has to be performed by a user with Administrator rights. 2. The User Account Control (UAC) must be turn off (unchecked) before installing the CELLTRAQ software. www.midtronics.com Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527
Page 20 CELLTRAQ Midtronics Inc. 7000 Monroe Street Willowbrook, IL 60527 www.midtronics.com