Manually migrating the Web Administration Tool

Edit online

You can manually migrate the Web Administration Tool.

Before you begin

To migrate the Web Administration Tool manually, the Web Administration Tool must be installed first. Follow the steps to migrate the Web Administration Tool manually. In the example that is shown, the Web Administration Tool on IBM® Security Directory Server V6.3.1 is migrated to IBM Security Directory Server V6.4.

On AIX®, the migration commands are similar to the commands on Linux®, except the path /opt/ibm/ldap should be replaced by /opt/IBM/ldap.

Procedure

  1. For Windows, add the WebSphere® Application Server service using following command: 
    "[WAS_home]\bin\WASService.exe" -add 
TDSWebAdmin-V6.4.0 -serverName server1 -profilePath 
"[WAS_home]\profiles\TDSWebAdminProfile" 
-startType automatic
  2. Back up the Web Administration Tool files from the previous release.
    • On Windows, find these files under the directory:
      C:\Program Files\IBM\LDAP\V6.3.1\appsrv\profiles\TDSWebAdminProfile\
 installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\
 WEB-INF\classes\
      or
      C:\Program Files\IBM\LDAP\V6.3.1\appsrv\installedApps\DefaultNode
\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\classes
    • On Linux, find these files under the following directory:
      /opt/ibm/ldap/V6.3.1/appsrv/profiles/TDSWebAdminProfile/installedApps
/DefaultNode/IDSWebApp.war.ear/IDSWebApp.war/WEB-INF/classes
      or 
      /opt/ibm/ldap/V6.3.1/appsrv/installedApps/DefaultNode
/IDSWebApp.war.ear/IDSWebApp.war/WEB-INF/classes
    Copy only the following five files from the directories:
    • security\console_passwd
    • IDSConfig\IDSSessionConfig\IDSSessionMgmt.xml
    • IDSConfig\IDSServersConfig\IDSServersInfo.xml
    • IDSConfig\IDSAppReg\IDSAppReg.xml
    • IDSConfig\IDSSearchSettings\IDSSearchMgmt.xml
    For example:
    		copy "C:\Program Files\IBM\LDAP\V6.3.1\appsrv\profiles\TDSWebAdminProfile\
installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\classes\
security\console_passwd" c:\BackUp
		copy "C:\Program Files\IBM\LDAP\V6.3.1\appsrv\profiles\TDSWebAdminProfile\
installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\classes\
IDSConfig\IDSSessionConfig\IDSSessionMgmt.xml" c:\BackUp
		copy "C:\Program Files\IBM\LDAP\V6.3.1\appsrv\profiles\TDSWebAdminProfile\
installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\classes\
IDSConfig\IDSServersConfig\IDSServersInfo.xml" c:\BackUp
		copy "C:\Program Files\IBM\LDAP\V6.3.1\appsrv\profiles\TDSWebAdminProfile\
installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\classes\
IDSConfig\IDSAppReg\IDSAppReg.xml" c:\BackUp
		copy "C:\Program Files\IBM\LDAP\V6.3.1\appsrv\profiles\TDSWebAdminProfile\
installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\classes\
IDSConfig\IDSSearchSettings\IDSSearchMgmt.xml" c:\BackUp
  3. Uninstall the war file from the previous release.
    • On Windows, the command is present under the following directory:
      C:\Program Files\IBM\LDAP\V6.3.1\appsrv\profiles\TDSWebAdminProfile\bin\wsadmin.bat
      or 
      C:\Program Files\IBM\LDAP\V6.3.1\appsrv\bin\wsadmin.bat
    • On Linux, the command is present under the following directory:
      /opt/ibm/ldap/V6.3.1/appsrv/profiles/TDSWebAdminProfile/bin/wsadmin.sh
      or 
      /opt/ibm/ldap/V6.3.1/appsrv/bin/wsadmin.sh
    wsadmin.bat -conntype NONE -c "$AdminApp uninstall IDSWebApp.war"
    For example:
    "C:\Program Files\IBM\LDAP\V6.3.1\appsrv\profiles\TDSWebAdminProfile\bin\wsadmin.bat"
 -conntype NONE -c "$AdminApp uninstall IDSWebApp.war"
  4. If the server of the previous WebSphere Application Server is running, then stop the application server.
    • On Windows, the command is present under the following directory:
      C:\Program Files\IBM\LDAP\V6.3.1\appsrv\profiles\TDSWebAdminProfile\bin\
stopServer.bat
      or
      C:\Program Files\IBM\LDAP\V6.3.1\appsrv\bin\stopServer.bat
    • On Linux, the command is present under the following directory:
      /opt/ibm/ldap/V6.3.1/appsrv/profiles/TDSWebAdminProfile/bin/stopServer.sh
      or
      /opt/ibm/ldap/V6.3.1/appsrv/bin/stopServer.sh
    For example:
    "C:\Program Files\IBM\LDAP\V6.3.1\appsrv\profiles\TDSWebAdminProfile\bin\
stopServer.bat" server1
  5. Check for the existence of the profile on the new WebSphere Application Server. If the profile does not exist, create a new profile.
    • On Windows, run the following command to create new profile:
      "[WAS_home]\bin\manageprofiles.bat" -create
 -profileName TDSWebAdminProfile -profilePath "[WAS_home]\profiles\TDSWebAdminProfile" -templatePath
 "[WAS_home]\ profileTemplates\default"
 -nodeName DefaultNode -hostName localhost -cellName
 DefaultNode -isDefault -portsFile "C:\Program Files\IBM\LDAP\V6.4\idstools
 \TDSWEBPortDef.props"
    • On Linux, run the following command to create new profile:
      [WAS_home]/bin/manageprofiles.sh -create -profileName
 TDSWebAdminProfile -profilePath "[WAS_home]/profiles/
 TDSWebAdminProfile" -templatePath "[WAS_home]/
 profileTemplates/default" -nodeName DefaultNode -hostName localhost
 -cellName DefaultNode -isDefault -portsFile "/opt/ibm/ldap/V6.4/idstools
 /TDSWEBPortDef.props"
  6. Copy the new war file into the new WebSphere Application Server directory.
    • On Windows, run the following command:
      copy "C:\Program Files\IBM\LDAP\V6.4\idstools\IDSWebApp.war"
 "[WAS_home]\profiles\TDSWebAdminProfile\
 installableApps"
    • On Linux, run the following command:
      cp "/opt/ibm/ldap/V6.4/idstools/IDSWebApp.war"
 "[WAS_home]/profiles/TDSWebAdminProfile/installableApps"
  7. Install the new WAR file into the new WebSphere Application Server product.
    • On Windows, run the following command:
      "[WAS_home]\profiles\TDSWebAdminProfile\bin
 \wsadmin.bat" -conntype NONE -c "$AdminApp install {[WAS_home]\profiles\TDSWebAdminProfile\installableApps\
 IDSWebApp.war} {-configroot \"[WAS_home]\config\" -node DefaultNode -usedefaultbindings -nodeployejb
 -appname IDSWebApp.war -contextroot \"IDSWebApp\"}"
    • On Linux, run the following command:
      "[WAS_home]/profiles/TDSWebAdminProfile/bin/wsadmin.sh"
 -conntype NONE -c "\$AdminApp install {[WAS_home]/
 profiles/TDSWebAdminProfile/installableApps/IDSWebApp.war}
 {-configroot \"[WAS_home]/config\"
 -node DefaultNode -usedefaultbindings -nodeployejb -appname IDSWebApp.war
 -contextroot \"IDSWebApp\"}"
  8. Restore the Web Administration Tool configuration files that were saved previously.
    • On Windows, replace following files with the backup copy files:
      [WAS_home]\profiles\TDSWebAdminProfile\
 installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\
 classes\security\console_passwd
	[WAS_home]\profiles\TDSWebAdminProfile\
 installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\
 classes\IDSConfig\IDSSessionConfig\IDSSessionMgmt.xml
	[WAS_home]\profiles\TDSWebAdminProfile\
 installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\
 classes\IDSConfig\IDSServersConfig\IDSServersInfo.xml
	[WAS_home]\profiles\TDSWebAdminProfile\
 installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\
 classes\IDSConfig\IDSAppReg\IDSAppReg.xml
	[WAS_home]\profiles\TDSWebAdminProfile\
 installedApps\DefaultNode\IDSWebApp.war.ear\IDSWebApp.war\WEB-INF\
 classes\IDSConfig\IDSSearchSettings\IDSSearchMgmt.xml
    • On Linux, replace following files with the backup copy files:
      [WAS_home]/profiles/TDSWebAdminProfile/installedApps/
 DefaultNode/IDSWebApp.war.ear/IDSWebApp.war/WEB-INF/classes/security/
 console_passwd
	[WAS_home]/profiles/TDSWebAdminProfile/installedApps/
 DefaultNode/IDSWebApp.war.ear/IDSWebApp.war/WEB-INF/classes/IDSConfig/
 IDSSessionConfig/IDSSessionMgmt.xml
	[WAS_home]/profiles/TDSWebAdminProfile/installedApps/
 DefaultNode/IDSWebApp.war.ear/IDSWebApp.war/WEB-INF/classes/IDSConfig/
 IDSServersConfig/IDSServersInfo.xml
	[WAS_home]/profiles/TDSWebAdminProfile/installedApps/
 DefaultNode/IDSWebApp.war.ear/IDSWebApp.war/WEB-INF/classes/IDSConfig/
 IDSAppReg/IDSAppReg.xml
	[WAS_home]/profiles/TDSWebAdminProfile/installedApps/
 DefaultNode/IDSWebApp.war.ear/IDSWebApp.war/WEB-INF/classes/IDSConfig/
 IDSSearchSettings/IDSSearchMgmt.xml
  9. On Windows, start the service that was added. 
    "[WAS_home]\bin\WASService.exe"
 -start TDSWebAdmin-V6.4.0
  10. On Linux, start the server. 
    [WAS_home]/profiles/TDSWebAdminProfile/bin/startServer.sh server1