Upgrading from ProblemTracker Versions 4.1 or 4.1.1 to Version 5.0.2
Before downloading ProblemTracker Enterprise Edition Version 5.0.2 (PTEE 5.0.2) or ProblemTracker Version 5.0.2 (standard edition), please review the information in the following sections:
Introducing ProblemTracker Enterprise Edition Version 5.0.2 (PTEE 5.0.2)ProblemTracker Enterprise Edition Version 5.0.2 is a new product offered in addition to the standard product, ProblemTracker Version 5.0.2. ProblemTracker Enterprise Edition includes all of the features available in the standard product as well as 2 new features, Alerts and Discussion. License Requirements for PTEE Version 5.0.2 and ProblemTracker Version 5.0.2PTEE 5.0.2 and ProblemTracker Version 5.0.2 require new license key(s). Your ProblemTracker Version 3 or 4 license keys will not work with Version 5 products. In order to upgrade to ProblemTracker Version 5.0.2, your support and upgrades subscription must be active (or at least active through 9/30/2002). If your subscription is current, you will receive a ProblemTracker Version 5 license key(s) via email. Please do not install Version 5.0.2 if you do not have your Version 5 License Keys as you will no longer be able to access Version 4 until you complete the upgrade. If you believe your subscription is current and have not yet received your Version 5 license key, contact NetResults Sales to inquire about your license key(s). To renew your subscription, click here for the support renewal form (pricing information is listed in the "Order Information" section). If you have any questions regarding your subscription, please contact NetResults Sales. In order to upgrade to ProblemTracker Enterprise Edition Version 5.0.2 (PTEE 5.0.2) to use the new Alerts and Discussion features, you must purchase license keys for this product. To upgrade to PTEE 5.0.2, please click here for the order form or contact NetResults Sales for more information. New FeaturesFor a more detailed list of new features and fixes in 5.0.2, click here. System Requirements for ProblemTracker Version 5.0.2NetResults ProblemTracker 5 has the following requirements. These requirements may have changed since the version of ProblemTracker you are currently using. Listed first are the requirements for use of multinationalization features (languages other than western European languages). Multinationalization features require newer versions of web browsers and web servers as many international web features have only recently been supported (and many standards are in fact still "in progress" in this area). Listed second are the requirements if you do not require multinational support. If any of the required software listed below is not installed on your server machine (or if you do not know if it is installed), click here for instructions on how to verify that you have the appropriate software, links to download the software, and instructions on how to install it. Multinationalization In order to use Multinationalization options (support of Non-Latin1 languages):Latin1 languages include the following - Basque, Catalan, Danish, English, Dutch, Finnish, French, German, Icelandic, Italian, Norwegian, Portuguese, Spanish, Swedish. If you plan to use a language other than one (or more) of those listed above, your system requires the following. Client Requirements:
Server Requirements:
Optional Database Support: In addition to the included support for Microsoft Access, ProblemTracker can be used with the following database systems:
General System Requirements (if not using Multinationalization):Client Requirements:
Server Requirements:
Optional Database Support: In addition to the included support for Microsoft Access, ProblemTracker can be used with the following database systems
Windows XP Professional is to be used as a platform for evaluation purposes only.Windows XP Professional is classified by Microsoft as a "desktop" operating system. There is no "server" version of Windows XP Professional. As such, the Microsoft license agreement for and implementation of IIS (the web server) severely restricts the number of concurrent users (a maximum of 10 concurrent connections, and a single browser may use multiple connections). Therefore, we support the use of Windows XP Professional with ProblemTracker for evaluation purposes only. Windows XP Professional is not supported as a production platform. Windows 2000 Server is recommended for use with ProblemTracker in a production environment. Known Issues in ProblemTracker Version 5.0.2
Upgrade PreparationEnsure your machine is prepared with the necessary components before upgrading to ProblemTracker 5 by reviewing the Preparation for Installing ProblemTracker section of the Online Help document. A review of how several new features in ProblemTracker Version 5.0.2 can affect your ProblemTracker 4 data is presented here. Recommendations to help you take advantage of these new features are also included below. Getting to Know ProblemTracker 5Probably the best way to "test drive" the new features of ProblemTracker 5 is to make use of the default workgroup (pteval) which is optionally installed along with ProblemTracker 5. To login to this workgroup, select Start->Programs->NetResults ProblemTracker 5->ProblemTracker Eval Version->Login Page, and enter Admin as the username and password. This workgroup is configured with the default (code template) configuration that a newly added Version 5 workgroup will have (it is what you would get by using the Add operation in the Workgroup Management System). You can use this as a test bed when reviewing the features described below. You can install this on a test system (test system use limited to 15 days). Windows NT 4.0 Service Pack 6a now required for use with ProblemTracker Version 5.0.2If you have installed ProblemTracker on a Windows NT 4.0 machine, Service Pack 6a is now required for use with ProblemTracker Version 5.0.2. This will allow you to take advantage of the bug fixes related to IIS 4.0 and security. Service Pack 6a can be downloaded from Microsoft at: http://www.microsoft.com/ntserver/nts/downloads/recommended/SP6/allSP6.asp User ManagementIn ProblemTracker 5, users for all workgroups are now managed in a central interface in the Workgroup Management System. This interface is called the License Administration section. In previous versions of ProblemTracker, a user could be added and edited within an individual workgroup. If the same user was a member of multiple workgroups, that user would need to be maintained in each of those workgroups. With the License Administration section, a user's account can be maintained in one location that updates all workgroups. Within each workgroup, a user can be assigned to user groups as in previous versions. If you are using (or plan to use) multinational workgroups in ProblemTracker, any users with a User Id that contains double-byte or other special characters that are only supported in the UTF-8 character set (Unicode), can only be used in a workgroup with UTF-8 selected as the character set. For more information about choosing a character set for a workgroup, please review the Adding a Workgroup section of the Workgroup Management System Help Guide. When upgrading a workgroup to ProblemTracker 5, you will be prompted to upgrade your users. If you are upgrading multiple workgroups to ProblemTracker 5 and have user accounts that belong to more than one workgroup (excluding the built-in users Admin, Inet, TBD), you may be prompted to resolve "User Conflicts". User Conflicts are instances where a user id appears in more than one of your workgroups, but has different profile information (email address, phone number, address, etc.). You will be asked to resolve the conflict by selecting the profile information that should be saved for the user account. If you are using multiple workgroups, it is possible that you have a user account with the same user id in multiple workgroups. Upon upgrade to Version 5, these user accounts with the same user id will be merged into a single user account. If you do not wish for these multiple accounts to be merged during the upgrade, before upgrading please rename the user accounts such that they no longer have the same user id. If you choose to install the evaluation workgroup (pteval) during the Version 5.0.2 installation setup program, a set of 6 default users will be created in the License Administration section. These default users may cause you to exceed the number of users allowed based on your license key(s) if you have other users defined in your workgroup(s). For example, if you have a license key for 5 static users. You have one workgroup with 5 users defined and choose to install the pteval workgroup. After upgrading your workgroup to Version 5.0.2. you will have your original 5 users + 6 default users created for use in the pteval workgroup. You can use the Delete User operation to delete the 6 default users. The names of the 6 default users are "dev_mgr", "qa_mgr", "process_mgr", "bld_mgr", "dev_one", and "qa_one". After deleting the default users, your original users can still use the pteval workgroup. Simply give your original users access to the pteval workgroup by using the Edit User Access operation. Please review the License Administration section of the Workgroup Management System (WMS) Help Guide for details about adding and maintaining users in ProblemTracker. If you are using Access or case-insensitive SQL Server as your database type, click here to skip the remaining paragraphs in this section, which only apply to Oracle or case-sensitive SQL Server users. If you are using Oracle or case-sensitive SQL Server as your database type, a conflict will arise when user ids that differ only in case (for example, "user_one" and "User_One") are upgraded to Version 5.0.2. If you have any user accounts with User Ids that differ only in case, one of the following conflicts may arise when upgrading to Version 5.0.2 (for example, you have a user id called "user_one" and another user id called "User_One").: Case 1: If these user accounts are present in the same workgroup, after upgrading to Version 5.0.2 only one of the user accounts will be able to login to the workgroup. In order to avoid this conflict, rename one of the user ids prior to upgrading to Version 5.0.2 so that the user ids are no longer the same when the case is ignored (for instance, you can change "User_One" to be "user1"). To rename a user account prior to upgrade, login as Admin to the workgroup(s) where the user id is present, click on the Admin icon, then click on the User Administration button. Click on the Edit button to the left of the user account you wish to modify, rename the user id, then click OK to save your changes. After renaming the user id, you can upgrade your installation to Version 5.0.2. If you already upgraded to Version 5.0.2 without renaming one of the user ids, you can rename one of the user ids by using the Edit User operation in the Workgroup Management System. Case 2: If these user accounts are present in different workgroups, after upgrading to Version 5.0.2 both user ids will be merged into a single user id. If you do not wish to have both user ids merged into a single user id, rename one of the user ids prior to upgrading to Version 5.0.2 so that the user ids are no longer the same when the case is ignored (for instance, you can change "User_One" to be "user1"). To rename a user account prior to upgrade, login as Admin to the workgroup(s) where the user id is present, click on the Admin icon, then click on the User Administration button. Click on the Edit button to the left of the user account you wish to modify, rename the user id, then click OK to save your changes. After renaming the user id, you can upgrade your installation to Version 5.0.2. Viewing User Profile InformationA new feature has been added to allow user names that appear on the Home, Query, and View pages to appear as clickable links. When clicking on a user name on these pages, a separate window will be displayed with the user's profile information as entered in the License Administration section of WMS. This feature is only enabled by default for the Admin group. To allow other user groups to use this feature, enable the user group privilege called "View User Information" for these user groups. This can be done in the User Administration section of the workgroup. The difference between "Add & Copy" and "Add"In ProblemTracker 5, there are 2 ways to add a new record. Option 1: Use the "Add" button to save a new record To add a new record using the "Add" button:
Creating a new record using this method will save the new record, then the Add page will be reloaded with all fields set to blank (e.g. for text & date fields) or default values (e.g. for pulldown fields). The function of the "Add" button has changed from ProblemTracker 3 and 4. In ProblemTracker 3 and 4, when the "Add" button was used to save a new record, the Add page would be reloaded, but the values of the pulldown fields would be displayed as they were entered in the record that was saved. This would allow a user to add a second record with similar information in the pulldown fields. This is now done by the "Add & Copy" button explained below. In ProblemTracker 5, when "Add" button is clicked to save a record, the Add form will re-set all fields to blank or default values. To add a new record using the "Add & Copy" button:
Creating a new record using this method will save the new record, then the Add page will be reloaded with some fields keeping the same value as was entered in the record you just saved. The Add page is set in this way so that it is ready for you to create another record. This is useful in cases where multiple records need to be added with similar information to be assigned to different departments, projects, or versions. You can customize which fields are saved for the next added record by editing the field attributes in the Define Record section of the Administration page. MetricsThe Summary (Charts & Graphs) section has been changed to Metrics. The Metrics page allows you to create saved charts for personal use and user groups. Saved Charts can also be run based on the results of a Saved Query to limit the data set. Access to the Metrics page and the ability to save group charts and chart layouts are privileges that are enabled for the Users group by default. To change the privileges related to Metrics, please refer to the User Group Privileges section of the Administrative Help Guide. For more details on using the new Metrics features, please review the Metrics section of the User Help Guide. "Read-Only" Task FieldsThe ability to configure "read-only" task fields is available in ProblemTracker 5. This allows a field that cannot be modified to be displayed during the task operation. Date fields can be configured as "read-only", initialized task fields. This allows a date field to be initialized (set with the current date & time) during the task operation, but cannot be modified by the user. More information on "read-only" task fields can be found in the Workflow Transitions section of the Administrative Help Guide. ProblemTracker Enterprise Edition Version 5.0.2 (PTEE 5.0.2) FeaturesIf you are simply upgrading to ProblemTracker Version 5.0.2 (standard edition) without purchasing PTEE 5.0.2, click here to skip this section. If you have purchased license(s) for ProblemTracker Enterprise Edition Version 5.0.2 (PTEE 5.0.2), please review the information in the following section: Alerts (PTEE 5.0.2)The Alerts feature is included in PTEE 5.0.2. Alerts allows you to schedule a notification message to be sent for a record at a particular date and time. These alert messages can be used as reminders to take action on a record or can be used to escalate a record which has not progressed through the workflow. To set up the Alerts feature after your upgrade to PTEE 5.0.2, please review the Customizing Alerts section of the Online Help document. Discussion (PTEE 5.0.2)The Discussion feature is included in PTEE 5.0.2. Discussion allows you to initiate discussions within a record in ProblemTracker. These discussions allow your users to collaborate on various topics relevant to a record in parallel to the record's progress through the workflow. To set up the Discussion feature after your upgrade to PTEE 5.0.2, please review the Customizing Discussions section of the Online Help document. Download Link and Upgrade InstructionsDownload InformationGo to the Support Downloads page to download the latest version of ProblemTracker and any applicable patches, then return to this section for the detailed instructions to upgrade your installation. Click here to download ProblemTracker Enterprise Edition Version 5.0.2 (PTEE 5.0.2). Otherwise, click here for ProblemTracker Version 5.0.2 (standard edition). Upgrade InstructionsSection 1 - Backup your ProblemTracker InstallationFor Access Users:For each of items below, a default path is listed. The "<installation directory>" mentioned in the path may be "C:\Inetpub\wwwroot\ProblemTracker" for Internet Information Server users. Or, it may be a value other than the default if the default was overridden in the original installation. Typically it is at the "root" of your (virtual) web site.
For SQL Server 7.0 / 2000 or Oracle Users:For each of items below, a default path is listed. The "<installation directory>" mentioned in the path may be "C:\Inetpub\wwwroot\ProblemTracker" for Internet Information Server users. Or, it may be a value other than the default if the default was overridden in the original installation. Typically it is at the "root" of your (virtual) web site.
IMPORTANT NOTE FOR ALL USERS: It is REQUIRED that you either copy the database file(s) to a safe place (Access only) or perform a backup (Access, SQL Server or Oracle). Section 2 - Running the Installation Set up Program and Performing the Upgrade from Version 4.1 or 4.1.1 to Version 5.0.2
|
Your system has now been upgraded to Version 5.0.2 for all workgroups.
Support Resources
If you have feedback or questions about this release, please contact NetResults Technical Support for assistance. A Version 5 Online Help document is also available for this release. If you receive any errors during the installation, upgrade process, or while using ProblemTracker, please consult the Installation Errors section of the FAQ and/or the Known Issues section of this page.