The following instructions are meant for our techs to use. It is not expected for end users to be able to perform this upgrade.
1. SHUTDOWN ALL PROGRAMS. Close Cash Advance Pro and all other applications that are running. You should leave the database server (Cash Advance Pro Server) running in the system tray until the conversion completes.
2. BACKUP – Backup the entire Cash Advance Pro folder that is going to be converted. A simple backup would be to copy the entire Cash Advance Pro folder and all its sub-folders into a folder named C:\Backup.
3. CHECK EXISTING VERSION – Make sure the old Cash Advance Pro is running version 4.92 and is dated 3-26-08 or newer. To check the version and release date, from within Cash Advance Pro, go to Help / About. If necessary, run the appropriate update utility to bring the old system up-to-date.
4. CHECK SOURCE DATA PATHS –Go into the Cash Advance Pro Server and look at the Alias names (Config / Aliases). CashAdvPro is the standard alias listed. Note the path for it. If there are other aliases, make note of them and their paths. You will need to know this to make decisions later.
5. RUN UPGRADE – Run UpgradeCashAdvancePro.exe. Select the appropriate task for the source folder. Be sure to examine the FF2NX upgrade utility log for any failures. The last line should say: 0 transfers failed. The UpgradeCashAdvancePro.exe utility will upgrade only the standard data folder. If other data folders need to be converted, do the next step to convert them.
6. UPGRADE ADDITIONAL FOLDERS IF NECESSARY – If other data folders need converting, such as Installment, Title, etc., do the additional steps notated at the bottom of these instructions right now.
7. EDIT DESKTOP ICONS – In many cases, setup parameters are being passed as command-line arguments via the target box of the shortcut. This condition is especially true when multiple Cash Advance Pro icons exist on the desktop. It is important to edit these icons immediately; otherwise, executing one may add incorrect aliases to the database server that will need to be removed manually. If the icon is named Cash Advance Pro, you should rename it to preserve your edits, as an uninstall performed later will attempt to remove a desktop icon with that same name.
8. REGISTER SOFTWARE VIA INTERNET – Doing this will update records at Bestware Inc. that the software has been updated.
9. SETUP CONTRACTS & CUSTOM FORMS/REPORTS – Existing active contracts (Contract.rtm, Contract2.rtm, Contract3.rtm, etc.) and custom forms on the old system need to be copied over to the new Reports folder. Do not copy all the reports over because most have already been converted. Only copy customized active templates. Load them into the designer to convert them, and then save them with the new format. Some may require changing the RB components to non-RB components, such as changing RBARichText to standard RichText components. Custom reports will also need to be converted. Refer to the instructions noted at the bottom of this document for details. The conversion should be done before uninstalling Cash Advance Pro 4.92.
10. UNINSTALL – Uninstall the old Cash Advance Pro. First, shut down the old Cash Advance Pro server. Locate the Cash Advance Pro Server icon in the system tray, right-click on it, and select Exit. Then navigate the Start menu to Start / All Programs / Cash Advance Pro / Uninstall Cash Advance Pro.
11. DELETE THE OLD CASH ADVANCE PRO FOLDER IF NECESSARY – After uninstalling, examine the original folder and ensure that it is completely deleted. If the user had copied any other files into that folder, the uninstall program will leave the folder and those additional files. Please ensure the old Cash Advance Pro folder is completely deleted. If any other files are needed later, they can be found in the backup folder or in the recycle bin.
12. SETUP SHARING AND OTHER COMPUTERS ON LAN – If there are other computers on a local area network, set up sharing to \CashAdvPro and then edit the icon properties on the other computers.
UPGRADE ADDITIONAL FOLDERS DETAILS
1. Open a command prompt.
2. Navigate to the new installation folder, which by default is: \CashAdvPro
For example, enter CD \CashAdvPro.
3. Run either Convert.bat or ConvertPF.bat. Convert.bat is run if the old Cash Advance Pro source files are located under \Cash Advance Pro, while ConvertPF.bat should be run if the old source files are located under \Program Files\Cash Advance Pro. Enter the batch file command (Convert or ConvertPF) followed by the name of the data source folder. For example, if the data source folder is named Installment, enter: Convert Installment
4. Review the results of the conversion to verify that there were no failures. If this occurs, please review the log to identify which file encountered the issue.
5. The upddef.exe utility is run automatically from the convert.bat file. Its log is located in the newly created data folder as upddef.txt. Usually, it is not necessary to examine this log unless there are problems later when running the Cash Advance Pro 5 application.
6. Edit desktop icons to target \CashAdvPro instead of \Cash Advance Pro or \Program Files\Cash Advance Pro. When the icon is executed and the alias name is the same as the folder name of the alternate database, a new alias will be created automatically. If this is not the case, the alias will need to be added to the server manually.
7. Important – Re-Save Alias List – Only for systems with multiple databases, resave the alias list for future updates. Otherwise, future updates will have errors. Go to File / Change Database / Save Alias List.
CONVERT CUSTOM REPORTS DETAILS
1. In the designer of Cash Advance Pro 4.92, use File / Save to File to save the report to disk. Alternatively, if the data manager nxMgr was installed, it can be used to view the reports located in the file rbItem.nx1. Copy and paste the blob field into a text editor, then copy and replace it again after editing (step 2).
2. Load the template into a text editor and do the following Find and Replace operations (note that the single quotes are important and need to be specified in the Find and Replace command):
a. Change: daff to danx
b. Change ‘DateTime’ to ‘DateT’
c. Change ‘Datetime’ to ‘Datet’
d. Change: ‘dtFlashFiler’ to ‘dtNexusDB’
3. Save the file to disk in the new reports folder (CashAdvPro\Reports), or save the rbItem.nx1 record if using nxMgr. Load the template into the Report Designer in Cash Advance Pro 5.0 under Reports / Custom Reports. Then save the report to the custom report area using File/Save As.
The system utilizes three external custom reports: MRStmt.rtm, PCStmt.rtm, and PCChk.rtm. It is useful to have these loaded into the custom reports area for doing reprints of Misc. Receipt and Petty Cash Statements, and for printing petty cash checks. If you have already loaded them into the custom report area, their names (e.g., Petty Cash Statement) are likely more meaningful. Use the File/Load from File option to load them and the File/Save As option to save them in the custom report area, overwriting the existing previous report name if it exists already.