This appendix describes how to internetwork the OpenWindows environment and the DECwindowsTM environment via the NSP DECnet transport protocol.
Note that this whole chapter concerning "DECnet Internetworking" applies only to SPARC-based machines. DECnet internetworking is also available only with 8.x DNI.
There are two DNI scenarios:
Running an X11 client on a VAX system (under the VMSVMSTM operating system) and displaying the client's window on an OpenWindows machine
Running an X11 client on an OpenWindows machine and displaying the client's window on a VAX system
These two scenarios are described in the following sections after an initial section on how to set up the DNI software for either scenario.
The OpenWindows server and client libraries use a dynamically loadable version of the DNI transport library libdni. In order for the server and client libraries to load libdni you must set the environment variable DNI_X_ENABLE to the directory where libdni.so is installed.
The example below assumes you loaded DNI via pkgadd in the default location:
Start the OpenWindows server.
By default, the OpenWindows server supports "MIT-MAGIC-COOKIE" security. This security mechanism is user-specific, rather than host-specific -- you decide which users may connect to the server instead of which machines may connect to the server. In the default mode, the xhost command returns an empty list, and states only that security is turned on. You can turn off this security mode (and revert to the security mode of previous OpenWindows server versions) by using the -noauth option with the openwin command.
$ openwin -noauth
Request the owner of the machine running the OpenWindows software to use the xhost command to give DEC® VAX® permission to have an X11 connection to the OpenWindows server.
In order for X11 clients to connect to the OpenWindows server through the DNI software, the DECnet node addresses must be mapped to their DECnet node names. You do this by creating and initializing the NCP database. This must also be done on the DEC VAX system.
$ xhost decvax::
The double colon specifies the DECNet transport.
You can run X11 clients from VMS by using the SunLink DNI dnilogin command to log into the VAX system. First, set the environment variable DISPLAY on your local machine to be the X11 server on the remote machine. Then run an X11 client by entering the name of the client, represented here by x11_client. (See the VMS DECwindows User's Guide, Running Applications Across the Network for more information on using the VMS operating system.)
$ dnilogin decvax . . . $ define DECW$DISPLAY OW_machine::0 $ spawn/nowait run x11_client
Before you can run any of the X11 clients you must compile and install the OpenWindows fonts in the DECwindows server. These fonts are available in the X11R5 release or in the optional font package with the OpenWindows software. Follow these steps to install the proper fonts in the DECwindows server:
Install the optional OpenWindows font sources (of the font sources from the X11R5 release) on the OpenWindows machine.
See the Solaris X Window System Developer's Guide for font installation instructions.
Copy the font sources to a directory on the VAX system.
$ cd /usr/openwin/share/src/fonts/misc$ dnicp *.bdf `decvax::[vaxdir]'
Compile the cursor fonts on the VAX system.
This results in files such as: olcursor.decw$font;1 olglyph10.decw$font;1...
$ font olcursor.bdf $ font olglyph10.bdf ...
Copy the fonts to the sysfont directory:
$ set def sys$sysroot:[sysfont.decw.user_cursor16] $ copy [vaxdir]olcursor.decw$font;1 *
You must be logged in as "system" on the DEC VAX system to copy the fonts to the sysfont directory.
You must also perform steps 2-4 for the rest of the cursor fonts and for the Lucida fonts in /usr/openwin/share/src/fonts/75dpi and /usr/openwin/share/src/fonts/100dpi.
The Lucida fonts should be installed in sys$sysroot:[sysfont.decw.user_75dpi] and sys$sysroot:[sysfont.decw.user_100dpi].
The following list shows the minimum working set of fonts needed to be installed in order to run the OpenWindows DeskSet tools. If you are using default fonts for the applications you should only have to install these fonts. You can, however, install more fonts as needed.
Restart the DECwindows server.
You can verify that the fonts were installed by listing the available fonts in the DECwindows server:
$ DISPLAY=decvax::0 $ xlsfonts | grep Sun (Cursor fonts)$ xlsfonts | grep Lucida
Make sure you have given the OpenWindows node permission to display on the DECwindows server by using the Security Menu in the DECwindows Session Manager.
Run an X11 application (for example, an OpenWindows DeskSet tool).
$ DISPLAY=decvax::0 $ mailtool
DNI_X_ENABLE must be set
to the location of the DNI transport library libdni. See Step 1 under "E.1 Setting Up DECnet Internetworking",
in this chapter.
If an error message such as the one below is printed, you need to install that font in the DECwindows server in order to run the application.
XView warning: Cannot load font `-b&h-lucida-medium-r-*-*-*-80-*-*-*-*-*-*' (Font package)
This error message means font luRS10.bdf needs to be installed.
See the Solaris X Window System Developer's Guide for more information on fonts.