Difference between revisions of "Workstation Installation Instructions"

From Agency Systems Wiki
Jump to navigation Jump to search
 
(59 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
[[Category:Installation]][[Category:Pervasive]]
+
[[Category:Installation]][[Category:Pervasive]]  
−
Adding Newton by Agency Systems to a workstation requires the installation of Pervasive.  The instructions below reference the most current version of pervasive, however your office may be running an older version. Since all versions of Pervasive on the same network must match, please contact [http://www.agencysystems.com/support Agency Systems Support] to verify the installed version before proceeding.
+
<table class="infobox" cellspacing="5" style="background-color: #FFFFFF; width:27em; text-align:left; border-spacing: 2px; line-height:1.5em;">
 +
   <tr>
 +
    <td>[[File:Ic_description_black_24dp.png|link=Newton User Guide#Installation]] Newton User Guide: [[Newton User Guide#Installation|Installation]]</td>
 +
  </tr>
 +
  <tr style="background-color: #bdbdbd; text-align: center; font-weight:bold;">
 +
    <td>Related Pages</td>
 +
  </tr>
 +
  <tr>
 +
    <td>
 +
      <ul>
 +
        <li>[[Backup Information]]</li>
 +
        <li>[[Hardware Recommendations]]</li>
 +
        <li>[[Installation Environment and Network Requirements]]</li>
 +
        <li>[[Make Text and Other Items Larger or Smaller]]</li>
 +
      </ul>
 +
    </td>
 +
  </tr>
 +
  <tr style="background-color: #d3d3d3; text-align: center; ">
 +
    <td>Related Categories</td>
 +
  </tr>
 +
  <tr>
 +
    <td>
 +
      <ul>
 +
        <li>[[:Category:Installation|Installation]]</li>
 +
      </ul>
 +
    </td>
 +
  </tr>
 +
</table>
  
−
== Windows 8 / 7 / Vista ==
+
==Instructions==
 +
*Verify the workstation is running a current version of Microsoft Windows. As of 2025-10-14 Windows 10 reached end-of-life. See [https://support.microsoft.com/en-us/windows/windows-10-support-ends-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281 https://support.microsoft.com/en-us/windows/windows-10-support-ends-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281].
 +
*Review the [[Installation Environment and Network Requirements]] and [[Hardware Recommendations]].
 +
===Map Drive As Admin and run Adduser===
 +
#Login to Windows as the user.
 +
#Run CMD as administrator.
 +
#:[[File:wss.2.png]]
 +
#Map a network drive to the share on your file server where Newton is installed. Use the same drive letter on every machine e.g.:
 +
#:'''net use s: \\newton-server\asApps'''
 +
#Change directory to the empire\programs directory on the mapped drive e.g.:
 +
#:'''cd /d s:\empire\programs'''
 +
#Run '''adduser.exe''' and click Begin.
 +
#:[[File:wss.3.png]]
  
−
Verify the workstation is running one of the following:
+
===Map Drive as User===
−
Microsoft Windows 8 / Windows 7 / Windows Vista
+
#Open CMD.
 +
#:[[File:wss.0.png]]
 +
#Map the network drive e.g.:
 +
#:'''net use  s:  \\newton-server\asapps
 +
#:[[File:wss.1.png]]
 +
#Exit CMD.
  
−
Review the [[Network Requirements]] and [[Hardware Recommendations]].
+
===Run Newton to Complete Setup===
−
+
Double click the Agency Systems icon on the desktop to run Newton. You may get two User-Account-Control message boxes asking to run RWEasyMapi64.exe requiring admin elevation, and another to run mariadb-connector32-3-1-11.msi. Enter the local admin user and password to run them.
−
You will need to be logged in as a local Administrative user.  
+
#:[[File:wss.4.png]]
−
+
===Login===
−
==== Map the Network Drive ====
+
Have the user login to test, or use
−
Map a network drive to the share directory containing the empire folder on the Server/Master machine. It is recommended to use the same drive letter on every machine in the office.  For the examples below the letter X: will be used.  Substitute X: with your drive letter as needed.
+
*Agency: '''95'''
 +
*Operator: '''DCS'''
 +
*Password: '''EMPYRE'''
  
−
;Example:<tt>
+
==LEGACY Pervasive Client Installation==
−
:Server Name: SERVERNAME
+
Open a '''new''' command prompt as Administrator.
−
:Shared Folder: APPS
+
'''x:'''
−
:Mapped Path: X:\APPS\ </tt>
+
'''cd empire'''
 +
'''PSQL11.3Client32.exe'''
 +
#Select '''Yes'''
 +
#:[[File:WorkstationInstall4.jpeg]]
 +
#Select '''Unzip'''
 +
#:[[File:WorkstationInstall5.jpeg]]
 +
#Select '''Ok'''
 +
#:[[File:WorkstationInstall6.jpeg]]
 +
#Select '''Install'''
 +
#:[[File:WorkstationInstall7.jpeg]]
 +
#Select '''Next'''
 +
#:[[File:WorkstationInstall8.jpeg]]
 +
#Select '''I accept...'''
 +
#Select '''Next'''
 +
#:[[File:WorkstationInstall9.jpeg]]
 +
#Select '''Run as a Service'''
 +
#Select '''Next'''
 +
#:[[File:WorkstationInstall10.jpeg]]
 +
#Select '''Complete'''
 +
#Select '''Next'''
 +
#:[[File:WorkstationInstall11.jpeg]]
 +
#Select '''Install'''
 +
#:[[File:WorkstationInstall12.jpeg]]
 +
#Select '''Finish'''
 +
#Select '''Exit'''
 +
*Disregard and Close the internet window.
 +
:[[File:WorkstationInstall13.jpeg]]
  
−
[[File:Mapnetworkdrive-gui.png]]
+
=== Configure Pervasive Settings ===
 +
Close the old command prompt & Open a '''new''' command prompt as Administrator.
 +
'''PCC'''
 +
#Select '''Tools''' > '''ODBC Administrator or 32bit ODBC Administrator''' (Not 64bit).
 +
#Select the '''System DSN'''  >  '''Add''' (If Agyforms is not already configured).
 +
#Choose '''Pervasive ODBC Client Interface''' and select Finish.
 +
#Type '''AGYFORMS''' in the Data Source Name field.
 +
#Enter '''Your''' Server Name in the Server Name/IP field.
 +
#Select '''Get List'''.
 +
#Verify '''Agyforms''' is selected in the drop down box named Database Name.
 +
#Select '''Test''' and select '''OK''' once the Connection Successful box appears.
 +
#Select '''OK''' to create the Client DSN.
 +
#'''Exit''' the ODBC Administrator.
  
−
Optionally, the drive can be mapped from a cmd.exe prompt.  
+
=== Create Agency Systems Icon and Install Crystal Reports ===
−
  net use X: \\SERVERNAME\APPS
+
Close the old command prompt & Open a '''new''' command prompt as Administrator.
 +
  '''x:'''
 +
'''cd empire'''
 +
'''Adduser.exe'''
 +
#If the workstation will have 64 bit Microsoft Office installed (Office, Not Windows), replace '''Adduser.exe''' with '''Adduser.exe /64'''.
 +
#Select '''Run'''.
 +
#Select '''Begin'''.
 +
#Select '''Finish'''.
  
−
==== Install the Pervasive Client ====
+
=== Test Agency Systems ===
−
Browse to X:\Empire\ and run the pervasive installer PSQ11.3Client32.exe.  The version number of 11.3 may be different if you are using an older version of Pervasive.  
+
#'''Double click''' the Agency Systems icon.
−
+
#Agency: '''95'''
−
If the file does not exist, download it from the following location and save it to the X:\Empire\ folder on the server.
+
#Operator: '''DCS'''
 +
#Password: '''EMPYRE'''
  
−
http://www.asfiles.com/PSQL/PSQL11.3Client32.exe
+
Once the application opens, click on one of the tabs to make sure it loads data.
−
 
−
Take all of the defaults except, select "Install as Service" when prompted.
 
−
 
−
==== Setup Client Data Source Name (DSN) ====
 
−
#Select the Microsoft Windows Start Menu.
 
−
#Enter '''PCC''' in the start search box then select Ok.
 
−
#Select '''Tools -> ODBC Administrator''' or '''32-bit ODBC Administrator''' if using a 64-bit operating system.
 
−
#Select the '''System DSN''' tab and then select Add.
 
−
#Highlight '''Pervasive ODBC Client Interface''' and select Finish.
 
−
#Under Data Source Name enter '''AGYFORMS'''
 
−
#Enter the full server name in the Server Name/IP: field and select Get List.
 
−
#Verify AgyForms is selected in the drop down box named Database Name.
 
−
#Select Test and select Ok once the Connection Successful box appears.
 
−
#Select Ok to create the Client DSN.
 
−
#Exit the ODBC Administrator.
 
  
−
==== Setup the Agency Systems Icon ====
+
[[File:Ic_info_black_24dp.png]] See [[#Troubleshoot Error Codes and Other Considerations|the troubleshooting section above]] for any errors.
−
When installing from a mapped network drive, the drive mappings are lost when the Administrator account is elevated. This is a function of the User Access Control (UAC) in Windows. The elevated and non-elevated administrator accounts have different logon tokens and can therefore have different drive mappings.
 
  
−
#Select the Microsoft Windows Start Menu.
+
== Troubleshoot Error Codes and Other Considerations ==
−
#Enter CMD in the start search box.
+
[[:Category:Error|Category: Error Codes]]
−
#Right-click and select Run as Administrator.  '''This step is critical, even if you are already logged into the machine as Administrator.'''
+
*[[Error: Crpe32.dll not found]]
−
#Enter the following commands where X: is the drive letter for your office:
+
*[[Error: 501 Job Failed]]
−
net use X: \\SEVERNAME\SHAREDFOLDERNAME
+
*[[The Easy MAPI COM Server is needed to use MAPI in a "Cross-Bitness" environment]]
−
X:
 
−
cd Empire
 
−
Adduser.exe
 
  
−
Select Run, Begin, then Finish.
+
Display Issues
 +
*[[Display Issues Printing Forms or Viewing Window Buttons]]
 +
*[[Make Text and Other Items Larger or Smaller]]
 +
*[[Transaction Number Or Code Default Text Blank]]
  
−
If prompted to reboot the machine select Yes.
+
Other
−
 
+
*[[Open File Security Warning]]
−
== Potential Error Codes After Installation ==
 
−
[[Error: Crpe32.dll not found]]
 
−
 
 
−
[[Error: 501 Job Failed]]
 

Latest revision as of 14:22, 30 October 2025

Ic description black 24dp.png Newton User Guide: Installation
Related Pages
Related Categories

Instructions

Map Drive As Admin and run Adduser

  1. Login to Windows as the user.
  2. Run CMD as administrator.
    Wss.2.png
  3. Map a network drive to the share on your file server where Newton is installed. Use the same drive letter on every machine e.g.:
    net use s: \\newton-server\asApps
  4. Change directory to the empire\programs directory on the mapped drive e.g.:
    cd /d s:\empire\programs
  5. Run adduser.exe and click Begin.
    Wss.3.png

Map Drive as User

  1. Open CMD.
    Wss.0.png
  2. Map the network drive e.g.:
    net use s: \\newton-server\asapps
    Wss.1.png
  3. Exit CMD.

Run Newton to Complete Setup

Double click the Agency Systems icon on the desktop to run Newton. You may get two User-Account-Control message boxes asking to run RWEasyMapi64.exe requiring admin elevation, and another to run mariadb-connector32-3-1-11.msi. Enter the local admin user and password to run them.

  1. Wss.4.png

Login

Have the user login to test, or use

  • Agency: 95
  • Operator: DCS
  • Password: EMPYRE

LEGACY Pervasive Client Installation

Open a new command prompt as Administrator. 

x:
cd empire
PSQL11.3Client32.exe
  1. Select Yes
    WorkstationInstall4.jpeg
  2. Select Unzip
    WorkstationInstall5.jpeg
  3. Select Ok
    WorkstationInstall6.jpeg
  4. Select Install
    WorkstationInstall7.jpeg
  5. Select Next
    WorkstationInstall8.jpeg
  6. Select I accept...
  7. Select Next
    WorkstationInstall9.jpeg
  8. Select Run as a Service
  9. Select Next
    WorkstationInstall10.jpeg
  10. Select Complete
  11. Select Next
    WorkstationInstall11.jpeg
  12. Select Install
    WorkstationInstall12.jpeg
  13. Select Finish
  14. Select Exit
  • Disregard and Close the internet window.
WorkstationInstall13.jpeg

Configure Pervasive Settings

Close the old command prompt & Open a new command prompt as Administrator. 

PCC
  1. Select Tools > ODBC Administrator or 32bit ODBC Administrator (Not 64bit).
  2. Select the System DSN > Add (If Agyforms is not already configured).
  3. Choose Pervasive ODBC Client Interface and select Finish.
  4. Type AGYFORMS in the Data Source Name field.
  5. Enter Your Server Name in the Server Name/IP field.
  6. Select Get List.
  7. Verify Agyforms is selected in the drop down box named Database Name.
  8. Select Test and select OK once the Connection Successful box appears.
  9. Select OK to create the Client DSN.
  10. Exit the ODBC Administrator.

Create Agency Systems Icon and Install Crystal Reports

Close the old command prompt & Open a new command prompt as Administrator. 

x:
cd empire
Adduser.exe
  1. If the workstation will have 64 bit Microsoft Office installed (Office, Not Windows), replace Adduser.exe with Adduser.exe /64.
  2. Select Run.
  3. Select Begin.
  4. Select Finish.

Test Agency Systems

  1. Double click the Agency Systems icon.
  2. Agency: 95
  3. Operator: DCS
  4. Password: EMPYRE

Once the application opens, click on one of the tabs to make sure it loads data.

Ic info black 24dp.png See the troubleshooting section above for any errors.

Troubleshoot Error Codes and Other Considerations

Category: Error Codes

Display Issues

Other

Retrieved from "http://wiki.agencysystems.com/index.php?title=Workstation_Installation_Instructions&oldid=7127"