Contents Index


Managing Jconfig

Setting Jconfig options

Click the Options icon on the Jconfig toolbar to configure the Jconfig application settings. You can specify the following information for Jconfig:

There are some additional Server options for the administration host and other remote machine running Jconfig. These options are available in the Daemon Settings service under Jconfig in the Available Services pane.

To configure the Jconfig options:

  1. On the Jconfig toolbar, click Options.
  2. In the Workstation Database section, specify the name of the workstation database file. The default file is workstn.hdb, located in the user directory.
  3. In the Administration Log section, select the Enable administrator's log file check box to record status information, then do the following:
    1. In the File Name box, specify the name of the Administration Log file. The default file is jconfig.log, located in the user directory.
    2. To empty the contents of the log file each time you run Jconfig, select the Clear on Startup check box.
  4. In the Web Browser section, specify the full path and executable file name of a web browser. For example: c:\Program Files\Plus!\Microsoft Internet\Iexplore.exe.

Viewing the Jconfig Administration Log

Click Log on the toolbar to display the Jconfig Administration Log. Several of the services provide the option of placing information in the Administration Log.


Running Jconfig in a browser

You can run Jconfig in two ways: as a Windows application or from a Java-enabled Web browser. By default, Jconfig runs as a Windows application.

To run Jconfig from a Java-enabled Web browser:

  1. Set up a Web server on your administration host to serve the JconfigApplet.html file. This file is located in the Hummingbird home directory. The Web server should set the home directory as either the root or virtual root to ensure that relative links are valid.
  2. Jconfig Daemon must run on the same machine as the Web server. This machine will be your administration host.
  3. Using a Web browser, connect to the Web server by typing the URL of the JconfigApplet.html file. This allows the applet to run using Sun Microsystems' Java 2 Runtime Environment, Standard Edition (JRE) instead of the web browser's default virtual machine. This plug-in supports both Netscape Navigator TN (3.0 and later on Windows 95, 98, and NT 4.0) and Microsoft Internet Explorer (4.0 and later on Windows 95, 98, and NT 4.0).

Note: If you want to run in a language other than English, you can modify the language parameter in the JconfigApplet.html file. You can use the following values:


Managing the host database

You can use the Workstation Database service located under Jconfig in the Available Services pane to store connection information for hosts to which you frequently connect. Use this option, along with script files, to configure multiple remote hosts simultaneously.

To add entries to the Workstation Database:

  1. On the Workstation Database Service toolbar, click Add Entry. The Add Entry dialog box opens.
  2. Type the name of the new host in the Workstation box.
  3. Accept the default port assignment or click Port and type the new port number in the box.
  4. Type the password for the new host in the Password and Confirmation boxes. Click OK.
  5. On the Workstation Database Service toolbar, click Save host database to save the new entry and any other changes.

To edit entries:

  1. On the list of workstation, select the host you want to edit and click Edit Entry on the Workstation Database Service toolbar. The Edit Entry dialog box opens.
  2. Modify the parameters for the selected host and click OK.
  3. On the Workstation Database Service toolbar, click Save workstation database to save the new entry and any other changes.

To delete entries:

  1. On the list of workstations, select the host you want to edit and click Delete Entry on the Workstation Database Service.
  2. Click OK to confirm the deletion.
  3. On the Workstation Database Service toolbar, click Save workstation database to save the new entry and any other changes.

To find a host:

  1. On the Workstation Database Service toolbar, click Find workstation. The Find dialog box opens.
  2. Type the name (or a portion of the name) of the host in the Workstation box. If you want to find only the exact string typed in the Workstation box, select the Find exact check box.
  3. Click Find to highlight the appropriate host in the Workstation Database Service window. Click Find Next to find the next instance of the string.
Note: All searches are case insensitive.

To change a host password:

  1. On the Workstation Database toolbar, click Password Wizard.
  2. On the Select Workstations pane, specify the hosts for which you want to change the password. You can select all hosts in the host database, or a specific host group.
  3. On the Specify Password pane, type the new password in the Password and Confirmation boxes.
  4. Click Finish. The Change Admin dialog box opens to confirm the changes to the selected hosts. Click Close.
  5. On the Workstation Database toolbar, click Save workstation database to save the new password.

To refresh the display:

On the Workstation Database toolbar, click Refresh list. The list updates with the information in the host database file. Any unsaved changes are lost. This function helps if you have made changes to the services, but want to revert back to the currently saved version.

Generating the workstation database automatically

If there is a large number of hosts in your network, you can create a Java program to automatically create the host database file. In your program, use the class: com.hcl.apps.rcfg.Services.WorkstationDb.Server.workstationDBCreator

This class has the following public methods:

// --- Creates a workstation database with the filename JCONFIG.HDB workstationDBCreator()
// --- Creates a workstation database with given filename workstationDBCreator(String fileName)
// --- Adds a new entry to the database without a password public boolean addNewEntry (String group, String workstation, String port)
// --- Adds a new entry to the database with a password public boolean addNewEntry (String group, String workstation, String port, String password)
// --- Saves the workstation database to disk public void save() throws IOException
// --- Closes the workstation database file public void close() throws IOException

Changing passwords for connecting to remote hosts

To change the password:

  1. Connect to the remote host.
  2. In the Available Services list, expand the Jconfig folder.
  3. Double-click Daemon Settings. The Daemon Settings Service dialog box opens.
  4. Select the Change Password check box.
  5. Type the new password in the New Password and Confirmation boxes.
  6. Click Apply Changes in the Daemon Settings Service toolbar to make the new password effective. The next time the Jconfig Daemon starts, you must use this new password to make a connection.


Contents Index