View source for Installing Barcoders Android Server

{{Note}} This is an incomplete guide at present

== Installing the server ==
Install on Windows Server.

This server must have the following configured by TechHub:
* Port 50061 for TCP
* Access to internet for license validation and application download.


Install on the RDT server:
* Show hidden files and files with known extensions
* Create the following directories:
** c:\logs
** c:\data
* Set the PC power settings to not turn off.
* Open the firewall port.
** Add inbound exception to port 50061 for TCP, named "Barcoders Android"
* Navigate to the "Android RFServer Files" folder.
** Cut and Paste the "Barcoders" folder to the c:\Program Files directory.
** Cut and Paste the "Barcoders.com" folder to the c:\ProgramData directory.
* Find your License folder and copy your two license files (userid.dat and license.xml) into the c:\ProgramData\Barcoders.com folder.
* Update the server to the latest version (see section [[#Updating the server]]


* Create some shortcuts on the desktop, running from C:\Program Files\Barcoders:
** "Start Barcoders Updater", from "C:\Program Files\Barcoders\BarcodersUpdater.exe", set as Run as Administrator
** "Start Barcoders Server", from "C:\Program Files\Barcoders\AndroidStudio\Android Connector.exe"
** "Start Barcoders Admin", from "C:\Program Files\Barcoders\AndroidConnectorWindow\TermProtoTestWindow.exe"


== Updating the server ==
* Ensure that the server is stopped (close the Admin and Server windows).
* Run BarcodersUpdater.exe as administrator (or use the "Start Barcoders Updater" shortcut.
* A window will display - click the button to update to that version.
* When complete, close the window.


== Updating to a specific version ==
To revert to a prior version of the server

* Run CMD (DOS level) as administrator.
* Navigate to the c:\program files\barcoders directory.
* Type the following at the c:\ prompt
 c:\BarcodersUpdater --license-id versions/{vers}
* Where {vers} is the required version number

e.g.
 WIN-R
 cmd
 CTRL-SHIFT-ENTER
 Confirm Administrator rights
 cd c:\program files\barcoders
 BarcodersUpdater --license-id versions/23.52


== Configuring the Applications ==

In "C:\Program Files\Barcoders\AndroidStudio" there are two configuration files:
* appsettings.json - application log levels
* config.json - the applications being run by ABSStudio

To configure applications that can be run by the system, add entries to the config.json file, example below:

 {
 	"ProgramTasks": [
 		{	"ExecutablePath": "C:/WCSTEST/RDTMenu1_Android.exe",
 			"Name": "RDTMenu1 (TEST)",
 			"UsePipes": "True",
 		},
 		{	"ExecutablePath": "C:/WCSLIVE/RDTMenu1_Android.exe",
 			"Name": "RDTMenu1 (LIVE)",
 			"UsePipes": "True",
 		},
 	]
 }

To change logging for the application, modify the Logging setting of the appsettings.json file, example below:

   "Logging": {
     "LogLevel": {
       "Default": "Info",
       "Microsoft": "Warning",
       "Microsoft.Hosting.Lifetime": "Error"
     }
   },
Values can be changed to 
* Info
* Warning
* Error
* Debug

{{Note}} We can clear (delete) the log file and it will recreate with no issues whilst still running.

{{Note}} A single copy of the log file is added to by the server - it does not change or rotate every day or hour.

A script is being investigated to copy and to cleardown old scripts - details will be added here and in the support guide when available.


== Updating Licenses ==

To update the license manually: 
* Contact Barcoders
* Get updated license files.
* Drop into ProgramData
* Stop and restart ABS server.

To renew the license automatically:
* Contact Barcoders
* Barcoders renew license on server
* Stop and restart ABS server.


{{Note}} Confirmation on some processes is being sought:
* Who in Aptean is in charge of renewals of Android licenses?
** We want to be changing and updating licenses BEFORE expiration.
** We want to plan downtime for this.
** Customer Product Manager should handle this.
* Confirmation of the license renewal process with Barcoders requested.

{{:Android_Setup_Guide}}


[[Category:Android]]
[[Category:Technical Guides]]