Sun Java System Portal Server 6 2004Q2 Migration Guide |
Appendix A
Tool Design
This appendix includes information, options or parameters, and usage information for the Sun ONE Portal Server 3.0 Data Migration Tool Suite and the Sun ONE Compass Server Migration Tools. This appendix contains the following sections:
Sun ONE Portal Server 3.0 Data Migration Tool SuiteThis section provides the tool design for the export, conversion, and import tools used to migrate from Sun ONE Portal Server 3.0 to Sun ONE Portal Server 6.2.
Export Tool Design
Synopsis
./exportps [-a] [-p LDAP passphrase] [ExportDir]
Description
The export tool copies the following Sun ONE Portal Server 3.0 components to a directory or a .tar file:
Options
Table A-1 describes the options available for the exportps command. This two-column table lists the options in the first column and their descriptions in the second column.
Usage
If you run the exportps command without the ExportDir option, the script exports the data to /tmp/psExport. In addition to the options listed in the Options section, you can also get help and version information by issuing the following commands:
- ./exportps --help
This command gives the following output:
exportps is used to save an iPlanet Portal Server 3.0
(Service Pack 3a or 4) system to disk
USAGE
exportps [-a] [-p <passphrase>] [<directory>]
OPTIONS
-a Export all modules (no menu)
-p <passphrase> Set LDAP root DN passphrase
<directory> where <directory> is place to save exported data
- ./exportps --version
This command gives the following output:
Name: Portal Server export utility
Version: 6.2
Product: Portal Server, Hana release
Legal-notices:
Copyright 2003 Sun Microsystems, Inc. All rights reserved.
PROPRIETARY/CONFIDENTIAL. Use of this product is subject to license terms.
Conversion Tool Design
Synopsis
./convertps [-a] [-f] [-i ExportDir] [-o ImportDir]
Description
The results of the convertps command are converted to files to be used by the importps command for loading Sun ONE Portal Server 3.0 customizations into Sun ONE Portal Server 6.2.
Options
Table A-2 describes the options available for the convertps command. This two-column table lists the options in the first column and their descriptions in the second column.
Usage
If you run the convertps command without the -i ExportDir and -o ImportDir options, the conversion tool will check for the /tmp/ipsExport directory. If the tool finds valid exported data, it will store the converted data in /tmp/psImport. In addition to the options listed in the Options section, you can also get help and version information by issuing the following commands:
convertps is used to migrate iPlanet Portal Server 3.0
(Service Pack 3a or 4) data to files that can be uploaded into
a Portal Server 6.2 system
OPTIONS
-a Convert all modules (no menu)
-f Converts roles to roles, instead of roles to
sub-organizations-i <directory> where <directory> is iPS export directory
-o <directory> where <directory> is place to save migrated files
for future upload using importps
Import Tool Design
Synopsis
./importps [-a] [-k] [-m] [ImportDir]
Description
The import tool imports into the Sun ONE Portal Server 6.2 system the data converted with the conversion tool.
Options
Table A-3 describes the options available for the importps command. This two-column table lists the options in the first column and their descriptions in the second column.
Usage
If you run the importps command without the ImportDir option, the script looks in /tmp/psImport for converted data. In addition to the options listed in the Options section, you can also get help and version information by issuing the following commands:
importps is used to upload converted iPlanet Portal Server
3.0 (Service Pack 3a or 4) customizations into Portal Server 6.2
USAGE
importps [-a] [-k] [-m] [<directory>]
OPTIONS
-a Import all modules (no menu)
-k Do not overwrite existing users
-m Merge display profile documents
<directory> where <directory> is location of converted data
Flow of Sun ONE Portal Server 3.0 Data Migration Tool SuiteExport Tool
The export tool adds to ExportDir/templates.tar:
- /etc/opt/SUNWips/desktop/
- changed files in /etc/opt/SUNWips/auth/
- BaseDir/SUNWips/locale/
- BaseDir/SUNWips/public_html except for admin, launch.html, netlet, banner.html, index.html, netfile, netmail, and third_party
- files with fully-qualified path names listed in BaseDir/SUNWps/migration/modules/desktop/migrate_files.txt
Conversion Tool
The conversion tool:
- extracts ExportDir/templates.tar into /tmp/.temp_desktop/exportData/
- does the conversion of templates, JSPs, and resource bundles in /tmp/.temp_desktop/exportData/
- saves converted data in /tmp/.temp_desktop/importData/
- adds to ImportDir/desktop.tar the contents of /tmp/.temp_desktop/importData/desktop/
- adds to ImportDir/locale.tar the contents of /tmp/.temp_desktop/importData/locale/
- adds to ImportDir/auth.tar the contents of /tmp/.temp_desktop/importData/auth/
- adds to ImportDir/public_html.tar the contents of /tmp/.temp_desktop/importData/public_html/
- removes the directory /tmp/.temp_desktop/
- automatically extracts the files and directories added by migrate_files.txt as long as they are fully qualified pathnames.
Import Tool
The import tool:
Sun ONE Compass Server Migration ToolsThis section provides the tool design for the export and import tools used to migrate Sun ONE Compass Server 3.01C, Service Pack 1 or later to Sun ONE Portal Server 6.2.
Sun ONE Compass Server Export Tool Design
Synopsis
perl./export.pl [-o ExportDir] [-i Target_InstanceDir]
Description
The Sun ONE Compass Server export tool exports data from Sun ONE Compass Server 3.01C, Service Pack 1 and later to the Sun ONE Portal Server 6.2 system.
Parameters
Table A-4 shows the parameters and their descriptions for the export.pl script. This two-column table lists the parameters in the first column and their descriptions in the second column.
Usage
If you do not specify any parameters, the Sun ONE Compass Server export tool will export all instances to the current directory.
Sun ONE Compass Server Import Tool Design
Synopsis
perl./import.pl [-o Target_InstanceDir] [-i Source_InstanceDir] [-p Portal_InstallDir]
Description
The Sun ONE Compass Server import tool imports the Sun ONE Compass Server 3.01C, Service Pack 1 or later data exported with the export.pl script into Sun ONE Portal Server 6.2.
Parameters
Table A-5 shows the parameters and their descriptions for the export.pl script. This two-column table lists the parameters in the first column and their descriptions in the second column.