Difference between revisions of "EXtplorer on OpenWRT"

1,352 bytes added ,  17:16, 12 July 2021
m
no edit summary
(Created page with "eXtplorer is a web based file explorer available through a web browser. See https://extplorer.net/ for additional information The author of the software spells it CamelCase...")
 
m
Line 3: Line 3:
The author of the software spells it CamelCase as eXtplorer.  However MediaWiki does not allow article titles to begin with a lower case letter, hence the name of this being titled EXtplorer instead of eXtplorer.
The author of the software spells it CamelCase as eXtplorer.  However MediaWiki does not allow article titles to begin with a lower case letter, hence the name of this being titled EXtplorer instead of eXtplorer.


=== Wonky ===
===Wonky===
Best to get this out of the way first, so readers don't get frustrated when using it: The software works, but there is some 'wonky' behavior in some web browsers (Chrome and Edge (which is based on Chrome)
Best to get this out of the way first, so readers don't get frustrated when using it: The software works, but there is some 'wonky' behavior in some web browsers (Chrome and Edge (which is based on Chrome)


Line 14: Line 14:
Adding Users: This is a similar issue to Logging Out above (IE, double click the button)
Adding Users: This is a similar issue to Logging Out above (IE, double click the button)


=== Installation ===
===Installation===


* Download the installation file from the eXtplorer website ( https://extplorer.net/projects/extplorer/files )
*Download the installation file from the eXtplorer website ( https://extplorer.net/projects/extplorer/files )
* Copy the files to a Directory and configure Apache per how the environment for Apache is set up (the details of Apache are not covered here, safe to say, all one has to do is configure a sub-directory in a working Apache Directory at a minimum)
*Copy the files to a Directory and configure Apache per how the environment for Apache is set up (the details of Apache are not covered here, safe to say, all one has to do is configure a sub-directory in a working Apache Directory at a minimum)
* Configure Ownership, Directory, and File Permissions (the assumption is that the Apache User and Group are apache and apache and that one is in the root directory for Apache when issuing the below commands);
*Open and Extract the contents of the scripts.tar.gz file (a directory named 'scripts') to the eXtplorer Directory (eXtplorer will attempt to extract this file, but the PEAR implementation on OpenWRT seems to prevent this from occurring, so do it manually)
** Ownership: chown -R apache:apache WhatEverEXtplorerDirectoryName
*Configure Ownership, Directory, and File Permissions (the assumption is that the Apache User and Group are apache and apache and that one is in the root directory for Apache when issuing the below commands);
** All Directories: find WhatEverEXtplorerDirectoryName -type d -exec chmod 755 {} \;
**Ownership: chown -R apache:apache WhatEverEXtplorerDirectoryName
** All Files: find WhatEverEXtplorerDirectoryName -type f -exec chmod 644 {} \;
**All Directories: find WhatEverEXtplorerDirectoryName -type d -exec chmod 755 {} \;
** Specific Directory and File Permissions;
**All Files: find WhatEverEXtplorerDirectoryName -type f -exec chmod 644 {} \;
*** ftp_tmp Directory: chmod 777 PathToEXtplorer/ftp_tmp
**Specific Directory and File Permissions;
*** "User Password File":  
***ftp_tmp Directory: chmod 777 PathToEXtplorer/ftp_tmp (if this is
***"User Password File": chmod 777 PathToEXtplorer/config/.htusers.php (if this isn't done then attempting to change passwords in the eXtplorer GUI will result in an error)


<br />
=== Use it ===
Navigate to the directory that eXtplorer is installed in.  eXtplorer should work at this point.  If not, double check the above steps.


=== Thoughts ===
The default user name / password is: admin / admin
 
=== Some Solutions to issues ===
To change the password manually;
 
* Use this command to generate an encrypted version of the password: echo -n "WhatEverPassword" | md5sum (include / use the double quotes in the command, which aren't part of the password)
* Copy the generated password without the trailing dash / hyphen ( - )
* Full credit to https://theinspired.dev/blog/how-to-reset-extplorer-admin-password/ for the above items.
* Paste the generated password into this file: PathToEXtplorer/config/.htusers.php (the position to paste it in is in between the single quotes following a user name)
 
===Thoughts===
The documentation on the eXtplorer website is sparse, but is enough to get it working.
The documentation on the eXtplorer website is sparse, but is enough to get it working.
While Chrome, Edge, and Firefox have minor issues with eXtplorer, Internet Explorer seems to work with fewer of the above mentioned issues.  Go figure...