Pre-installation Notes

Running Cashbook Platinum on a server requires the use of the Advantage Database Server if it will be run on any type of remote-style connection, such as Remote Desktop, Terminal Server, Citrix Server, etc. If Cashbook Platinum is running in a peer-to-peer style connection, use of the Advantage Database Server is optional, although recommended for performance and database integrity reasons. The Advantage Database Server is licenced based on the number of concurrent users (e.g. If five people need access to Cashbook, but only two need simultaneous access, a 2-user licence is required). Pricing is available on request.

Please note: IPv6 may cause database connection issues. Please disable IPv6 before attempting to run the application.

 

Step 1 - Installation

1. Install Cashbook Platinum to your preferred location (default is C:\Program Files (x86)\PracSys\CBPlat) on the Server.
2. Share this folder with all users who need access to Cashbook Platinum, with a minimum of Read/Execute permissions.

If you have an existing installation in C:\CBPlus, do not install Cashbook there without contacting Practical Systems.

 

Step 2 - Data Location

1. If you want to move the data into another location (e.g. File server, NAS, etc), copy the following files/folders from the Install folder (in Step 1) into the new location. Note: Files/Folders in italics below might not exist, but should be copied to new location if they do:
   
   • ​Data
   • DefaultData
   • Documents
   • Cashbook.unl
   • Cashbook.naf
   • Databases.ini
2. When sharing this folder, all users who need access to Cashbook Platinum will need full Read/Write/Create permissions. If you are using the Advantage Database Server:
   
   • This folder should not be shared to other users as a mapped drive. The path specified in Step 3 must be a UNC path.
   • Also share this folder with SYSTEM user, with full Read/Write permissions.
   • The data must be on the same hardware server as the Advantage Database Server.

 

Step 3 - Configuration

1. Go to the install folder from Step 1 and open the Programs folder. Edit the CBPlus.ini file and modify the DatabaseLocation line to match the new location. This needs to be a UNC path (e.g. \\myserver\cashbook data), rather than a mapped drive (e.g. z:\cashbook data)
2. If you have the Advantage Database Server installed on the server with the data (from Step 2), change DatabaseType to Type=2.

Example File

[MAIN]
Type=2
DatabaseLocation=\\myserver\cashbook data
DFURL=https://df.practicalsystems.com.au:8735/ApplicationService.svc?singleWsdl
AutoUpdate=1

Backups and local connection error

1. [Settings]
2. MTIER_LOCAL_CONNECTIONS=1

Article ID 1427