Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: typos;

...

Serial port optionDescription
type

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

  • socket: the port is set to raw mode.
  • telnet: the port supports the telnet protocol.
  • device: indicates that the emulated serial line is connected to a physical terminal on the host.
port

Each port is mapped to a TCP socket on the emulator host or to a physical line. This parameter defines the port number used or the name of the physical device. The port number must be unique on the host system.

A port number is specified as: ":<portnumber>". It requires a port type of socket or telnet.

Default values:

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

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

Example:

  • "/dev/ttyS0"
  • "/dev/ttyUSB0"
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-HPA provides preconfigured profiles for PuTTy PuTTY (HPA-Socket HPA-Telnet HPA-Telnet-VT100) that can be used to connect to the emulated system via a serial line.

...

LineHP3000HP9000

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

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


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

...

Please note: if the terminal emulation program runs on a remote system, any firewall between the remote system and the emulator host system must permit the configured ports.

Stromasys supplies PuTTy PuTTY profiles with the Charon-HPA kit. However, customers can select another terminal emulation program better suited to their purposes. This is especially true for emulated HP3000 systems, where applications often use block mode terminals. This mode is not supported by PuTTyPuTTY.

If not done so already during the installation, copy the provided PuTTy PuTTY profiles to the correct directory on the host system. See Charon-HPA Software Installation.

Accessing Emulated HP3000 Systems via Terminal Emulation

HPA3000 HP3000 guest systems running on Charon-HPA can be accessed directly from the Linux emulator host using either of two freeware terminal emulators listed 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 HP3000 network is configured, it's preferable to connect to the virtual HP3000 from a networked PC using any of the robust commercially-available terminal emulators.

Using

...

PuTTY

The PuTTY terminal emulator is the preferred method to use as the HP3000 console. It does not, however, support HP terminal escape sequences, 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 typeahead type-ahead enabled), as data overruns can easily occur.

...

By default, the emulator configuration is set up to start PuTTy PuTTY on the console port with the command:

...


StepCommand / Action
1Make sure the pre-configured PuTTy PuTTY profiles are in the directory .putty/sessions or .config/putty/sessions in your home directory.(see Charon-HPA Software Installation)
2Start PuTTy PuTTY from the command-line. 

$ putty -load HPA-Telnet

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

Start PuTTy 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 PuTTY from the command-line.

$ putty

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

...

The image below shows a PuTTY terminal window connected to the emulated HP3000 systems's system console:

Div
classpagebreak


...

Stromasys provides preconfigured PuTTy PuTTY profiles to access the serial console of an HP-UX system running on Charon-HPA. PuTTy 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 PuTTY on the console port with the command: serial.uart0.device.command="putty -load HPA-Telnet-VT100".

...


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


Start PuTTy 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 PuTTY from the command-line.

$ putty

Select and load the required profile.

Change the hostname to the one of the Charon-HPA host as required.

Connect to the remote Charon-HPA system.


(info) Instead of PuTTyPuTTY, you can also use the standard telnet command on your remote Linux system (telnet <charon-hpa-host> <port>). However, Stromasys does not provide profiles for this.

...

StepCommand
On Charon-HPA host system or remote Linux system
Temporary set locale to C before starting PuTTY if you use a different locale. 

$ export LC_ALL=C

Then start PuTTyPuTTY.

This setting will enable better line-drawing.

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.

...

The following image shows a PuTTy PuTTY window running SAM after the settings above were configured:

...

The following image shows a PuTTy PuTTY window where the locale on the system running PuTTy PuTTY is something different from C:

...

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

Option 1: using PuTTy PuTTY installed on the remote system

If PuTTy PuTTY is installed on the remote system, you can use the session profiles provided by Charon-HPA (copy them from the emulator host) to connect to the emulated system:

  • Start PuTTyPuTTY.
  • Load the correct session profile (see sections above).
  • Change localhost to the name or IP-address of the emulator host.
  • Start the session.

...

Use the following steps to start a PuTTy PuTTY session across an SSH tunnel:


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 programm program (e.g., PuTTyPuTTY, assuming the Charon-HPA session configurations have been installed for the user).$ putty -load HPA-Telnet-VT100

...