Versions Compared

Old Version 20

changes.mady.by.user user-1bc08

Saved on

compared with

New Version 21

changes.mady.by.user user-1bc08

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

While it is recommended that one Perspectium Meshlet run per machine, multiple meshlets can be installed as services on the same machine for multitenancy.

(info) 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  

(warning) 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: 


UI Expand
titleWindows Install


Divbox
stylebackground:white;


Expand
titleClick here for an online installation...


UI Steps
sizesmall


UI Step

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. 


UI Step

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.


UI Step

In the CommandPrompt, 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.

Code Block
languagebash
cd ..\..\Users\username\Downloads\install-multitenant-meshlet-service



UI Step

Install the meshlet as a service that you want to run on this machine by entering the following commands:

Code Block
install-multitenant-meshlet-service.bat -m application/version/meshlet.jar -c application/meshlet.zip -e environment_name

Replace the following path with: 

FieldDescriptionExample
application/version/meshlet.jarMeshlet jar locationIvanti/Gold_5.0.12/perspectium-meshlet-ivanti-user-5.0.12.jar
application/meshlet.zipMeshlet 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

(warning) Contact Perspectium Support for the proper links for the meshlet and configuration to be installed. 



Installing Ivanti User Meshlet as a service example:

Code Block
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

(info) 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.


UI Step

Go to Windows Services and start the service for the meshlet (e.g. Perspectium Ivanti User Meshlet service).




Expand
titleClick here for an offline installation...


UI Steps
sizesmall


UI Step

In each meshlet directories, copy 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 at the same level as the meshlet jar file. 


UI Step

Issue the following command in your terminal to make install-multitenant-meshlet-service executable: 

Code Block
languagebash
chmod +x install-multitenant-meshlet-service
(info) NOTE: The meshlet service file should be on the same level as the jar file. 

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.


UI Step

Then, install the meshlet by issuing the following command in your terminal: 

Code Block
languagebash
sudo ./install-multitenant-meshlet-service -m meshlet_jar_name.jar -n meshlet_service_name

Replace the following path with: 

FieldDescriptionExample
meshlet_jar_name.jarMeshlet jar nameperspectium-meshlet-jira-change-5.0.10.jar
meshlet_service_name

Meshlet service name 

(info) 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:

Code Block
languagebash
sudo ./install-multitenant-meshlet-service -m perspectium-meshlet-jira-change-5.0.10.jar -n jira-change-prod

(info) NOTE: The  The meshlet service name will be appended by psp-meshlet-, i.e., psp-meshlet-<meshlet_service_name>.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.


sudo /etc/init.d/psp-meshlet-jira-change-prod restart

UI Step

Go to Windows Services and start the service for the meshlet (e.g. Perspectium Ivanti User Meshlet service).

UI Step

After installation, you can now run the meshlet by issuing the following command in your terminal: 

Code Block
languagebash
sudo /etc/init.d/psp-meshlet-jira-change-prod start

To stop the meshlet service, you can use the following command in your terminal:

Code Block
languagebash
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:

Code Block
languagebash
sudo /etc/init.d/psp-meshlet-jira-change-prod status

To restart the meshlet service, you can use the following command in your terminal:

Code Block
languagebash







UI Expand
titleLinux Install


Divbox
stylebackground:white;


Expand
titleClick here for an online installation...


UI Steps
sizesmall


UI Step

Open File Explorer and find the folder where In each meshlet directories, copy install-multitenant-meshlet-service is located, i.e. C:\Users\username\Downloads\. 

Then, right-click the folder and select Extract All. 

UI Step

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. at the same level as the meshlet jar file. 


UI Step

In the CommandPrompt, change your directory to the location where the Issue the following command in your terminal to make install-multitenant-meshlet-service zip was extracted to.For example C:\Users\username\Downloads\install-multitenant-meshlet-service.service executable: 

Code Block
languagebash
cd ..\..\Users\username\Downloads\chmod +x install-multitenant-meshlet-service

(info) NOTE: The meshlet service file should be on the same level as the jar file. 


UI Step

Install the meshlet as a service that you want to run on this machine by entering the following commands:

Code Block
sudo ./install-multitenant-meshlet-service.bat -m application/version/meshlet.jar -c application/meshlet.zip -e environment_name

Replace the following path with: 

FieldDescriptionExample
application/version/meshlet.jarMeshlet jar locationIvanti/Gold_5.0.12/perspectium-meshlet-ivanti-user-5.0.12.jar
application/meshlet.zipMeshlet 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

(warning) Contact Perspectium Support for the proper links for the meshlet and configuration to be installed. 



Installing Ivanti User Meshlet as a service example:

Code Block
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

(info) NOTE:  The 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.

service name will be appended by psp-meshlet-, i.e., psp-meshlet-<meshlet_service_name>.


UI Step

After installation, you can now run the meshlet by issuing the following command in your terminal: 

Code Block
languagebash
sudo /etc/init.d/psp-meshlet-jira-change-prod start

To stop the meshlet service, you can use the following command in your terminal:

Code Block
languagebash
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:

Code Block
languagebash
sudo /etc/init.d/psp-meshlet-jira-change-prod status

To restart the meshlet service, you can use the following command in your terminal:

Code Block
languagebash
sudo /etc/init.d/psp-meshlet-jira-change-prod restart
UI Step
Go to Windows Services and start the service for the meshlet (e.g. Perspectium Ivanti User Meshlet service).




 Expand
titleClick here for an offline installation...

 UI Steps
sizesmall

 UI Step
In each meshlet directories, copy install-multitenant-meshlet-service at the same level as the meshlet jar file. 

 UI Step
Issue the following command in your terminal to make install-multitenant-meshlet-service executable: 
 Code Block
languagebash
chmod +x install-multitenant-meshlet-service 
(info) NOTE: The meshlet service file should be on the same level as the jar file. 

 UI Step
Then, install the meshlet by issuing the following command in your terminal: 
 Code Block
languagebash
sudo ./install-multitenant-meshlet-service -m meshlet_jar_name.jar -n meshlet_service_name
Replace the following path with: 
FieldDescriptionExample
meshlet_jar_name.jarMeshlet jar nameperspectium-meshlet-jira-change-5.0.10.jar
meshlet_service_name
Meshlet service name 
(info) 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:
 Code Block
languagebash
sudo ./install-multitenant-meshlet-service -m perspectium-meshlet-jira-change-5.0.10.jar -n jira-change-prod
(info) NOTE: The meshlet service name will be appended by psp-meshlet-, i.e., psp-meshlet-<meshlet_service_name>.

 UI Step
After installation, you can now run the meshlet by issuing the following command in your terminal: 
 Code Block
languagebash
sudo /etc/init.d/psp-meshlet-jira-change-prod start
To stop the meshlet service, you can use the following command in your terminal:
 Code Block
languagebash
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:
 Code Block
languagebash
sudo /etc/init.d/psp-meshlet-jira-change-prod status
To restart the meshlet service, you can use the following command in your terminal:
 Code Block
languagebash
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: 

 UI Expand
titleWindows Uninstall

 Divbox
stylebackground:white;

 UI Steps
sizesmall

 UI Step
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:
 Code Block
languagebash
cd C:\perspectium-Ivanti-Incident\src\main\resources


 UI Step
Then, uninstall the meshlet by running the following command:
 Code Block
languagebash
uninstall-meshlet-service.bat
(info) NOTE: The meshlet remains installed on the machine if you want to run the meshlet manually in the foreground.