Configuring ION Java for Windows

ION Java for Windows includes two dialog-based utilities that duplicate the functionality of the command-line utilities discussed in Starting the ION Daemon on UNIX.

The ION Java Properties utility presents a tabbed dialog that allows you to start, configure and control ION Daemon settings. For more information, see the following section, The ION Java Properties Dialog.

The ION Java Status utility allows you to check the status of the ION Daemon. For more information, see Checking Status with the ION Java Status Utility.

The ION Java Properties Dialog

Access the ION Java Properties utility from the Start menu by selecting Programs

ITT ION 6.4

ION Java Properties. This program, wionprop.exe, is located in the bin directory of your ION Java installation.

Modify the desired settings on each of the tabs described in the following sections:

See The Control Tab to install, remove, start or stop the ION Daemon service.

See The Locations Tab to set ION and IDL directory paths, the ION log file and IDL search path.

See The Security Tab and The Commands Tab to define which IDL commands should or should not be executed.

After making changes, click "OK" to accept the change and close the dialog, "Apply" to accept the change but leave the dialog open, or "Cancel" to close the dialog without making any changes.

The Control Tab

The Control Tab is used to start, stop or remove the ION Service and to configure the ION daemon attributes.

Table 1-1: ION Java Properties — Control Tab

Table 1-1: ION Java Properties — Control Tab
Attribute	Description
Remove / Install	Removes or installs the ION Service in the Windows service registry. Note - The service was automatically installed during your installation which called `ion_srvinst.exe` with the `-install` option so you will probably not need to remove or install the service until a new version of ION is released. See Windows Command Line Installation of the ION Daemon for more information regarding the `ion_srvinst` utility.
Start / Stop	Starts or stops the ION service. This button performs the same actions as the Services dialog described in the section Using Windows Services Manager to Start the ION Daemon. Note - Occasionally, the service may be unable to respond to a request. For more information, see Troubleshooting ION Service Problems.
ION Port Number	Defines the port number the ION Service listens to for connection requests.
ION Communication Timeout	Specifies the number of seconds ION will wait before closing a connection.
Allow Remote Utility Connections	Select this checkbox to allow the `iondown` and `ionstat` utility programs to be run from computers other than the one on which the ION service is installed.

The Locations Tab

The Locations Tab of the ION Java Properties dialog configures the paths used by ION Java.

Table 1-2: ION Java Properties — Locations Tab

Table 1-2: ION Java Properties — Locations Tab
Attribute	Description
ION Directory	Specifies the ION installation directory on your server machine.
IDL Directory	Specifies the IDL directory on your server machine.
ION Log File	Specifies the location of a text file that will contain the ION Server logs. Click "View" to view the contents of the log file.
IDL Path	Specifies the search path to the directory or directories containing the IDL library (.pro and .sav) files. In this field, specify the Web server's ION Java directory where IDL files were copied during ION installation. For example, using the Apache web server, this path may be: `+C:\Program Files\Apache Group\Apache2\htdocs\IONJava` You can enter either a ";" separated list of multiple directories, or use a "+" in front of a directory indicating that all subdirectories of the specified directory should be searched. See Setting the IDL Path if you need more information.

The Security Tab

The Security Tab, pictured in the following figure, allows you to define the commands that ION should or should not execute.

Use the Location Tab, to define the path to text files containing the following items:

Table 1-3: ION Java Properties — Security Tab

Table 1-3: ION Java Properties — Security Tab
Attribute	Description
Exclusion List	Contains a list of the commands ION should not execute. Click the Edit button on either field to edit the text file. See Security Command Files for details on how the ION Daemon handles inclusion and exclusion lists and how they can be created.
Inclusion List	Contains a list of the commands ION is allowed to execute. Click the Edit button on either field to edit the text file. See Security Command Files for details on how the ION Daemon handles inclusion and exclusion lists and how they can be created.
Active Security Groups	Select options to disable entire classes of IDL functionality. See the table, Active Security Group Tokens for a description of the security tokens associated with this field.

The Commands Tab

The Commands tab dialog offers another way of specifying IDL commands which should or should not be executed.

To add a command, click Add and enter a of an IDL command to the list of individual commands to be excluded or allowed by the ION security mechanism. To remove a command, select a command from either list and click Remove.

Checking Status with the ION Java Status Utility

The ION Java Status utility allows you to obtain information about the current state of the ION Daemon. Access the ION Java Status utility from the Start menu by selecting Programs

ION 6.4

ION Java Status. This program, wionstat.exe, is located in the bin directory of your ION Java installation.

Table 1-4: ION Status

Table 1-4: ION Status
Field	Description
Host	Set this field to the name of the computer on which the ION Daemon is running.
Port Number	Set this field equal to the port being watched by the ION Daemon. The default is port 7085, which is the default port for the ION Daemon. Click Query to retrieve information on the Daemon running on the specified host and port. Click Clear to clear the display or OK to dismiss the dialog.

Windows Command Line Installation of the ION Daemon

Use the ion_srvinst.exe program to install, control, and check the status of the ION Daemon Windows service. The ION installation process automatically calls ion_srvinst with the -install flag so you do not need to install it again. You can use this program to remove the service or configure how the daemon is started.

-install

-remove

-start

Set this switch to specify the start type of the service. If set to auto, the ION Daemon service will be started by the Windows system at startup. If set to manual (the default), the ION Daemon service must be started through the ION Java Properties dialog or the Control Panel Services dialog. Note that this option is ignored if the -install switch is not also specified.

-iondir

Use this switch to specify the ION installation directory, for example, ITT_DIR\idl64\products\ion64, not ITT_DIR\idl64\products\ion64\ion_java. Setting this switch will override any Windows registry entries and environment variable settings.

Using Windows Services Manager to Start the ION Daemon

Use the Services dialog to start, stop or configure automatic or manual startup modes of the ION Java Daemon. To open the Service dialog, do one of the following:

In the Services dialog, select ION Java Daemon 6.4 and use the interface to modify the settings. The following figure shows the Windows NT Services dialog with the ION Daemon selected.