OPENPOINT ISSUE TRACKER Version 2.1 **************************************************************************** RUNNING OPENPOINT ISSUE TRACKER **************************************************************************** Once OpenPoint Issue Tracker has been installed, you can run it from the Windows Start menu or the icon on your Desktop. If you elected to not add Issue Tracker to your Start menu or Desktop, you can run it by executing: X:\\Run\IssueTracker.cmd where X: is the drive on which OpenPoint Issue Tracker is installed. Once this command is executed, a DOS window will appear followed by a small OpenPoint Server window. If OpenPoint Issue Tracker is working correctly, the web server will already be started. The 'Start' button should be disabled, and the 'Restart'and 'Stop' buttons should be enabled. The server window must remain open for the application to run. You may close the DOS command window, if you wish. Click on the 'Go...' menu item on the OpenPoint Server menu bar. A browser window should appear, displaying the Issue Tracker home page. Note that if a browser window is already open, Issue Tracker will use that window. You can also enter: http://localhost:8080/issuetracker in the address bar of your browser. (The port number -- 8080 -- must match the port you chose during installation.) You will need to sign in to the application before you can use it. The default System Administrator user id is 'Admin' and the password is 'changeme'. You should change the default password. You may inactivate or delete the default System Administrator, but make sure that you establish a new, active System Administrator first; otherwise, you will lock yourself out of the system. In addition to the System Administrator, there is one Regular User included with the database. The user id is 'User' and the password is 'changeme'. You may delete or inactivate this user, if you wish. ***************************************************************************** KNOWN INSTALLER ISSUE ***************************************************************************** For some installs, an error message will appear at the end of the installation routine: 'The jar-file 'IssueTrackerInstall.jar' could not be executed' This message can safely be ignored. We are working to resolve this issue. More information can be found at: http://developer.berlios.de/bugs/?func=detailbug&bug_id=3795&group_id=1408 ***************************************************************************** A NOTE ABOUT WEB SERVERS ***************************************************************************** OpenPoint Issue Tracker is a web-based application. This means that it runs under a web server. If the computer that you installed OpenPoint Issue Tracker on is connected to a network with TCP/IP protocol enabled, other computers on the network will be able to access OpenPoint Issue Tracker. If you want others to be able to access the application, they can do so by going to: http://computername:8080/issuetracker where 'computername' is the name or IP address of your computer. OpenPoint Issue Tracker is secured by user ID and password to prevent unauthorized access. Other users do not have access to any other part of your computer via OpenPoint Issue Tracker (for example, they can't access files or other system resources). It is possible to make your implementation of OpenPoint Issue Tracker available to others across the Internet. This is not the default functionality, and configuring it to do so is out of the scope of this document. ***************************************************************************** IF IT DOESN'T WORK... ***************************************************************************** NOTE: If you cannot find the answer here, check: http://www.faxone.com/Products/issuetracker.html 1. Do you have the correct version of Java installed? ----------------------------------------------------- OpenPoint Issue Tracker requires Java version 1.4 or newer. To check your version of Java, open a DOS command window. At the prompt, type: java -version If you have the correct version, you should see a response similar to: java version "1.5.0_04" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_04-b05) Java HotSpot(TM) Client VM (build 1.5.0_04-b05, mixed mode, sharing) If necessary, you can download and install Java from http://java.com. 2. Is the port available? ------------------------- If the port you selected during install is not available, you will get a message like 'Port 8080 is in use by another application'. There are several reasons why the port may not be available: Another application on your system may already be using the port you selected, your system administrator may have restricted the ports you may use, or you may have already started another instance of OpenPoint Issue Tracker. Although OpenPoint is capable of processing requests to HTTPS ports (usually Port 443), this version of OpenPoint Issue Tracker does not have this feature enabled. You can change the port on which OpenPoint Issue Tracker runs by locating the issuetracker.xml file which is in the xmllib directory. Open this file using a text (such as Notepad) or an XML editor. Locate the tag like: 8080 near the top of the file (if you selected a port other than the default of 8080, that number will be in the XML). Enter an alternative port. For example: 9000 and save the file. Once it is saved, try starting the application. 3. Unable to connect to database? ---------------------------------- There are several reasons that OpenPoint Issue Tracker may not be able to connect to its database. The most likely reason is that you do not have the correct ODBC Microsoft Access Driver installed. To check the driver: 1. Open the 'ODBC Data Source Administrator'. - Windows 98: 'Control Panel' under '32bit ODBC' - Windows 2000: 'Control Panel', then 'Administration Tools', then 'Data Sources ODBC'. If you can't find it on your system then you don't have any ODBC drivers installed. 2. Once you open the ODBC Data Source Administrator, select the 'Drivers' tab. You should now see a list of ODBC drivers installed on your computer. 3. Review the list for 'Microsoft Access Driver (*.mdb)'. 4. Check the version number of the driver; OpenPoint Issue Tracker requires version 4 or above. 4. Unable to sign on to OpenPoint Issue Tracker? ------------------------------------------------- The default System Administrator user id is 'Admin' and the password is 'changeme'. Note that passwords are case-sensitive; user IDs are not. In addition to the System Administrator, there is one Regular User included with the database. The user id is 'User' and the password is 'changeme'. You may delete this user, if you wish. If you are unable to sign on with another user ID and password, sign on as a System Administrator and check that the user is 'Active' (to do this, go to the Admin menu, and select Maintain People). You can also reset the user's password with this screen. 5. Unable to see the table maintenance items on the Admin menu? ---------------------------------------------------------------- Only System Administrators can see the table maintenance items on the Admin menu. To grant permission to access all functionality within OpenPoint Issue Tracker, assign a user as a System Administrator. The application permits more than one System Administrator. ***************************************************************************** BACK-UP ***************************************************************************** You should back up your OpenPoint Issue Tracker database regularly. To do so, copy the IssueTracker.mdb from the data directory to another location. ***************************************************************************** SUPPORT ***************************************************************************** Direct technical support is not currently offered for the freeware version of OpenPoint Issue Tracker. Some support information is available on the OpenPoint Issue Tracker Home Page: http://www.faxone.com/Products/issuetracker/issues Please submit any bugs, problems or enhancement suggestions via the link on the Help menu or by emailing issuetracker@faxone.com. We will do our best to address them. ***************************************************************************** REMOVAL / UNINSTALL ***************************************************************************** We hope that you will opt to keep OpenPoint Issue Tracker, but we also realize that you may want or need to uninstall it from your system. To remove OpenPoint Issue Tracker: 1. Make sure that the OpenPoint Server is stopped. 2. You can either: - Select OpenPoint / Issue Tracker / Uninstall Issue Tracker from the Windows Start menu. Or: - Delete the entire directory in which you installed OpenPoint Issue Tracker. Or: - Run the uninstaller.jar file in the Uninstaller directory (under the directory in which you installed OpenPoint Issue Tracker) by right-mouse clicking the file, and selecting Open. If the uninstaller does not remove the the directory in which you installed OpenPoint Issue Tracker, delete it manually. Note that the Issue Tracker database will be deleted so any data that you have entered will be lost. At FaxOne, we do not like software that cannot be removed easily. OpenPoint Issue Tracker does not add anything to the Windows registry or place files anywhere on the file system other than in the directory in which it is installed. (If you elect to add OpenPoint Issue Tracker to the Windows Start menu or the Desktop, shortcuts will have been added in these locations. If the uninstaller does not remove them, you may delete them manually.) The installer creates temporary files which are usually removed by Windows. You may delete them manually, if you wish. The files are located under the in X:\Documents and Settings\\Local Settings\Temp directory. Note that the uninstall process will not remove Java from your system. This is because Java may be used by other applications (and may have been installed prior to installing OpenPoint Issue Tracker). If you wish to remove Java, you can find the instructions here: http://www.java.com/en/download/help/5000010800.xml In addition, the uninstaller will not remove any Excel spreadsheets or Adobe PDFs that you may have saved (other than those saved in the directory in which you installed OpenPoint Issue Tracker). Finally, if you believe we have omitted any instructions that would facilitate removal of OpenPoint Issue Tracker please email us at issuetracker@faxone.com. ***************************************************************************** PRIVACY ***************************************************************************** We respect your privacy. OpenPoint Issue Tracker does not submit any information whatsoever to FaxOne or to anyone else. No client-side cookies are stored on users' computers. We will not share any identifying information (including email addresses, names and telephone numbers) with any third party. If you submit a bug report via issuetracker@faxone.com, we reserve the right to add the issue to our database and display it on our web site. We will not include identifying information on the web site. If you do not want your issue on our web site, please state that in your email. ***************************************************************************** (c) Copyright 2005, FaxOne Systems LLC www.faxone.com