Installing & Configuring AutoMate
Pre-Installation Tasks
In case AutoMate is installed in a network environment (LAN), a Windows Login Account is required specifically for Nimbus AutoMate, which then provides AutoMate with the appropriate Access Permissions to run and to automatically update it from the Internet.
- Administrative Access to the server where AutoMate to be installed.
- Internet access (Nimbus picks up the AutoMate software from the Internet) from the workstastion/server running the install.
- Provide AutoMate with correct Permissions.
- Path of the database to be synchronised.
- Path for Synced documents Folder.
Administrative Access to installation path
The installation path for AutoMate is typically: C:\Program Files\Nimbus Technology\
Please ensure the Windows User Account that you create to run Nimbus AutoMate, has sufficient rights to create a folder from the Program Files folder.
Internet Access
- Please ensure you have internet access to - nimbushost.net
- Confirm that https://*.nimbushost.net is a trusted website:
- Open Internet Explorer
- Go to Internet Options > Security tab
- Trusted Sites > Sites button - ensure that "https://*.nimbushost.net" is a trusted site.
Install AutoMate
- Login to your Nimbus Business account as Administrator user
Go to Admin > AutoMate and select the Integration type from the drop-down list.
If the Install and Configure buttons are not enabled it means that the machine environment is not qualified to support Nimbus AutoMate and you should contact Nimbus support
The Install button is used to download and install the Nimbus AutoMate service. To begin installation, just click on it. The system will show a “Launching Application” window, followed by a security warning and/or a downloading progress window, but will soon stop at the Install dialog similar to:
The dialog will then switch to the installed state:AutoMate runs as a true Windows service and hence appears under the Windows Control Panel >> Administrative Tools >> Services and events are posted the Windows Event Log >> Applications
Its is now ready to commence the configuration process.
Account & Permissions
When the AutoMate Windows Service is set with the proper permissions to operate, it will be able to perform the following:
- Stop the AutoMate Service;
- Upgrade the AutoMate software, which is downloaded from the Nimbus Web Site; and
- Restart the AutoMate Service.
The Nimbus Windows User Account is used to ensure your system has the correct network permissions for the AutoMate software to operate and upgrade automatically where necessary.
Creating the Windows User Account for Nimbus AutoMate
Active Directory user
Please contact your IT services provider to create this account for you.
Local Windows user
- Open the Control Panel
- Access User Accounts
- Add a new User Account
- User name: "Nimbus"
- Full name: "Nimbus"
- Description: "Nimbus"
Set the Service Properties for the Nimbus User Account
- Open the Control Panel
- Open Services
- Scroll down the list and locate the Nimbus AutoMate Service
- Right mouse click on the Nimbus AutoMate and select Properties
- Click the Log On tab
- Select “This account”: radio button and Browse for the User Account: Nimbus created above.
- Apply the changes.
Set the Permissions for the Nimbus Windows User Account
- Click the Start button
- Select “Run Enter “regedit” and click the OK button
- Navigate to:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\NimbusAutoMate\Parameters
- Right-click on Parameters and select Permissions
- Locate the Nimbus Windows User Account created above.
- Allow Full Control for this User Name.
- Please ensure that this Windows User Account has rights to delete files from the Program Files\Nimbus Technology folder (and sub- directories) and that it can create a sub-directory.
Network Access for Nimbus Windows User
- Ensure that the Nimbus Windows User Account has HTTPS access on Firewall port 443 for outgoings
Ensure the Nimbus Windows User Account has network Access
If folder sync is required, confirm that the Nimbus account has full permissions to the documents folder
This may be an issue if you receive an error “No Nimbus Access”.
Nimbus Windows User Account has full permissions to the Database
- Confirm that the Nimbus user has full access to the synced Database (MYOB AE, HandiSoft, APS, PaperBuster)
- The Nimbus Documents folder (if one is being used)
- The MYOB Document Management data folder. Typically this is C:\MYOB\Data\DMFS_VPMSER
IF MYOB DM Configuration required and IF NOT on the same server as Nimbus AutoMate
- Pre-installation - Make a share on the server that contains MYOB Folders – the share must point to the MYOB DM folder which typically is C:\MYOB\Data\DMFS_VPMSER
- Post-installation - Run Regedit on the server where Nimbus AutoMate is installed
- 4.7 Ensure Nimbus Windows User Account has Stop and Start permissions: Microsoft has provided a list of steps at http://social.technet.microsoft.com/wiki/contents/articles/5752.how-to- grant-users-rights-to-manage-services-start-stop-etc.aspx
- 4.8 Ensure the Nimbus Windows User Account has permissions to access the SQL database (APS, HandiSoft and PaperBuster SQL) 1. Open the SQL Manager Studio 2. Ensure the Windows User Account that has been created for Nimbus AutoMate displays within Security / Logins as bellow screenshot. If the user account is not visible, then right mouse click on Login and select New Login. Search for the User Name.
Database | What is required |
MYOB AE (and MYOB AE DM) | the database connection information is contained in the file “lookup.xml” normally found in: C:\program files\MYOB\central\deploy. AutoMate uses this file to locate the actual SQL database |
APS | you will need to know the name of and the location of the APS SQL database |
HandiSoft SQL | you will need to know the name of and the location of the HandiSoft SQL database |
HowNow | you will need to know the name of and the location of the HowNow database |
CCH iFirm | an API key is required |
WorkFlow Max / Xero PM | an API key is required |
Paper Buster | the Microsoft Access file “ATOPB.mbd” is normally used, often stored under the Practice Central folder |
iManage | Please contact Nimbus Support for assistance. |
For HowNow sites, this tab is not available. When the Nimbus Documents folder is located on the same server as the database you are syncing to, you must use a full path name eg: C:\Nimbus Documents\
AutoMate Configuration
The Configure button is used to access the Nimbus AutoMate user interface dialog, which interacts with the installed AutoMate service. When first installed the dialog will present similar to:
Note that the Integration Type has been selected, and that the Practice Login field has been pre-configured with the URL for your Nimbus Business site.
- Click Start Service, to start the Windows Nimbus AutoMate Service. The dialog will update depending upon integration type to include an appropriate database integration tab.
- Click the database tab (2nd tab), and skip to the section below according to database type:
Paper Buster Configuration
- Use the dropdown button to browse and select the desired Paperbuster database. The Verify Paper Buster Database button will be enabled.
- Click the Verify Paper Buster Database button. If the database is verified, i.e., accessible and contains the expected data, the dialog will update to:
- Use the drop down to select the desired Contacts table. This will normally be: “vwBPSPCContacts”.
- Set the Wait time, being the refresh period for subsequent database sync runs, i.e., how quickly the Nimbus database will reflect PM updates. Shorter periods will increase the load on your LAN server.
- Check the Active Only flag according to your preference. When ticked this restricts Nimbus sync to Contacts flagged as active in the Paper Buster database.
- Click Enabled Database Sync. This checks that the database is valid and accessible. The status is reported and the Sync Now button enabled:
- If you wish to immediately populate the Nimbus contact database in the cloud, click “Sync Now”. AutoMate should show sync status culminating with a message similar to “Success. nn updates done”. Please skip ahead now to “Folder Sync”.
MYOB AE Configuration
- Use the ellipsis button to browse and select the AE Central deployment directory. The Verify AE Central Configuration button will be enabled.
- Click the Verify AE Central Configuration button. If a valid MYOB “lookup.xml” file has been found, the dialog will update to enable the AE database field.
- Use the drop down on the AE Database field to select the required database. The Verify AE Central Database Access button will become enabled.
- Check access to the database by clicking Verify AE Central Database Access, it will respond with a Sync Status of “Database access is valid”.
- Set the Wait time, being the refresh period for subsequent database sync runs, i.e., how quickly the Nimbus database will reflect PM updates. Shorter periods will increase the load on your LAN server.
- Check the Active Only flag according to your preference. When ticked this restricts Nimbus sync to Contacts not having a “closed” date.
- Check the Clients Only flag to only sync Client details (not Prospects, Suppliers etc).
- Select a MYOB Extra field to filter on, if you wish to only sync Client Entities who have the Extra Field set to Yes. The name of this Extra field in MYOB is decided by the Business.
- Click Enable Database Sync. This checks that the database is valid and accessible. The status is reported and the Sync Now button enabled.
- If you wish to immediately populate the Nimbus contact and employee database in the cloud, click Sync Now. AutoMate will show sync status culminating with a message similar to “Success. nn updates done”.
Folder Sync Configuration
- Use the ellipsis button to select the root of the folder structure you wish to sync with Nimbus The dialog will update to:
- Use the drop down to change the Sync option if you wish.
- Set the Wait time, being the refresh period for subsequent folder sync runs, i.e., how quickly the Nimbus folders will reflect updates to the server folder structure and vice versa. Shorter periods will increase the load on your LAN server.
- Click “Enable Folder Sync”, the “Sync Now” button will be enabled.
- If you wish to immediately update the Nimbus folder structure in the cloud, click “Sync Now”. AutoMate should show sync status, culminating with a message similar to “Completed, now waiting”.
Day to Day Operation
- On your LAN server, log into your Nimbus Business site using a login with Admin level access. Select Admin>>Practice Details. You should see a pair of buttons labeled “Install” and “Configure”.
- Click the Configure button. Nimbus will check the running version and update it if it is out of date. The Nimbus AutoMate user interface dialog will open. Changes can be made while the service is running, and typically will take effect after the next scheduled sync run.
- If you wish to change either database integration or folder location, it will be necessary to first stop syncing by clicking the relevant “Disable Database Sync” or Disable Folder Sync button.
Further Assistance
Related articles