Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
mypower24:plantcontrol:troubleshooting [2025/03/12 10:54] – adminmypower24:plantcontrol:troubleshooting [2025/03/20 10:01] (current) – [Unable to change device parameters] admin
Line 1: Line 1:
-===== Troubleshooting Common Issues =====+====== Troubleshooting Guide ====== 
 + This guide offers solutions to common issues, categorized for quick navigation. Use the  
 + examples provided to resolve your problems efficiently. 
 +  
 +===== Setting device parameters =====
  
-This page helps you troubleshoot common problems encountered in DokuWiki. If you're experiencing any issue not covered here, check the DokuWiki support forum or community for more help.+==== Unable to change device parameters ==== 
 +  * **Possible Causes:** 
 +    - Device serial number contains invalid characters. 
 +  * **Solutions:** 
 +    - The device needs to be removed from plant control, then removed from the logger's interfaces in "My Devices" => "Logger myPower" => "Intefaces". Once it has been removed from the interface, go to the "Installed Devices" tab and remove the offline device from there. Reboot the logger add the device to the interface again. 
 +    - If prompted for a serial number type only **valid characters[a-z A-Z 0-9 _ -]. No white spaces allowed.**  
 +    - Click scan.
  
----- 
  
-==== 1. DokuWiki Page is Not Loading ==== 
  
-  *''Issue:''*   
-    The page might not load, showing a blank screen or server error. 
- 
-  *''Possible Causes:''* 
-    - Server misconfiguration. 
-    - Corrupted DokuWiki files. 
-    - Permissions issue. 
- 
-  *''Solutions:''* 
-    - *Check Server Logs:*   
-      Examine the web server logs (e.g., Apache or Nginx) to see if there are any errors. Check for permissions issues or missing files. 
-    - *Permissions Check:*   
-      Ensure the correct file and folder permissions are set, particularly the ''data/'' , ''conf/'' , and ''lib/'' folders. Permissions should be set to ''755'' for directories and ''644'' for files. 
-       
-      Example command to set the correct permissions: 
-      <code>chmod -R 755 data/ conf/ lib/</code> 
-      <code>chmod -R 644 data/pages/* data/media/*</code> 
-       
-    - *Reinstall DokuWiki Files:*   
-      If a file has become corrupted, consider re-uploading or reinstalling DokuWiki files. 
- 
----- 
- 
-==== 2. DokuWiki Error: "403 Forbidden" ==== 
- 
-  *''Issue:''*   
-    When trying to access the page, you encounter a ''403 Forbidden'' error. 
- 
-  *''Possible Causes:''* 
-    - Incorrect file or directory permissions. 
-    - Incorrect ''`.htaccess`'' or server configuration. 
-    - Restrictive user roles or access permissions within DokuWiki. 
- 
-  *''Solutions:''* 
-    - *Check .htaccess File:*   
-      Ensure there are no restrictions preventing access in the ''`.htaccess`'' file. If unsure, try renaming it temporarily to see if access is restored. 
-       
-    - *File Permissions:*   
-      Ensure that the DokuWiki folders have correct permissions (refer to the solution in Section 1). 
- 
-    - *Review DokuWiki Access Control List (ACL):*   
-      Review the ''acl.txt'' file in the ''conf/'' directory and ensure that the permissions are set correctly for the users or groups attempting to access the page. 
- 
-      Example ACL rule to allow public access: 
-      <code>*   @ALL   1</code> 
- 
----- 
- 
-==== 3. DokuWiki Media Upload Not Working ==== 
- 
-  *''Issue:''*   
-    You can't upload media files to your DokuWiki site, or you get an error message when uploading. 
- 
-  *''Possible Causes:''* 
-    - Incorrect file permissions. 
-    - File size limit restrictions. 
-    - File type not allowed. 
- 
-  *''Solutions:''* 
-    - *File Permissions:*   
-      Check that the ''data/media/'' folder has write permissions. 
-       
-      Example command to ensure the correct permissions: 
-      <code>chmod -R 755 data/media/</code> 
- 
-    - *File Size Limit:*   
-      Check the PHP configuration (''php.ini'') for upload limits. Look for the following directives and adjust them if necessary: 
-      <code>upload_max_filesize = 10M</code> 
-      <code>post_max_size = 10M</code> 
- 
-    - *Allowed File Types:*   
-      DokuWiki may block certain file types for security reasons. Check the file types in ''conf/mime.conf'' and ensure the file type you're trying to upload is permitted. 
- 
----- 
- 
-==== 4. DokuWiki Search Not Working ==== 
- 
-  *''Issue:''*   
-    Search functionality is returning no results or not working properly. 
- 
-  *''Possible Causes:''* 
-    - Corrupted search index. 
-    - Missing files or outdated cache. 
- 
-  *''Solutions:''* 
-    - *Rebuild Search Index:*   
-      You can rebuild the search index from the DokuWiki Admin page by navigating to ''Admin > Indexing'' and selecting ''Rebuild Search Index.''   
-    - *Clear Cache:*   
-      If the search results seem outdated, try clearing the cache. Delete the contents of the ''data/cache/'' directory, but not the directory itself. 
-       
-      Example command to clear the cache: 
-      <code>rm -rf data/cache/*</code> 
- 
----- 
- 
-==== 5. DokuWiki Plugin Not Working ==== 
- 
-  *''Issue:''*   
-    A plugin installed in DokuWiki is not working as expected. 
- 
-  *''Possible Causes:''* 
-    - Plugin not activated. 
-    - Plugin is incompatible with your DokuWiki version. 
-    - Incorrect installation or missing files. 
- 
-  *''Solutions:''* 
-    - *Check Plugin Compatibility:*   
-      Ensure the plugin is compatible with your version of DokuWiki. Visit the plugin’s page on the DokuWiki plugin repository for version compatibility information. 
-       
-    - *Activate Plugin:*   
-      Go to the ''Admin > Extension Manager'' page and make sure the plugin is activated. 
- 
-    - *Reinstall Plugin:*   
-      If the plugin is still not working, try reinstalling it by deleting the plugin folder and uploading it again from the plugin repository. 
- 
----- 
- 
-==== 6. DokuWiki Admin Panel Not Accessible ==== 
- 
-  *''Issue:''*   
-    You cannot access the Admin panel of DokuWiki, or you see an error when trying to open it. 
- 
-  *''Possible Causes:''* 
-    - Incorrect permissions for the ''conf/'' or ''data/'' directories. 
-    - Corrupted session files. 
-    - Admin user permissions. 
- 
-  *''Solutions:''* 
-    - *Clear Session Files:*   
-      Delete old session files located in the ''data/cache/sessions/'' directory. Example command: 
-      <code>rm -rf data/cache/sessions/*</code> 
- 
-    - *Check User Permissions:*   
-      Ensure the admin user has the correct ACL permissions in the ''acl.txt'' file. Example entry for an admin user: 
-      <code>user:admin    @ALL   8</code> 
- 
-    - *File Permissions:*   
-      Double-check that the DokuWiki installation files have proper permissions (similar to the solution provided in Section 1). 
- 
----- 
- 
-==== 7. DokuWiki Theme Issues ==== 
- 
-  *''Issue:''*   
-    The DokuWiki theme is not displaying correctly, or you see broken styles on the page. 
- 
-  *''Possible Causes:''* 
-    - CSS or theme files are missing or corrupted. 
-    - Theme incompatibility with the DokuWiki version. 
- 
-  *''Solutions:''* 
-    - *Check Theme Files:*   
-      Ensure the theme files are present in the ''lib/tpl/'' directory