h1. Introduction
This page will walk you through the installation and configuration of the Sun Unified Storage Simulator using VMware Player for Windows, or VMware Fusion for Macintosh. The PC instructions assume Windows XP or higher. This tutorial also assumes that you have already installed either VMware Player or VMware Fusion as appropriate. The Sun Unified Storage Simulator will work with a future release of Virtual Box (as of 11/08).
h2. Step 1 - Downloading the Simulator
Open your web browser and navigate to [http://www.sun.com/storage/disk_systems/unified_storage/resources.jsp] and then click the link to download the Virtual Machine. You will be taken to the Sun Download Center, where you will accept the license agreement and log into your account to continue. Finally, you will click on the file to download it; save it to a familiar location on your system.
h2. Step 2 - Installing the Simulator
The Simulator is distributed in a .zip file format. The first step is to unzip the archive and install the components on your system.
To do this on a PC:
# Open the file using your favorite .zip utility, or the one built-in to Windows
## On Windows XP, unzip the contents to c:\Documents and Settings\<Username>\My Documents\My Virtual Machines
## On Windows Vista, unzip the contents to c:\Users\<Username>\Documents\Virtual Machines
To do this on a Macintosh:
# Click on the file 'SunStorageVMware.zip' to expand it into the same folder you downloaded it to. You will see a progress bar as the file extracts
# You can move the uncompressed contents to a different location if you'd like, or you can continue below
\\
h2. Step 4 - Starting the Unified Storage Simulator
Now let's start VMware and open the Simulator.
To do this on a PC:
# Click Start, Program Files, VMware, VMware Player
# Open the Simluator by clicking 'Open' and navigating to the location where you unzipped the virtual machine and selecting Sun Storage VMware.vmx
# VMware detects that that the machine is running on a new host and asks whether it has been moved or copied. Click on copied to continue
To do this on a Macintosh:
# Navigate to the location of the uncompressed file, and double click it to launch VMware Fusion with the new VM running
# VMware detects that that the machine is running on a new host and asks whether it has been moved or copied. Click on copied to continue
h2. Step 5 - Configuring your Unified Storage Simulator
\\
Once you've completed the steps above, the system will begin booting. You may see a warning about 'longmode' while booting, you can click OK to ignore this warning. When it's ready, you'll see a message that says:
{noformat}
Press any key to begin configuring appliance: [*]
{noformat}
At this point, you can click into the VMware window to direct input to the Virtual Machine. You can escape this mode using CTRL-Apple on a Macintosh or CTRL-ALT on a PC. Direct your input the the virtual machine, and press a key to continue. You will be looking at a screen titled 'Sun Storage VMware Configuration. Your cursor will be in the 'Host Name' field. Press the 'Up' arrow to navigate to the network interface selection field near the top of the screen. You can see that the instructions near the bottom of the screen indicate that you can use the 'j' key to navigate left, and the 'k' key to navigate right. Press 'k' once to select NET-1, the second network interface. The fields below will refresh to look something like this:
\\
{noformat}
Host Name: unknown
DNS Domain: localdomain
IP Address: <some IP address>
IP Netmask: 255.255.255.0
* Default Router:
DNS Server: <some IP address>
* Password:
* Re-enter Password:
{noformat}
The IP address scheme will be different as VMware creates it randomly when you install VMware Player or Fusion. Use the down arrow to navigate to the Default Router field and set it to the same address as the DNS server. Use the same process to fill in the password and re-enter password field. When complete, press the ESC and 1 keys at the same time to continue. The system will apply your settings and display a screen showing a URL similar to this one.
{panel}
https://<someIPaddress>:215/
{panel}
Escape the VMware input by using the CTRL-Apple or CTRL-ALT keys as described above.
h2. Step 5 - Connecting to your USS and Completing the Setup Wizard
\\
You're almost done with setup, go into your web browser and type the URL from the final console screen into the address bar. You can now complete the wizard to finish your setup. If you're running VMware Workstation or Fusion, now would be a good time to take a snapshot in case things go wrong later.
\\
h2. Step 6 - Now the demo fun can begin!
\\
The USS VM provides 15 2GB LUNs to play with. a) If you haven't configured a storage pool (in above setup), do it now usin the USS Wizard by going to Configuration\-\->Storage\-\-Configure. Pick a storage configuration Type: RAID, Double Raid, Mirrored, Striped, etc. Watch how the various areas of the screen change as you change selections to tell you how much space will be available and other trade-offs. b) (This is for MAC, but you should be able to do the same with a CIFs example). Go to Configuration Services and turn on NFS. Then go to Shares\-\-\-+Filesystems and add a filesystem for sharing, name it (uss1 for my example) and open up all the permissions. This will cause an NFS share called /export/uss1 to begin being served by your USS VM. c) Open up a MAC OS terminal and "mkdir /uss1"; then mount the USS VM filesystem: "sudo mount_nfs 192.168.1.111:/export/uss1 /uss1". From the Mac terminal you can do a df -h and see the mount. Next copy a large file from the Mac to the NFS mount, like: "cp sol-10-u6-ga1-sparc-dvd.iso /uss1" (a large file allows time to watch the USS Status and Analytics screens). d) Things may start moving slowly now...your HW to do a lot of work on real and virtualized OS's. Go to the USS browser GUI, click on Status and watch the various graphs. e) Next click on Analytics\-\->+Add A Statistic\-\->NFSv3\-\->Broken Down By Client. You only have one NFS client, your Mac's IP address will show up there\-\-but if you had multiple NFS clients, it would be easy to see who is the hog. Hit Close. f) Next, still under Analytics, do a +Add A Statistic\-\->NFSv3\-\->Broken Down By File Name. And there's the file name being written that is causing all the fuss, in my case, sol-10-u6-ga1-sparc-dvd.iso. Try other features and share them here.
\\
This page will walk you through the installation and configuration of the Sun Unified Storage Simulator using VMware Player for Windows, or VMware Fusion for Macintosh. The PC instructions assume Windows XP or higher. This tutorial also assumes that you have already installed either VMware Player or VMware Fusion as appropriate. The Sun Unified Storage Simulator will work with a future release of Virtual Box (as of 11/08).
h2. Step 1 - Downloading the Simulator
Open your web browser and navigate to [http://www.sun.com/storage/disk_systems/unified_storage/resources.jsp] and then click the link to download the Virtual Machine. You will be taken to the Sun Download Center, where you will accept the license agreement and log into your account to continue. Finally, you will click on the file to download it; save it to a familiar location on your system.
h2. Step 2 - Installing the Simulator
The Simulator is distributed in a .zip file format. The first step is to unzip the archive and install the components on your system.
To do this on a PC:
# Open the file using your favorite .zip utility, or the one built-in to Windows
## On Windows XP, unzip the contents to c:\Documents and Settings\<Username>\My Documents\My Virtual Machines
## On Windows Vista, unzip the contents to c:\Users\<Username>\Documents\Virtual Machines
To do this on a Macintosh:
# Click on the file 'SunStorageVMware.zip' to expand it into the same folder you downloaded it to. You will see a progress bar as the file extracts
# You can move the uncompressed contents to a different location if you'd like, or you can continue below
\\
h2. Step 4 - Starting the Unified Storage Simulator
Now let's start VMware and open the Simulator.
To do this on a PC:
# Click Start, Program Files, VMware, VMware Player
# Open the Simluator by clicking 'Open' and navigating to the location where you unzipped the virtual machine and selecting Sun Storage VMware.vmx
# VMware detects that that the machine is running on a new host and asks whether it has been moved or copied. Click on copied to continue
To do this on a Macintosh:
# Navigate to the location of the uncompressed file, and double click it to launch VMware Fusion with the new VM running
# VMware detects that that the machine is running on a new host and asks whether it has been moved or copied. Click on copied to continue
h2. Step 5 - Configuring your Unified Storage Simulator
\\
Once you've completed the steps above, the system will begin booting. You may see a warning about 'longmode' while booting, you can click OK to ignore this warning. When it's ready, you'll see a message that says:
{noformat}
Press any key to begin configuring appliance: [*]
{noformat}
At this point, you can click into the VMware window to direct input to the Virtual Machine. You can escape this mode using CTRL-Apple on a Macintosh or CTRL-ALT on a PC. Direct your input the the virtual machine, and press a key to continue. You will be looking at a screen titled 'Sun Storage VMware Configuration. Your cursor will be in the 'Host Name' field. Press the 'Up' arrow to navigate to the network interface selection field near the top of the screen. You can see that the instructions near the bottom of the screen indicate that you can use the 'j' key to navigate left, and the 'k' key to navigate right. Press 'k' once to select NET-1, the second network interface. The fields below will refresh to look something like this:
\\
{noformat}
Host Name: unknown
DNS Domain: localdomain
IP Address: <some IP address>
IP Netmask: 255.255.255.0
* Default Router:
DNS Server: <some IP address>
* Password:
* Re-enter Password:
{noformat}
The IP address scheme will be different as VMware creates it randomly when you install VMware Player or Fusion. Use the down arrow to navigate to the Default Router field and set it to the same address as the DNS server. Use the same process to fill in the password and re-enter password field. When complete, press the ESC and 1 keys at the same time to continue. The system will apply your settings and display a screen showing a URL similar to this one.
{panel}
https://<someIPaddress>:215/
{panel}
Escape the VMware input by using the CTRL-Apple or CTRL-ALT keys as described above.
h2. Step 5 - Connecting to your USS and Completing the Setup Wizard
\\
You're almost done with setup, go into your web browser and type the URL from the final console screen into the address bar. You can now complete the wizard to finish your setup. If you're running VMware Workstation or Fusion, now would be a good time to take a snapshot in case things go wrong later.
\\
h2. Step 6 - Now the demo fun can begin!
\\
The USS VM provides 15 2GB LUNs to play with. a) If you haven't configured a storage pool (in above setup), do it now usin the USS Wizard by going to Configuration\-\->Storage\-\-Configure. Pick a storage configuration Type: RAID, Double Raid, Mirrored, Striped, etc. Watch how the various areas of the screen change as you change selections to tell you how much space will be available and other trade-offs. b) (This is for MAC, but you should be able to do the same with a CIFs example). Go to Configuration Services and turn on NFS. Then go to Shares\-\-\-+Filesystems and add a filesystem for sharing, name it (uss1 for my example) and open up all the permissions. This will cause an NFS share called /export/uss1 to begin being served by your USS VM. c) Open up a MAC OS terminal and "mkdir /uss1"; then mount the USS VM filesystem: "sudo mount_nfs 192.168.1.111:/export/uss1 /uss1". From the Mac terminal you can do a df -h and see the mount. Next copy a large file from the Mac to the NFS mount, like: "cp sol-10-u6-ga1-sparc-dvd.iso /uss1" (a large file allows time to watch the USS Status and Analytics screens). d) Things may start moving slowly now...your HW to do a lot of work on real and virtualized OS's. Go to the USS browser GUI, click on Status and watch the various graphs. e) Next click on Analytics\-\->+Add A Statistic\-\->NFSv3\-\->Broken Down By Client. You only have one NFS client, your Mac's IP address will show up there\-\-but if you had multiple NFS clients, it would be easy to see who is the hog. Hit Close. f) Next, still under Analytics, do a +Add A Statistic\-\->NFSv3\-\->Broken Down By File Name. And there's the file name being written that is causing all the fuss, in my case, sol-10-u6-ga1-sparc-dvd.iso. Try other features and share them here.
\\