While it is recommended that one Perspectium Meshlet run per machine, multiple meshlets can be installed as services on the same machine for multitenancy.
NOTE: If you are already have a meshlet installed and need to update the meshlet, please uninstall the meshlet service first as described below.
Prerequisites
First, contact Perspectium Support to get the multitenant-meshlet-service zip installation file.
Installing a Multitenant Meshlet as a service for Windows
To install the meshlet as a service in your Windows machine, follow these steps:
Unzip zip file
Open File Explorer and find the folder where install-multitenant-meshlet-service is located, i.e. C:\Users\username\Downloads\.
Then, right-click the folder and select Extract All.
Install the meshlet
Open up a Command Prompt and run as an Administrator. For example, type cmd in the Windows search window and right-click on Command Prompt and select Run as administrator.
In the Command Prompt, change your directory (cd) to the location where the install-multitenant-meshlet-service zip was extracted to. For example C:\Users\username\Downloads\install-multitenant-meshlet-service.
cd C:\Users\username\Downloads\install-multitenant-meshlet-service
Then, install the meshlet as a service that you want to run on this machine by entering the following commands:
install-meshlet-service.bat -m Application/Version/Meshlet_Jar.jar -c Application/Depot.zip -e Environment_Name
where Application/Version/Meshlet_Jar.jar and Application/Depot.zip correspond to the name of the meshlet and its configuration to be installed. Optionally you can add the -e argument at the end to specify an environment for this meshlet. This Environment_Name value is a way to label what type of meshlet this is (i.e. it's a production, test, dev meshlet) for informational purposes only and is used to create the folder structure where the meshlet is installed.
Contact Perspectium Support for the proper links for the meshlet and configuration to be installed.
Installing Ivanti User Meshlet as a service example:
install-meshlet-service.bat -m Ivanti/Gold_5.0.12-111111111/perspectium-meshlet-ivanti-user-5.0.12.jar -c Ivanti/Ivanti-User.zip -e Production
Installing Ivanti Incident Meshlet as a service example:
install-meshlet-service.bat -m Ivanti/Gold_5.0.12-111111111/perspectium-meshlet-ivanti-incident-5.0.12.jar -c Ivanti/Ivanti-Incident.zip -e Production
NOTE: The meshlet will be installed in the C:\Perspectium-<Configuration>-<Environment_Name> directory where <Configuration> is the name of the configuration file specified without the file extension and <Environment_Name> is the name of the environment. Using the above Ivanti User meshlet example, the meshlet would be installed in C:\Perspectium-Ivanti-User-Production\ (<Configuration> of Ivanti-User.zip and <Environment_Name> of Production). If no <Environment_Name> is specified, then it will be installed in C:\Perspectium-<Configuration> i.e. C:\Perspectium-Ivanti-User.
Run the meshlet as a service
Go to Windows Services and start the service for the meshlet (e.g. Perspectium Ivanti Incident Meshlet service).
Uninstalling a Multitenant Meshlet service for Windows
To uninstall the previously installed service for a meshlet, follow these steps:
Access the meshlet folder
Open up a Command Prompt and run as an Administrator. For example, type cmd in the Windows search window and right-click on Command Prompt and select Run as administrator.
In the Command Prompt, change your directory (cd) to the location of the meshlet application folder. By default the meshlet is installed in the C:\<meshlet_name>\src\main\resources when installed using the above steps. For example, if the meshlet is installed in C:\perspectium-Ivanti-Incident\src\main\resources:
cd C:\perspectium-Ivanti-Incident\src\main\resources
Uninstall the meshlet
Run the following command:
uninstall-meshlet-service.bat
This will uninstall the service for the meshlet.
NOTE: The meshlet remains installed on the machine if you want to run the meshlet manually in the foreground.
Installing a Multitenant Meshlet as a service for Linux
To install the meshlet as a service in your Linux machine, follow these steps:
Copy installation script
In each meshlet directories, copy install-multitenant-meshlet-service at the same level as the meshlet jar file.
Install the meshlet
Issue the following command in your terminal:
sudo ./install-meshlet-service <replace_with_jar_name> <meshlet_service_name>
Replace <replace_with_jar_name> with the jar name, e.g. perspectium-meshlet-jira-change-5.0.10.jar See the following:
sudo ./install-meshlet-service perspectium-meshlet-jira-change-5.0.10.jar jira-change-prod
NOTE: The meshlet service name will be appended by psp-meshlet-, i.e., psp-meshlet-<meshlet name>.
Run the meshlet
Issue the following command in your terminal:
sudo /etc/init.d/psp-meshlet-jira-change-prod start
To stop the meshlet service, you can use the following command in your terminal:
sudo /etc/init.d/psp-meshlet-jira-change-prod stop
To get the status of the meshlet service, you can use the following command in your terminal:
sudo /etc/init.d/psp-meshlet-jira-change-prod status
To restart the meshlet service, you can use the following command in your terminal:
sudo /etc/init.d/psp-meshlet-jira-change-prod restart
