Difference between revisions of "Workstation Installation Instructions"

From Agency Systems Wiki
Jump to navigation Jump to search
(43 intermediate revisions by 3 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>
== Windows 8 / 7 / Vista ==
+
    <td>[[File:Ic_description_black_24dp.png|link=Newton User Guide#Installation]] Newton User Guide: [[Newton User Guide#Installation|Installation]]</td>
 
+
</tr>
*Verify the workstation is running one of the following: Microsoft Windows 8 / Windows 7 / Windows Vista
+
<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>
 +
*Verify the workstation is running one of the following: Microsoft Windows 10 / Windows 8 / Windows 7 / Windows Vista
  
 
*Review the [[Installation Environment and Network Requirements]] and [[Hardware Recommendations]].
 
*Review the [[Installation Environment and Network Requirements]] and [[Hardware Recommendations]].
 
   
 
   
 
*You will need to be logged in as a local Administrative user.  
 
*You will need to be logged in as a local Administrative user.  
 
==== Map the Network Drive ====
 
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.
 
  
;Example:<tt>
+
== Troubleshoot Error Codes and Other Considerations ==
:Server Name: SERVERNAME
+
[[:Category:Error|Category: Error Codes]]
:Shared Folder: APPS
+
*[[Error: Crpe32.dll not found]]
:Mapped Path: X:\APPS\ </tt>
+
*[[Error: 501 Job Failed]]
 +
*[[The Easy MAPI COM Server is needed to use MAPI in a "Cross-Bitness" environment]]
  
[[File:Mapnetworkdrive-gui.png]]
+
Display Issues
 
+
*[[Display Issues Printing Forms or Viewing Window Buttons]]
Optionally, the drive can be mapped from a cmd.exe prompt.
+
*[[Make Text and Other Items Larger or Smaller]]
net use X: \\SERVERNAME\APPS
+
*[[Transaction Number Or Code Default Text Blank]]
 
 
==== Install the Pervasive Client ====
 
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.
 
 
If the file does not exist, download it from the following location and save it to the X:\Empire\ folder on the server.
 
 
 
http://www.asfiles.com/PSQL/PSQL11.3Client32.exe
 
 
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 ====
+
Other
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.
+
*[[Open File Security Warning]]
  
#Select the Microsoft Windows Start Menu.
+
== Map the Network Drive ==
#Enter CMD in the start search box.  
+
'''Map the drive as an Admin'''
#Right-click and select Run as Administrator'''This step is critical, even if you are already logged into the machine as Administrator.'''
+
#Click the Microsoft Windows Start Menu.
#Enter the following commands where X: is the drive letter for your office:
+
#Enter '''cmd''' in the start search box.
  net use X: \\SEVERNAME\SHAREDFOLDERNAME
+
#Right-click '''cmd.exe'''
X:
+
#Select '''Run as Administrator'''. This step is critical, even if you are already logged into the machine as Administrator.
  cd Empire
+
#:[[File:WorkstationInstall1.jpeg]]
Adduser.exe
+
#You will see the Command Prompt box open with Administrator.
 +
#:[[File:WorkstationInstall2.jpeg]]
 +
#Enter the following commands where X: is the drive letter for your office & "servername" is your actual server's name.
 +
#Verify '''The command completed successfully.'''
 +
  '''net use x: \\servername\APPS'''
 +
:[[File:WorkstationInstall3.jpeg]]
 +
'''Map the drive as a User'''
 +
#Click the Microsoft Windows Start Menu.
 +
#Enter '''cmd''' in the start search box.
 +
#Left-click to open the command prompt.
 +
#Enter the following commands where X: is the drive letter for your office & "servername" is your actual server's name.
 +
  '''net use x: \\servername\APPS'''
  
If the workstation will have 64 bit Microsoft Office installed (Office, not Windows), replace Adduser.exe with the following:
+
== Install the Pervasive Database Client ==
  Adduser.exe /64
+
Open a '''new''' command prompt as Administrator.
 +
'''x:'''
 +
  '''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]]
  
Select Run, Begin, then Finish.
+
=== 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.
  
If prompted to reboot the machine select Yes.
+
== 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'''
 +
#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'''.
  
== Potential Error Codes After Installation ==
+
== Test Agency Systems ==
[[Error: Crpe32.dll not found]]
+
#'''Double click''' the Agency Systems icon.
 +
#Agency: '''95'''
 +
#Operator: '''DCS'''
 +
#Password: '''EMPYRE'''
  
[[Error: 501 Job Failed]]
+
Once the application opens, click on one of the tabs to make sure it loads data.
  
[[Display Issues Printing Forms or Viewing Window Buttons]]
+
[[File:Ic_info_black_24dp.png]] See [[#Troubleshoot Error Codes and Other Considerations|the troubleshooting section above]] for any errors.

Revision as of 18:03, 23 September 2019

Ic description black 24dp.png Newton User Guide: Installation
Related Pages
Related Categories
  • Verify the workstation is running one of the following: Microsoft Windows 10 / Windows 8 / Windows 7 / Windows Vista
  • You will need to be logged in as a local Administrative user.

Troubleshoot Error Codes and Other Considerations

Category: Error Codes

Display Issues

Other

Map the Network Drive

Map the drive as an Admin

  1. Click the Microsoft Windows Start Menu.
  2. Enter cmd in the start search box.
  3. Right-click cmd.exe
  4. Select Run as Administrator. This step is critical, even if you are already logged into the machine as Administrator.
    WorkstationInstall1.jpeg
  5. You will see the Command Prompt box open with Administrator.
    WorkstationInstall2.jpeg
  6. Enter the following commands where X: is the drive letter for your office & "servername" is your actual server's name.
  7. Verify The command completed successfully.
net use x: \\servername\APPS
WorkstationInstall3.jpeg

Map the drive as a User

  1. Click the Microsoft Windows Start Menu.
  2. Enter cmd in the start search box.
  3. Left-click to open the command prompt.
  4. Enter the following commands where X: is the drive letter for your office & "servername" is your actual server's name.
net use x: \\servername\APPS

Install the Pervasive Database Client

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.