Prerequisites
This section describes the prerequisite/procedures you must perform for the deployment of SureMDM OnPremise.
Hardware Requirements
Based on the number of devices you plan to use in your deployment, 42Gears Tech Support will be able to provide the hardware specifications for SureMDM OnPremise. You can reach out to 42Gears TechSupport at techsupport@42gears.com
- The customer will be responsible for handling the maintenance and support of prerequisite components.
- SureMDM OnPremise can be installed on a modern Linux Server. We recommend Ubuntu Server 22.04 LTS.
- Application (nodes) and Database servers should be able to connect with other servers through the private IP.
- For optimal performance, we recommend using SSDs in On-Premise deployments.
Software Requirements
Ensure SureMDM OnPremise is supplied with all the following software requirements:
| Requirement | Description |
|---|---|
| SQL Server | SQL DB Server 2019 or SQL Server 2022 should be installed on the Windows Server. This SQL DB server instance should be reachable from the SureMDM server. |
| MongoDB | MongoDB version 7.0.x should be installed on the Windows server. This MongoDB should be reachable from the SureMDM server . Click here to find out more about the MongoDB configuration process. |
| Storage | Note: You can use either MinIO or Amazon S3 as a third-party storage solution for the configuration. Third-party software mentioned in this guide is not bundled with or maintained by 42Gears. Such software is subject to its respective license terms, and users are solely responsible for reviewing and complying with those terms. 42Gears disclaims all liability arising from the use of such software. MinIO: The latest version of the MinIO server must be installed on the SureMDM machine for data storage. During MinIO setup, the system administrator must use the same DNS and SSL configurations as those used for the SureMDM On-Premise deployment. Amazon S3 Storage: The system administrator must configure two S3 buckets: one for storing jobs and reports, and the other for storing icons. Note: The customer is responsible for purchasing the required AWS storage. The SureMDM App Icon Bucket must have public access enabled to allow users to download icons. |
| Kubernetes distribution (K3s) | Lightweight Kubernetes distribution (K3s) is used for managing containerized applications across a cluster of machines. |
General Requirements
Ensure SureMDM OnPremise is supplied with all the following general requirements to ensure a successful installation:
a. System admin will be provided with SureMDM OnPremise Installer package and offline images by 42Gears Support. These files should be extracted in the SureMDM Server used for deployment.
b. System Admin should have SUDO access to complete the deployment.
| Requirement | Description |
|---|---|
| DNS | Keep an unmapped DNS available for the SureMDM setup. The DNS should be mapped to the Public/Private IP of the SureMDM server. Note: Once the deployment is done, run the following command to obtain the IP address to which DNS should be mapped: sudo kubectl get ingress -n suremdm |
| Certificates | After extracting the installer package, place the following certificates in the respective folders based on the deployment. SSL Certificates - Customers should have an SSL certificate in the certificate and key format. Customers can use the same certificate to set up both SureMDM and MinIO application. The files (full chain certificate and key) should be placed under k8sopinstaller\appdata\certs for SureMDM setup. Android Enterprise Setup - The MSA/ESA certificates should be placed under k8sopinstaller\appdata\api\App_Data and k8sopinstaller/appdata/pluto directory. iOS Device Setup - The push certificates with the file names DefaultPushCertificate.p12 (APNs) and NixProductionPush.p12 should be placed under k8sopinstaller\appdata\pluto\iOS and /appdata/pluto/iOS. For details on generating an Apple Push Certificate, click here. Note: System admin must use the same file names as provided above. macOS Device Setup - The push certificate with the file name NixProductionPush.p12 should be placed under k8sopinstaller\appdata\pluto\macOS. Note: System admin must use the same file name as provided above. Device Management by Android Management - The credentials file should be named cred.json and placed under k8sopinstaller\appdata\api\App_Data. Note: Please contact the 42Gears technical support team at techsupport@42gears.com for the above-specified certificates (NixProductionPush.P12, MSA, ESA, and cred.json). |
| FCM keys | If System admin wish to configure FCM, FCM Project ID, Server API Key, Application ID, and Sender ID are required. Click here to learn how to generate FCM Key. Place the FCM credential file with the .json extension in the appdata/pluto directory for Android. Click here to learn how to download .json file.If the System admin does not want to configure FCM, normal polling will be used as a fallback. Note: FCM Key should be purchased by the customer and FCM V1 should be enabled for FCM project. |
| Window push notification | If the system admin wishes to configure the Windows push notification service, WNS values are required. Click here to learn how to get the WNS values. Note: WNS Key should be purchased by the customer. |
| Email server | If the system admin wishes to configure an email server, the Server Username, Password, and MailServerBackup are required. We support email servers that use the SMTP protocol. Click here for the steps. |
| Google API key for Location | If the system admin wishes to use Google Maps for location tracking, a Google API key is required. Otherwise, the system admin can use the default OpenStreet maps available in SureMDM. Note : Google API Key should be purchased by the customer. |
| SureMDM Hub configuration | This is only applicable for SureMDM Hub deployment. A separate license key is required for SureMDM Hub configuration. Please contact 42Gears Support for more information. |
Network Requirements
Other than this, SureMDM OnPremise deployment requires Internet access, and few ports should be allowed internally. Click here for more details.