Sage Pastel Support Document

Solving Error Code 20

This error occurs when the Pervasive Engine is not running on

the local machine or Server or when a workstation cannot

link to the server engine in a Client / Server environment

A.On a New Installation

B. On a Previously Functioning Installation

A. ON A NEW INSTALLATION

Do you have a permanent Pervasive license?

Pervasive not licensed permanently and the temp license having expired, could result in thiserror.Check your Pervasive Licenses – Go to Start > All Programs > Pervasive > Pervasive.SQL >Other Utilities > License Administrator. Here you must have a Permanent license type showing.

Has the embedded spaces option been “turned off”?

To turn off the embedded spaces follow the procedures below:

Pervasive V9

• Go to Start > Run, and type pcc, and click on the OK button. The screen below willdisplay.

• On the left hand side of the screen, click on Local Client > Microkernel Router. On theright hand side of the screen, double click Configure Microkernel Router.

• Untick the “Embedded Spaces” option, and click on OK.

Pervasive V10

• Select Start | All Programs | Pervasive SQL | Pervasive.SQL 10 Control Centre

• Expand the Pervasive.SQL folder

• Expand Local Client

• Double click on Microkernel Router, and then select Application characteristics

• Ensure that Embedded Spaces is unticked, click on Apply and OK

Is the Pervasive Engine Running?

Bottom right hand corner where the time is displayed, there is should be an Icon called PervasiveDatabase - Pre-load

Are there conflicting versions of Pervasive installed?

• Bottom right hand corner where the time is displayed, there should be an Icon calledPervasive Database - Pre-load, right click on it.

Pervasive V8 & V9

Pervasive V10

• Select the option Stop Engines and Exit.

• Check to see which version of Pervasive you are running by following the steps aboveand select the option About…

Always make sure that you have the same version of Pervasive installed and running onall machines, including the Server. Please note that you should be running the Pervasiveversion you are registered for.

If the Pervasive Engine is running and there are no conflicting versions of Pervasive installed,Pervasive will have to be uninstalled completely and reinstalled.

Uninstalling Pervasive (Pervasive V8 & V9)

• Bottom right hand corner where the time is displayed, there is should be an Icon calledPervasive Database - Pre-load, select the option Stop Engines and Exit.

• Insert the Pastel CD. If the Autorun is on, the CD menu will automatically launch. Click on• EXIT to exit to close the menu.• Double click on My Computer.• In My Computer, you will see an icon for Pastel CD. Right-click on it, and select the• option: Open.• Double click on Workgroups For Windows.• Double click on the Pervasive folder.• Double click on the Psa folder.• Double click on the Setup.Exe file (it has the icon of a blue computer screen with a box in• front of it. It might also have description “32-bit setup launcher”).• When the Pervasive System Analyzer setup screen comes up, click on Next until it• installs.• A Pervasive System Analyzer Wizard window will open.• Select the option: “Delete Components or Archives”.• Select “Local Machine”.• Select both options to delete components and delete archives.• The Pervasive System Analyser will uninstall Pervasive.• Once this has completed, you will need to restart the computer.

Reinstalling Pervasive (Pervasive V8 & V9)

• Double click on My Computer.• Right click on the Pastel CD again and select the option Open.• Double click on Workgroups for Windows.• Double click on the Pervasive folder to open it.• Double click on Setup.Exe.• When the Pervasive Setup screen comes, click on Next.• Accept the License Agreement.• When prompted to enter a license code, leave the field blank and click on Next.• Select “Typical” as the setup option.• Leave the default destination folder and click on Next.• Click on Install to install Pervasive.• After the installation has completed, restart the computer.• After the installation, a HTML Help window will appear .Close this screen.• When prompted if you want to test the Transactional Engine, select “I do not want to run• the Transactional Engine Test.”• When prompted if you want to test the Relational Engine, select “I do not want to run the• Relational Engine Test.”• Click on Finish to complete the installation procedure.• After Pervasive has been installed, you will need to restart the computer.• After the computer has been restarted, click on Start | Run.• Type in: regsvr32 pvswver.dll.• A dialog box should appear with the text: “DllRegisterServer in pvswver.dll Succeeded.• You should be able to open Pastel successfully.

Uninstalling Pervasive (Pervasive V10)

• Please go to Start > Control Panel > Add or Remove Programs.• Scroll to the Pervasive installation, select it and click on the Remove button.

Reinstalling Pervasive (Pervasive V10)

• Insert CD / DVD into disk drive

• Right click on the Disk drive and select Explore

• Go to Pervasive > Pervasive V10

• Double click Workgroup for Windows

• Double click on SetupWorkgroup_x86.exe

• Go next on first screen

• Accept Licence Agreement…Next

• Select the option “Run as an Application, and click on Next

• On the Setup Type screen, please select the option “Complete”, and click on Next

• Select InstallThis process takes some time, so it is advisable to not interrupt installation at any stage.

• Once the installation is complete, click on Finish

• Close HTML File as no need to register

• Once you can open Pastel, please go through the registration processagain, in order to register the newly installed Pervasive.NB: Pervasive is registered AUTOMATICALLY when Pastel is registered

B. ON A PREVIOUSLY FUNCTIONING INSTALLATION

When using a single user license a local pervasive engine is required. This means that Pervasivemust be installed and running on the machine where Pastel is loaded.

Using a workgroup engine multi user license a pervasive engine is required on the local machineas well as on the machine with the data. And these two machines should be able to communicatewith each other.

Running a Client / Server multi user license the Pervasive engine is only fully loaded on theServer machine and all other workstation only process requests through to the Server.Hence the reason the shortcut when accessing Pastel should be directed to the Server for theClient Pervasive to be able to locate the Server engine.

Checking Firewall settings in Windows

• Click on Start > Control Panel• Double click on Windows Firewall

Add the Pervasive Ports 1583 & 3351 under the Exceptions tab in your Windows Firewalland Anti Virus Software programs. This will prevent the security programs from blockingPervasive.

• Also please stop the Windows Firewall Service.

Right click on the My Computer icon, and click on Manage.

On the right hand side of the screen, double click on Services and Applications, and thenclick on Services. On the right hand side of the screen again, look for the WindowsFirewall / Internet Connection. Right click on it, and select Stop.

Check Regional Settings in the Control Panel

• Ensure that the regional settings are set to English South Africa. To verify the regionalsettings, go to Start > Control Panel > Regional and Language Options.

Check the network using the Pervasive System Analyzer (If using Pervasive V8 & V9)

• Click on Start > All Programs > Pervasive system Analyzer• This will open a window on the screen, click on Next• Select the option “Test Active Installation”, also select all the options below

• Click on Next• Now select the Server machine on the network, this will test network communication

between the Server and the Workstation.• A summary indicating that ALL information sent have been received should display.

• On the next screen run the Transactional Engine Test – make sure it is successful.

• Then run the Relational Engine Test – make sure it is successful.

• If errors were encountered on any of these tests, they need to be sorted out by yourNetwork Technician.

Error Code 20 when using Pervasive Client / Server

• On the workstation, right click on the Pastel icon on the desktop• Select properties• Go to the option that says Start In

• Make sure that your mapped network drive is selected. E.g. your server drive is F: fromthe workstation, the Start In should read “F:\”.

• If the target is correct, then run through the network tests shown above.

Error Code 20 when running Pastel and Pervasive on a Windows Vista / Windows 7machine

When getting an error code 20 once you installed Pastel & Pervasive on Windows Vista, youneed to change the following settings. Remember that this is what we have found to work so farand will not necessarily solve your issue.

1. Set the access level to full control for the following Pervasive file:• If you have Pervasive V8 and V9 installed, go to C:\PVSW\Bin and look for

w3dbsmgr.exe.• If you are running Pervasive V10, go to C:\Program Files\Pervasive Software\PSQL\bin

and look for w3dbsmgr.exe.• Right click on this file and select Properties.• Click on the Securities tab, and allow all users full control.

2. Turn off the following User Account setting in the Control Panel:• Go to the Control Panel, User Accounts.• Select the option “Turn User Account Control on or off”

• Uncheck the option “Use User Account Control (UAC) to protect your computer”

Turning off UAC on a Windows 7 machine

• Go to the Control Panel and ensure that the View By option is set to “Category”

• Click on the green text listed as “User Accounts”

• You will get a second menu and once again click on the green text listed as “UserAccounts”

• In the next menu in the User Accounts settings click on “Change User Account ControlSettings”

• In the User Account Control Settings window, by default the slider on the left is in the second fromthe top position.

• Drag this slider down to the bottom or “Never notify” option and then click on the OK on thebottom right.

• You will be prompted and will need to reboot the PC at this time.