From time to time, a new GYTPOL client is introduced.
Upon completion of thorough testing and endorsement for public distribution, the GYTPOL team will furnish you with a link to upgrade your current clients to the latest version.
Refer to the steps below to facilitate the automatic upgrade of the GYTPOL client on your workstations and servers.
On-Prem Deployment
Retrieve the client files provided by the GYTPOL team and unzip the MSI files into the client updates directory situated at C:\gytpol\data\WebSrv\static\updates (you can substitute "C:" with the GYTPOL Installation folder directory).
If any files already exist in that folder, please proceed to overwrite and replace them with the newly downloaded files.
Navigate to the .MSI file and right-click on it. Then, select "Properties" and go to the "Details" tab. Note down the version of the client, ensuring to record only the first three numbers and omit the trailing zero.
Navigate to the GYTPOL installation directory, typically located at C:\gytpol\data\Analyzer\Config (you can replace "C:" with the actual installation folder path). Then, open the file named clientUpgrade.json using Notepad++ or Notepad with elevated privileges.
Please change the following:
Under the "computers" section, you can specify the list of computers you intend to update. By default, it is set to "all," which updates any client reporting to GYTPOL. If you wish to update only specific clients, please list the names of the Endpoints/Servers within the list while maintaining JSON syntax, including commas and quotes. For example:
“computers”: [
“pc01”,”pc02”,”srv01”,”dc02”
],
b. Under the "links" section, you should specify the URL from which the clients will download the new version. This URL should include the Fully Qualified Domain Name (FQDN) of the GYTPOL server. This step is required only the first time the file is edited.
If you are utilizing the Remote Employees feature, you can include additional links from web-facing servers like DMZ, AWS, or Azure servers. Ensure these links are added using JSON syntax. For example:
"links": [
"https://_gytpol:9093/updates/gytpolClient_x64.msi",
"https://some-webserver.domain.com/path-to-msi.msi"
],
c. Under the "gytpolClient" section, the name of the client file at the end of the URL specified in step 4.b should be modified. Initially, it appears as an example and should be changed to gytpolClient_x86.msi for 32-bit systems and gytpolClient_x64.msi for 64-bit systems.
After the initial upgrade, it should remain unchanged.
d. For updating Linux / macOS clients, utilize IP addresses instead of Fully Qualified Domain Names (FQDN) in the client link. Additionally, manually add Linux links to the JSON, incorporating version, clientType, and fileType parameters as shown in the example below (marked green):
e. Under the "version" section, input the client file version obtained from step 2. Ensure to include only the first three numbers of the version (e.g., 2.26.5 instead of 2.26.5.0).
Save the file once you have made the necessary modifications.
If you are using Notepad++, please follow these steps to launch it in Administrator mode and save the file
Navigate to the System Services. Locate the "GYTPOL Data Repository" service and the "GYTPOL Web UI" service. Restart both services to apply the changes.
Upon the next client communication with the server, your client will automatically fetch the upgrade and undergo a silent upgrade process without requiring any intervention.
SaaS Deployment
Client update batch tasks can be applied to computer groups, which should be created before setting up the update task. To check or create a computer group, please refer to this guide: https://gytpol.atlassian.net/wiki/x/CIBUBg
Navigate to the gear icon located in the top right corner, then select "Settings," followed by "Client Updates".
Click the Plus icon in the Automated Client Update Batches section.
Enter a batch name and select the desired computer group from the list. If the group doesn't exist yet, you can create it from this screen.
Choose the schedule window for the batch to run:
ASAP: The update task will be executed by the GYTPOL Client’s hourly check-in, assuming the computer and client are active.
After time: Only after a designated [hour] and within the provided time [window].
After day/time: On the next specified [day] and only after a designated [hour] within the provided time [window].
You should now see the newly created task in the list.
Monitoring Upgrade Progress and Client Health
To track the upgrade process or validate its effectiveness, log in to the GYTPOL web portal. Navigate to the Health dashboard by clicking on the gear icon located in the top right corner of the screen. From there, you can monitor the clients' health status and verify that all clients have successfully upgraded to the latest version by reviewing their status on the dashboard. This allows you to ensure that the upgrade process is working as intended and that all clients are running the latest software version.
