Jprofiler License Key Guide

<Header>.<Payload>.<Signature> | Component | Description | |-----------|-------------| | | JSON metadata (algorithm, version). Example: "alg":"RS256","typ":"JPROF" | | Payload | Encrypted JSON object containing: • type – “node”, “floating”, “enterprise”, or “trial”. • exp – UNIX timestamp of expiration. • issued – Issue date. • host – For node‑locked: MAC address / Windows SID. • maxClients – For floating: max concurrent sessions. • features – Enabled modules (CPU, memory, database, etc.). | | Signature | RSA‑2048 signature generated by ej‑technologies’ private key, ensuring tamper‑proofness. |

auth: type: ldap url: ldap://ad.example.com baseDn: dc=example,dc=com bindDn: cn=serviceaccount,ou=users,dc=example,dc=com bindPassword: $LDAP_BIND_PASSWORD | Phase | Recommended Action | |-------|---------------------| | Provisioning | Store the key in a read‑only directory with restricted OS permissions (e.g., chmod 440 ). Use a secrets‑management tool (Vault, Azure Key Vault) for automated CI pipelines. | | Distribution | For node‑locked keys, use a configuration‑management tool (Ansible, Chef) to push the file. For floating, keep the server binary under version control and deploy via container orchestration (Docker/K8s). | | Renewal | Set calendar reminders 30 days before exp timestamp. The portal provides a “Renew” button that issues a new key with an extended expiry while preserving the same host binding. | | Revocation | If a workstation is decommissioned, re‑issue a new node‑locked key (excluding the retired host). For floating servers, simply remove the host from the allowed IP list in config.yml . | | Auditing | Enable JProfiler’s license‑usage logs ( jprofiler.log ) and forward them to a SIEM. Logs contain entries such as License granted to host <MAC> , Floating license checked out by user X . | 7. Common Issues & Troubleshooting | Symptom | Likely Cause | Fix | |---------|--------------|-----| | “Invalid license key” dialog at startup | Corrupted .lic file (line‑breaks, whitespace) | Re‑download from portal; ensure file is stored exactly as received. | | “License expired on …” | Expiration date reached (check exp field with a Base64 decoder) | Renew license via portal; replace the key. | | “Host mismatch” (node‑locked) | The key was generated for a different MAC/Windows SID | Regenerate the key for the current host; verify host identifier using jprofiler --show-host-id . | | “Maximum number of concurrent users reached” (floating) | All floating slots are occupied | Increase maxClients in the server configuration or free a slot (stop a profiler session). | | “Cannot connect to license server” | Network/firewall block on port (default 8849) | Open the port; configure proxy settings in jprofiler.properties . | | “License server not running” | Server process stopped or crashed | Check server logs ( license-server.log ), restart the JVM, ensure sufficient heap ( -Xmx256m ). | | “License key not found” on CI agents | Environment variable not propagated in container | Add -e JPROFILER_LICENSE_KEY=/path/to/jprofiler.lic to Docker run command or mount the file as a volume. | jprofiler license key