Webmin Control Panel (eApps) - Using the File Manager
Posted by Cinu Varghese on 24 September 2010 10:55 AM
Applicable Plans - eApps Cloud Hosting Plans (eApps templates only)
User Guide - Using the File Manager
The File Manager in the Control Panel allows you to edit, create, and manipulate files and directories on your system. All options that are available through the command line are also available through the File Manager.
To access the File Manager, you will need to log in to the Control Panel. See the User Guide - Using the Control Panel http://support.eapps.com/control_panel_eapps/control_panel for more information if necessary.
NOTE - the File Manager is a Java applet, meaning your browser must support Java for the File Manager to work. For various reasons, some versions of some browsers do not work with the File Manager. If this is the case, please try a different browser, or make sure your browser is on the latest update. This is not an eApps issue, but a browser/java issue. eApps has no way to resolve this problem.
Navigating the File Manager
To access the File Manager, click on the File Manager icon in the main System screen
Depending on your browser, it make take some seconds for the Java applet to display. If your browser locks up at this point, you will need to close it and try a different browser, or update your browser and possibly your version of Java.
File Manager main screen
The File Manager is divided into three sections - a button bar at the top for all the various functions, a left pane that shows the directory tree, and a right pane that shows the directories and files in the selected directory in the left pane. There is also a text area above the right pane where you can enter the absolute path name of a file to search for it.
To move around the File Manager, click on a directory in the left pane, and then use the right pane to navigate to any files and directories in that directory.
To exit the File Manager and return to the main System screen, click on the Index button
To change any of the configuration options for the File Manager module, click on the Config button
Please take a few minutes to become familiar with how to navigate the File Manager so that you will be able to find files and directories easily.
Manipulating Files and Directories (Copy, Paste, Cut, Delete, Rename)
The File Manager allows you to do standard file and directory manipulations, such as copy, paste, cut, delete and rename. All of these actions are available on the button bar.
Warning - by default, the File Manager is accessed with root user privileges. This means that you can easily overwrite and delete critical system files, rendering your system useless. Please be careful and make sure you know exactly what files you are working with, and the consequences of moving or deleting them.
Copy, Cut, and Paste
To copy a file or directory, click on the item you wish to copy in the right pane, and then click on the Copy button
You can copy multiple items by holding down the Control key, and selecting the items with the mouse. Then click on Copy to copy all those items.
To cut a file or directory, click on the item you wish to cut in the right pane, and then click on the Cut button
As with Copy, you can cut multiple items by holding down the Control key and selecting the items with the mouse, and then clicking on Cut to cut those items.
To paste a copied or cut item, navigate to where you want the item to be copied to, and click on Paste
If there are already files or directories with the same names as the items you are trying to paste, you will be given a chance to rename the file being pasted to avoid a conflict. If you choose not to rename the file, then the existing file will be overwritten by the file being pasted.
You can also paste the items into multiple locations by navigating to the new location, and then clicking on Paste again.
Delete and Rename
To delete a file or directory, click on that item in the right pane of the File Manager, and then click on the Delete button
You will be prompted to confirm that you wish to delete these items. Remember that the File Manager will allow you to delete any file or directory, even if it is a critical system file. Make sure that you know exactly what you are deleting.
You can delete multiple files or directories by holding down the Control key and selecting the items with the mouse. Then click on Delete to delete those items.
To rename a file or directory, click on that item in the right pane of the File Manager, and then click on the Rename button
You will be prompted for the new name of the file or directory. If you choose the same name as an existing file or directory, you will not be allowed to use that name.
You can only rename one file or directory at a time - there is not a way to rename multiple files using the Control Panel.
The File Manager will allow you to rename any file or directory on the system, even if that item is needed by other applications. Be very careful when renaming any files.
Creating and Editing Files
Using the File Manager, you can create new files on the system, and also edit any text file. You can also upload files from your local computer to the system. (Creating directories will be covered in the Creating Directories section.)
There are two ways to create a new file on the system. You can create a text file directly on the system, or upload an existing file from your local computer to the system.
Create a new file
To create a new file on the system using the File Manager, click on the New button to the right of the Delete button
This opens a new window, where you can enter the absolute path to the location of the file you wish to create. You can also enter the text of the file.
There are several options at the bottom of the Creating file screen:
Uploading a file
To upload a file from your local computer to the system, click on the Upload button
NOTE - you may have to enable pop up windows in your browser for the Upload button to function correctly.
Once you have made all the selections, click on Upload to upload the file. Depending on the size of the file, it will take several seconds to several minutes (or longer) to upload the file to the directory you have chosen.
Any text file on the system can be edited using the File Manager.
To edit a file, navigate to the file in the right pane of the File Manager, and click on the file name to select it. Then click on the Edit button
WARNING - do not try to edit a non-text file, such as a binary file, using the Edit function. You will corrupt the file and damage the application or system it belongs to.
In the Editing window you can edit the file. Remember that this is a plain text editor, so there is no character formatting available (no bold or italic, for example). Only plain ASCII text is allowed.
The same options that were available in the Creating file window are available here:
Creating Directories and Symbolic Links
To create a new directory (usually a subdirectory of an existing directory), navigate to the parent directory for the new directory in the left pane of the File Manager, and click on it so that the contents of the parent directory are shown in the right pane.
Click on the New Directory button
This opens the New Directory window, where you have the absolute path of the parent directory displayed. Enter the name of the new directory (test_directory in this example), and click Create to create the new directory, or Cancel to cancel.
This will create the new directory, but that directory will have an owner and group of root. See the section on Directory Permissions for information on how to change the owner and group of the directory.
Creating Symbolic Links
To create a symbolic link, navigate to the directory you wish to create the symbolic link for. If you are creating a symbolic link for a file, navigate to the location of that file.
Click on the New Link button
Click on Create to create the symbolic link, or Cancel to cancel.
File and Directory Permissions
Using the File Manager, you can set or change the permissions, user and group on any file or directory on the system. In addition, you can also get the size of a directory, and specify how any changes to the parent directory affect subdirectories and files in that directory.
To change these attributes, navigate and select a file or directory, and click on the Info button
To view or change the permissions, owner, and group for a file, navigate to that file in the File Manager, and click on the Info button.
The File Permissions screen is divided into three sections: File, Permissions, and Ownership.
Click Save to save your changes, or Cancel to cancel your changes and return to the main File Manage screen.
To view or change the permissions and ownership for a directory, and to see the size of the directory, navigate to the directory in the File Manager (the directory must be in the right pane) and click on the Info button.
The Directory Permissions screen is divided into five sections: File, Permissions, Ownership, Directory Size, and Apply changes to.
Finding Files and Directories
The File Manager can be used to find files and directories on the system. The search can be filtered by size, user, and type of file.
To search for a file or directory, click on the Find button
There are two tabs: Search criteria and Search results
Search criteria - enter the search parameters here
Click on Search Now to start the search. When the search is complete, the files and directories that matched the search criteria will be listed in the Search results tab. You can double-click on the name of a file or directory and the File Manager will navigate to that location.
If you click on Download, your browser will attempt to open the file (if it is a text file). You may need to allow pop up windows in your browser for this to work.