*********************************************** LiL CJs RMI Administrator v1.0 *********************************************** *********************************************** RMI Administrator created by LiL CJ aka Erica Andrews March 14,2000. This JavaBean is FREEWARE; however, it is NOT open-source. The author of this application hereby grants the public unlimited *personal* use of this software provided it is *not* used for any commercial purposes or ventures whatsoever, is *not* used for any sort of profit, either directly or indirectly, and *no* portion of this software is modified in any way (except for intended modifications within JavaBeans tools). The ONLY legal modifications of this software include: 1. modificaton of three colors. 2. modification of the default start port. 3. modification of the default end port. 4. modification of the default host. 5. modification of the list of ports to be skipped. These modifications are only to be made in JavaBeans IDEs. No disassembly, decompilation, or other direct dealings with any source code from this software are permitted. By using this software, you agree to the terms above and acknowledge that this software is distributed on an as-is basis, without any warrantee of any kind, and agree that the author of this software will not, under any circumstances, be held responsible for any damages, losses, or inconveniences derived from the use of this software. Any use of this software which is not consistent with the aforementioned terms constitutes unauthorized, fraudulent misuse of the software, punishable in a court of law. Copyright 2000 By Erica Andrews. All Rights Reserved. cylikon@hotmail.com ./IcedPinky/ ./ButchWhipAppeal/ ********************************************* ABOUT RMI ADMINISTRATOR: The purpose of this software is to provide a visual picture of all the RMI objects on a particular host. The two main features are a port scanner, which searches specificly for bound RMI Objects and exported registries, and the ability to unbind any found objects and remove them from the RMI Registry with the click of a button. The application can scan as many or as few ports as you wish and will report which ports contain bound RMI objects or open/empty RMI registries, how many objects per port, the names of the objects, and their URLs (i.e. rmi://yada.yada:999/MyRMIObject). All objects are displayed in a JTree, and can be unbound from the RMI registry at any time, making them unavailable to clients until you choose to manually restart them. CODEBASES/SERVER STUBS: Whenever possible, complete *in-depth* information about the class that comprises the RMI object will be provided in the object list. However, you MUST set the codebases in the RMI Administrator application by clicking the "Codebases" button on your right. Further explanation about and help with RMI codebases is available on the codebases setup screen. Codebases are NOT necessary for simply listing bound RMI objects; however, if you desire information about the the RMI object's class, such as available methods to invoke, the codebases will need to be set to provide the application with access to the necessary RMI server stubs. You can also configure ports to be exempt from port scanning, and you WILL need to do so: PLEASE SEE THE BUG REPORT BELOW BEFORE USING THIS APPLICATION. ********************************************* FILES INCLUDED IN THIS DISTRIBUTION: ReadMe.txt - This text file. RMIAdmin.jar - The application. rmiadmin.ico - An icon. rmiadmin.gif - An icon. rmiadmin.properties - A *necessary* properties file. (This file must be in the same directory as the RMIAdmin.jar file.) ********************************************* RUNNING THIS APPLICATION: If you are using JDK 1.2 or JDK 1.3, you should be able to run the application by simply executing (double-clicking on Windows) the RMIAdmin.jar file. Alternately, you can also run the application by issuing one of the following command lines: javaw.exe -classpath C:\RMIAdmin\RMIAdmin.jar cylikon.RMIAdministrator.RMIAdmin or java.exe -classpath C:\RMIAdmin\RMIAdmin.jar cylikon.RMIAdministrator.RMIAdmin Remember to adjust the C:\RMIAdmin to reflect the directory where you have stored the RMIAdmin.jar file. Use the first command line example if you want to run the application without a console window and make the java app run more like a regular application (suggested). LAUNCHING RMI Administrator FROM CJs JAVA EXPLORER: If you obtained RMI Administrator through my bundled software package known as the Java Explorer, you can launch the application by simply starting the Java Explorer, then clicking the "Utilities" tab near the top of the screen, then clicking on the RMI Admin icon. ******************************************* ACCESSING HELP (THIS FILE): You can access this help file in the future (without having to run the full application), by simply issuing one of the following command lines: javaw.exe -classpath C:\RMIAdmin\RMIAdmin.jar cylikon.RMIAdministrator.About or java.exe -classpath C:\RMIAdmin\RMIAdmin.jar cylikon.RMIAdministrator.About ****************************************** TESTING, BUGS, AND LIMITATIONS: This software has ONLY been tested on Sun's JDK 1.3 Java Virtual Machine on Windows 98. It has NOT been tested on any other JVMs or Platforms. BUG REPORT!!! PLEASE READ BEFORE USING THE APPLICATION: Please be aware that the RMI Administrator will most likely hang or crash if it attempts to scan ports that have other daemons on them which are *not* RMI objects, such as smtp ports, pop3, http, database ports, and other non-RMI ports. You can prevent this problem by clicking the 'Ports To Skip' button in the application, and excluding all ports which are running non-RMI daemons on them. If this application hangs or crashes while scanning, it is most likely due to the scanner attempting to list RMI objects on a live port that does not understand RMI listing commands - i.e. smtp,http,pop3,etc. Scanning of ports known to be running non-RMI daemons should be avoided at all costs. ********************************************** NO TECHNICAL SUPPORT is offered for this software and no future releases are planned for the near future. ********************************************* Copyright 2000 By Erica Andrews. All Rights Reserved. cylikon@hotmail.com ./IcedPinky/ ./ButchWhipAppeal/