OpenSolaris 2008.11 Toshiba Notebook Software Recovery and Release Notes

UseOpenSolaris

OPENSOLARIS 2008.11 TOSHIBA NOTEBOOK SOFTWARE RECOVERY AND RELEASE NOTES

How to Install the OpenSolaris 2008.11 OS From the Live CD
How to Install Supplemental Software Packages (CLI)
How to Install Supplemental Software Packages (GUI)
How to Add the User Contributions Repository to the List of Repositories
Toshiba Notebook Release Notes

For information about known problems, see the Toshiba Notebook Release Notes.

Should you experience problems with your Toshiba M10 or R600 notebook that require you to start over, use this document to help you recover the OpenSolaris™ 2008.11 preinstalled image.

To recover the preinstalled OpenSolaris software and supplementary software packages, you must reinstall the notebook. See How to Install the OpenSolaris 2008.11 OS From the Live CD, How to Install Supplementary Software Packages (CLI), and How to Install Supplementary Software Packages (GUI).

How to Install the OpenSolaris 2008.11 OS From the Live CD

This procedure describes how to recreate the software installation performed at the Toshiba factory. If you want to reinstall the notebook in a different way, see Getting Started With OpenSolaris 2008.11.

After the OpenSolaris 2008.11 OS is installed on your system, install the supplementary software packages as described in How to Install Supplemental Software Packages.

1. Insert the OpenSolaris 2008.11 Live CD into the CD drive, and boot.

Press F12 to get the boot device menu, and choose the CD device.
2. Select the Installer icon from the Live CD desktop to begin installing the OpenSolaris OS on the entire disk.

You can also access the Getting Started With OpenSolaris 2008.11 guide by selecting the Getting Started icon from the Live CD desktop.
3. Confirm your installation choices, and click Install.
4. After the installation completes, select Reboot and eject the Live CD from the CD drive.

top

How to Install Supplemental Software Packages (CLI)

This procedure shows how to use the pkg command to install software packages. For more information, see OpenSolaris 2008.11 Image Packaging System Guide. For information about using the Package Manager tool, see How to Install Supplemental Software Packages (GUI).

Note - Be sure to install all of the supplemental software components from the various repositories, instead of downloading and installing the software from other web sites.

The following lists the IPS package name associated with the software component to be installed, as well as a pointer to more information about the software component:

Software Content	Source/IPS Package	For More Information
OpenSolaris 2008.11	Live CD plus `SUNWgnome-meeting`	opensolaris.com/learn/
Java™ SE Development Kit (includes Glassfish, NetBeans™ IDE, and Sun™ Studio Express)	`java-dev`, `ss-dev`	java.sun.com/javase/ glassfish.dev.java.net/ netbeans.org/ developers.sun.com/sunstudio/
Web Stack	`amp-dev`	opensolaris.org/os/project/webstack/
OpenOffice	`openoffice`	openoffice.org/
Sun xVM VirtualBox	`virtualbox`, `virtualbox/kernel`	virtualbox.org/
Adobe^® Flash Player	`web/firefox/plugin/flash`	adobe.com/products/flashplayer/

Note - The software versions listed in this table are the versions that were preinstalled on the notebook. When you get these packages from the repository, you will get the latest versions available.

1. Install each package by name.

Type the following at the command line prompt:

$ pfexec pkg install pkg-name

For each software package you want to install, replace pkg-name with the IPS package name associated with the software component shown in the supplemental software components table.

2. Obtain the key and certificate that are required to access the repository that holds the Sun xVM VirtualBox and Adobe Flash Player software packages.
3. Associate the key and certificate with the pkg.sun.com/opensolaris/extra repository.
4. Install the Sun xVM VirtualBox and the Adobe Flash Player software packages.

Use the pkg command, type the following at the command line prompt:

$ pfexec pkg install pkg-name

For each software package you want to install, replace pkg-name with the IPS package name associated with the Sun xVM VirtualBox and Adobe Flash Player software components shown in the supplemental software components table.

top

How to Install Supplemental Software Packages (GUI)

This procedure shows how to use the Package Manager tool to install software packages. For more information, see OpenSolaris 2008.11 Image Packaging System Guide. For information about using the pkg tool, see How to Install Supplemental Software Packages (CLI).

Note - Be sure to install all of the supplemental software components from the various repositories, instead of downloading and installing the software from other web sites.

1. Click the Package Manager icon on the desktop to start the tool.
2. Select each package that you want to install.

For each software package that you want to install, select the IPS package name associated with the software component shown in the supplemental software components table.

Note - The Sun xVM VirtualBox and Adobe Flash Player software must be installed from the extra repository.
3. Click Install/Update to begin the installation.

Follow the instructions to complete the installation.
4. (Optional) Prepare to install the Sun xVM VirtualBox and Adobe Flash Player software packages.

Perform Steps 2 and 3 of How to Install Supplemental Software Packages (CLI).

Skip this step if you already have the key and certificate associated with the extra repository.
5. Select the extra software repository from the Repository menu.
6. Select the Sun xVM VirtualBox and the Adobe Flash Player software packages from the list.

Use the IPS package name associated with the Sun xVM VirtualBox and Adobe Flash Player software components shown in the supplemental software components table.
7. Click Install/Update to begin the installation.

Follow the instructions to complete the installation.

top

How to Add the User Contributions Repository to the List of Repositories

The user contributions repository contains packages that users have contributed to the OpenSolaris release. To install packages from this repository, perform these steps either by using the pkg command or the Package Manager tool.

• Use the pkg command to make the repository available:

$ pfexec pkg set-authority -O http://pkg.opensolaris.org/contrib contrib

• Use the Package Manager tool to make the repository available:

1. Select File -> Manage Repositories.
2. Specify the URL and name of the repository.

The URL is http://pkg.opensolaris.org/contrib. The name is contrib.
4. Click Add.
5. Close the Manage Repositories window.

Package Manager will refresh its catalog of contents.
6. Select the new contribution repository from the Repository menu, and select the software to install.

top

TOSHIBA NOTEBOOK RELEASE NOTES

The following problems have been seen on the Toshiba M10 and/or R600 notebook models that are running the OpenSolaris 2008.11 release:

Changing the Power State While the System is Suspended Will Crash Upon Resume

Description:

Do not change the power state (plugged in or unplugged) of a suspended system, as the system will hang upon resume (CR 6769844).

Workaround:

Do not unplug (or replug) the system while it is suspended.

Note - A fix for this problem is available from the support repository. Update the system by using the Package Manager or by running the pkg image-update command. The updates are in the SUNWcakrx.i, SUNWcakr.i, and SUNWckr packages.

For information about using the support repository, see “Associating a Key and Certificate With a Repository” in the OpenSolaris 2008.11 Image Packaging System Guide.

`sys-unconfig` Corrupts System Configuration Data!

Description:

Do not use the sys-unconfig utility!

The sys-unconfig utility is not supported for use by OpenSolaris systems. If used, it will corrupt system configuration data and will leave the system in an unknown state.

If you want to configure the system with a static IP address, see Configuring the OpenSolaris OS With a Static IP Address.

Workaround:

To recover your system, reinstall the OS from the Live CD and the supplementary software components from the OpenSolaris repositories.

See How to Install the OpenSolaris 2008.11 OS From the Live CD, How to Install Supplementary Software Packages (CLI), and How to Install Supplementary Software Packages (GUI).

Configuring the OpenSolaris OS With a Static IP Address

Description:

The OpenSolaris OS comes with a default network configuration for a DHCP client. To use a static IP address instead, perform the additional configuration steps described in the workaround.

Workaround:

Perform the following steps from a terminal window to configure a static IP address:

1. In the terminal window, manually enable the default network interface:

svcadm enable physical:default
2. In the terminal window, disable the network automagic interface:

svcadm disable physical:nwam
3. Open the network configuration panel from the System->Administration->Network menu and do the following:
1. a. Click Manual to disable Automatic mode
2. b. Select the network connection to be configured
3. c. Click Properties
4. d. Set the values you want in the Interface Properties panel
5. e. Enable the device by setting the IP address, subnet, and default gateway
4. In the terminal window restart the network services:

svcadm restart milestone/network

OpenSolaris 2008.11 Might Hang on Toshiba Notebooks When Virtualization is Enabled

Description:

The system fails to boot OpenSolaris 2008.11 when virtualization is enabled in the BIOS. You might also see USB device errors during boot when virtualization is enabled.

Workaround:

Do one of the following:

• Enter the BIOS by pressing Esc during boot, and then pressing F1 when prompted. The Virtualization Technology option is in the OTHERS configuration pane on the right-hand side of page 1 of the BIOS system setup. Press O to select the OTHERS pane and use the down arrow key to move down and select the Virtualization Technology setting. Set it to Disabled and press the END key to save changes and reboot the machine.
• When the GRUB menu appears, press E to enter edit mode. Move the cursor to the line that begins with kernel$ and press E to edit the line. Append the following to the kernel$ line in the GRUB menu.lst:

-B intel-iommu=no

Press Enter to save the modified line, and then press B to boot from the updated line.

To make this change permanent, log in to the OpenSolaris system and run the following command from a terminal window:

$ pfexec vi /platform/i86pc/kernel/drv/rootnex.conf

Append the following line to the end of the rootnex.conf file:

intel-iommu="no";

The system will no longer attempt to start the IOMMU and should boot normally on subsequent boots.

For information about using the support repository, see “Associating a Key and Certificate With a Repository” in the OpenSolaris 2008.11 Image Packaging System Guide.

Network Automagic (NWAM) Might Cycle Endlessly Between Wired and Wireless Devices

Description:

Unable to connect to the internet because NWAM continuously cycles between the configured wireless and disconnected wired devices. NWAM might show the local wifi network and then disconnect and try to use the wired device, which is not connected.

Workaround:

Select the Always Use Wireless Network Interface (iwh0) menu entry to force the use of the wireless device regardless of the state of the wired device. Note that this only lasts until the next reboot cycle or restart of NWAM.

For information about using the support repository, see “Associating a Key and Certificate With a Repository” in the OpenSolaris 2008.11 Image Packaging System Guide.

SD Cards Might Not Work on the Toshiba M10 or R600 Notebook

Description:

The Toshiba M10 or R600 notebook might experience problems with SD cards (CR 6769845).

Workaround:

Check the repository for the latest SD card software to ensure that you are running the most current version.

For information about using the support repository, see “Associating a Key and Certificate With a Repository” in the OpenSolaris 2008.11 Image Packaging System Guide.

Fn+F5 Does Not Toggle Video Output Between Integrated LCD Display and External Video Ports on the Toshiba M10 and R600 Notebooks

Description:

Pressing the Fn+F5 key sequence to cycle through video output modes (internal LCD, LCD+CRT, and CRT) does not work.

Workaround:

Use the Shift+F5 key sequence to toggle through the video outputs on the Toshiba R600 notebook.

For information about configuring a Toshiba M10 notebook to use multiple screens, see Configuring Multiple Screens on the Toshiba M10 Notebook With NVIDIA Graphics.

Video Switch Might Not Work With the Default BIOS Setting on the Toshiba R600 Notebook

Description:: Pressing Shift+F5 enables you to toggle through the video outputs in sequence: LCD, LCD+external, external.
Workaround:: Toshiba R600 notebook only - Enter the BIOS by pressing Esc during boot, and then pressing F1 when prompted. Press PgDn to go to the second system setup page. The DISPLAY configuration pane is on the bottom left-hand side. Press D to select the Power On Display setting and change it to LCD+Analog RGB. Press the END key to save changes and reboot the machine.

Toshiba R600 Notebook Transflective Display Button Does Not Work

Description:: The Transreflective button is near the top right corner of the Toshiba R600 notebook keyboard, just below the LCD display hinge. When pressed, this button turns off the LCD backlight to improve screen visibility if the system is operating in bright sunlight.
Workaround:: Use the Fn+F6 key sequence to reduce LCD brightness when working in bright sunlight.

After Suspend/Resume Operation, External Display Devices Might Not “Light Up” on the Toshiba R600 Notebook

Description:

When you use the Shift+F5 key sequence to configure an external display device and then perform a suspend/resume operation, the external video outputs might not “light up” after the resume.

Perform the workaround if your system has the following symptoms:

• The internal LCD looks fine
• The external monitor or projector does not resume (the screen is dark)

Note - The Toshiba M10 does not support external displays.

Workaround:

Press the Fn+F6 or Fn+F7 key to “wake up” the external video port.

White Border Might Appear Around Menus When Compiz is Enabled on the Toshiba R600 Notebook

Description:

If “Visual Effects” are enabled (Normal, Extra, or Custom), windows might appear to have a white border around them instead of drop shadows.

Workaround:

Perform the following steps:

1. Open the Appearance Preferences panel by doing one of the following:
- • Right-click the background and select Appearance Preferences
- • Select System->Preferences->Appearance from the desktop menu
2. Left-click the Preferences button near the Custom option
3. Left-click Window Decoration to open the CompizConfig Settings Manager
4. Change the Shadow Radius setting to 8.5
5. Click Back
6. Click Close to exit the CompizConfig Settings Manager
7. Click Close to exit the Appearance Preferences panel

Audio Might Not Work on the Toshiba R600 Notebook

Description:

If you attempt to use the audio device and you get no audio output, check to see whether the following occur on your system:

• The speaker control icon in the upper right-hand corner of the menu has a red line through it
• The following error messages are logged in the /var/adm/messages file:

audiosup: [ID 718941 kern.warning] WARNING: audiohd0: init_controller() no codec exists audiosup: [ID 592854 kern.warning] WARNING: audiohd0: audiohd_attach() couldn't init controller

If your system has these symptoms, perform the workaround.

Workaround:

Enter the BIOS by pressing Esc during boot, and then pressing F1 when prompted. Press PgDn to go to the second system setup page. The CONFIGURATION pane is on the upper left-hand corner. Press O to select the Device Config setting and change it to All Devices. Press the END key to save changes and reboot the machine.

Sun xVM VirtualBox Update Problem on Toshiba Notebooks

Description:

Some applications have an automatic update feature that notifies users when new software updates are available. This feature might attempt to download and install SVR4-style packages rather than the IPS-style packages that are required by the OpenSolaris OS.

Note - The Sun xVM VirtualBox automatic update feature attempts to download and install SVR4-style packages.

SVR4-style packages are not compatible with the IPS-style packages that are installed on the OpenSolaris system.

Workaround:

Check the OpenSolaris repository for the latest software updates. For more information about accessing the VirtualBox software from the extra repository, see How to Install Supplemental Software Packages (CLI) or How to Install Supplemental Software Packages (GUI).

Do not use the VirtualBox automatic update feature to install new software versions!

OpenSolaris Only Blanks Screen on Lid Close

Description:

By default, OpenSolaris only blanks the screen when the lid of the notebook is closed while attached to AC power (CR 6060).

Workaround:

Go to System menu -> Preferences -> Power Management.

Ensure that the On AC Power tab is selected. In the Actions section, change When Notebook Lid Is Closed from Blank Screen to Suspend.

Xserver Display Output is Not Centered Onscreen

Description:

On boot, the login window (and the window manager after login) might appear off center as if it is trying to run in a window smaller than the native resolution of the built-in display (CR 6635155).

Workaround:

After logging in, open a terminal window and run the following command to resize your session to the full screen:

$ xrandr --output TV --off

Sometimes Shutdown Might Take a Very Long Time to Complete

Description:: Sometimes the shutdown process takes a long time to complete. The screen might turn white for an extended period of time and some messages might appear on the console.
Workaround:: This is a known problem. No workaround is available at this time. These messages are a part of the shutdown process and can be ignored.

Multiboot Systems are Not Supported

The following CRs describe the issues that have been encountered trying to use multiple operating systems with the OpenSolaris system:

CR 1161 – Solaris partition is not created on the largest usable chunks of unallocated space
CR 6748583 – FAT32/USB Filenames Change to All Caps
CR 6791642 – Unable to browse CIFS share using \\servername.fqdn
CR 6651842 – Need support for NTFS mounts

Known Problems With Function Key Sequences and Volume Wheel on Toshiba Notebooks

The following known problems might occur on Toshiba notebooks:

CR 6744016 – Lock sequence (Fn+F1) does not work
CR 6744026 – Power management profile sequence (Fn+F2) does not work
CR 6744028 – Initiate standby mode sequence (Fn+F3) does not work
CR 6744029 – Initiate hibernation mode sequence (Fn+F4) does not work
CR 6744030 – Video output modes sequence (Fn+F5) does not work, use Shift+F5 instead
CR 6744034 – Turn off wireless sequence (Fn+F8) does not work
CR 6744036 – Turn off touchpad sequence (Fn+F9) does not work
CR 6746963 – Volume control wheel does not work

Toshiba M10 and R600 Notebook BIOS Updates Available

You can access these BIOS updates from the Toshiba support web site.

Create a bootable CD by burning the ISO image directly on your CD.

Some UK Systems Might Be Configured With the US Keyboard Layout

Description:

Some UK systems might have been incorrectly configured to use the US keyboard layout. In such cases, when you type a character, the expected output might not appear on the display.

Workaround:

Do one of the following:

• During the initial notebook setup, skip the step to create an account password, or create a password that only uses simple alphabetic characters and numbers, no symbols.
• After initial notebook setup and boot, ensure that your account password contains only simple alphabetic characters and numbers, no symbols. Use the passwd command to change your password, if necessary.

Caution – Do not create a password that includes any special characters or symbols until after you change the keyboard layout, or you will be unable to log in to your system.

1. Open a terminal window.

Click the terminal icon in the top menu bar, or click Applications -> Accessories -> Terminal.
2. Configure the UK keyboard.

In the terminal window, issue the pfexec gedit /etc/default/kbd command. Scroll to the bottom of the file and change the line LAYOUT=US-English to LAYOUT=UK-English. Then, use Select File -> Save to save the changes.
3. Reboot for the changes to take affect.

Click System -> Log Out.

When you log in, the system is using the UK Keyboard layout.
4. (Optional) Create or change your password.

If you skipped the step to create a password, or if you want to change your password, run the passwd command in a terminal window.

top

UseOpenSolaris