Network Installation - Connect

Network Installation - Connect

How do I install Cashbook Connect on a Network or a Terminal Server Environment?
---------------
Pre-installation Notes

Running Cashbook Connect 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 Connect  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 licensed 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 license 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 Connect to your preferred location (default is C:\Program Files (x86)\PracSys\CBPlus) on the Server.
  2. Share this folder with all users who need access to Cashbook Connect, 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 Connect 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 0.

Example File

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

Backups and local connection error

If backups are prevented by an error message related to local connections, try creating an ads.ini file in the Programs folder of the installation location and add the following content.
  1. [Settings]
  2. MTIER_LOCAL_CONNECTIONS=1

Article ID 1427