About AdminBuddy

AdminBuddy is a SuperWaba based application that can be used by a network administrator to keep track of IP addresses, logins, passwords, and other information on their PDA. It also has a java based application that can be used to view and edit the information in a PDB that has been copied from the PDA to the desktop machine.

AdminBuddy is currently distributed with the binaries needed to install it on Palm OS devices. The application can also be run on Windows CE and Symbian OS 7 with the appropriate packaging. The latest version is version 2.0.1, and be gotten from http://pcsw.us/projects/adminbuddy/files/AdminBuddy_2.0.1.zip. See http://www.superwaba.com/br for more information about the SuperWaba virtual machine.

This application is copyrighted (C) 2003 by Philip A. Chapman and licensed to you for use under the GNU General Public License. More information concerning the licensing of AdminBuddy can be found here and the GPL license can be found here.

Installing and Using AdminBuddy

There are two directories in the release archive, desktop and palm. They are the files you need to run AdminBuddy on the desktop, and your PDA respectively.

Installing AdminBuddy on Your PALM PDA

The 3 files SuperWaba.prc, SuperWaba.pdb, and SWNatives.prc are the SuperWaba virtual machine and needed libraries. Install onto your PDA using your Palm sync software frist. The other 2 files, AdminBuddy.pdb and AdminBuddy.prc are the AdminBuddy application and its needed libraries. Install them next.

Running AdminBuddy on Your Desktop

In order to run AdminBuddy on your desktop, you must have the Java Runtime Environment (JRE) installed. The latest JRE can be obtained from Sun's website, http://java.sun.com.

There is only one file in the desktop directory, AdminBuddy.jar. Once the Java runtime has been installed, the application can be run with the command "java -jar AdminBuddy.jar" on unix and linux, or the command "javaw.exe -jar AdminBuddy.jar" on Windows. The application can also be started with the filename of the HostItems.pdb so that it is opened when the application starts: "java -jar AdminBuddy.jar HostItems.pdb".

Using AdminBuddy

The desktop application is written to look very much like the AdminBuddy application on the PDA, so the instructions will be almost the same for both versions of AdminBuddy. The one difference is that the desktop application requires you to open the HostItems.pdb file before data can be viewed or edited. Once the desktop version of AdminBuddy has been started, open a HostItems.pdb file by selecting the menu item "File", the the option "Open". To create a new HostItems.pdb file that can be transferred to your PDB, use the same process as used to open an exiting file. Choose the location at which the new file should be written, and select it.

The main window has a list of all servers for which data has been stored. It also has three buttons, "Add", "Edit" and "Delete". The "Add" button adds a new server item. The "Edit" button allows you to edit the selected server item. The "Delete" button allows you to delete the selected server item. In the desktop app, you can also edit a server item by double-clicking on the server item in the list. In the PDA app, simply tap to select an item in the list, then tap it again. The "Add Item...", "Edit Item...", and "Delete Item" file menu options duplicate the functionallity of the "Add", "Edit" and "Delete" buttons, respectively.

Finally, there is a sort feature that will sort the server items by server name. To use it, select the "File" menu item, then the "Open" option.

The same view is used for adding and editing server data. The fields available in the view are "Host", "Description", "IP Addr1", "IP Addr2", "Login", "Password", "Misc 1", and "Misc 2". Of the 8 data fields, "Description" is the only multi-line item. All others are single line items. The names are pretty descriptive, but there is no limit to what you can use the fields for. They can hold any data. The only limitation is that the "Host" field's value must be unique.

Final Notes

AdminBuddy's data is not encrypted and is not password protected. Anyone that has physical access to your PDA or has access to your desktop could hava access to the data stored in this application. This is a known issue. It is our hope to add data encryption and password protection in the near future. Until then, it is something that you should seriously consider before using this software.