migrate_home_folder

Finds the instances of the home folder for all users in the Teamcenter database and modifies the object_type property value to Fnd0HomeFolder. The Fnd0HomeFolder business object represents the home folder and is a child of the Folder business object. This utility is run automatically during upgrade. You only need to run it manually if the utility did not complete during upgrade. By default, this utility finds and process only the unmigrated instances. You can force it to process the objects that are already migrated by specifying the -force_rerun argument. You can rerun the utility any number of times. You can process all the home folder instances in bulk using the -objects argument. Syntax migrate_home_folder -u=user-ID {-p=password | -pf=password-file} [-g=group] [-objects=number-of-objects-per-iteration] [-force-rerun] [-log=log-file-path] [-v] [-h] Arguments -u Specifies the user ID. The user must have administrative privileges. -p Specifies the user's password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. For more information about managing password files, see Manage password files. This argument is mutually exclusive with the -p argument. -g Specifies the group associated with the user. -objects Specifies the number objects to be processed per iteration. The default value is 1000 objects. The input value must be a positive integer. If the number of objects specified exceeds the maximum objects in the database, this utility processes all instances in the first iteration itself. -force_rerun Forces the utility to query and migrate the instances that are already migrated along with unmigrated instances. -log Specifies the path for the log file. The log file contains the information about the number objects successfully migrated, the number of objects not migrated, the time taken to complete the operation, and so on. If this argument is not specified, the log file is generated under the directory defined by the TC_TMP_DIR environment variable. -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment. Files Apart from the default log files specified in Log files produced by Teamcenter, this utility generates an additional log file with the details of the number of instances migrated, the number of instances that failed to migrate, and the time taken to complete the operation. The additional log file has this format: migrade_home_folderYYYY_MM_DD_HH_MM_SS.log You can find it in the directory specified by the TC_TMP_DIR environment variable. Restrictions You must be a Teamcenter administrator to execute this utility. Examples To migrate all home folder instances in the database with up to 5000 objects per iteration, enter the following command. Copy migrate_home_folder -u=Tc-admin-user -p=password -g=group -objects=5000 To migrate all home folder instances in the database with up to 10000 objects per iteration and to force the utility to rerun the migration on already migrated instances along with unmigrated instances: Copy migrate_home_folder -u=Tc-admin-user -p=password -g=group -objects=5000 -force_rerun