Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

---

 

Use command line scripts

IBM^® WebSphere^® Portal Express provides a script file that you can use to invoke different migration tasks.

 

Use the command line scripts

Use the appropriate script file for your platform:

• Windows:

  WPmigrate.bat

• Linux:

  ./WPmigrate.sh

• i5/OS:

  WPmigrate.sh

You can run the script from the portal_server_root/migration directory, where portal_server_root is the directory in which the current WebSphere Portal Express version is installed.

If using i5/OS, you can run the script from the UserData portal_server_root_user/migration directory, where portal_server_root is the directory in which the current WebSphere Portal Express version is installed.

The syntax for invoking a migration task is as follows:

• Windows:

  WPmigrate.bat task_name -Dproperty=value

• Linux:

  ./WPmigrate.sh task_name -Dproperty=value

• i5/OS:

  WPmigrate.sh task_name -Dproperty=value

 

where:

• task_name indicates the migration task that you want to run

• property indicates a specific property that will be used by the task

• value indicates the value of a specific property that will be used by the task

 

Exporting content from WebSphere Portal Express

The export-portal-content task exports the WebSphere Portal Express content from the previous version.

Before running the export-portal-content task...

1. Stop the current WebSphere Portal Express server.

2. Start the server for your previous version of WebSphere Portal Express and ensure it is accessible to the network.

The syntax for invoking a migration task is as follows:

• Windows:

  WPmigrate.bat export-portal-content -DPrevPortalAdminId=portaladminid -DPrevPortalAdminPwd=password

• Linux:

  ./WPmigrate.sh export-portal-content -DPrevPortalAdminId=portaladminid -DPrevPortalAdminPwd=password

• i5/OS:

  WPmigrate.sh export-portal-content -DPrevPortalAdminId=portaladminid -DPrevPortalAdminPwd=password

 

where:

• PrevPortalAdminId indicates a portaladminid from the previous version of WebSphere Portal Express

• PrevPortalAdminPwd indicates the password for the above portaladminid

 

Importing content into WebSphere Portal Express

The import-portal-content task imports the content from the previous version of WebSphere Portal Express into the current version of WebSphere Portal Express.

Before running the import-portal-content task...

1. Stop the previous WebSphere Portal Express server.

2. Start the server for your current version of WebSphere Portal Express and ensure it is accessible to the network.

3. Specify the WasUserid and WasPassword in the wpconfig.properties file; see Configuration properties reference for information about editing the properties file.

The syntax for invoking the migration task is as follows:

• Windows:

  WPmigrate.bat import-portal-content -DPortalAdminId=portaladminid -DPortalAdminPwd=password

• Linux:

  ./WPmigrate.sh import-portal-content -DPortalAdminId=portaladminid -DPortalAdminPwd=password

• i5/OS:

  WPmigrate.sh import-portal-content -DPortalAdminId=portaladminid -DPortalAdminPwd=password

 

where:

• PortalAdminId indicates a portaladminid from the current version of WebSphere Portal Express

• PortalAdminPwd indicates the password from the above portaladminid

If running the import-portal-content task multiple times, Restart the servers before rerunning the task.

 

Optional: Migrating the FileServer portlet

If you cloned the FileServer portlet in previous versions and supplied HTML files in the wp_old_root/installedApps/FileServer.war/FileServerPortlet/html directory, copy those files to the portal_server_root/installedApps/FileServer.war/FileServerPortlet/html directory, after running the import task and before restarting the server, to make the files accessible in the current version.

For i5/OS, the directories are wp_user_old_root and portal_server_root_user, respectively.

 

Restart the servers

After completing the import-portal-content task, restart the following server on the current version only:

1. Open a command prompt and change to the following directory:

   • Linux:

     was_profile_root/bin

   • Windows:

     was_profile_root\bin

   • i5/OS:

     app_server_root/bin

2. Enter the following command:

   • Linux:

     ./stopServer.sh WebSphere_Portal -user admin_userid -password admin_password

   • Windows:

     stopServer.bat WebSphere_Portal -user admin_userid -password admin_password

   • i5/OS:

     stopServer.sh WebSphere_Portal -profileName profile_root -user admin_userid -password admin_password

     where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

3. Enter the following command:

   • Linux:

     ./startServer.sh WebSphere_Portal

   • Windows:

     startServer.bat WebSphere_Portal

   • i5/OS:

     startServer.sh WebSphere_Portal -profileName profile_root

     where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

 

Next steps

You have completed this procedure. Continue to the next step by choosing one of the following topics:

• Migrating additional components

• Migrating the remaining access control configuration

• Migrating collaborative components

• Verifying the migration tasks

 

Related information

• Troubleshooting migration

• Starting and stopping WebSphere Application Server and WebSphere Portal Express

 

Parent topic:

Migrating WebSphere Portal Configurations

---