Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The CHARON-SSP Manager is a GUI management interface for the CHARON-SSP for GNU/Linux virtual machine.  Using this management utility it is possible to manage multiple virtual machines, licenses and virtual neworks across a number of remote hosts.  It is also the interface presented on the console of a system running the CHARON-SSP Virtual Environment.

The following sections describe the different aspects managing a the virtual machineenvironment.

Table of Contentspagetree
rootmaxLevel@self4

Getting Connected

Upon starting the CHARON-SSP Manager you will immediately be presented with a login window similar to the following.

...

Note

If you receive an error similar to the following, check to ensure that the host specified in the IP address field is correct and the CHARON-SSP Agent is installed and running on the host.

 

...

The first step to running a SPARC-based virtual machine is creating the initial configuration.  To do this, follow the steps below.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleSteps to Create a Virtual Machine
StepDescriptions
1.From the opening splash screen entitled Welcome to CHARON Manager, click the icon labelled Create a New Virtual Machine.
2. Select the appropriate Hardware Model by clicking the radio button labelled with the SPARC model that most closely matches the system to you wish to run.
3.Enter a name for the virtual machine into the field labelled, Virtual machine name.
4.Click the button labelled OK.

The steps above will create a new virtual machine configuration.  It will appear in the left hand pane of the management interface labelled with the Virtual machine name you specified.  The screenshot below shows the management interface splash screen after the virtual machine LEELA was created.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleCHARON-SSP Manager Opening Screen

Image Removed

Info

The initial creation of the virtual machine is very sparse. To complete the configuration it is important to continue on to Modifying the Virtual Machine.

...

Whether completing configuration of a newly created virtual machine or adjusting the set up of an existing configuration the Virtual Machine Settings window can be opened by first clicking the name of the virtual machine in the left-hand pane of the management console.  This should be followed by clicking the button labelled Edit Virtual Machine.  

The example below shows the Virtual Machine Settings window for a virtual Enterprise 450 system.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleEdit Virtual Machine Settings Window

Image Removed

The following section describes each part of the Virtual Machine Settings window 

Note

For any changes to take effect, the virtual machine must be restarted. However, it is also recommended that before making any configuration changes the virtual machine is shutdown correctly.

Model Configuration

To view or change the virtual machine model, select Model in the Device column of the left hand pane.  The current setting will be displayed in the field labelled Hardware Model.  To change the model, click the Hardware Model drop-down box and select the appropriate model (see the example below).

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine Model Configuration Window

 Image Removed

The models currently supported by CHARON-SSP/4M for GNU/Linux are:

  • Sun SPARCstation 20

The models currently supported by CHARON-SSP/4U for GNU/Linux are:

  • Sun Enterprise 450

CPU Configuration

To view or change the current virtual machine CPU configuration, select CPU in the Device column of the left-hand pane.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine CPU Configuration Window

 Image Removed

The following table lists each of the fields in the CPU configuration window and describes their operation.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine CPU Configuration Fields
FieldDescription
Number of CPU

Configure the number of CPUs attached to the virtual machine. Not all virtual SPARC systems support the configuration of multiple CPUs. For those virtual systems that do support multiple CPUs, they can still be restricted by the formula:

Physical CPUs = Virtual CPUs + 1

An attempt to configure more virtual CPUs than allowed will result in the following error message:

Image Removed

Runtime OptimizationThis option controls the Dynamic Instruction Translation (DIT). This option is on by default.
CPU binding

Assign specific host CPUs to the processing of SPARC instructions.

This field is a comma-delimited list of CPU IDs. Leaving this blank will cause the virtual machine software to assign affinity itself.

I/O binding

Assign specific host CPUs to the processing of virtual machine I/O requests.

This field is a comma-delimited list of CPU IDs. Leaving this blank will cause the virtual machine to assign I/O processing affinity itself.

Reserved I/O CPUs

Reserve a number of CPUs on the host system for the purpose of processing virtual machine I/O requests.

Info

If neither I/O binding and Reserved I/O CPUs are not set, then the virtual machine software will assign 1/3 (rounded down) of the host CPUs to I/O processing.

Memory Configuration

To view or change the current virtual machine memory configuration, select Memory in the Device column of the left-hand pane.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine Memory Configuration Widows

Image Removed 

The following table lists each of the fields in the memory configuration window and describes their operation.

...

bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine Memory Configuration Fields

...

Set the amount of RAM allocated to the virtual machine. Memory can only be allocated in certain increments. The table below describes the allocation rules for each virtual machine model.

...

This option specifies the memory allocation method used for the virtual machine. The default is malloc.

...

SCSI Configuration

To view or change the current virtual machine SCSI configuration, select SCSI in the Device column of the left-hand pane.  This will open the SCSI configuration window, shown below.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine SCSI Configuration Window

 Image Removed

From this window it is possible to create virtual disk and tape container files as well as attach virtual storage devices (both physical and container files) to the virtual machine.

Creating Container Files

Often it is convenient to use container files for virtual disk and tape devices.  The following sections describes creating both disk and tape container files.

Creating a New Virtual Disk Container File

To begin creating a virtual disk container file, click the button labelled Create vdisk in the SCSI device Virtual Machine Settings window.  This will display the Create New Virtual Disk window shown below.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleCreate New Virtual Disk Window

 Image Removed

To create a virtual disk container file, follow the instructions listed below.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleSteps for Creating a New Virtual Disk Container File
StepDescription
1.Specify a name for the virtual disk container file in the field Virtual disk name.
2.Select the location on the host file system for the container file by clicking the button Location and navigating to the correct path.
3.

Select the virtual disk type from the drop-down list Virtual disk type.

  • If specifying the type of Custom, enter the container file size as a number of 512 byte blocks at the field Block number.
  • If selecting an existing Virtual disk type the Block number field will be updated to match that model.
4.

Click the button labelled Create to generate the virtual disk container file.

Depending on the size of the container file, this may take some time.

Creating a New Virtual Tape Container File

To begin creating a virtual tape container file, click the button labelled Create vtape in the SCSI device Virtual Machine Settings window.  This will display the Create New Virtual Tape window shown below.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleCreate New Virtual Tape Windows

 Image Removed

To create a virtual tape container file, follow the instructions listed below.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleSteps for Creating a New Virtual Tape Container File
StepDescription
1.Specify a name for the virtual tape container file in the field Virtual tape name
2.Select the location on the host file system for the container file by clicking the button Location and navigating to the correct path.
3.Specify the size for the virtual tape file in megabytes (MB) in the field Tape size.
4.

Click the button labelled Create to generate the virtual tape container file.

Depending on the size of the container file, this may take some time.

Add/Edit Virtual SCSI Device

To add a new virtual disk device click the button labelled Add...  To adjust an existing virtual disk device, select it from the list of configured devices and click the button labelled Edit....  In both cases a widow similar to the one below will pop up to further configure the virtual disk device.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleAdd/Edit Virtual Disk Device Window

Image Removed

The following table lists each of the fields in the Add/Edit SCSI Device configuration window and describes their operation.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleAdd/Edit Virtual Disk Device Configuration Fields
FieldDescription
SCSI device type  Virtual Disk or Physical disk...
SCSI bus 
SCSI ID 
SCSI device path 

Add/Edit Virtual CDROM Device

To add a new virtual CDROM device click the button labelled Add...  To adjust an existing virtual disk device, select it from the list of configured devices and click the button labelled Edit....  In both cases a widow similar to the one below will pop up to further configure the virtual CDROM device.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleAdd/Edit Virtual CDROM Device Window

Image Removed

The following table lists each of the fields in the Add/Edit SCSI Device configuration window and describes their operation.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleAdd/Edit Virtual CDROM Device Configuration Fields
FieldDescription
SCSI device name 
SCSI device type  Virtual CDROM ...
SCSI device path  

Add/Edit Virtual Tape Device

To add a new virtual tape device click the button labelled Add...  To adjust an existing virtual disk device, select it from the list of configured devices and click the button labelled Edit....  In both cases a widow similar to the one below will pop up to further configure the virtual tape device.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleAdd/Edit Virtual Tape Device Windows

Image Removed

The following table lists each of the fields in the Add/Edit SCSI Device configuration window and describes their operation.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleAdd/Edit Virtual Tape Device Configuration Fields
FieldDescription
SCSI device name 
SCSI device type  Virtual Disk or Physical disk...
SCSI device path  
Tape image size 
Autoload 

Removing a Virtual Storage Device

To remove a virtual storage device, select the device in the Virtual Machine Settings SCSI configuration window, then click the button labelled Remove.  The device will be removed immediately and the management console does not ask for confirmation.

Note

If the virtual SCSI storage device is attached to a container file the file itself is not removed when the configuration is.

...

To view or change the current virtual machine console configuration, select COM1(OPA0) in the Device column of the left-hand pane.  This will open the COM1(OPA0) configuration window, shown below.  In this example the console is disabled.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine COM1(OPA0) Configuration Window

Image Removed

It is possible to configure the virtual console device in one of three ways by selecting one of three options described below from the drop-down list labelled Type.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine Console Types
TypeDescription
 TCPConfigure the console device as a network device.
Physical Configure the console device as physical terminal directly attached to the host system.
Disable Disable the virtual console device entirely.

The following sections describe the specific configuration details of the physical and network consoles.

Physical Console Device

The image below shows the physical console device configuration window.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine COM1 (OPA0) Physical Device Configuration Window

 Image Removed

The only option for the physical terminal is Device.  This is a drop-down list of all directly attached serial ports available on the host system.

Network Console Device

The image below shows the network console device configuration window.

Image Removed

The following table lists each of the fields in the network console device configuration window and describes their operation.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine Memory Configuration Fields
FieldDescription 
Port

This option specifies the TCP/IP port to user when listening for incoming console client connections.

Note

A different port must be specified for each network console or serial port. Using a port that is already in use will result in the following error messages in the virtual machine log file.

Image Removed

ConsoleSpecify in which way the network console will be viewed.
ConsoleDescription
Built-inThe built-in console is displayed and accessible from the Console tab in the CHARON-AXP/SMA Manager.
ExternalAn external network console device allows an external client (e.g. a telnet client) to attach to the port and interact with the virtual console device.

COM2(TTA0) Configuration

To view or change the virtual machine COM2(TTA0) configuration, select COM2(TTA0) in the Device column of the left-hand pane.

The virtual COM2 or TTA0 serial device can be configured as both a physical or network connected device.  The configuration of this device is very similar to COM1(OPA0).  For further details related to configuring this device, consult the section COM1(OPA0) Configuration.

Ethernet Configuration

To view or change the virtual machine Ethernet configuration, select Ethernet in the Device column of the left-hand pane.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine Ethernet Configuration Window

Image Removed 

To remove an existing virtual Ethernet adapter, select if from the list of configured devices and click the button labelled Remove...

To add a new virtual Ethernet adapter click the button labelled Add...  To adjust an existing virtual Ethernet adapter, select it from the list of configured devices and click the button labelled Edit....  In both cases a widow similar to the one below will pop up to further configure the virtual Ethernet device.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleAdd/Edit Ethernet Adapter Windows

Image Removed

The following table lists each of the fields in the Add/Edit Ethernet Adapter configuration window and describes their operation.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Ethernet Configuration Fields
FieldDescription
Device Select the virtual Ethernet device from the drop-down list. It is possible to configure 4 virtual Ethernet adapters, EWA0 - EWD0.
Adapter The virtual machine supports three types of virtual Ethernet adapter, listed below. The default is DE435.
 DeviceDescription
 DE435DE435 EtherWORKS Turbo PCI Adapter
 DE450DE450 EtherWORKS Turbo PCI 10 Adapter
 DE500DE500-BA FastEtherWORKS 10/100 PCI Adapter
InterfaceSelect the host attached Ethernet device to be connected to the virtual device. This field is a drop-down list of all the network adapters available on the host system.
Set MAC Address

To force the MAC address of the virtual Ethernet device to a specific value, select the checkbox and enter the address as size groups of two character hexadecimal digits, separated by a colon, e.g. 08:00:2b:aa:bb:cc.

Info

This option can be useful in the case where licensing is tied to a network adapter MAC address.

Log Configuration

To view or change the virtual machine logging configuration, select Log in the Device column of the left-hand pane.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine Log Configuration Windows

Image Removed 

The following table lists each of the fields in the log configuration window and describes their operation.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleVirtual Machine Logging Configuration Fields
FieldDescription
Log pathSpecify the path name for the log file.
SeveritySet the minimum level of messages that should be reported. Legal values are debug, info, warning, error and fatal. The default is info.
Output toIndicate where virtual machine logging information should be written to. The default is file.
OptionDescription
fileOutput virtual machine logging information only to the file configured in Log path.
consoleOutput virtual machine logging information only to the virtual machine console.
allOutput virtual machine logging information to both the file configured in Log path and the virtual machine console.

...

To rename a virtual machine, follow the steps shown below.

...

bgColor#ffffff
titleBGColor#f0f0f0
titleRenaming a Virtual Machine

...

Right-click the virtual machine name and select Remove VM from the List.

Image Removed

Info

This action will not ask for any confirmation and the virtual machine will be immediately removed from the list.

...

A new window labelled Open Virtual Machine will appear. To continue:

  • Click the icon labelled Config file name
  • Navigate to configuration file saved from step 2 and click the button labelled Open.

...

Enter the new name of the virtual machine in the field labelled New VM name.

Image Removed

...

There is no confirmation and the newly renamed virtual machine will appear in the left-hand pane.

Note

This process does not rename the configuration file, container files, log files or any other associated files. It simply changes the name of the virtual machine as it appears in the list.

...

The complete removal of a virtual machine must be performed in a number of steps.  Each of these steps is detailed below.

Panel
bgColor#ffffff
titleBGColor#f0f0f0
titleSteps to Remove a Virtual Machine
StepDescription
1.Click the name of the virtual machine that is to be removed in the left hand pane of the management console.
2.Click the button labelled Edit Virtual Machine.
3.

You will be presented with the Virtual Machine Settings window. From here, click on the SCSI Device configuration in the left-hand pane. If any of the SCSI devices are container files, take note of their locations. In the example below, the devices DKA0, DKA100 and MKA600 are all container files.

Image Removed

4.Click the button labelled Cancel to leave the Virtual Machine Settings window.
5.
  • Right-click the name of the virtual machine in the left hand pane of the management console.
  • Select Delete VM from Disk.

Image Removed

Info

The management console does not confirm this action and the configuration and log files are immediately deleted.

6.

Any container files (virtual disk or tape) that were part of the configuration are still present on the system. These should have been noted in step 3. To remove them, either connect to the remote system using SSH or if connected to the console of a CHARON-SSP Virtual Environment system, press Ctrl+WinKey+F12 to open the shell. Navigate to the appropriate path and remove the container files.

...

...put the picture of the COnsole tab in here...

...show how it can be set to external...mention the configuration windows, above...

...need a note about networking and blocking the ports...

...need to be able to bind...

...include an example from the log file indicating what to look for when the port can't be bound...

 

The virtual machine console can be connected to either a physical serial line attached to the host or a network TCP/IP port.  The following sections describe how to attach to these different forms of console.

Physical Access

...