Uploader

The AdminTool's Uploader module allows administrators to upload server-side Zone and Room Extensions and Java Servlets to the server without using additional tools like FTP transfer managers. The module also controls Extensions reloading, to immediately activate a new version of a Zone Extension without restarting SmartFoxServer.

File upload protection

As this module allows to upload any kind of file to the server, in order to improve the security a physical lock has been placed on the server preventing the module usage until it is removed. This means that even if you forget to change the default access credentials for the AdminTool, a malicious user won't be able to take advantage of it.

To enable this module you have to remove the config/UploadsLock.txt file by accessing the server directly (via FTP or using a terminal/console window). Please make absolutely sure to first setup a secure password before removing the lock file.

As the module leverages SmartFoxServer's file uploading feature, in addition to the above, the module requires the internal web server to be already running and the HTTP protocol to be active in the Web Server tab of the Server Configurator module.

Extensions

The Extensions tab of the module shows the tree of folders and files currently existing in the server's extensions folder, including the _shared folder where library classes can be deployed and serve multiple Extensions.

In order to upload a new Extension, select the top folder, click on the Add folder () button and enter a name in the input. Then click the Add button. The new folder will be displayed and selected in the list: you can now click the Upload files () button. In the modal panel showing up, click the Select files... button and select the file/s to be uploaded in the operating system window popping up. As an alternative you can drag&drop files in the drop area of the user interface. Files are immediately uploaded, each one showing the completion percentage and explanatory details in case an error occurs. Upon completion of each file, the tree is refreshed showing the new item/s.

In case of a new Zone Extension, the last step is to assign it to the Zone by means of the Zone Extension tab of the Zone Configurator module.

In order to update an existing Extension instead, simply select the target folder in the tree and follow the same procedure to upload the files: the existing files on the server will be overwritten without further notice. Also, in case of an update, it is usually needed to run the new version of the Extension immediately. This is possible for Zone Extensions only by clicking the Reload Extension () button after selecting the main folder.

Use the Delete () button to remove the selected file or folder from the server.

Servlets & WARs

The Servlets & WARs tab of the module shows the tree of folders and files currently existing in the server's www folder.

In order to deploy a new servlet, you can either upload it as a WAR file under the top folder (www), or you can create a new folder and upload the servlet's native files. To create a folder, select the parent folder, click on the Add folder () button and enter a name in the input. Then click the Add button. The new folder will be displayed and selected in the list: you can now click the Upload files () button. In the modal panel showing up, click the Select files... button and select the file/s to be uploaded in the operating system window popping up. As an alternative you can drag&drop files in the drop area of the user interface. Files are immediately uploaded, each one showing the completion percentage and explanatory details in case an error occurs. Upon completion of each file, the tree is refreshed showing the new item/s.

In order to update a servlet, simply select the target folder in the tree and follow the same procedure to upload the files: the existing files on the server will be overwritten without further notice.

Use the Delete () button to remove the selected file or folder from the server.