Previous Next Generated Index Home


10

Removing the Sun Ray Software




This chapter explains how to remove the Sun Ray software from your server. Both script-based and manual removal procedures are provided. This chapter is organized as follows:


Using Scripts to Uninstall the Software

A system administrator can use an unconfiguration script and an uninstall script to remove the Sun Ray server software.

This section describes how to unconfigure and uninstall the Sun Ray 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 worksheet and substitute in the appropriate places. Refer to "Collecting Key Configuration Parameters" on page 40. 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 Server Software

  1. As superuser, type:

# cd /etc/init.d
 

  2. Stop the Sun Ray services:

# ./utsvc stop
 

  The services are 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 worksheet (see "Configuration Worksheet" on page 40).
  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/SUNWut/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. Yes is the default.

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

  8. Answer the question as follows:

Note - The web server instance name, @(WEBSERVER_NAME), and the CGI username, @(CGI_USER), in this example, use the default values: utadmin and www). If you entered different values, enter them here. Refer to your configuration worksheet for your original values (see "Configuration Worksheet" on page 40).
 

Enter UT admin web server instance name [utadmin]: 



Delete CGI username account ([y]/n)y
# Enter CGI username [www)]: utadmin



About to un-configure the following software products:



Sun Directory Services 3.1
Sun Web Server 2.1
Sun Ray enterprise server 1.1



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 'utadmin' ...
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.

 

To Uninstall the Sun Ray Software

This section describes how to use the utinstall -u command to remove the Sun Ray server software.


Note - Your current working directory must not be within any of the directories to be removed. Perform a cd / to your working directory for verification.
  1. Change to your working directory:

# cd /
 

  2. Start the removal process:

# /opt/SUNWut/sbin/utinstall -u
Removal of Sun Ray enterprise server Software
 

  3. Answer the questions as follows:

Remove Sun Directory Services 3.1 ([y]/n)? y



About to remove the following software products:



Sun Ray enterprise server 1.1
Sun Web Server 2.1
Sun Directory Services 3.1
In addition, any running Sun Ray enterprise server services will 
be stopped. All existing sessions will also be cleared out.



Continue ([y]/n)y 
 

  The packages are removed. The following message is displayed:

Removing Sun Ray enterprise server version 1.0 ...



Removal of <SUNWuta> was successful.



Removal of <SUNWutj> was successful.



Removal of <SUNWutm> was successful.



Removal of <SUNWuto> was successful.



Removal of <SUNWutr> was successful.
### successfully removed Sun Ray audio pseudo driver (utadem)
### successfully removed Sun Ray pseudo driver



Removal of <SUNWutk> was successful.



Removal of <SUNWutu> was successful.



Removing Sun Web Server version 2.1 ...
No running servers found.



Removing SWS does not remove your websites or configurations.
Server instances and websites are typically found in /var/http,
although they may be placed anywhere you choose.  See "/etc/http/
httpd-instances.conf" for the master list of server 
configurations.



Checking installed packages and patches...
...Removal of <SUNWsds> was successful.



Removal of <SUNWsdsc> was successful.



Removal of Sun Ray enterprise server has completed, see /var/tmp/
utinstall.xxxxx.log 
#
 

  4. 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.


Manually Uninstalling the Software

Use these procedures to uninstall the Sun Ray server software by using pkgrm. For procedures on how to remove the software using a script, see "Using Scripts to Uninstall the Software" on page 183.


Note - It is highly recommended that you use the utinstall script to remove the Sun Ray server software. Refer to "Using Scripts to Uninstall the Software" on page 183 for additional information.

 

To Remove the Sun Ray Server Software

  1. Become superuser and stop the Sun Ray services:

# /etc/init.d/utsvc stop
 

  2. Remove all of the network interconnects:

# /opt/SUNWut/sbin/utadm -r 
 

  3. Remove the software packages:

# pkgrm SUNWuta SUNWutm SUNWuto SUNWutr SUNWutux SUNWutu SUNWutkx SUNWutk SUNutj
 

  Respond y to each package removal query. The output is similar to the following:

The following package is currently installed:
   SUNWuto      Sun Ray enterprise server Core Software
                   (sun4m,sun4u,sun4d) Alpha4



Do you want to remove this package? y



## Removing installed package instance <SUNWuto>
## Verifying package dependencies.
## Processing package information.
## Removing pathnames in class <none>
/tftpboot/view
/tftpboot/tftpboot
/tftpboot <non-empty directory not removed>
/opt/SUNWut/lib/tftpboot
/opt/SUNWut/lib <shared pathname not removed>
/opt/SUNWut/bin/utfwupgrade
/opt/SUNWut/bin/esdl
/opt/SUNWut/bin <shared pathname not removed>
/opt/SUNWut <shared pathname not removed>
## Updating system information.



Removal of <SUNWuto> was successful.
 


SunDS 3.1 and Sun WebServer 2.1

Refer to the supporting software's documentation (included on the Sun Ray enterprise server software 1.1 CD) for uninstall and unconfigure information.




Previous Next Generated Index Home

Copyright © 2000 Sun Microsystems, Inc. All Rights Reserved.