[V5.1 and later]Manually uninstalling on Solaris platforms

This task describes uninstalling the product on the Solaris operating platform.

 

Overview

Use the following procedure to remove all remnants of a WebSphere Application Server product. This produces a clean system that allows you to reinstall the product. Verify that you are removing only the product instance that you intend to remove and not coexisting products, or products that you might have migrated and do not intend to delete. It is important to know the installation root directory for the product instance that you are removing.

 

Overview

Uninstall WebSphere Application Server products in the following sequence when you are uninstalling more than one product:

  1. [V5.1 and later]WebSphere Business Integration Server Foundation on Network Deployment

  2. WebSphere Application Server Network Deployment

  3. [V5.1 and later]WebSphere Business Integration Server Foundation on the base product

  4. WebSphere Application Server (base product)

In the following steps:

  1. Use the killall -9 java command to kill all Java processes that are running.

    If there are Java processes running that are not related to WebSphere Application Server products, and it is not possible to stop them, stop all WebSphere Application Server product-related processes. Use the following command to determine all processes that are running:

    ps -ef | grep java
    Stop all WebSphere Application Server-related processes with the kill -9 java_pid_1 java_pid_2...java_pid_n command.

  2. Halt any running WebSphere MQ queue managers.

    1. Type dspmq to show the state of any queue managers.

    2. Type endmqm -i for each running queue manager.

    3. Type $ ipcs -a to check for any IPCs.

    4. Type $ ipcrm -[qms] [ID] to delete the IPCs.

  3. Issue the following command to stop any MQ processes that are running.

    kill -9 amq_pid_1 amq_pid_2 ... amq_pid_n

  4. Search for related packages.Type the following commands from any directory to search for related packages:

    • pkginfo | grep WS to show packages for WebSphere Application Server products and the IBM HTTP Server product

    • pkginfo | grep wemps to show packages related to the embedded messaging feature or to IBM WebSphere MQ. You can delete these packages.

    • pkginfo | grep mqm to show packages related to the embedded messaging feature or to IBM WebSphere MQ.

      Do not remove IBM WebSphere MQ packages if you have installed IBM WebSphere MQ as a separate product.

    If no packages appear when using these commands, skip the next step.

  5. Change directories to the directory where package information is registered.

    cd /var/sadm/pkg 

  6. Issue the following command to remove any WebSphere Application Server-related packages.

    Do not remove packages for WebSphere Application Server products that you are not uninstalling. You can identify packages that belong to V5.1 by the 51 on the end of WSB packages and WSN packages. WSBM and WSNM packages are for the embedded messaging feature.

    pkgrm packagename1 packagename2 packagename3 ...

    Do not remove embedded messaging packages if you intend to leave the embedded messaging feature installed on the machine.

    Do not remove mqjava, mqm-upd04, or mqm packages if you have installed IBM WebSphere MQ as a separate product. If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, which is based on WebSphere MQ, do not remove the embedded messaging or mqjava, mqm-upd04, or mqm packages or directories.

    If you do not have IBM WebSphere MQ installed as a separate product on this machine, and if you do not have the embedded messaging server and client feature installed on this machine, you can remove wemps packages.

    Remove the mqm package last, or you cannot remove any other embedded messaging feature packages. You will have to reinstall the embedded messaging feature to remove the packages. If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not remove the embedded messaging packages or directories.

    If you do intend to remove WebSphere MQ or embedded messaging packages, include the packages in the commands you are running to remove packages. For example, issue the following command as root to remove the embedded messaging feature:

    pkgrm wemps mqjava mqm-upd04 mqm
    Reply y[es] to all prompts.

    Alternatively, you can be in any directory and use the pkginfo command to remove any package, such as those that begin with wemps:

    pkginfo | grep wemps | awk '{print $2}' | xargs -i pkgrm -n {}
    

    Issue the following commands from the /var/sadm/pkg directory to search for and remove any WebSphere Application Server product-related packages that are registered in the /var/sadm/pkg directory:

    1. Verify that you are in the correct directory: cd /var/sadm/pkg

    2. ls |grep WSB|xargs -i pkgrm -n {} for the base WebSphere Application Server product.

      A known problem in ISMP causes ISMP to rename some packages that begin with WS to begin with ISWS instead. You can safely remove all ISWS packages as well.

    3. ls |grep WSN|xargs -i pkgrm -n {} for the Network Deployment product

    4. ls |grep WSC|xargs -i pkgrm -n {} for the WebSphere Application Server Java client

    5. ls |grep wemps|xargs -i pkgrm -n {} for the WebSphere embedded messaging publish and subscribe function

    6. ls |grep mqjava|xargs -i pkgrm -n {} for IBM WebSphere MQ

    7. ls |grep mqm|xargs -i pkgrm -n {} for IBM WebSphere MQ

    If there is a problem removing the packages, remove the related package directories in the /var/sadm/pkg directory, including the preremoval files. For example, remove the following file before issuing the pkgrm -n WSEAA51 command:

    /var/sadm/pkg/WSEAA51/install/preremoval

  7. Issue the following command to remove WebSphere Application Server directories in the /opt/WebSphere/AppServer installation root.

    rm -rf /opt/WebSphere/AppServer/ 

    Do not remove installation root directories for products that you intend to keep.

  8. Issue the following command to remove multiple directories.

    rm -rf /opt/WebSphere/AppServer/ /opt/WebSphere/DeploymentManager/
    Again, do not remove directories for products that you intend to keep.

  9. Issue the following command if you are certain that there is no embedded messaging data to preserve.

    rm -fr /var/wemps /opt/wemps

    If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not remove the embedded messaging packages or directories.

  10. Issue the following command to delete the IBM HTTP Server directory.

    rm -rf IBMHttpServer

  11. If you do not have IBM WebSphere MQ installed as a separate product on this machine, and if you do not have the embedded messaging server and client feature installed on this machine, issue the following command if you are certain that there is no embedded messaging data to preserve.

    If you have other instances of WebSphere Application Server products on the same machine, and if they use the embedded messaging feature, do not remove the embedded messaging packages or directories.

    rm -fr /var/mqm /opt/mqm

    If you installed IBM WebSphere MQ as a separate product on this host to use as the messaging provider, and if you do not want to continue using WebSphere MQ, you can uninstall the product as described in the WebSphere MQ information.

 

Results

When the process completes, the product is completely uninstalled. You are now ready to reinstall.

 

Example

Example of displaying package names beginning with mqm, for the embedded messaging feature

pkginfo |grep mqm

application mqm            WebSphere MQ for Sun Solaris

Example of displaying package names beginning with wemps, for the embedded messaging feature

pkginfo |grep wemps

application wemps          WebSphere Embedded Messaging Publish and Subscribe Edition

Example package names for the base package

application ISWSBIH1A            ihsComponent
application ISWSBJD9A            javaCommonConfigComponent
application ISWSBJD9A.2          javaCommonConfigComponent
application ISWSBLA1A            logAnalyzerComponent
application ISWSBLAAA            LogAnalyzer
application WSBAA                WebSphere Application Server
application WSBAAAA              Application And Assembly Tools
application WSBAC1AA             adminConsoleFilesComponent
application WSBACAA              Admin Console
application WSBADAA              Admin
application WSBAS1AA             adminScriptingFilesComponent
application WSBASAA              Admin Scripting
application WSBAT1AA             applicationAssemblyToolComponent
application WSBATAA              Application Assembly Tool
application WSBAU1AA             antUtilityComponent
application WSBAUAA              Ant Utility
application WSBCO1AA             commonFiles
application WSBCO4AA             pbwServerConfigWithMQGood
application WSBCO5AA             IsmpLauncherComponent
application WSBCOAA              commonFeature
application WSBDM1AA             DCMStdComponent
application WSBDMAA              Dynamic Cache Monitor
application WSBDT1AA             deployToolComponent
application WSBDTAA              Deploy Tool
application WSBES1AA             messagingSampleFileComponentBean
application WSBESAA              mqSeriesSamples
application WSBGK2AA             gskitUnixComponent
application WSBGK3AA             gskit4SolarisComponent
application WSBGKAA              gskitFeature
application WSBIHAA              ihsFeature
application WSBJA1AA             javadocComponent
application WSBJAAA              Javadoc
application WSBJD4AA             javaSolarisComponent
application WSBJD7AA             javaUninstallComponent
application WSBJDAA              Java
application WSBMQ1AA             mqSeriesSetupFileComponent
application WSBMQ2AA             mqSeriesBinComponent
application WSBMQ3AA             mqSeriesLibFilesComponent
application WSBMQAA              MQSeries
application WSBMS6AA             mqSeriesSunConfig
application WSBMSAA              mqSeriesServer
application WSBPL1AA             component8
application WSBPLAA              Plugins
application WSBPS1AA             perfServletComponent
application WSBPSAA              Performance Servlet
application WSBPTAA              PerformanceAndAnalysisTools
application WSBSM1AA             samplesComponent
application WSBSMAA              Samples
application WSBSR1AA             serverStdComponent
application WSBSR4AA             serverConfigWithoutSamplesComponent
application WSBSRAA              Server
application WSBTV1AA             tivoliViewerComponent
application WSBTVAA              TivoliPerformanceViewer

Example package names for the Network Deployment package

application ISWSNMQ1A            mqClientFiles
application ISWSNMQAA            mqFeature
application WSNAA                WebSphere Network Deployment
application WSNCF1AA             configFiles
application WSNCF4AA             configSunLinuxWithMQComponent
application WSNCFAA              Config
application WSNCO1AA             commonFiles
application WSNCO2AA             IsmpLauncherComponent
application WSNCOAA              commonFeature
application WSNJD4AA             javaSolarisComponent
application WSNJDAA              Java
application WSNSR1AA             serverStdComponent
application WSNSRAA              Server
application WSNUR1AA             uddiComponent
application WSNURAA              UDDI
application WSNWG1AA             wsgwComponent
application WSNWGAA              Web Services Gateway
application WSNWSAA              Web Services

Example package names for a V5.1 system with the base product and the Network Deployment product

application IBMHTTPSV      IBM HTTP Server
application ISIHS.bas      HTTPServer base
application ISIHS.con      component23
application ISIHS.htt      feature13
application ISIHS.ins      component26
application ISIHS.ssl      component57
application ISWSBIH1A      ihsComponent
application ISWSBJD9A      javaCommonConfigComponent
application ISWSBLA1A      logAnalyzerComponent
application ISWSBLAAA      LogAnalyzer
application ISWSNJD9A      javaCommonConfigComponent
application ISWSNMQ1A      mqClientFiles
application ISWSNMQAA      mqFeature

application WSBAA51        WebSphere Application Server
application WSBAAAA51      Application And Assembly Tools
application WSBAC1AA51     adminConsoleFilesComponent
application WSBACAA51      Admin Console
application WSBADAA51      Admin
application WSBAS1AA51     adminScriptingFilesComponent
application WSBASAA51      Admin Scripting
application WSBAU1AA51     antUtilityComponent
application WSBAUAA51      Ant Utility
application WSBCO1AA51     commonFiles
application WSBCO5AA51     IsmpLauncherComponent
application WSBCOAA51      commonFeature
application WSBDM1AA51     DCMStdComponent
application WSBDMAA51      Dynamic Cache Monitor
application WSBDT1AA51     deployToolComponent
application WSBDTAA51      Deploy Tool
application WSBES1AA       messagingSampleFileComponentBean
application WSBESAA        mqSeriesSamples
application WSBGK2AA51     gskitUnixComponent
application WSBGK3AA51     gskit4SolarisComponent
application WSBGKAA51      gskitFeature
application WSBIHAA51      ihsFeature
application WSBJA1AA51     javadocComponent
application WSBJAAA51      Javadoc
application WSBJD4AA51     javaSolarisComponent
application WSBJD7AA51     javaUninstallComponent
application WSBJDAA51      Java
application WSBMC4AA       mqSeriesClientUnixInstall
application WSBMQ1AA       mqSeriesSetupFileComponent
application WSBMQ2AA       mqSeriesBinComponent
application WSBMQ3AA       mqSeriesLibFilesComponent
application WSBMQAA        MQSeries
application WSBMS4AA       mqSeriesUnixInstall
application WSBMS6AA       mqSeriesSunConfig
application WSBMSAA        mqSeriesServer
application WSBPL1AA51     component8
application WSBPLAA51      Plugins
application WSBPS1AA51     perfServletComponent
application WSBPSAA51      Performance Servlet
application WSBPTAA51      PerformanceAndAnalysisTools
application WSBSM1AA51     samplesComponent
application WSBSMAA51      Samples
application WSBSR1AA51     serverStdComponent
application WSBSR4AA51     serverConfigWithoutSamplesComponent
application WSBSRAA51      Server
application WSBTV1AA51     tivoliViewerComponent
application WSBTVAA51      TivoliPerformanceViewer
application WSNAA51        WebSphere Network Deployment
application WSNCF1AA51     configFiles
application WSNCF4AA51     configSunLinuxWithMQComponent
application WSNCFAA51      Config
application WSNCO1AA51     commonFiles
application WSNCO2AA51     IsmpLauncherComponent
application WSNCOAA51      commonFeature
application WSNJD4AA51     javaSolarisComponent
application WSNJDAA51      Java
application WSNSR1AA51     serverStdComponent
application WSNSRAA51      Server
application WSNUR1AA51     uddiComponent
application WSNURAA51      UDDI
application WSNWG1AA51     wsgwComponent
application WSNWGAA51      Web Services Gateway
application WSNWSAA51      Web Services

application gsk4bas        gsk4bas
application gsk7bas        Certificate and SSL Base Runtime (gsk7bas)
application mqm            WebSphere MQ for Sun Solaris
application mqm-upd04      WebSphere MQ for Sun Solaris 2 - U486877
application wemps          WebSphere Embedded Messaging Publish and Subscribe Edition

 

What to do next

Return to Uninstalling WebSphere Application Server to continue.


Related tasks
Uninstalling manually
Manually uninstalling on AIX platforms
Manually uninstalling on HP-UX platforms
Manually uninstalling on Linux platforms
Manually uninstalling on Windows platforms
Uninstalling when the embedded messaging client feature is installed