ar_recover

Attempts to perform a recovery and cleanup of partially created data during Multi-Site Collaboration archive and restore operations when IDSM an ODS connection failures have occurred. During the archive and restore critical operations, a recovery text dataset containing the operation ID and object UIDs is created in the current logged-in user's NewStuff folder. After a successful operation, the recovery dataset is automatically deleted. However, if a critical failure occurs, the dataset is not deleted and you can use the ar_recover utility to attempt recovery of the data. Syntax ar_recover -u=user-ID {-p= password | -pf=password-file} -g=group -f={recover | list | update} [-ds_name=name][-extinct_siteID=id] [-new_siteID=id][-verbose] [-h] Arguments -u Specifies the user ID. The user must have administrative privileges. If this argument is used without a value, the operating system user name is used. Note If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments are authenticated externally through SSO rather than being authenticated against the Teamcenter database. If you do not supply these arguments, the utility attempts to join an existing SSO session. If no session is found, you are prompted to enter a user ID and password. -p Specifies the user password. If used without a value, the system assumes a null value. If this argument is not used, the system assumes the user-ID value to be the password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. If used without a value, the system assumes a null value. If this argument is not used, the system assumes the user-ID value to be the password. 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. If used without a value, the user’s default group is assumed. -f Specifies one of the following functions: recover Performs recovery and cleanup of partially-created data during an archive or restore operation. Valid with the -ds_name argument. list Lists the extent of recovery datasets at the current site. update Updates the archived published objects extinct site ID with the new site ID. Valid with the -extinct_siteID and -new_siteID arguments. -ds_name Specifies name of the recovery dataset. Valid with the -f=recover argument. -extinct_siteID Specifies the ID of the site previously owning the data. Valid with the -f=update argument. -new_siteID Specifies the ID of the site currently owning the data. Valid with the -f=update argument. -verbose Includes additional detailed messages in the utility's output. -h Displays the help for this utility. Environment As specified in Manually configure the Teamcenter environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples List the extent of recovery datasets at the current site: Copy ar_recover -f=list -verbose To recover from a failed archive operation for audit logs: Copy ar_recover -u=Tc_admin -p=password -g=group -f=recover -ds_name="__Recover_archive_00003f58_5e731606_Fnd0AuditArchive-19-Mar-2020 12:19:35" To recover from a failed restore operation for audit logs: Copy ar_recover -u=Tc_admin -p=password -g=group -f=recover -ds_name="__Recover_restore_00001dc0_5e7340c5_Fnd0AuditArchive-19-Mar-2020 15:21:22" Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration