This article takes a look at how you can change config settings for the desktop API service that applies for local and network mode.
Let’s get started
Heads up: it is assumed you have the AccountRight API desktop service installed and running alongside the AccountRight Server edition.
First things first we need to locate the running service and stop it.
- Close AccountRight and all other programs on your computer.
- Simultaneously press the Windows and R key on your keyboard. The Run window appears.
- In the Open Field, type services.msc then click OK
- Locate the MYOB AccountRight API service in the list
- Right click on the Service and select Properties.
- Click Stop. This will stop the Service.
Now that the service is stopped we can get down to business, the next step is to locate the config file.
Where to find the API config file.
Now we can locate the config file for the MYOB Add-on Connector by browsing to C:\Users\{Windows User}\AppData\Local\Programs\MYOB\AccountRightServerEdition\app-2024.XXX.XXXXX\API
(Note: Windows User is the folder that shared the same name that you log into Windows with. The XXXX.X depends on the version that you have installed.)
The file that we are looking for is called MYOB.AccountRight.API.WindowsServiceHost.exe.
Attention: If having difficulty, previous versions stored the config file in this location:
C:\Program Files (x86)\MYOB\API\2.0.XXXX.X (the XXXX.X depends on the version that you have installed).
As we are dealing with an XML configuration file you can simply open it up with your favourite editor, I have used Notepad ++ in my example below.
What to do next?
Okay now that we have our config file opened up, the 3 variables we are interested in are PublicAddressServer, PublicAddressPort and InstallationAddress.
If our local service is listening to a different port number than the default 8080 we can change both PublicAddressPort and InstallationAddress keys to reflect this.
When running in network mode, it’s worth noting the server name and URI returns localhost by default, because I am accessing a network machine hosting my files, I want to return the IP address of this machine as my default.
I can do this by simply changing the PublicAddressServer key and updating the InstallationAddress to achieve this.
Now that we have made our changes, save the config file and restart the AccountRight API desktop service to apply. To restart the service it is simply a case of following the steps above but instead of clicking stop you would click start to restart the service.
Note: changing the port number may also require updates to your firewall rules allowing external access to it for hosting.
But I run the AccountRight PC edition...
No worries, that's an easy fix.
Let's get started.
Again, this will assume that you have the MYOB Add-on Connector installed alongside the AccountRight PC Edition.
The first step is to stop the MYOB Add-on Connector. The easiest way to do this is to right-click on the Purple chain icon in the system tray and select Exit MYOB Add-on Connector.
Where to find the config file
Now we can locate the config file for the MYOB Add-on Connector by browsing to C:\Users\{Windows User}\AppData\Local\Programs\MYOB\app-2024.XXX.XXXXX\AddOnConnector\
(Note: Windows User is the folder that shared the same name that you log into Windows with. The XXXX.X depends on the version that you have installed.)
The file that we are looking for is called MYOB.AccountRight.API.AddOnConnector.exe.config.
You can simply open it up with your favourite editor like Notepad ++.
What to do next?
Just like we did with the API Config file, the 3 variables we are interested in are PublicAddressServer, PublicAddressPort and InstallationAddress.
If our local service is listening to a different port number than the default 8080 we can change both PublicAddressPort and InstallationAddress keys to reflect this.
When running in network mode, it’s worth noting the server name and URI returns localhost by default, because I am accessing a network machine hosting my files, I want to return the IP address of this machine as my default.
I can do this by simply changing the PublicAddressServer key and updating the InstallationAddress to achieve this.
Now that we have made our changes, save the config file and relaunch the MYOB Add-on Connector.
Note: changing the port number may also require updates to your firewall rules allowing external access to it for hosting.
Comments
0 comments
Please sign in to leave a comment.