test

Netra j 2.0.1 Product Notes

Netra j 2.0 Administrator's Guide

This section describes updates to the Netra j 2.0 Administrator's Guide.

DNS Primary Server Administration

Table 1-7 DNS Primary Server Administration

DNS Primary Server Information 

Description 

Primary Domain Name 

The name of the primary domain. The primary domain name is assumed to be fully qualified (do not use a trailing period). Example: elmo 129.144.79.1

Domains/ DNS Servers 

The domains served by the corresponding DNS name servers. The domain must be a subdomain of the primary domain, unless it is a fully qualified domain name. The host name of the name server must be within this domain, unless it is a fully qualified host name. All DNS servers are treated as authoritative for the listed domain. If a subdomain is entered, authority for that domain is delegated to the listed server. This field must always contain a record for this name server. Enter the name of this primary domain together with the host name of this server. A trailing period is required for the domain name.  

DNS Primary Domains

The domain name should be followed by a trailing dot as shown in the following example: 

mydomain.com.

Adding Records for Name Servers

When adding records for name servers, the first record must contain at least one entry specifying that this server is a name server for the domain. You must also create a second record for the name server of the subdomain within the primary domain.

Example of DNS Primary Server

The example of the DNS Primary Server under "Name Services Administration," "DNS" should be replaced with the following information:

For example, assume that a master database for the domain comedy.tv.net is to be set up. In the Primary Domain Name field, specify: 

comedy.tv.net

In the Host Names/Host Addresses field, type a list of those hosts whose presence are to be broadcast to any machine that can connect to this DNS server. For this example, type ren and stimpy, and for a host called homer located in the DNS subdomain black.comedy.tv.net, type homer.black. 

ren							129.1.1.2
stimpy							129.1.1.3
homer.black							129.2.1.2

The Internet community uses conventional names for hosts that provide certain types of services, in order to make them easy to locate. For instance, the WWW server for a domain is usually known as www.domain, and an anonymous FTP server is typically called ftp.domain. On comedy.tv.net, ren is an FTP and WWW server, while stimpy is a name server. Standard aliases for these machines are added into the Host Aliases/Host Names field. For example: 

www							ren
ftp							ren
ns							stimpy

stimpy is going to handle mail sent to comedy.tv.net, so an MX record needs to be created: 

comedy.tv.net.						5 		stimpy

Finally, records are added for name servers. This field must contain at least one entry specifying that this server is a name server for the domain. Add a second record homer.black, which is the name server for a subdomain of this domain. If a domain contains subdomains, the DNS primary domain server for the domain must know a DNS server for the subdomain. comedy.tv.net has a subdomain called black, whose DNS primary domain server is called homer. homer resides on that domain, so in order for the Netra DNS server to reach homer when it needs to request name services for that domain, it has to know homer's IP address. That is why homer.black was added to the list of known hosts.

Modem Administration

Connection speed choices shown in the table "Modem Remote Host Administration" include 38400, 19200, and 9600. Actual choices available in the Netra j "Add a Remote Host Connection" page are as follows:

Default Web Server Administration

The section "Default Web Server Administration" under "Using Netra j System Administration" (Chapter 6) should be removed.

File System Backup and Restore

The tables that describe options on the following pages do not include a complete description of the "Other directories" text field:

The "Other directories" text field can be used to specify another top-level directory to be saved in the backup. It also must be used to specify an alternate web server document root (i.e. other than /export/htdocs) if HTML documents will be saved in the backup.

Save and Restore Configuration

The instructions under "To Eject a Diskette" should state that the Verify page, not the Eject Diskette page, appears after you click Eject Diskette.

Routing Administration

In TABLE 4-6 Dynamic Router Administration and TABLE 4-7 Static Router Administration, the Destination Network/Host Address option should be Destination Address.

Network Computer Server Administration

The table under "Configuring Global Parameters" states that Time Zone is set in a text field, when actually it is set using a scrollable menu. Since a menu is used, an invalid entry is not possible.

Setting JavaOS Properties

The name of the JavaStation serial port is now SerialA. This change affects the setting of the JavaOS property javaos.printservice.local.params.serial-port described under "Printing Properties."

Table 1-8 Printing Properties
 Property Name Default Value Description
javaos. printservice. local.params. serial-port null

The port portion of this property is the name of a serial port (which is always SerialA on the JavaStation). This property sets the communications parameters for the serial port. The syntax of the parameters is baud_rate:data_bits:stop_bit: parity: flow_control. For example: -djavaos.printservice.local.params. serial-SerialA=57600:8:1:none:hh

Valid values for each parameter are as follows: 

  • baud_rate: 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200

  • data_bits: 5, 6, 7, 8

  • stop_bits: 1, 1.5, 2

  • parity: none, odd, even

  • flow_control: none, {s,h}{s,h} You can disable flow control by specifying none. Otherwise, specify an {input}{output} pair by selecting from Xon/Xoff (s) or RTS/CTS (h) for input and output.

The description of the property javaos.homedir under "General Properties" should be changedto the following:

Table 1-9 General Properties
 Property Name Default Value Description
 javaos.homedir null

This property specifies the NFS path JavaOS should mount if NIS is not used to find the path based on the user name. The NFS path is specified as hostname:/path.

This property is most often used to determine the directory to use for the properties file that is read by HotJava at startup. If the javaos.login property is set to false, javaos.homedir is not used.

JavaStation User Setup Forms

Information for PPP/modem described in the JavaStation User Setup forms available in Appendix C and from the Netra j Administration Interface should be updated with the following information:

Localization and Fonts

Under "Modifying Languages Displayed at Login," the property setting examples should be changed to the following. 

-djavaos.loginLocaleList=locale-1;locale-2; . . . ;locale-n

The default value of this property is: 

-djavaos.loginLocaleList=en_US;de;es;fr;it;ja;ko;sv;zh;zh_TW

Troubleshooting

The following sections pertain to the "Troubleshooting" appendix in the Netra j 2.0 Administrator's Guide.

Delete Tables

The following tables should be deleted.

Console Error Message

If you configure the Netra j system as a NIS master server or slave server, or if you send mail from the Netra j system, the following message appears on the console: 

sendmail[16702]: NOQUEUE: SYSERR(root): Cannot bind to domain netratest.Eng.Sun.COM: no such map in server's domain: Bad file number

This message can safely be ignored.

Troubleshooting JavaOS

The following section, "Capturing Log Files"," should be added to the Troubleshooting appendix.

Capturing Log Files

In some cases, if JavaOS fails, it may broadcast an SNMP trap. The trap can be received by any SNMP manager listening on the (sub)net. There is a simple SNMP trap receiver supplied with JavaOS state information in a log file.

To Capture Log Files for JavaOS

  1. Run the following command on any machine in the (sub)net: 

    # /opt/SUNWjsos/bin/snmptrapd -x /opt/SUNWjsos/bin/logdumper&

    If failures do occur, they are saved in the /tmp directory of the server machine with the following unique file name: 

    /tmp/javaos.log.IP address of failed client@time in seconds since January 1, 1970

    You can browse the log file to determine errors that may have caused a failure. You may also want to add the snmptrapd command to the Solaris initialization and booting hierarchy. See the README files in /etc/init.d and /etc/rc2.d for details.

    Note -

    Not all JavaStation client failures will result in a log file creation on the server machine.