Manually uninstalling on Solaris platforms

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

Before you begin

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. Before you begin, 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.

Why and when to perform this task

Use this procedure to uninstall WebSphere Application Server products. Uninstall the products in the following sequence when you are uninstalling more than one product:

  1. [5.0 only][Version 5.0.1][Version 5.0.2]WebSphere Application Server Enterprise on Network Deployment
  2. WebSphere Application Server Network Deployment
  3. [5.0 only][Version 5.0.1][Version 5.0.2]WebSphere Application Server Enterprise on the base product
  4. WebSphere Application Server (base product)

One of the ways that this procedure completely uninstalls the product is by completely deleting the installation root directory for the product. References to the directory are abbreviated install_root in some of the steps. The default install_root for WebSphere Application Server is the /opt/WebSphere/AppServer directory.

The default directory for IBM HTTP Server is /opt/IBMHttpServer.

[5.0 only][Version 5.0.1][Version 5.0.2]Default installation roots for the Enterprise product are:

Steps for this task

  1. Use the kill -9 java_pid command to kill each Java process that is 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. Generally, you can identify packages that belong to V5.1 by the 51 on the end of WSB packages and WSN packages. However, WSBM and WSNM packages are for the embedded messaging feature and do not include the 51 on the end as an identifier.

    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 WSE|xargs -i pkgrm -n {} for the Enterprise V5.0.x product
    5. ls |grep WSC|xargs -i pkgrm -n {} for the WebSphere Application Server Java client
    6. ls |grep wemps|xargs -i pkgrm -n {} for the WebSphere embedded messaging publish and subscribe function
    7. ls |grep mqjava|xargs -i pkgrm -n {} for IBM WebSphere MQ
    8. 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 you finish, the product is completely uninstalled. You are now ready to reinstall. Reinstalling successfully into the same directory is the final indicator of success in removing the original product.

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 the V5.0.2 Enterprise product

application ISWSEBDAA            Destination For Base
application ISWSEBR01            BRB Files
application ISWSEBR03            BRB Samples
application ISWSEBRAA            BRB
application ISWSECC01            Corba Files
application ISWSECC02            Corba IR
application ISWSECC05            Corba C++ Samples
application ISWSECC06            gskitFeature
application ISWSECCAA            Corba
application ISWSECF01            CommonFilesComponent
application ISWSECF02            Setup Cmd
application ISWSECF03            LAFilesComponent
application ISWSECF04            IsmpLauncherComponent
application ISWSECF06            PRTFilesComponent
application ISWSECF08            eFixInstaller
application ISWSECF09            Uninstaller
application ISWSECF11            UnzipPluginzipFile_CF_Unix
application ISWSECF12            Set_InstallCF_TRUEComponent
application ISWSECF14            PluginActionSequence_CF
application ISWSECFAA            CommonFeature_WAS
application ISWSEDQ01            EJBQuery
application ISWSEDQ02            EJBQueryJar
application ISWSEDQ04            DQSamples
application ISWSEDQAA            DQ
application ISWSEEM01            CMM Files
application ISWSEEM03            CMM Samples
application ISWSEEM05            UnzipPluginzipFile_EM_Unix
application ISWSEEM06            Set_InstallEM_TRUEComponent
application ISWSEEM07            PluginActionSequence_EM
application ISWSEEMAA            CMM
application ISWSEFC01            Workflow Files
application ISWSEFC03            Process Choreographer Samples
application ISWSEFC04            feature23
application ISWSEFC06            UnzipPluginzipFile_PC_Unix
application ISWSEFC07            Set_InstallPC_TRUEComponent
application ISWSEFC08            PluginActionSequence_PC
application ISWSEFCAA            ProcessChoreographer
application ISWSEOS01            Other Services Files
application ISWSEOS03            OtherServices_PropertiesUpdate
application ISWSEOS04            OS Samples
application ISWSEOS05            AppProfile Files
application ISWSEOS07            UnzipPluginzipFile_OS_Unix
application ISWSEOS08            Set_InstallOS_TRUEComponent
application ISWSEOS09            PluginActionSequence_OS
application ISWSEOSAA            OtherServices
application ISWSEOT03            ConfigFileCopy
application ISWSEOTAA            OneTimeInstall_WAS
application ISWSESA01            SCHED Files
application ISWSESA03            SCHED Samples
application ISWSESA04            SCHED_DefaultWorkManager
application ISWSESA07            UnzipPluginzipFile_SA_Unix
application ISWSESA08            Set_InstallSA_TRUEComponent
application ISWSESA09            PluginActionSequence_SA
application ISWSESAAA            Scheduler
application WSEAA                WebSphere Application Server Enterprise

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

After uninstalling the product, see Installing WebSphere Application Server products to begin planning your next installation.

Related tasks
Uninstalling manually



Searchable topic ID:   tins_uninstallSolaris
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/ae/tins_uninstallSolaris.html

Library | Support | Terms of Use | Feedback