Read Me - NetResults ProblemTracker 5.5.4
© Copyright 1997-2005 NetResults Corporation. All Rights Reserved.
These are the Release Notes for NetResults ProblemTracker Version 5.5.4. This is the version on our web site. It was most recently updated on March 28, 2005. Click here to review our Online ProblemTracker Help.
Before using (or upgrading to) ProblemTracker Enterprise Edition Version 5.5.4 (PTEE 5.5.4) or ProblemTracker Version 5.5.4 (Standard Edition), please review the information in the following sections:
System Requirements for ProblemTracker Version 5.5.4
NetResults ProblemTracker 5.5.4 has the following requirements. Listed first are the requirements for use of multinationalization features (languages other than western European languages). Multinationalization features require newer versions of 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.
In order to use Multinationalization options (support of Non-Latin1 languages):
Latin1 languages include the following - English, Basque, Catalan, Danish, 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
|
Upgrade Instructions
Click on the link below that corresponds to the version you are upgrading from to see the upgrade instructions relevant to your current version:
Upgrading from Version 2.x requires assistance from NetResults Technical Support. Please do not attempt to upgrade your Version 2.x installation without assistance.
Upgrading from Versions 5.5 - 5.5.3 to Version 5.5.4
Section 1 - Backup your ProblemTracker Installation
For 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.
- Copy all ProblemTracker workgroup database files which are to be upgraded and archive the copies in a safe location. These files are shown below for a default installation.
<installation directory>\workgroup\Database\Bugtrack.mdb - Copy all ProblemTracker workgroup attachment files and archive the copies in a safe location. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Attachments
- Copy the Workgroup Management System database file. The default location is:
<installation directory>\ptadmin\Database\ptadmin.mdb - Copy the User Management database file. The default location is:
<installation directory>\ptcommon\Database\ptcommon.mdb - If you have customized the login page with your own html, you need to back up the corresponding files as well. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Include\loginbottom.inc
<installation directory>\workgroup\Include\logintop.inc
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.
- For each workgroup, you may backup SQL Server 7.0/2000 or Oracle database(s) by using SQL Server or Oracle backup or data export operation. Backups may done to a hard disk as well as to tape. Please review your SQL Server or Oracle documentation for further information.
- Copy all ProblemTracker workgroup attachment files and archive the copies in a safe location. These files are located in the path (folder)
shown below for a default installation.
<installation directory>\workgroup\Attachments
- Copy the Workgroup Management System database file. This will in Access format even if your workgroup databases are SQL Server or Oracle databases. The default location is:
<installation directory>\ptadmin\Database\ptadmin.mdb
- Copy the User Management database file. The default location is:
<installation directory>\ptcommon\Database\ptcommon.mdb
- If you have customized the login page with your own html, you need to back up the corresponding files as well. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Include\loginbottom.inc
<installation directory>\workgroup\Include\logintop.inc
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). UNDER NO CIRCUMSTANCES IS NETRESULTS RESPONSIBLE FOR THE LOSS OF ANY DATA AS THE RESULT OF THE INSTALLATION PROCESS.
Section 2 - Running the Installation Set up Program and Performing the Upgrade from Versions 5.5 - 5.5.3 to Version 5.5.4
- GO TO SECTION 1.0 ABOVE AND BACKUP ALL OF YOUR PROBLEMTRACKER DATABASES BEFORE PROCEEDING.
- Prior to installing ProblemTracker Version 5.5.4, please make sure all users are logged out of every workgroup. You may wish to block the workgroups via the Workgroup Management System (WMS) while you perform the upgrade. To end any active sessions and block a workgroup:
- Login to WMS
- Click on the Admin icon
- Select the option Block / Unblock Workgroups, then click on the Continue button
- Select a workgroup (or select all workgroups by checking the box at the top left of the workgroup list), then click on the Logoff User Sessions button at the bottom
- Click on an active session, then click on the Logoff button. After all sessions have been logged off, click OK to return to the Block / Unblock section.
- Select the workgroup you wish to block (or select all workgroups by checking the box at the top left of the workgroup list), then click on the Block button.
- Repeat the steps above for each workgroup you wish to block.
- Temporarily disable any anti-virus software while you run the Version 5.5.4 installation program and perform configuration steps in the Workgroup Management System (WMS). This is recommended so that your anti-virus software will not prevent the installation program or WMS from performing operations such as copying files, running scripts, configuring your web server, setting file permissions and registry entries. Your anti-virus software can be reactivated safely after you have completed the installation steps and any necessary WMS configuration.
- If you are upgrading a NT 4.0 Server installation, temporarily stop all IIS services (IIS Admin Service and World Wide Web Publishing Service) while you run the Version 5.5.4 installation setup program. Running the installation setup program without stopping all IIS services will prevent you from receiving all of the necessary file updates included in this version. This step is optional if you are upgrading a Windows 2000 Server or Windows Server 2003 installation as the upgrade program will stop (and restart) the services for you.
- Install ProblemTracker 5.5.4 or ProblemTracker Enterprise Edition 5.5.4. To do this, login to the web server machine as Administrator and then run (double-click from Windows Explorer) pbtrk554.exe (ProblemTracker 5.5.4) or ptee554.exe (ProblemTracker Enterprise Edition 5.5.4). During the installation, if you are asked about updating "read only" files, answer Yes (overwrite the read only file as a part of the installation). When the installation setup program has finished, you will be asked to reboot your system.
- Login to the Workgroup Management System (WMS) by going to Start->Programs->NetResults ProblemTracker 5->Workgroup Management System. To upgrade your workgroups, click on the Admin icon on the Button bar. Select the option "Upgrade workgroups from versions 4.x / 5.x to ProblemTracker 5.5.4", then click on the Continue button.
- A list of workgroups that need to be upgraded from Version 5.5 - 5.5.3 to 5.5.4 will be displayed. Click on the "Upgrade All Workgroups" button to upgrade all of the workgroups at once. A confirmation message will be displayed once each workgroup has been upgraded successfully.
If any of your workgroups were created in Version 5.5 with "Help Desk" or "Customer Support" selected as the template type, you will need to complete additional steps on those workgroups. This step does not need to be performed if you are upgrading from Version 5.5.1 or newer. To check the template type for your workgroups, click on the Home icon in the Workgroup Management System (WMS), then click on the View icon to the left of a workgroup listed on the Home page. In the "Database" section, check what is listed for "Template". If it says "helpdesk" or "support", please perform the following additional steps:
- Login as Admin to a workgroup which has "helpdesk" or "support" selected as the template.
- Click on the Admin icon.
- Click on the Maintenance button.
- Click on the "Fix Mail Config Error" button. Wait until the Status bar is updated to confirm that the operation has finished.
- Click on the Logoff button to log out of the workgroup.
- Repeat the steps above for each workgroup with "helpdesk" or "support" selected as the template.
If you are upgrading from Version 5.5 AND any of your workgroups use an Oracle database, you will need to complete additional steps on those workgroups. This step does not need to be performed if you are upgrading from Version 5.5.1 or newer. To check the database type for your workgroups, click the Home icon in the Workgroup Management System (WMS), then click the View icon to the left of a workgroup listed on the Home page. In the "Database" section, check what is listed for "Type". If it is "Oracle", please perform the following additional steps:
- Login as Admin to a workgroup which has "Oracle" as the database type.
- Click on the Admin icon.
- Click on the Maintenance button.
- Click on the "Fix Default Queries" button. Wait until the Status bar is updated to confirm that the operation has finished.
- Click on the Logoff button to log out of the workgroup.
- Repeat the steps above for each workgroup with "Oracle" as the database type.
- Go back to the Workgroup Management System Home Page. To login to your upgraded workgroup, click on the key icon to the left of the workgroup name from the list on the WMS Home Page. Login to the workgroup to confirm that the upgrade was successful.
- Re-activate your anti-virus software and, if you are running NT 4.0 Server, re-start IIS services.
Your system has now been upgraded to Version 5.5.4 for all workgroups.
Upgrading from Versions 5.0 - 5.0.2 to Version 5.5.4
Section 1 - Backup your ProblemTracker Installation
For 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.
- Copy all ProblemTracker workgroup database files which are to be upgraded and archive the copies in a safe location. These files are shown below for a default installation.
<installation directory>\workgroup\Database\Bugtrack.mdb - Copy all ProblemTracker workgroup attachment files and archive the copies in a safe location. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Attachments
- Copy the Workgroup Management System database file. The default location is:
<installation directory>\ptadmin\Database\ptadmin.mdb - Copy the User Management database file. The default location is:
<installation directory>\ptcommon\Database\ptcommon.mdb - If you have customized the login page with your own html, you need to back up the corresponding files as well. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Include\loginbottom.inc
<installation directory>\workgroup\Include\logintop.inc
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.
- For each workgroup, you may backup SQL Server 7.0/2000 or Oracle database(s) by using SQL Server or Oracle backup or data export operation. Backups may done to a hard disk as well as to tape. Please review your SQL Server or Oracle documentation for further information.
- Copy all ProblemTracker workgroup attachment files and archive the copies in a safe location. These files are located in the path (folder)
shown below for a default installation.
<installation directory>\workgroup\Attachments
- Copy the Workgroup Management System database file. This will in Access format even if your workgroup databases are SQL Server or Oracle databases. The default location is:
<installation directory>\ptadmin\Database\ptadmin.mdb
- Copy the User Management database file. The default location is:
<installation directory>\ptcommon\Database\ptcommon.mdb
- If you have customized the login page with your own html, you need to back up the corresponding files as well. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Include\loginbottom.inc
<installation directory>\workgroup\Include\logintop.inc
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). UNDER NO CIRCUMSTANCES IS NETRESULTS RESPONSIBLE FOR THE LOSS OF ANY DATA AS THE RESULT OF THE INSTALLATION PROCESS.
Section 2 - Running the Installation Set up Program and Performing the Upgrade from Versions 5.0 - 5.0.2 to Version 5.5.4
- GO TO SECTION 1.0 ABOVE AND BACKUP ALL OF YOUR PROBLEMTRACKER DATABASES BEFORE PROCEEDING.
- Prior to installing ProblemTracker Version 5.5.4, please make sure all users are logged out of every workgroup. You may wish to block the workgroups via the Workgroup Management System (WMS) while you perform the upgrade. To end any active sessions and block a workgroup:
- Login to WMS
- Click on the Admin icon
- Select the option Block / Unblock Workgroups, then click on the Continue button
- Select a workgroup, then click on the Logoff User Sessions button at the bottom
- Click on an active session, then click on the Logoff button. After all sessions have been logged off, click OK to return to the Block / Unblock section.
- Select the workgroup you wish to block, then click on the Block button.
- Repeat the steps above for each workgroup you wish to block.
- Temporarily disable any anti-virus software while you run the Version 5.5.4 installation program and perform configuration steps in the Workgroup Management System (WMS). This is recommended so that your anti-virus software will not prevent the installation program or WMS from performing operations such as copying files, running scripts, configuring your web server, setting file permissions and registry entries. Your anti-virus software can be reactivated safely after you have completed the installation steps and any necessary WMS configuration.
- If you are upgrading a NT 4.0 Server installation, temporarily stop all IIS services (IIS Admin Service and World Wide Web Publishing Service) while you run the Version 5.5.4 installation setup program. Running the installation setup program without stopping all IIS services will prevent you from receiving all of the necessary file updates included in this version. This step is optional if you are upgrading a Windows 2000 Server or Windows Server 2003 installation as the upgrade program will stop (and restart) the services for you.
- Install ProblemTracker 5.5.4 or ProblemTracker Enterprise Edition 5.5.4. To do this, login to the web server machine as Administrator and then run (double-click from Windows Explorer) pbtrk554.exe (ProblemTracker 5.5.4) or ptee554.exe (ProblemTracker Enterprise Edition 5.5.4). During the installation, if you are asked about updating "read only" files, answer Yes (overwrite the read only file as a part of the installation). When the installation setup program has finished, you will be asked to reboot your system.
- Login to the Workgroup Management System (WMS) by going to Start->Programs->NetResults ProblemTracker 5->Workgroup Management System. To upgrade your workgroups, click on the Admin icon on the Button bar. Select the option "Upgrade workgroups from versions 4.x / 5.x to ProblemTracker 5.5.4", then click on the Continue button.
- A list of workgroups that need to be upgraded from Version 5.0 - 5.0.2 to Version 5.5.4 will be displayed. Select a workgroup from the pulldown, then click on the "Upgrade Workgroup" button to proceed then click OK to confirm. A confirmation message will be displayed once the workgroup has been upgraded successfully.
- Go back to the Workgroup Management System Home Page. To login to your upgraded workgroup, click on the key icon to the left of the workgroup name from the list on the WMS Home Page. Login to the workgroup to confirm that the upgrade was successful.
- To upgrade another workgroup, repeat steps 6 - 8 until all workgroups have been upgraded.
- Re-activate your anti-virus software and, if you are using NT 4.0 Server, re-start IIS services.
Your system has now been upgraded to Version 5.5.4 for all workgroups.
Upgrading from Versions 4.1 - 4.1.1 to Version 5.5.4
Section 1 - Backup your ProblemTracker Installation
For 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.
- Copy all ProblemTracker workgroup database files which are to be upgraded and archive the copies in a safe location. These files are shown below for a default installation.
<installation directory>\workgroup\Database\Bugtrack.mdb - Copy all ProblemTracker workgroup attachment files and archive the copies in a safe location. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Attachments
- Copy the Workgroup Management System database file. The default location is:
<installation directory>\ptadmin\Database\ptadmin.mdb - If you have customized the login page with your own html, you need to back up the corresponding files as well. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Include\loginbottom.inc
<installation directory>\workgroup\Include\logintop.inc
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.
- For each workgroup, you may backup SQL Server 7.0/2000 or Oracle databas(es) by using SQL Server or Oracle backup or data export operation. Backups may done to a hard disk as well as to tape. Please review your SQL Server or Oracle documentation for further information.
- Copy all ProblemTracker workgroup attachment files and archive the copies in a safe location. These files are located in the path (folder)
shown below for a default installation.
<installation directory>\workgroup\Attachments
- Copy the Workgroup Management System database file. This will in Access format even if your workgroup databases are SQL Server or Oracle databases. The default location is:
<installation directory>\ptadmin\Database\ptadmin.mdb
- If you have customized the login page with your own html, you need to back up the corresponding files as well. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Include\loginbottom.inc
<installation directory>\workgroup\Include\logintop.inc
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). UNDER NO CIRCUMSTANCES IS NETRESULTS RESPONSIBLE FOR THE LOSS OF ANY DATA AS THE RESULT OF THE INSTALLATION PROCESS.
Section 2 - Running the Installation Set up Program and Performing the Upgrade from Versions 4.1 - 4.1.1 to Version 5.5.4
- GO TO SECTION 1.0 ABOVE AND BACKUP ALL OF YOUR PROBLEMTRACKER DATABASES BEFORE PROCEEDING.
- ProblemTracker Version 5.5.4 requires a new license key. Your ProblemTracker Version 4 license key(s) will not function with ProblemTracker 5.5.4. Please do not install ProblemTracker Version 5.5.4 if you do not have your Version 5 License Keys. Installing Version 5.5.4 without your Version 5 keys may result in an inability to login to your workgroups (because you have more users than licenses entered) and / or unexpected changes to your users (floating users will be converted to static users if a floating license key is not entered). NetResults Sales will send you a Version 5 key if your support and upgrades subscription is current. Please contact NetResults Sales if you have licensing or subscription questions.
- Prior to installing ProblemTracker Version 5.5.4, please make sure all users are logged out of every workgroup. Failure to do this before installing Version 5.5.4 will result in your workgroups being "locked" because you will not be able to log the users out (because access to the previous version is denied until the workgroup is upgraded) and will not be able to proceed with the upgrade until the users are logged out.
- If you have any two (or more) user accounts (within a single workgroup or in different workgroups) where the User IDs differ only by case (for example, one user account has the User ID "johnsmith" and another user account has the User ID "JohnSmith"), you should change the User IDs until no two differ only by case. It is possible to make these changes as a part of the upgrade process (using the Upgrade Users operation referenced below), but it is generally easier to do this in advance of upgrade. To make this change, do one of the following for each set of user accounts with User IDs that differ only by case.
- If all user accounts are used by the same person (e.g. the User ID is someone's name), Edit all user accounts that differ by case to have the same User ID with the same case (e.g. change "JohnSmith" to "johnsmith"). To do this login as Admin to the Workgroup, click on the Admin icon, click on the User Administration button, click the Edit icon next to the user account to be modified, change the User ID, click OK.
- If all user accounts are used by different people (e.g. the User ID is something generic like "QA"), Edit all user accounts to have a different User ID. In other words, if three user accounts have a User ID that only differs by case, rename two of the three accounts. To do this login as Admin to the Workgroup, click on the Admin icon, click on the User Administration button, click the Edit icon next to the user account to be modified, change the User ID, click OK. Note: Only do this if you have sufficient licenses to cover the new user accounts (each account with a different User ID is counted as a separate user account and will count against your Static and/or Floating license limits on user accounts).
- Temporarily disable any anti-virus software while you run the Version 5.5.4 installation program and perform configuration steps in the Workgroup Management System (WMS). This is recommended so that your anti-virus software will not prevent the installation program or WMS from performing operations such as copying files, running scripts, configuring your web server, setting file permissions and registry entries. Your anti-virus software can be reactivated safely after you have completed the installation steps and any necessary WMS configuration.
- This procedure assumes that you are installing ProblemTracker Version 5.5.4 on the same machine where you have ProblemTracker 4 installed. If you are installing ProblemTracker Version 5.5.4 on a different machine than where you have ProblemTracker 4 installed, please review the following Version 5.x Move and Upgrade FAQ entry for instructions.
- If you are upgrading a NT 4.0 Server installation, temporarily stop all IIS services (IIS Admin Service and World Wide Web Publishing Service) while you run the Version 5.5.4 installation setup program. Running the installation setup program without stopping all IIS services will prevent you from receiving all of the necessary file updates included in this version. This step is optional if you are upgrading a Windows 2000 Server or Windows Server 2003 installation as the upgrade program will stop (and restart) the services for you.
- Please note that after running the ProblemTracker Version 5.5.4 installation setup program, you will not be able to access your Version 4.x workgroups until you complete the upgrade process for all workgroups. When ready, install ProblemTracker 5.5.4 or ProblemTracker Enterprise Edition 5.5.4 To do this, login to the web server machine as Administrator and then run (double-click from Windows Explorer) pbtrk554.exe (ProblemTracker 5.5.4) or ptee554.exe (ProblemTracker Enterprise Edition 5.5.4). Enter your license key(s) information by going to Start->Programs->NetResults ProblemTracker 5->ProblemTracker License Manager. During the installation, if you are asked about updating "read only" files, answer Yes (overwrite the read only file as a part of the installation). When the installation setup program has finished, you will be asked to reboot your system.
Login to the Workgroup Management System (WMS) by going to Start->Programs->NetResults ProblemTracker 5->Workgroup Management System. To upgrade your workgroups, click on the Admin icon on the Button bar. Select the option "Upgrade Workgroups from versions 4.x / 5.x to ProblemTracker 5.5.4". A pulldown menu will contain the workgroups that need to be upgraded from Version 4.x to 5.5.4. Select a workgroup to be upgraded and click on the Upgrade Workgroup button, then click OK to confirm.
Once the workgroup files have been upgraded successfully, a confirmation page will be displayed. You will be prompted to upgrade the data for the workgroup. Click on the Continue button to proceed with upgrading your database. A confirmation page will be displayed with details about your database, click on the Upgrade Data button, then click OK to confirm the operation.
Once the database has been upgraded successfully, a confirmation page will be displayed. You will be prompted to upgrade your users. Click on the Upgrade Users button to proceed. Depending on the users you have in your workgroup and the number of workgroups you have, it is possible to have user conflicts that need to be resolved before you can upgrade your users. The conflicts arise because multiple workgroups have the same user id, but the user profile information (name, email address, etc.) is different in each workgroup. If a conflict exists for a particular user id, a "Yes" button will be present in the "User Details Conflict?" column. If all of the user ids listed display "No" in the "User Details Conflict?" column and there are no "Resolve" buttons in the "Action" column, proceed to step 11. If any user ids have "Yes" in the "User Details Conflict?" column, click on the "Resolve" button that appears in the "Action" column for the user account.
The next page will display the "Existing User Details" for the user id. This information is the profile information present in the Workgroup Management System for this workgroup because you have already upgraded a workgroup to 5.5.4 or you are using one of ProblemTracker's standard users (i.e., dev_mgr or process_mgr). The user account's profile information as entered in the workgroup you are upgrading will be displayed in the "Workgroup User Details" column. You can choose to do one of the following to resolve the user conflict:
- You can either select the user profile information present in one of the columns (by selecting either "Existing User Details" or "Workgroup User Details" in the pulldown at the top of the "Resolved User Details" column). Click on the Update button to proceed.
- You can select the user profile information present in one of the columns (by selecting either "Existing User Details" or "Workgroup User Details" in the pulldown at the top of the "Resolved User Details" column), then change any of the information you would like to save in the user's profile. Choosing this option will result in the user account being saved with the profile information entered in the "Resolved User Details" column. Click on the Update button to proceed.
You can create a new user account to resolve the conflict. To choose this option, select the user profile information present in one of the columns (by selecting either "Existing User Details" or "Workgroup User Details" in the pulldown at the top of the "Resolved User Details" column), then change the user id in the "Resolved User Details" column to be different from the user id displayed in the other columns. You cannot select a user id that is already in use by another workgroup or a user id that is the same as a default user (such as dev_one, dev_mgr, process_mgr, etc.). You may also change any other user profile information in the "Resolved User Details" column, then click on the Update button to create this new user account. This will resolve the user conflict and the existing user account already present in the Workgroup Management System (displayed in the "Existing User Details" column) will be preserved. This new user account will be counted toward the license limits for the keys you have entered in the ProblemTracker License Manager. Once you have renamed the user id and click on the Update button, you will not have another opportunity to change this user's profile information until after the "Upgrade Users" process is complete. After the users have been upgraded, you can use the Edit User option in the License Administration section of WMS to make changes to this user.
After making your selection and / or entering the user details in the "Resolved User Details" column, click on the Update button. Click on the "Resolve" button for another user to continue resolving the conflicts.
Users with "No" displayed in the "User Details Conflict?" column do not have a conflict present. If you wish to modify the profile information for a user which had a conflict resolved, click on the "Edit" button displayed in the "Action" column for the user account, select one of the options in the pulldown at the top of the "Resolved User Details" column to fill the user profile details in this column (the "Resolved User Details" choice will fill the column with the values that were saved for this user when the conflict was resolved), modify the profile information, then click Update to save your changes.
Repeat this step until all user conflicts have been resolved. All user conflicts are resolved when all users have "No" listed in the "User Details Conflict?" column and there are no longer any "Resolve" buttons in the "Action" column.
- Click on the Upgrade Users button. When the users have been upgraded, a confirmation page will be displayed. Click OK to return to the Administration Menu.
- Go back to the Workgroup Management System Home Page. To login to your upgraded workgroup, click on the key icon to the left of the workgroup name from the list on the WMS Home Page. Login to the workgroup to confirm that the upgrade was successful.
- Repeat steps 9 - 12 for each workgroup you have in the Workgroup Management System.
- Re-activate your anti-virus software and, if you are running NT 4.0 Server, re-start IIS services.
Your system has now been upgraded to Version 5.5.4 for all workgroups.
Upgrading from Versions 4.0 - 4.0.3 to Version 5.5.4
Section 1 - Backup your ProblemTracker Installation
For 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.
- Copy all ProblemTracker workgroup database files which are to be upgraded and archive the copies in a safe location.
These files are shown below for a default installation.
<installation directory>\workgroup\Database\Bugtrack.mdb - Copy all ProblemTracker workgroup attachment files and archive the copies in a safe location. These files are located in the path (folder)
shown below for a default installation.
<installation directory>\workgroup\Attachments
- Copy the Workgroup Management System database file. The default location is:
<installation directory>\ptadmin\Database\ptadmin.mdb - If you have customized the login page with your own html, you need to back up the corresponding files as well. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Include\loginbottom.inc
<installation directory>\workgroup\Include\logintop.inc
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.
- For each workgroup, you may backup SQL Server 7.0/2000 or Oracle databas(es) by using SQL Server or Oracle backup or data export operation. Backups may done to a hard disk as well as to tape. Please review your SQL Server or Oracle documentation for further information.
- Copy all ProblemTracker workgroup attachment files and archive the copies in a safe location. These files are located in the path (folder)
shown below for a default installation.
<installation directory>\workgroup\Attachments
- Copy the Workgroup Management System database file. This will in Access format even if your workgroup databases are SQL Server or Oracle databases. The default location is:
<installation directory>\ptadmin\Database\ptadmin.mdb
- If you have customized the login page with your own html, you need to back up the corresponding files as well. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Include\loginbottom.inc
<installation directory>\workgroup\Include\logintop.inc
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). UNDER NO CIRCUMSTANCES IS NETRESULTS RESPONSIBLE FOR THE LOSS OF ANY DATA AS THE RESULT OF THE INSTALLATION PROCESS.
Section 2 - Running the Installation Set up Program and Performing the Upgrade from Versions 4.0 - 4.0.3 to Version 5.5.4
- GO TO SECTION 1.0 ABOVE AND BACKUP ALL OF YOUR PROBLEMTRACKER DATABASES BEFORE PROCEEDING.
- ProblemTracker Version 5.5.4 requires a new license key. Your ProblemTracker Version 4 license key(s) will not function with ProblemTracker 5.5.4. Please do not install ProblemTracker Version 5.5.4 if you do not have your Version 5 License Keys. Installing Version 5.5.4 without your Version 5 keys may result in an inability to login to your workgroups (because you have more users than licenses entered) and / or unexpected changes to your users (floating users will be converted to static users if a floating license key is not entered). NetResults Sales will send you a Version 5 key if your support and upgrades subscription is current. Please contact NetResults Sales if you have licensing or subscription questions.
- Prior to installing ProblemTracker Version 5.5.4, please make sure all users are logged out of every workgroup. Failure to do this before installing Version 5.5.4 will result in your workgroups being "locked" because you will not be able to log the users out (because access to the previous version is denied until the workgroup is upgraded) and will not be able to proceed with the upgrade until the users are logged out.
- If you have any two (or more) user accounts (within a single workgroup or in different workgroups) where the User IDs differ only by case (for example, one user account has the User ID "johnsmith" and another user account has the User ID "JohnSmith"), you should change the User IDs until no two differ only by case. It is possible to make these changes as a part of the upgrade process (using the Upgrade Users operation referenced below), but it is generally easier to do this in advance of upgrade. To make this change, do one of the following for each set of user accounts with User IDs that differ only by case.
- If all user accounts are used by the same person (e.g. the User ID is someone's name), Edit all user accounts that differ by case to have the same User ID with the same case (e.g. change "JohnSmith" to "johnsmith"). To do this login as Admin to the Workgroup, click on the Admin icon, click on the User Administration button, click the Edit icon next to the user account to be modified, change the User ID, click OK.
- If all user accounts are used by different people (e.g. the User ID is something generic like "QA"), Edit all user accounts to have a different User ID. In other words, if three user accounts have a User ID that only differs by case, rename two of the three accounts. To do this login as Admin to the Workgroup, click on the Admin icon, click on the User Administration button, click the Edit icon next to the user account to be modified, change the User ID, click OK. Note: Only do this if you have sufficient licenses to cover the new user accounts (each account with a different User ID is counted as a separate user account and will count against your Static and/or Floating license limits on user accounts
- Temporarily disable any anti-virus software while you run the Version 5.5.4 installation program and perform configuration steps in the Workgroup Management System (WMS). This is recommended so that your anti-virus software will not prevent the installation program or WMS from performing operations such as copying files, running scripts, configuring your web server, setting file permissions and registry entries. Your anti-virus software can be reactivated safely after you have completed the installation steps and any necessary WMS configuration.
- This procedure assumes that you are installing ProblemTracker Version 5.5.4 on the same machine where you have ProblemTracker 4 installed. If you are installing ProblemTracker Version 5.5.4 on a different machine than where you have ProblemTracker 4 installed, please review the following Version 5.x Move and Upgrade FAQ entry for instructions.
- If you are upgrading a NT 4.0 Server installation, temporarily stop all IIS services (IIS Admin Service and World Wide Web Publishing Service) while you run the Version 5.5.4 installation setup program. Running the installation setup program without stopping all IIS services will prevent you from receiving all of the necessary file updates included in this version. This step is optional if you are upgrading a Windows 2000 Server or Windows Server 2003 installation as the upgrade program will stop (and restart) the services for you.
- Please note that after running the ProblemTracker Version 5.5.4 installation setup program, you will not be able to access your Version 4.x workgroups until you complete the upgrade process for all workgroups. When ready, install ProblemTracker 5.5.4 or ProblemTracker Enterprise Edition 5.5.4. To do this, login to the web server machine as Administrator and then run (double-click from Windows Explorer) pbtrk554.exe (ProblemTracker 5.5.4) or ptee554.exe (ProblemTracker Enterprise Edition 5.5.4). During the installation setup program, you will be prompted to select a server time zone. Please ensure that you select the same time zone as the time zone set in your operating system. Failure to select the same time zone as your operating system's setting will result in incorrect date and time values in your ProblemTracker data. These incorrect values cannot be corrected at a later time. During the installation, if you are asked about updating "read only" files, answer Yes (overwrite the read only file as a part of the installation). You can enter your license keys during installation. If you do not enter them during installation (or get additional license keys later), you can enter your license key(s) after installation by going to Start->Programs->NetResults ProblemTracker 5->ProblemTracker License Manager. When the installation setup program has finished, you will be asked to reboot your system.
Login to the Workgroup Management System (WMS) by going to Start->Programs->NetResults ProblemTracker 5->Workgroup Management System. To upgrade the workgroups, click on the Admin icon on the Button bar. Select the option "Upgrade Workgroups from versions 4.x / 5.x to ProblemTracker 5.5.4". Select a workgroup from the pulldown menu, then click on the Upgrade Workgroup button and click OK to confirm. A confirmation page will be displayed confirming that the workgroup files have been upgraded. You will be prompted to upgrade your database. Click on the Continue button to proceed with upgrading the data for the workgroup, then click OK to confirm.
Another confirmation page will be displayed listing several areas of your database that need a time zone selection. Select a time zone for each these areas. The time zone you select can be different from the time zone you selected for your ProblemTracker server during the Version 5.5.4 installation setup. Click on the Upgrade Data button to proceed, then click OK to confirm.
Once the database has been upgraded successfully, a confirmation page will be displayed. You will be prompted to upgrade your users. Click on the Upgrade Users button to proceed. Depending on the users you have in your workgroup and the number of workgroups you have, it is possible to have user conflicts that need to be resolved before you can upgrade your users. The conflicts arise because multiple workgroups have the same user id, but the user profile information (name, email address, etc.) is different in each workgroup. If a conflict exists for a particular user id, a "Yes" button will be present in the "User Details Conflict?" column. If all of the user ids listed display "No" in the "User Details Conflict?" column and there are no "Resolve" buttons in the "Action" column, proceed to step 11. If any user ids have "Yes" in the "User Details Conflict?" column, click on the "Resolve" button that appears in the "Action" column for the user account.
The next page will display the "Existing User Details" for the user id. This information is the profile information present in the Workgroup Management System for this workgroup because you have already upgraded a workgroup to 5.5.1 or you are using one of ProblemTracker's standard users (i.e., dev_mgr or process_mgr). The user account's profile information as entered in the workgroup you are upgrading will be displayed in the "Workgroup User Details" column. You can choose to do one of the following to resolve the user conflict:
- You can either select the user profile information present in one of the columns (by selecting either "Existing User Details" or "Workgroup User Details" in the pulldown at the top of the "Resolved User Details" column). Click on the Update button to proceed.
- You can select the user profile information present in one of the columns (by selecting either "Existing User Details" or "Workgroup User Details" in the pulldown at the top of the "Resolved User Details" column), then change any of the information you would like to save in the user's profile. Choosing this option will result in the user account being saved with the profile information entered in the "Resolved User Details" column. Click on the Update button to proceed.
You can create a new user account to resolve the conflict. To choose this option, select the user profile information present in one of the columns (by selecting either "Existing User Details" or "Workgroup User Details" in the pulldown at the top of the "Resolved User Details" column), then change the user id in the "Resolved User Details" column to be different from the user id displayed in the other columns. You cannot select a user id that is already in use by another workgroup or a user id that is the same as a default user (such as dev_one, dev_mgr, process_mgr, etc.). You may also change any other user profile information in the "Resolved User Details" column, then click on the Update button to create this new user account. This will resolve the user conflict and the existing user account already present in the Workgroup Management System (displayed in the "Existing User Details" column) will be preserved. This new user account will be counted toward the license limits for the keys you have entered in the ProblemTracker License Manager. Once you have renamed the user id and click on the Update button, you will not have another opportunity to change this user's profile information until after the "Upgrade Users" process is complete. After the users have been upgraded, you can use the Edit User option in the License Administration section of WMS to make changes to this user.
After making your selection and / or entering the user details in the "Resolved User Details" column, click on the Update button. Click on the "Resolve" button for another user to continue resolving the conflicts.
Users with "No" displayed in the "User Details Conflict?" column do not have a conflict present. If you wish to modify the profile information for a user which had a conflict resolved, click on the "Edit" button displayed in the "Action" column for the user account, select one of the options in the pulldown at the top of the "Resolved User Details" column to fill the user profile details in this column (the "Resolved User Details" choice will fill the column with the values that were saved for this user when the conflict was resolved), modify the profile information, then click Update to save your changes.
Repeat this step until all user conflicts have been resolved. All user conflicts are resolved when all users have "No" listed in the "User Details Conflict?" column and there are no longer any "Resolve" buttons in the "Action" column.
- Click on the Upgrade Users button. When the users have been upgraded, a confirmation page will be displayed. Click OK to return to the Administration Menu.
- Go back to the Workgroup Management System Home Page. To login to your upgraded workgroup, click on the key icon to the left of the workgroup name from the list on the WMS Home Page. Login to the workgroup to confirm that the upgrade was successful.
- Repeat steps 9 - 12 for each workgroup you have in the Workgroup Management System.
- Re-activate your anti-virus software and, if you are running NT 4.0 Server, re-start IIS services.
Your system has now been upgraded to Version 5.5.4 for all workgroups.
Upgrading Versions 3.0 - 3.6.1 to Version 5.5.4
Section 1 - Backup your ProblemTracker Installation
For Access Users:
For each of items below, a default path is listed. The "<installation directory>" mentioned in the path may be "C:\Inetpub\wwwroot" 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.
- Copy all ProblemTracker workgroup database files which are to be upgraded and archive the copies in a safe location.
These files are shown below for a default installation.
<installation directory>\workgroup\Database\Bugtrack.mdb - Copy all ProblemTracker workgroup attachment files and archive the copies in a safe location. These files are located in the path (folder)
shown below for a default installation.
<installation directory>\workgroup\Attachments
- If you have customized the login page with your own html, you need to back up the corresponding files as well. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Include\loginbottom.inc
<installation directory>\workgroup\Include\logintop.inc
- If you have implemented any additional web server security measures on your ProblemTracker workgroups, this security will be altered after running the upgrade operation on each workgroup. Additional web server security includes the recommendations in the Web Server Security Help section or other measures recommended by your system administrator (e.g. SSL, etc.). You will need to re-apply this additional security after you have completed the upgrade operation on each workgroup.
For SQL Server 7.0 / 2000 Users:
For each of items below, a default path is listed. The "<installation directory>" mentioned in the path may be "C:\Inetpub\wwwroot" 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 each workgroup, you may backup SQL Server 7.0/2000 databas(es) by using SQL Server backup or data export operation. Backups may done to a hard disk as well as to tape. Please review your SQL Server documentation for further information.
- Copy all ProblemTracker workgroup attachment files and archive the copies in a safe location. These files are located in the path (folder)
shown below for a default installation.
<installation directory>\workgroup\Attachments
- If you have customized the login page with your own html, you need to back up the corresponding files as well. These files are located in the path (folder) shown below for a default installation.
<installation directory>\workgroup\Include\loginbottom.inc
<installation directory>\workgroup\Include\logintop.inc
- If you have implemented any additional web server security measures on your ProblemTracker workgroups, this security will be altered after running the upgrade operation on each workgroup. Additional web server security includes the recommendations in the Web Server Security Help section or other measures recommended by your system administrator (e.g. SSL, etc.). You will need to re-apply this additional security after you have completed the upgrade operation on each workgroup.
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 or SQL Server). UNDER NO CIRCUMSTANCES IS NETRESULTS RESPONSIBLE FOR THE LOSS OF ANY DATA AS THE RESULT OF THE INSTALLATION PROCESS.
Section 2 - Running the Installation Set up Program and Performing the Upgrade from Versions 3.0 - 3.6.1 to Version 5.5.4
- GO TO SECTION 1.0 ABOVE AND BACKUP ALL OF YOUR PROBLEMTRACKER DATABASES BEFORE PROCEEDING.
- ProblemTracker Version 5.5.4 requires a new license key. Your ProblemTracker Version 3 license key(s) will not function with ProblemTracker 5.5.4. Please do not install ProblemTracker Version 5.5.4 if you do not have your Version 5 License Keys. Installing Version 5.5.4 without your Version 5 keys may result in an inability to login to your workgroups (because you have more users than licenses entered) and / or unexpected changes to your users (floating users will be converted to static users if a floating license key is not entered). NetResults Sales will send you a Version 5 key if your support and upgrades subscription is current. Please contact NetResults Sales if you have licensing or subscription questions.
- Prior to installing ProblemTracker Version 5.5.4, please make sure all users are logged out of every workgroup. Failure to do this before installing Version 5.5.4 will result in your workgroups being "locked" because you will not be able to log the users out (because access to the previous version is denied until the workgroup is upgraded) and will not be able to proceed with the upgrade until the users are logged out.
If you have any two (or more) user accounts (within a single workgroup or in different workgroups) where the User IDs differ only by case (for example, one user account has the User ID "johnsmith" and another user account has the User ID "JohnSmith"), you should change the User IDs until no two differ only by case. It is possible to make these changes as a part of the upgrade process (using the Upgrade Users operation referenced below), but it is generally easier to do this in advance of upgrade. To make this change, do one of the following for each set of user accounts with User IDs that differ only by case.
- If all user accounts are used by the same person (e.g. the User ID is someone's name), Edit all user accounts that differ by case to have the same User ID with the same case (e.g. change "JohnSmith" to "johnsmith"). To do this login as Admin to the Workgroup, click on the Admin icon, click on the User Administration button, click the Edit icon next to the user account to be modified, change the User ID, click OK.
- If all user accounts are used by different people (e.g. the User ID is something generic like "QA"), Edit all user accounts to have a different User ID. In other words, if three user accounts have a User ID that only differs by case, rename two of the three accounts. To do this login as Admin to the Workgroup, click on the Admin icon, click on the User Administration button, click the Edit icon next to the user account to be modified, change the User ID, click OK. Note: Only do this if you have sufficient licenses to cover the new user accounts (each account with a different User ID is counted as a separate user account and will count against your Static and/or Floating license limits on user accounts
- Temporarily disable any anti-virus software while you run the Version 5.5.4 installation program and perform configuration steps in the Workgroup Management System (WMS). This is recommended so that your anti-virus software will not prevent the installation program or WMS from performing operations such as copying files, running scripts, configuring your web server, setting file permissions and registry entries. Your anti-virus software can be reactivated safely after you have completed the installation steps and any necessary WMS configuration.
- This procedure assumes that you are installing ProblemTracker Version 5.5.4 on the same machine where you have ProblemTracker 3 installed. If you are installing ProblemTracker Version 5.5.4 on a different machine than where you have ProblemTracker 3 installed, please review the following Version 5.x Move and Upgrade FAQ entry for instructions.
- Install ProblemTracker 5.5.4 or ProblemTracker Enterprise Edition 5.5.4. To do this, login to the web server machine as Administrator and then run (double-click from Windows Explorer) pbtrk554.exe (ProblemTracker 5.5.4) or ptee554.exe (ProblemTracker Enterprise Edition 5.5.4). During the installation setup program, you will be prompted to select a server time zone. Please ensure that you select the same time zone as the time zone set in your operating system. Failure to select the same time zone as your operating system's setting will result in incorrect date and time values in your ProblemTracker data. These incorrect values cannot be corrected at a later time. During the installation, if you are asked about updating "read only" files, answer Yes (overwrite the read only file as a part of the installation). You can enter your license keys during installation. If you do not enter them during installation (or get additional license keys later), you can enter your license key(s) after installation by going to Start->Programs->NetResults ProblemTracker 5->ProblemTracker License Manager. After the installation setup program has finished, you will be asked to reboot your system.
- Log into the Workgroup Management System by going to Start->Programs->NetResults ProblemTracker 5->Workgroup Management System. Click on the Admin icon and select the option "Upgrade Workgroups from versions 3.x to ProblemTracker 5.5.4", then click on the Continue button.
- In the Current Workgroup details section, type in the current workgroup name, select the current database type and web site, then click on the Continue button to proceed.
- In the New Workgroup details section, enter information for the new workgroup including Workgroup Name, Description, Location, Template, Web Site, Host Name/IP Address, Port Number, and history comment. If using Access as your database type, please choose a workgroup name and location that are different than your current 3.x workgroup. This is very important because choosing an identical name will cause you to overwrite your 3.x workgroup. If you are using SQL Server as your database type, the Version 3 database will be upgraded whether you choose a different name or use the same name. Please make sure you have a backup of your database before proceeding. Once you have entered the necessary information, if you are using Access as your database type, uncheck the box for "re-direct your Version 3 workgroup URL to your Version 5.5.4 database". If you are using SQL Server, you may check this box for re-direction. Click on the Continue button to proceed with the upgrade process.
A confirmation screen listing information for both the current workgroup and the new workgroup will be displayed. Click on the Back button to make any necessary changes. Otherwise, click on the Upgrade Workgroup button to complete the Upgrade operation. Click OK to confirm. A confirmation page will be displayed confirming that the workgroup files have been upgraded. Click on the Continue button to proceed with upgrading the data for the workgroup, then click OK to confirm the operation.
Another confirmation page will be displayed listing several areas of your database that need a time zone selection. Select a time zone for each these areas. The time zone you select can be different from the time zone you selected for your ProblemTracker server during the Version 5.5.4 installation setup. Click on the Upgrade Data button to proceed, then click OK to confirm. Click OK after the upgrade operation has completed.
Once the database has been upgraded successfully, a confirmation page will be displayed. You will be prompted to upgrade your users. Click on the Upgrade Users button to proceed. Depending on the users you have in your workgroup and the number of workgroups you have, it is possible to have user conflicts that need to be resolved before you can upgrade your users. The conflicts arise because multiple workgroups have the same user id, but the user profile information (name, email address, etc.) is different in each workgroup. If a conflict exists for a particular user id, a "Yes" button will be present in the "User Details Conflict?" column. If all of the user ids listed display "No" in the "User Details Conflict?" column and there are no "Resolve" buttons in the "Action" column, proceed to step 13. If any user ids have "Yes" in the "User Details Conflict?" column, click on the "Resolve" button that appears in the "Action" column for the user account.
The next page will display the "Existing User Details" for the user id. This information is the profile information present in the Workgroup Management System for this workgroup because you have already upgraded a workgroup to 5.5.4 or you are using one of ProblemTracker's standard users (i.e., dev_mgr or process_mgr). The user account's profile information as entered in the workgroup you are upgrading will be displayed in the "Workgroup User Details" column. You can choose to do one of the following to resolve the user conflict:
- You can either select the user profile information present in one of the columns (by selecting either "Existing User Details" or "Workgroup User Details" in the pulldown at the top of the "Resolved User Details" column). Click on the Update button to proceed.
- You can select the user profile information present in one of the columns (by selecting either "Existing User Details" or "Workgroup User Details" in the pulldown at the top of the "Resolved User Details" column), then change any of the information you would like to save in the user's profile. Choosing this option will result in the user account being saved with the profile information entered in the "Resolved User Details" column. Click on the Update button to proceed.
You can create a new user account to resolve the conflict. To choose this option, select the user profile information present in one of the columns (by selecting either "Existing User Details" or "Workgroup User Details" in the pulldown at the top of the "Resolved User Details" column), then change the user id in the "Resolved User Details" column to be different from the user id displayed in the other columns. You cannot select a user id that is already in use by another workgroup or a user id that is the same as a default user (such as dev_one, dev_mgr, process_mgr, etc.). You may also change any other user profile information in the "Resolved User Details" column, then click on the Update button to create this new user account. This will resolve the user conflict and the existing user account already present in the Workgroup Management System (displayed in the "Existing User Details" column) will be preserved. This new user account will be counted toward the license limits for the keys you have entered in the ProblemTracker License Manager. Once you have renamed the user id and click on the Update button, you will not have another opportunity to change this user's profile information until after the "Upgrade Users" process is complete. After the users have been upgraded, you can use the Edit User option in the License Administration section of WMS to make changes to this user.
After making your selection and / or entering the user details in the "Resolved User Details" column, click on the Update button. Click on the "Resolve" button for another user to continue resolving the conflicts.
Users with "No" displayed in the "User Details Conflict?" column do not have a conflict present. If you wish to modify the profile information for a user which had a conflict resolved, click on the "Edit" button displayed in the "Action" column for the user account, select one of the options in the pulldown at the top of the "Resolved User Details" column to fill the user profile details in this column (the "Resolved User Details" choice will fill the column with the values that were saved for this user when the conflict was resolved), modify the profile information, then click Update to save your changes.
Repeat this step until all user conflicts have been resolved. All user conflicts are resolved when all users have "No" listed in the "User Details Conflict?" column and there are no longer any "Resolve" buttons in the "Action" column.
- Click on the Upgrade Users button. When the users have been upgraded, a confirmation page will be displayed. Click OK to return to the Administration Menu.
- Go back to the Workgroup Management System Home Page. To login to your upgraded workgroup, click on the key icon to the left of the workgroup name from the list on the WMS Home Page. Login to the workgroup to confirm that the upgrade was successful.
- Repeat steps 8 - 14 for each workgroup you have in the Workgroup Management System.
- There are significant changes to the way your Version 3 data will be represented after upgrading to Version 5.5.4. Please review the details in the Version 3.0 - 3.6.1 Upgrade Preparation information on the NRTracker web site.
- After ensuring that each workgroup was upgraded successfully, uninstall ProblemTracker 3 from your machine following the steps below.
- Select Start-> Programs -> NetResults ProblemTracker 3 -> Modify-Uninstall ProblemTracker
- When the uninstall starts, click "Next"
- Select "Remove" option and click "Next"
For SQL Server Users: Select "Components only (leave databases)" option as SQL Server database(s) are upgraded "in place". If you select "Components and databases", you will delete the 5.5.4 SQL Server database(s).
For Access Users: Select "Components and databases" option as Access database(s) are copied before being upgraded.
- Click "Next" and complete the uninstallation
- Reactivate your anti-virus software and, if you are running NT 4.0 Server, re-start IIS services.
Your system has now been upgraded to Version 5.5.4 for all workgroups.
Changes in ProblemTracker
Version 5.5.4
Enhancements
|
Fixes
|
Version 5.5.3
Enhancements
|
Fixes
|
Version 5.5.2
Enhancements
|
Fixes
|
Version 5.5.1
Enhancements
There are no enhancements in Version 5.5.1, only fixes.
Fixes
|
Version 5.5
Enhancements
|
Version 4.1.1 and older
For a complete list of features for Version 4.1.1 and older versions of ProblemTracker, please visit the ProblemTracker Version 4.1 Features Page.
Support Resources
Support information is available in the ProblemTracker Online Help Guides. Click on the Help icon after logging into ProblemTracker. Or, from the machine on which ProblemTracker is installed, select
Start > Programs > NetResults ProblemTracker > Help Library
Then scroll down to the Support section near the bottom of the table of contents. Support is also available on the ProblemTracker web site. Browse to http://www.nrtracker.com, then hover your mouse over the Support menu (on top of web page), then click on the appropriate link in the Support menu.
And, if you are evaluating the product or have a current support agreement with NetResults, support is available via e-mail on business days (Monday through Friday, excluding holidays) from 5am to 5pm Pacific. Additional support options (e.g. phone support, extended hours) may be purchased (send e-mail to sales@n2r6.com or browse our web site in the ProblemTracker product info section for information on additional support options). Support email should be sent to the following address:
When reporting a bug, please include any information displayed on the screen regarding the problem. In many cases if you get a generic database error message, you can scroll further down on the page to find more detailed error information. Please provide the required information listed at the following page to help us assist you as quickly as possible: http://www.nrtracker.com/support/index.html.
You can also review the Online ProblemTracker Help at our web site at: http://www.nrtracker.com/support/help_manuals.html.
If you have feedback or questions about this release, please contact NetResults Technical Support for assistance.