Resolving Issues with Installing and Running PrizmDoc on Windows 11

Overview

When installing or starting PrizmDoc on Windows 11, you may encounter issues such as Prizm failing to start or errors during installation. These problems often arise due to changes in Windows 11, such as the absence of certain default utilities like WMIC (Windows Management Instrumentation Command-line), which PrizmDoc relies on for some functionalities.

Here are steps to resolve these issues related to the WMIC utility and general recommendations to ensure a smooth installation and operation of PrizmDoc on Windows 11.

Issues and Symptoms

1. Service Startup Failures:
   PrizmDoc services, such as the watchdog, fail to start. Logs in C:\Prizm\Logs may show errors like:

   {"name":"LAUNCHER","hostname":"DESKTOP-XXXXXX","pid":12345,"taskid":3,"gid":"abcdef12345","level":60,"err":{"message":"spawn wmic ENOENT","name":"Error","stack":"Error: spawn wmic ENOENT\n at Process.ChildProcess._handle.onexit (node:internal/child_process:285:19)\n at onErrorNT (node:internal/child_process:485:16)\n at processTicksAndRejections (node:internal/process/task_queues:83:21)","code":"ENOENT"},"msg":"Unexpected failure","time":"2024-11-13T06:25:34.761Z","v":0}

2. Missing WMIC:
   Running wmic in the Command Prompt results in an error indicating the command is not recognized, as WMIC is no longer included by default in Windows 11 version 24H2 (Reference).

3. Verifying Logs:

   Logs are essential for diagnosing issues with PrizmDoc. You can find the logs in C:\Prizm\logs. In particular: 

• watchdog.launcher.log: For service startup and dependency errors.

Resolving Issue

1. Open Settings on your Windows 11 system.

2. Navigate to System > Optional Features.

3. Scroll down and check whether WMIC appears in the installed features list.

   • If it is not listed, click Add a feature.
   • Search for WMIC and select it.
   • Click Install (an internet connection is required).

4. Restart your system if prompted.

5. Confirm the installation by running wmic in the Command Prompt. The WMIC prompt should appear.

6. Verify the PATH environment variable includes the directory: C:\Windows\System32\Wbem

7. To update the PATH:

   • Right-click This PC > Properties > Advanced system settings.
   • Under System Properties, click Environment Variables.
   • Locate the PATH variable and add the directory above if it is missing. Ensure that the PATH has been updated system-wide and not just for the current user. 

General Recommendations for Installation and Operation

1. Run the Installer as Administrator: Always run the PrizmDoc installer with administrative privileges to avoid permission-related issues.

2. Check Dependencies Before Installation: Ensure all required Windows components, such as .NET Framework and WMIC, are enabled.

3. Configure Firewall and Antivirus Settings: Allow PrizmDoc processes and open necessary ports.

4. After installation, verify that all services are running and review logs in C:\Prizm\Logs for errors.

Additional Assistance

If you encounter issues after following these steps:

1. Verify that the logs in C:\Prizm\Logs correspond to the instance experiencing the issue.
2. Contact support with detailed information, including relevant logs and error messages.

Feedback

If this article was helpful or if you have suggestions for improvement, please let us know!