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.
For any issues regarding JStack, contact Perspectium Support.
Prerequisites
First, contact Perspectium Support to get the install-multitenant-meshlet-service zip installation file.
Installing Multitenant Meshlet as a service
To install the meshlet as a service in your Windows or Linux machine, follow these steps:
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.
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 to the location where the install-multitenant-meshlet-service zip was extracted to.
For example C:\Users\username\Downloads\install-multitenant-meshlet-service.
cd ..\..\Users\username\Downloads\install-multitenant-meshlet-service
Install the meshlet as a service that you want to run on this machine by entering the following commands:
install-multitenant-meshlet-service.bat -m application/version/meshlet.jar -c application/meshlet.zip -e environment_name
Replace the following path with:
Field | Description | Example |
---|---|---|
application/version/meshlet.jar | Meshlet jar location | Ivanti/Gold_5.0.12/perspectium-meshlet-ivanti-user-5.0.12.jar |
application/meshlet.zip | Meshlet zip folder location | Ivanti/Ivanti-User.zip |
environment_name | (Optional) Specifies an environment for the meshlet This is a way to label what type of meshlet it 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. | Production |
Contact Perspectium Support for the proper links for the meshlet and configuration to be installed.
Installing Ivanti User Meshlet as a service example:
install-multitenant-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
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.
Go to Windows Services and start the service for the meshlet (e.g. Perspectium Ivanti User Meshlet service).
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.
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.
Then, install the meshlet by issuing the following command in your terminal:
install-multitenant-meshlet-service -m meshlet_jar_name.jar -n meshlet_service_name
Replace the following path with:
Field | Description | Example |
---|---|---|
meshlet_jar_name.jar | Meshlet jar name | perspectium-meshlet-jira-change-5.0.10.jar |
meshlet_service_name | Meshlet service name NOTE: This is a way to label what type of meshlet it 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. | jira-change-prod |
Installing Jira Change Meshlet as a service example:
install-multitenant-meshlet-service -m perspectium-meshlet-jira-change-5.0.10.jar -n jira-change-prod
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.
Go to Windows Services and start the service for the meshlet (e.g. Perspectium Ivanti User Meshlet service).
In each meshlet directories, copy install-multitenant-meshlet-service at the same level as the meshlet jar file.
Issue the following command in your terminal to make install-multitenant-meshlet-service executable:
chmod +x install-multitenant-meshlet-service
NOTE: The meshlet service file should be on the same level as the jar file.
Install the meshlet as a service that you want to run on this machine by entering the following commands:
sudo ./install-multitenant-meshlet-service.bat -m application/version/meshlet.jar -c application/meshlet.zip -n meshlet-service-name
Replace the following path with:
Field | Description | Example |
---|---|---|
application/version/meshlet.jar | Meshlet jar location | Ivanti/Gold_5.0.12/perspectium-meshlet-ivanti-user-5.0.12.jar |
application/meshlet.zip | Meshlet zip folder location | Ivanti/Ivanti-User.zip |
meshlet-service-name | Specifies the name of the meshlet service This is a way to label what type of meshlet it 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. | Ivainti-User-Prod |
Contact Perspectium Support for the proper links for the meshlet and configuration to be installed.
Installing Ivanti User Meshlet as a service example:
install-multitenant-meshlet-service.bat -m Ivanti/Gold_5.0.12-111111111/perspectium-meshlet-ivanti-user-5.0.12.jar -c Ivanti/Ivanti-User.zip -n Ivanti-User-Prod
NOTE: The meshlet service name will be appended by psp-meshlet-, i.e., psp-meshlet-<meshlet_service_name>.
After installation, you can now run the meshlet by issuing 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
In each meshlet directories, copy install-multitenant-meshlet-service at the same level as the meshlet jar file.
Issue the following command in your terminal to make install-multitenant-meshlet-service executable:
chmod +x install-multitenant-meshlet-service
NOTE: The meshlet service file should be on the same level as the jar file.
Then, install the meshlet by issuing the following command in your terminal:
sudo ./install-multitenant-meshlet-service -m meshlet_jar_name.jar -n meshlet_service_name
Replace the following path with:
Field | Description | Example |
---|---|---|
meshlet_jar_name.jar | Meshlet jar name | perspectium-meshlet-jira-change-5.0.10.jar |
meshlet_service_name | Meshlet service name NOTE: This is a way to label what type of meshlet it 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. | jira-change-prod |
Installing Jira Change Meshlet as a service example:
sudo ./install-multitenant-meshlet-service -m perspectium-meshlet-jira-change-5.0.10.jar -n jira-change-prod
NOTE: The meshlet service name will be appended by psp-meshlet-, i.e., psp-meshlet-<meshlet_service_name>.
After installation, you can now run the meshlet by issuing 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
Uninstalling Multitenant Meshlet as a service
To uninstall the previously installed service for a meshlet, follow these steps:
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
Then, uninstall the meshlet by running the following command:
uninstall-meshlet-service.bat
NOTE: The meshlet remains installed on the machine if you want to run the meshlet manually in the foreground.