Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: PDF layout

...

Most models emulated by Charon-PAR have two serial lines (LDev 20 and 21). One of these emulated lines is mapped to the serial console, the other to a second serial port. Some models may have more serial lines. Please refer to Emulated Model Hardware Configuration Details for more information. This section provides an overview of the serial line configuration. Please also refer to the Configuration File Reference.

Configuration Parameters Overview

...

The following table shows the device and configuration paths used for the two serial lines:

Serial lineConfiguration path
Charon-PAR 64-bit models

1 = Console

serial.uart0.device
2serial.uart2.device

Serial port configuration options are specified using the following syntax:

serial.uartX.device.
Charon-PAR 32-bit model 7000-720
1 = Consoleasp.uart0.device
2asp.uart1.device



Div
classpagebreak


Serial port configuration options are specified using the following syntax:

serial.uartX.device.<option>="<value>"

or (for model 720)

asp.uartX.device.<option>="<value>"



(info) If If the Super/IO module has been loaded, there are two additional serial lines. In the configuration, they are identified by 

  • superio_001.uart0 and
  • superio_001.uart1.

The basic configuration options are the same as for the default serial lines.

...

classpagebreak

A serial port has three configuration options:The most important configuration options are listed below. For additional parameters and more detailed information, please refer to the Configuration File Reference.

Serial port optionDescription
type

The serial port type determines the protocol used on the serial port. Possible values are:

  • DUMMY: serial interface presented to emulator is not connected.
  • socket: the port is set to TCP raw mode.
  • telnet: the port supports the telnet protocol.
  • devicepty: indicates that the emulated serial line is connected to a physical terminal on the host.
portEach port is mapped to
  • Linux pseudo-terminal.
  • tty: emulated serial line is connected to physical hardware (serial hardware must be supported by Linux).
  • RFC2217: emulatied serial line is connected to a serial line server across the IP network.
port

Each port is mapped to a TCP socket on the emulator host or to a physical line. This parameter defines the TCP port numberused or , the name of the physical device. The , or the port and address of a serial line server. A port number must be unique among all active port numbers on the host system.

A TCP port numberis specified as: "<where-to-listen>:<portnumber>". It requires a port type of socket or telnet.

Default valuesDefault values (listening on all interfaces):

  • ":30000" for line 1
  • ":30002" for line 2

To restrict console connections to certain host interfaces or host IP addresses, set where-to-listen to the respective interface name or IP address. The settings lo:<portnumber> and <portnumber> (without the colon) are equivalent.

A physical device is specified as "<device-file>". It requires a port type of device.

Example:

  • "/dev/ttyS0"
  • "/dev/ttyUSB0"

A serial line server is specified as "<ip-address>:<port>".

commandThis parameter is optional. It can be used to specify a terminal emulation program that is started automatically when the emulated system is started. Charon-PAR provides preconfigured profiles for PuTTY (HPAPAR-Socket HPAPAR-Telnet HPAPAR-Telnet-VT100) that can be used to connect to the emulated system via a serial line.


Div
classpagebreak



The configuration file templates contain the following default configurations:

1
LineCharon-PAR/PA3Charon-PAR/PA9

Emulated serial console on port 30000 using the telnet protocol. PuTTY started automatically with preconfigured profile.automatically with preconfigured profile.
1 serial.uart0.device.type="telnet"
serial.uart0.device.port=":30000"
serial.uart0.device.command="putty -load PAR-Telnet"

PA9-64

serial.uart0.device.type="telnet"
serial.uart0.device.port=":30000"
serial.uart0.device.command="putty -load

HPA

PAR-Telnet-VT100"

PA9-32

serialasp.uart0.device.type="telnet"
serialasp.uart0.device.port=":30000"
serialasp.uart0.device.command="putty -load HPAPAR-Telnet-VT100"


Emulated second serial line in raw mode on port 30002.
2 serial.uart2.device.type="socket"
serial.uart2.device.port=":30002"


PA9-64

serial.uart2.device.type="socket"
serial.uart2.device.port=":30002"

PA9-32

asp.uart1.device.type="socket"
asp.uart1.device.port=":30002"


Div
classpagebreak


HP-UX Interactive Login Activation

...

If not done so already during the installation, copy the provided PuTTY profiles to the correct directory on the host system. See See Post-Installation Tasks in  Charon-PAR Software Installation#PARSoftwareInstallation-Post-InstallationTasksInstallation.

Accessing Emulated Charon-PAR/PA3 Systems via Terminal Emulation

Charon-PA3 guest systems can be accessed directly from the Linux emulator host using either the PuTTY or xhpterm terminal emulator described below, both of which run directly on the Linux host desktop, or by simply using the telnet command. Each has limitations, however. Neither terminal emulator provides a reliable way to paste multiple lines of text into :EDITOR , for example.
Once the network of the Charon-PAR/PA3 guest system has been configured configured, it may be preferable to connect to the emulated system from a networked PC using any of the robust commercially-available terminal emulators.

...

  • charon-host: IP address or hostname of the Charon-PAR host system on which the emulator runs
  • console-tcp-port: The TCP port configured for the serial console port in the configuration file of the emulated PA3 system

(warning)  Please note: Line-editing is very limited. To delete a character on the command-line, use CTRL+BACKSPACE. Note that the deleted character will still be visible until it is overwritten. Block-mode applications are not supported.

...

The PuTTY terminal emulator is the preferred method to use as the Charon-PAR/PA3 console. It does not, however, support HP the terminal escape sequences used by the legacy hardware, so any inverse or highlighted text codes will be ignored, and block mode applications cannot be run. Using PuTTY in telnet mode (as supplied) allows use of the Break key. PuTTY supports copy and paste. To copy text to the clipboard, just select it with the left mouse button (this automatically copies the selection to the clipboard). To paste the clipboard into a PuTTY window, use Shift-Ins . Unfortunately, PuTTY cannot be used to reliably paste large blocks of text (even with MPE type-ahead enabled), as data overruns can easily occur.

By default, the emulator configuration is set up to start PuTTY on the console port with the commanda command similar to the following example:

serial.uart0.device.command="putty -load HPAPAR-Telnet" (default port 30000). 

...


StepCommand / Action
1Make sure the preconfigured PuTTY profiles are in the directory .putty/sessions or .config/putty/sessions in your home directory.(see see Post-Installation Tasks in  Charon-PAR Software Installation#PARSoftwareInstallation-Post-InstallationTasksInstallation)
2Start PuTTY from the command-line. 

$ putty -load HPAPAR-Telnet

3Should you get an error that a font was not found, change the font.

Start PuTTY from the command-line.

$ putty

  • Select and load the required profile.
  • Select Fonts on the left and select a monospace font.
  • Select Session on the left and save the profile.
4To connect from a remote host, change localhost in the template to the correct hostname or IP address.

Start PuTTY from the command-line.

$ putty

  • Select and load the required profile.
  • Change the hostname to the one of the Charon-PAR host as required.
  • Connect to the remote Charon-PAR system..


Div
classpagebreak


The image below shows a PuTTY terminal window connected to the guest MPE/iX system console:

(warning) Please note: Line-editing is very limited. To delete a character on the command-line, use BACKSPACE. Note that the deleted character will still be visible until it is overwritten. Block-mode applications are not supported.

Div
classpagebreak


Using xhpterm

The xhpterm terminal emulation (an X Windows version of freevt3k ) does not support many terminal escape sequences used by historic HP3000 hardwarePA-RISC hardware for MPE/iX, but it can be used to run block-mode applications. It must be used on a serial line set up for raw mode.

...

The following image shows an xhpterm window connected to the second serial line of an emulated MPE/iX system (running NMMGR):

Div
classpagebreak


Working without Block-Mode Enter key

If working without a block-mode Enter key, you can navigate using the function keys of your keyboard. They correspond to the selection fields at the bottom of the screen.

For example, in the above window,

  • F1 would correspond to Open Config,
  • F8 would correspond to Exit Program.

Mapping the Block-Mode Enter key

...


StepCommand
1Determine the key code of the Right-Ctrl key.

$ xmodmap -pk | grep "Control_R"

You will receive an output similar to: 

105 0xffe4 (Control_R) 0x0000 (NoSymbol) 55 0xffe4 (Control_R)

2Redefine the key code to the numeric keypad Enter key.$ xmodmap -e "keycode 105 = KP_Enter"
3If original key mapping is required, reverse step 2.$ xmodmap -e "keycode 105 = Control_R"

...


Using Different Fonts

The default command-line to start xhpterm is:  $ xhpterm -port 30000 -clean -font 10x20

...

# yum install xorg-x11-fonts-misc

(info) When Please note: When using xhpterm , avoid resizing the window - it can result in input and output fields in block-mode programs being misaligned. Changing the screen font will change the window size automatically, without causing this problem.

Accessing Emulated Charon-PAR/PA9 Systems via Terminal Emulation

Using Non-Graphical Telnet Client

In the absence of a graphical user environment, terminal emulators such as PuTTY and xhpterm cannot be used. In such cases, you can use the telnet command on the Charon host or from a remote system (if the serial line configuration permits it) to access the serial console port of the emulated PA3 system.

...

  • charon-host: IP address or hostname of the Charon-PAR host system on which the emulator runs
  • console-tcp-port: The TCP port configured for the serial console port in the configuration file of the emulated PA3 system

(warning)  Please note: To make character deletion via the BACKSPACE key work on the command-line of HP-UX, you may have to enter the command$ stty erase <backspace-key> (and add it to your shell startup file, e.g., $HOME/.profile).).

Div
classpagebreak


Using PuTTY

Stromasys provides preconfigured PuTTY profiles to access the serial console of an HP-UX system running on Charon-PAR. PuTTY does not support all control characters used by HP-UX, but many utilities (e.g., SAM) will work with some restrictions.

By default, the emulator configuration is set up to start PuTTY on the console port with the commanda command similar to the following example
   serial.uart0.device.command="putty -load HPAPAR-Telnet-VT100".

To start an terminal emulator manually, perform the following steps:


StepCommand / Action
1Make sure the preconfigured PuTTY profiles are in the directory .putty/sessions or .config/putty/sessions in your home directory.(see Charon-PAR Software Installation#PARSoftwareInstallation-Post-InstallationTasks)
2Start PuTTY from the command-line. $ putty -load HPAPAR-Telnet-VT100
3Should you get an error that a font was not found, change the font.


Start PuTTY from the command-line.

$ putty

  • Select and load the required profile.
  • Select Fonts on the left and select a monospace font.
  • Select Session on the left and save the profile.
4To connect from a remote host, change localhost in the template to the correct hostname or IP address.

Start PuTTY from the command-line.

$ putty

  • Select and load the required profile.
  • Change the hostname to the one of the Charon-PAR host as required.
  • Connect to the remote Charon-PAR system.


(info) Instead Instead of PuTTY, you can also use the standard telnet command on your local or remote Linux system (telnet <charon-par-host> <port>). However, Stromasys does not provide profiles for this. To make character deletion via the BACKSPACE key work on the command-line of HP-UX, you may have to use the command $ stty erase <backspace-key>.

Div
classpagebreak



Additional configuration steps to improve the behavior of the terminal emulation:

StepCommand
To enable better line drawing with the VT100 setting do the following on system where PuTTY runs
PuTTY versions before 0.71
Temporary set locale to C before starting PuTTY if you use a different locale. 

$ export LC_ALL=C

Then start PuTTY.

This setting will enable proper line-drawing.

PuTTY versions starting with 0.71
Use the new UTF8linedraw parameter in the PuTTY configuration.

Either add the line UTF8linedraw=1 to your session configuration file

or

Start PuTTY from the command-line, load the HPAPAR-Telnet-VT100 session, enable VT100 line drawing for UTF-8 (the last parameter in Window > Translation), and save the session.

On the HP-UX guest system
Set the terminal type to vt100 after logging in to the system (this can be added to the login profile, if required).

$ TERM=vt100

$ export TERM

This will configure a terminal type known to HP-UX. Without a known terminal type many screen-based applications (e.g., editor, SAM) will not work.


(info) Additional Additional information: Cannot get correct line drawing on Linux/UNIX with Putty.

...

Accessing the Emulated System Console from a Remote System

(warning) Please Please note:

  • The serial line port configuration must allow the remote connection.
  • intermediate firewalls must allow the ports used.

...

  • There can be only one connection to an emulated serial line at one time.

The following two options provide two examples of how to connect to the console of an emulated system from a remote system.

...

Even though a plain telnet connection can be used to connect to the emulated system's console, this plaintext connection may create security problems. As an alternative, you can tunnel a terminal emulation through an SSH tunnel provided X11 is active on the emulator host and the remote system.

(warning) Any Please note: Any intermediate firewall must permit the port used for SSH (default 22).

...


StepCommand
1Connect to the emulator host via SSH specifying that X11 should be tunneled.$ ssh -X <user>@<emulator-host>
2Enter the password of user to log into the emulator host system.
3Start the terminal emulation program (e.g., PuTTY, assuming the Charon-PAR session configurations have been installed for the user).$ putty -load HPAPAR-Telnet-VT100

...


Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc