Moving a Server from Your Office to the Customer's Site--
The Five-Minute Guide 

This five-minute guide describes how to move a Sun Ray(TM) demo server, 
which was configured in your office, to a customer's site. 

     Caution - For the Sun Ray demo, set up the Sun Ray server by itself
. 
Do NOT set it up or configure it on SWAN. 

Refer to your configuration worksheet. If you are changing the 
configuration, you need both the old and new configuration information. 


     Note - This five-minute guide uses Sun Ray-specific scripts. If 
     you want to do this manually, see the Sun Ray Enterprise Server 
     Software 1.0 Administrator's Guide. 


Overview 

First, backup your Sun Ray administration data if desired. Then stop 
all the processes, unconfigure the interconnect, and unconfigure the 
Sun Ray server and related software. 

If you are upgrading the software, you need to uninstall the old 
software (see Sun Ray Enterprise Server Software 1.0 Administrator's 
Guide for details).

If appropriate, use the sys-unconfig command to unconfigure the 
Solaris(TM) system and pack it up. Move the server. Reconfigure the
Solaris system using the sysidnet, sysidnis, and sysidsys commands as 
needed. 

If you are upgrading the Sun Ray server software, install the software 
using the Sun Ray Enterprise Server Software 1.0 Installation Guide.

Configure the Sun Ray software and interconnect again, using the 
configuration worksheet. If you have backed up all the administration 
data and you want to restore it, stop the daemons, restore the data and
restart the daemons. If you did a partial backup (users or desktops), 
you can do a batch add using the appropriate command (utuser or 
utdesktop). 

The topics covered in this five-minute guide are:

     Backing Up Administration Data 
     Unconfiguring the Sun Ray Interconnect and Software 
     Moving the Sun Ray Server 
     Configuring the Sun Ray Software 
     Configuring the Sun Ray Interconnect Fabric 
     Restoring the Administration Data 

Unconfiguring the Sun Ray Interconnect and Software 


Backing Up Administration Data 

Before upgrading your Sun Ray server software, you may want to make a 
backup of your existing Sun Ray administration data. 


Note - When upgrading to a new version of the Sun Ray server software, 
you must uninstall the old version of Sun Ray server software, before 
installing the new version. Keep a record of your settings as they are 
lost with the uninstall. 


Do the following if you want to keep existing registered Sun Ray users 
or Sun Ray desktop information.

   
   To Back Up All Your Existing Sun Ray Administration Data 


Make a backup of the directory that contains the SunDS data store for 
Sun Ray administration data. If you used the default installation 
location, this directory is /var/opt/SUNWconn/ldap/dbm.ut. 

 # cd /var/opt/SUNWconn/ldap

 # tar cf /var/tmp/dbm.ut.tar dbm.ut 



If you want to keep only the user information, use the utuser command.

   
   To Back Up Only Your User Data 


   Type the following command to dump the user data to a flat file: 

            % utuser -o /var/tmp/users


If you want to keep only the desktop information, use the utdesktop 
command. 

   To Back Up Only Your Desktop Data 


Type the following command to dump the desktop data to a flat file:

            % utdesktop -o /var/tmp/desktops



Unconfiguring the Sun Ray Interconnect and Software 

This section describes how to unconfigure the Sun Ray interconnect and 
server software.


Note - You must unconfigure the Sun Ray server software before you can 
use uninstall -u to remove the server software. 


In the following instructions you will need to take the values you 
chose in the configuration worksheet and substitute in the appropriate 
places. For example, if you chose @(WEBSERVER_NAME) to be utadmin, when 
substituting into this partial command:

# htserver stop @(WEBSERVER_NAME)

the result would be:

# htserver stop utadmin

   
   To Unconfigure the Sun Ray Interconnect and Server Software 


     1. As root, type: 

      # cd /etc/init.d 



     2. Stop the server:

      # ./utsvc stop 



         The server is stopped. 

     3. Type: 

      # htserver stop @(WEBSERVER_NAME) 



The Sun WebServer instance is stopped. @(WEBSERVER_NAME) is the name of 
the WebServer instance that supports the administration application. 
Refer to the value you chose on your configuration worksheet. 

     4. Stop SunDS: 

      # ./dsserv stop 

      Stopping SunDS daemon 

      SunDS daemon stopped 


     5. Type: 

      # /opt/SUNWut/sbin/utadm -r 



All of the entries and all of the structure relating to all of the Sun 
Ray interfaces are removed. This command prepares the system for the
removal of the Sun Ray server software.

          ### Removing interface "<interface>" 


     6. Begin the unconfiguration process: 

      # /opt/SUNut/sbin/utconfig -u 

      Un-configuration of Sun Ray enterprise server Software 


     7. Answer the question: Unconfigure Sun Web Server 2.1 ([y]/n)? 

This script gives you the option of unconfiguring the Sun Web Server 
2.1 or not. Type y or press Return. 

          Unconfigure Sun Web Server 2.1 ([y]/n)y 


     8. Answer subsequent questions as follows: 


Note - The web server instance name, @(WEBSERVER_NAME), and the CGI 
username, @(CGI_USER), in this example, are the default values: 
utadmin and www). If you entered different values, enter those values 
here. Refer to your configuration worksheet for your original values. 


      Enter UT admin web server instance name [utadmin]: 

      Delete CGI username account ([y]/n)y 

      # Enter CGI username [www)]: www 

      About to un-configure the following software products: 

      Sun Directory Services 3.1 

      Sun Web Server 2.1 

      Sun Ray enterprise server 1.0 

      Continue ([y]/n)y 



     The Sun Ray server unconfiguration process begins. The following 
message is displayed. 

      Removing Sun Ray enterprise server Configuration ... 

      Removing Sun Web Server 'utadmin' instance ... 

      utadmin : Not running. 

      utadmin : Deleted. 

      Deleting user account for 'www' ... 

      www:x:130001:10:ut admin web server cgi user:/tmp:/bin/sh 

      Unloading Sun Directory Services Datastore ... 

      Removing Sun Directory Services Datastore ... 

      Downdating Sun Directory Services ACL's ... 

      Downdating Sun Directory Services schema ... 

      Starting SunDS daemon . 

      Tue Apr 20 16:58 : dsservd starting 

      Un-configuration of Sun Ray enterprise server has completed. 
      Please check the log file,
      /var/tmp/utconfig.xxxxx.log, for errors. 



9. After the script has completed check in /var/tmp/utconfig.xxx.log 
to see if there were any errors. Where xxx is the process id of the 
script. 


Note - If you are upgrading the Sun Ray server software, use the 
utinstall -u command to remove the old Sun Ray server software. See 
the Sun Ray Enterprise Server Software 1.0 Administrator's Guide or 
man page for more detailed information. 



Moving the Sun Ray Server 

If appropriate, use the sys-unconfig command to unconfigure the Solaris
system and pack it up. Move the server. Reconfigure the Solaris system
using the sysidnet, sysidnis, and sysidsys commands as needed. 



Configuring the Sun Ray Software 

The configuration script configures all of the supporting software 
products. Use this script unless you are an experienced system 
administrator and need to customize the configuration. 

   
   To Run the Configuration Script 



     1. As superuser root, type:

      # cd /opt/SUNWut/sbin 

      # ./utconfig 



Note - Fill out the configuration worksheet before continuing. 


     2. Answer the continuation prompt by typing y. 

The configuration script prompts you for values (default values in 
brackets). For example:

      Using hostname: yoyodyne 

      Enter UT root entry [o=utdata]: 

      Using UT root name: utdata (derived from UT root entry) 

      Enter UT admin password: <value> 

      Re-enter UT admin password: <value> 

      Enter SunDS 'rootdn' [cn=admin,o=utdata]: 

      Enter SunDS 'rootdn' admin password: <value> 

      Re-enter SunDS 'rootdn' admin password: <value> 



     3. Answer the prompt for Sun WebServer. 

     Type n if you do not want to configure the Sun WebServer. 

     Type y if you want to configure the Sun WebServer. The 
     configuration script prompts you for values (default values in 
     brackets). For example:

     Enter UT admin web server instance name [utadmin]: 

     Enter UT admin web server port number [1660]: 

     Enter CGI username [www]: 



     The values you have entered are shown. For example:

      About to configure the following software products: 

      Sun Directory Services 3.1 

      Hostname: yoyodyne 


      UT root entry: o=utdata 

      UT root name: utdata 

      UT utdata admin password: (not shown) 

      SunDS 'rootdn': cn=admin,o=utdata 

      SunDS 'rootdn' admin password: (not shown) 

      Sun Web Server 2.1 

      UT admin web server instance name: utadmin 

      UT admin web server port number: 1660 

      CGI username: www 

      Sun Ray enterprise server 1.0 



     4. Answer the continuation prompt by typing y. 

       Once you confirm, the script begins configuring the products and 
       displays on the screen the various operations it performs. 

     5. After the script has completed, check in 
       /var/tmp/utconfig.xxx.log to see if there were any errors. 
       Where xxx is the process id of the script. 

     6. Once the script has successfully finished, see the "Testing the
        Installation and Configuration" section in the Sun Ray 
        Enterprise Server Software 1.0 Administrator's Guide. 



Configuring the Sun Ray Interconnect Fabric 

Run the utadm command to configure the network interface card (NIC) and
the DHCP service for the interconnect fabric, and to enable the Sun Ray
log management function. The default DHCP setup configures each 
interface for 225 hosts and uses private network addresses for the 
Sun Ray interconnect fabric. When you configure the interconnect fabric,
the version of the firmware on the enterprise appliances is 
automatically changed to version of the firmware on the server if the 
versions are different. 


Note - The Sun Ray server software works with other products that use 
DHCP. 



Note - If you have just installed the Ethernet controller, remember to 
boot the server with the -r flag so that the system looks for the new 
interface and creates the appropriate device files. 

   
   To Configure the Interconnect 


     1. Type: 

 # /opt/SUNWut/sbin/utadm -a interface_name   {-a   interface_name} ... 


         Some interface names are hme[0-9], qfe[0-9], or vge[0-9]. 

         For example:

          # /opt/SUNWut/sbin/utadm -a gem0 


A dialog similar to the following is initiated. If the default values 
are acceptable, type y. 

          Configuring the Sun Ray Interconnect Fabric 

          ### Configuring /etc/nsswitch.conf 

          ### Disabling Routing 

          ### configuring gem0 interface at subnet 128 

            Selected values for interface "gem0" 

              host address:    xxx.xxx.xxx.1 

              net mask:        255.255.255.0 

              net address:    xxx.xxx.xxx.0 

              host name:         yoyodyne-128 

              net name:          SunRay-128 

              first unit address: xxx.xxx.xxx.3 

              last unit address: xxx.xxx.xxx.254 

              firmware server: xxx.xxx.xxx.1 

            Accept as is? ([Y]/N): y 

          ### successfully setup "/etc/hostname.gem0" file 

          ### successfully setup "/etc/inet/hosts" file 

          ### successfully setup "/etc/netmasks" file 

          ### successfully setup "/etc/inet/networks" file 

          ### finished install of "gem0" interface 

          ### Building network tables - this will take a few minutes 

          ### Configuring DHCP Service for Sun Ray 


If the default values are unacceptable, respond n, and enter new values.
 
A dialog similar to the following will be displayed. In the dialog 
below, the network is changed from xxx.xxx.xxx to xxx.xxx.xxx and 
configured for a maximum of 14 sessions.

          Configuring the Sun Ray Interconnect Fabric 

          ### configuring /etc/nsswitch.conf 

          ### Disabling Routing 

          ### configuring gem0 interface at subnet 128 

            Selected values for interface "gem0" 

              host address:       xxx.xxx.xxx.1 

              net mask:           255.255.255.0 

              net address:        xxx.xxx.xxx.0 

              host name:          yoyodyne-128 

              net name:           SunRay-128 

              first unit address:  xxx.xxx.xxx.3 

              last unit address:   xxx.xxx.xxx.254 

              firmware server:     xxx.xxx.xxx.1 

          Accept as is? ([Y]/N): n 

            new host address: [xxx.xxx.xxx.1] xxx.xxx.xxx.1 

            new netmask: [255.255.255.0] 

            new first Sun Ray address: [xxx.xxx.xxx.3] 

            new last Sun Ray address: [xxx.xxx.xxx.254] xxx.xxx.xxx.16 

            Selected values for interface "gem0" 

              host address:       xxx.xxx.xxx.1 

              net mask:           255.255.255.0 

              net address:        xxx.xxx.xxx.0 

              host name:          yoyodyne-129 

              net name:           SunRay-129 


              first unit address:  xxx.xxx.xxx.3 

              last unit address:   xxx.xxx.xxx.16 

              firmware server:     xxx.xxx.xxx.1 

          Accept as is? ([Y]/N): y 

          ### successfully setup "/etc/hostname.gem0" file 

          hostname "yoyodyne-129" appears in "/etc/inet/hosts" file 
          with another IP 

          address, fix? ([Y]/N): y 

          ### successfully setup "/etc/inet/hosts" file 

          ### successfully setup "/etc/netmasks" file 

          ### successfully setup "/etc/inet/networks" file 

          ### finished install of "gem0" interface 

          ### Building network tables - this will take a few minutes 

          ### Configuring DHCP Service for Sun Ray 



         The remaining output should be similar to the following:

          ### Configuring DHCP Service for Sun Ray

          ### stopped DHCP daemon

          ### started DHCP daemon

          ### Configuring firmware version for Sun Ray

           All the units served by "yoyodyne" on the xxx.xxx.xxx.0

           network interface, running firmware other than version

  "1.0_4,REV=1999.02.23.20.39" will be upgraded at their next power-on.

          ### Configuring Sun Ray Logging Functions

          syslog service starting.




     2. Reboot the server and power cycle the enterprise appliances. 



Restoring the Administration Data 

Once you have installed and configured the latest Sun Ray software, 
perform the following steps to restore your previous administration 
data.

   
   To Restore All the Administration Data 



     1. Stop the Sun Ray services and the SunDS daemon (note that the 
        order of execution is important). 

      # /etc/init.d/utsvc stop

      # /etc/init.d/dsserv stop 



     2. Move the current Sun Ray administration data store directory 
        to a new location and restore the previous data.

      # cd /var/opt/SUNWconn/ldap

      # mv dbm.ut dbm.ut.orig

      # tar xf /var/tmp/dbm.ut.tar 




     3. Restart the SunDS daemon and Sun Ray services (note that the 
        order of execution is important). 

      # /etc/init.d/dsserv start

      # /etc/init.d/utsvc start 


   
   To Restore Only the User Data 



Note - Be sure you have updated the file if you have changed the 
configuration (for example, by changing the server name or port). 



As root, add the user data to the administration database from the flat
file created when you backed up the data:

            # utuser -af /var/tmp/users


   
   To Restore Only the Desktop Data 




Note - Just plugging a Sun Ray 1 appliance into the interconnect, adds 
it to the administration database. 


As root, type the following command to update the desktop data in the 
administration database from the flat file created when you backed up 
the data:

            # utdesktop -ef /var/tmp/desktops

http://webhome2.eng/iawpubs/5minute/move/moves.html