Meshlet requires that you have the following specifications laid out on this page.
System
System Requirements | |
---|---|
Memory | 8GB+ |
Processor Cores | 4+ |
Hard Disk Space | 100GB minimum |
Network Interface | GigE |
The above system requirements are based on running one meshlet on one system (virtual machine). It is recommended that you only run one meshlet per system due to the CPU and memory usage by the meshlet and Java. However if you are running multiple meshlets on one machine, you will need a minimum of 4GB of memory per meshlet. For example, if running 4 meshlets, the system will need at least 16GB of memory.
If deploying in an AWS environment, we recommend using a M5.xlarge EC2 general purpose instance with general purpose SSD (gp2) EBS volume type. Perspectium has tested using the M5.xlarge instance type though any system meeting the system requirements should be able to run the application.
For other cloud platforms, it is recommended to use the equivalent services to the aforementioned AWS services:
AWS | Microsoft Azure | |
---|---|---|
Virtual Machine | m5.xlarge | Standard_D4_v3 (Dv3 and Dsv3-series) or Standard_D4_v4 (Dv4 and Dsv4-series) |
Storage | general purpose SSD (gp2) | Standard SSD Managed Disks |
Network
Meshlet requires outbound access to the Perspectium Integration Mesh and its MBS cloud service as well as your ServiceNow instance.
Your firewall settings will need to allow this outbound traffic in order for the meshlet to connect to our cloud service and your ServiceNow instance to properly read data. Check with your IT administrator to verify that firewall settings allow application and protocol access for the meshlet to connect to the Mesh as indicated below.
The following protocols and ports are used by the meshlet:
Network Requirements | |
---|---|
AMQPS Protocol on Outbound Port | TCP/5671 outbound to your Perspectium MBS (amqps://example.perspectium.net) |
or | |
AMQP Protocol on Outbound Port | TCP/5672 outbound to your Perspectium MBS (amqp://example.perspectium.net) |
HTTPS Protocol on Outbound Port | TCP/443 outbound to your ServiceNow instance (https://example.service-now.com) |
Java
Java is required to be installed to run a meshlet. Newer versions may also be able to run the meshlet but have not been tested or verified. We typically provide support for the latest version of Java with a major release after the Java version's general release date and when we have completed testing to ensure compatibility.
Perspectium Version | Java 7 & earlier | Java 8 | Java 9 | Java 10 | Java 11 | Java 12 | Java 13 | Java 14 | Java 15 | Java 16 | Java 17 | Java 18 | Java 19 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Helium | |||||||||||||
Iodine | ^ | ^ |
Starting with the Iodine 7.0.0 release, Meshlets will run with at minimum Java 11.
^Only supported with Iodine 7.0.1 and newer.
Supported Operating Systems
The following operating systems are supported by meshlets:
OS | Version |
---|---|
Windows | Professional/Home 7+ |
Server 2012+ | |
Linux* | Red Hat 6+ |
Ubuntu 14.04+ | |
CentOS 6+ |
*Linux requires superuser access (sudo) to install the meshlet and run it as a service.
The versions of Linux specified above have been tested to work with meshlets. Other versions with equivalent Linux kernel and meeting the other requirements above (System, Java, etc.) may also be able to run meshlets. Please contact Perspectium Support for more information.
ServiceNow
DataSync meshlets requires a ServiceNow user in order to access the ServiceNow table schemas you share. This user you specify must be a local user in the ServiceNow instance (i.e. it cannot be a SSO user) that is given at minimum the perspectium role and has permissions to invoke a processor. In the event that the processor cannot be accessed when the meshlet runs, a call to the PSPSchema rest API will be made instead to get the ServiceNow table schema.
You do not need to upgrade the meshlet at the same time as you upgrade the ServiceNow application as the core functionality of syncing data will work. New features however may require both to be upgraded to function properly. Perspectium tests n-2 compatibility with each release e.g. the previous two major releases of the meshlet prior to this release has been tested with the latest version of the ServiceNow application.
Database User Permissions
For DataSync meshlets that integrate with a database, the following are the required permissions that the meshlet must have.
NOTE: The database (and schema if relevant) must be created in advance as the meshlet will not create a database.
It is recommended that the meshlet be the only one writing data to this database to avoid conflicts with the meshlet accessing tables it did not create and/or do not match the schema definitions as the source (such as ServiceNow).
Permission | Description |
---|---|
Create tables within defined databases | Once replicated data is available, the meshlet will determine if the table associated with the replicated data exists, and if not, create it. This means that the configured user must have the permissions required to create tables within the defined database. |
Query database and associated tables and update data in existing tables | When you share out data to be consumed by the meshlet, you'll typically specify whether the data is being shared in bulk or dynamically. When the data is shared in bulk, the meshlet will typically perform a query in order to determine if the row already exists in the database. The meshlet must therefore have permission to query the database and the associated tables. If the meshlet determines that the row already exist then it performs an update, otherwise it will insert the row. The meshlet must have permission to perform both these actions. |
Insert data into tables | Once the required table has been created the meshlet will perform an insert in order to populate the table with the replicated row. This means that the meshlet must have the permissions to perform an insert into the table. |
Alter table | The meshlet wants to ensure that all data is replicated. It's possible that the structure of the source table has changed. For example, an additional column has been added to the table. The meshlet performs the analysis required to make this determination and by default will alter the table in order to add this column so it aligns with the source table in ServiceNow. Currently, Perspectium supports adding a column. The agent must therefore have the permissions to alter the table. |
Delete table row | In order to support the deletion of rows from a table, the database user must also have permission to delete a table row. |
For database-specific permissions, see their respective pages such as Snowflake.