Troubleshooting

 

+
Search Tips   |   Advanced Search

 

---

Troubles:

1. Can not start WebSphere Portal V5.0 Test Environment
2. Can not start WebSphere Portal V4.2 Test Environment
3. Failure of installation of WebSphere Portal Test Environment
4. Failure of uninstallation of WebSphere Portal Test Environment
5. Can not start WebSphere Studio (error "Could not restore workbench layout" appears.)

Solutions:

Can not start WebSphere Portal V5.0 Test Environment

• Ensure that you have installed the WebSphere Portal V5.0 Test Environment using the toolkit installer.

• Check the install log to verify successful installation:

  • WS_installdir\runtimes\portal_v50\log\wpsinstalllog.txt

  • Both WebSphere Portal Test Environments: WS_installdir\PortalToolkit\log\TkWpsInst.log

• Check the log of WebSphere Portal to determine the problem.

  • To enable the console logging of WebSphere Portal, you can configure the server. In the Servers view, double-click the server to open the server configuration. In the Portal page, select the Enable console logging of WebSphere Portal checkbox. Press Ctrl+S to save the configuration.

Can not start WebSphere Portal V4.2 Test Environment

• Ensure that you have installed the WebSphere Portal V4.2 Test Environment using the toolkit installer.

• Check the install log to verify successful installation:

  • WS_installdir\runtimes\PortalServer\install\*.log

  • Both WebSphere Portal Test Environments: WS_installdir\PortalToolkit\log\TkWpsInst.log

• Check the log of WebSphere Portal to determine the problem.

  • WS_installdir\runtimes\PortalServer\log\*.log

Failure of installation of WebSphere Portal Test Environment

• Check the install log and carry out the appropriate measures to rectify the problem.

  WebSphere Portal 5.0 Test Environment

  WS_installdir\runtimes\portal_v50\log\wpsinstalllog.txt

  WebSphere Portal 4.2 Test Environment

  WS_installdir\runtimes\PortalServer\install\*.log

  where WS_installdir is the directory that you have installed WebSphere Studio.

• If the problem can not be determined by the log files, then try performing one of the following:

  • Verify that the HTTP server does not start.

  • Shorten the PATH environment variable temporarily while you install the WebSphere Portal Test Environment.

  • Verify the name of directory where you installed WebSphere Studio.

    • You do not use double-byte characters or special characters or dollar signs ("$").

    • You do not use periods ("."). Required when you use WebSphere Portal v4.2.x or v5.0.0

    • The directory name is short. Required when you user WebSphere Portal v4.2.x or v5.0.0 on Windows.
    To change the target directory, you will need to uninstall Portal Toolkit, the WebSphere Portal Test Environment and WebSphere Studio and then reinstall them once again.

  • Uninstall the WebSphere Portal Test Environment and then reinstall them.

• If the installation still fails, then your environment seems to have a severe problem. To avoid the problem, try performing the following.

  • Carry out the following.
    Uninstall the WebSphere Portal Test Environment by executing the CleanupWPS commands.

    1. Uninstall the WebSphere Portal Test Environment manually by executing the CleanupWPS commands.

    2. Retry the installation.

  • If the installation still fails, then carry out the following.
    Delete the WebSphere Portal Test Environment manually.

    1. Uninstall the WebSphere Portal Test Environment manually by deleting the remaining files.

    2. Rename the vpd.properties file.

       • OS_installdir\vpd.properties, where OS_installdir is the operating system installation directory (for example, c:\windows or c:\winnt).

       • /root/vpd.properties

    3. Retry the installation.

Failure of uninstallation of WebSphere Portal Test Environment

The Portal Toolkit uninstaller should always be used. However in some cases, such as an aborted installation, the uninstaller might not be completed and functional. In these cases, use either of the following procedure to complete the uninstallation manually:

• Uninstall the WebSphere Portal Test Environment manually by executing the CleanupWPS commands:

If you have the Portal Toolkit CD:

D:\util\CleanupWPS50 WS_Installdir
D:\util\CleanupWPS42 WS_Installdir

Alternatively, you can use the Portal Toolkit installable image.

ptkimg\PortalToolkit5023\util\CleanupWPS50 WS_Installdir
ptkimg\PortalToolkit5023\util\CleanupWPS42 WS_Installdir

If you have the Portal Toolkit CD:

/mnt/cdrom/util/CleanupWPS50.sh WS_Installdir

Alternatively, you can use the Portal Toolkit installable image.

ptkimg/PortalToolkit5023/util/CleanupWPS50.sh WS_Installdir

where

• D: is the CD drive
• ptkimg is the directory where the Portal Toolkit Installable image exists.
• WS_installdir is the directory where you have installed WebSphere Studio.

• Uninstall the WebSphere Portal Test Environment manually by deleting the remaining files:

1. Invoke regedit.exe from a command prompt to edit the Windows System Registry. Keys to delete:

   • HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere Portal Server\4.2

   • HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere Portal Server\5.0.0.0

2. Delete the following and their subdirectories:

   • WS_installdir\runtimes\portal_v50

   • WS_installdir\runtimes\PortalServer

3. Delete the following files:

   • WS_Installdir\PortalToolkit\WPS50OnTEInstalled

   • WS_Installdir\PortalToolkit\WPS42OnTEInstalled

1. Delete the following and their subdirectories:

   • WS_installdir/runtimes/portal_v50

2. Delete the following files:

   • WS_Installdir/PortalToolkit/WPS50OnTEInstalled

where WS_installdir is the directory where you have installed WebSphere Studio.

"Could not restore workbench layout" error appears

Solution: Restart WebSphere Studio and specify a new directory as a workspace. If you selected Use this workspace as the default and do not show this dialog box again which means the dialog to allow you to specify the workspace directory will not appear, execute "WS_installdir\ws*.exe -setworkspace" from the command prompt to open this dialog (WS_installdir is the directory where you have installed WebSphere Studio).

Reason: The workspace created by the old version of the toolkit cannot be used. To work with projects you created in the old version, export it as a WAR file in the old version and import it as a new project in this toolkit.