SFS2X Docs / GettingStarted / admintool-ServletManager
» Servlet Manager module
The AdminTool's Servlet Manager module allows administrators to upload a Java Servlet to SmartFoxServer's internal Jetty web server, without using additional tools (for example FTP transfer managers).
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 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 the module you have to remove the UploadsLock.txt file contained in the server's config folder by accessing the server directly (via FTP or using a terminal/console window).
Please make absolutely sure to first setup a secure password before unlocking the Servlet Manager.
As the module leverages the uploading feature introduced in SmartFoxServer starting from version 2.9, in addition to the above, the module requires the internal web server to be running and the HTTP protocol to be active in the Web server tab of the Server Configurator module.
The left side of the module shows the list 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 in the top folder (www), or you can create a folder to upload its native files. In order to create a folder, enter its name in the textbox below the list and hit the Create folder button. The new folder will be displayed and selected in the list. Now click the Upload files button, select the file/s to be uploaded in the operating system window popping up; when confirming, a summary table will list the files, requiring one last confirmation.
The files being uploaded are listed in the queue on the right side of the module, together with their completion percentage and explanatory details in case an error occurs. Upon completion of each file, the left list is refreshed showing the new item.
Please note that the items in the uploading queue are handled sequentially: the Cancel uploading button allows stopping the current upload and the following ones.
In order to update a servlet, simply select the target folder in the left list and follow the same procedure to upload the file/s: the existing file/s on the server will be overwritten without further notice.
Use the Remove selected button to delete one or more files (CTRL-click / CMD-click to select multiple) from the server.