update_fms_configuration

Updates the FMS configuration to reflect changes in volume definitions and other FMS configuration options. The import can be performed either through Teamcenter Environment Manager or the admin data_import command line utility. Syntax update_fms_configuration [-u=user-id {-p=password | -pf=password-file} -g=group] -inputfile=path-to-input-XML-file -volumes=volume-name -fsc_id=fsc-ID -filestore=filestore-ID -load_balancer=load-balancer-ID [-addTransientVolume] [-h] Arguments -u Specifies the user ID. This is a user with Teamcenter administration privileges. 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 password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. 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. -inputfile Specifies the full path to the input text file containing the volume name and FSC ID separated by |. Following is an example input file: Copy #delimiter=| #volume_name|fsc_id|filestore|load_balancer volume1|FSC_S0928933_jpip_1|| volume2|FSC_S0928933_jpip_1|| volume3|FSC_S0928933_jpip_1|| volume4||FSC_S0928933_jpip_2| volume5||FSC_S0928933_jpip_2| volume6||FSC_S0928933_jpip_2| volume7|||FSC_S0928933_jpip_3 volume8|||FSC_S0928933_jpip_3 volume9|||FSC_S0928933_jpip_3 volume10|FSC_S0928933_jpip_4|| volume11|FSC_S0928933_jpip_4|| volume12|FSC_S0928933_jpip_4|| -volumes Specifies a comma-separated list of volumes to be updated in the FMS primary configuration -fsc_id Specifies the FSC ID when the ID type is FSC. -filestore Specifies FSC ID when the ID type is Filestore Group. -load_balancer Specifies the FSC ID when the ID type is Load Balancer. When the new volume is created, you must specify where in the FMS primary configuration file the definition of this volume should be placed: the FSC element section, the filestore group section, or the load balancer section. This is determined by which of three parameters is used. Only one of the -fsc_id, -filestore, and -load_balancer arguments is mandatory. -addTransientVolume Adds the transient volume definition for the specified Teamcenter server process (Tcserver) context to the fmsmaster configuration. Run this utility on each Teamcenter server and pool server to add the transient volume specific to each server. Doing so eliminates the need to manually define and update the transient volumes using information obtained using the backup_xmlinfo utility. -h Displays help for this utility. Restrictions You must be a privileged user to run this utility. You must use either the -inputfile argument, or the -volumes argument and one of -fsc_id, -filestore, and -load_balancer arguments. Examples To update the FMS primary configuration of FSC ID FSC_S0928933_fsc1 with volume1, enter the following command on a single line: Copy update_fms_configuration -u=admin-user -p=admin-password -g=dba -volumes=volume1 -fsc_id=FSC_S0928933_fsc1 To update the FMS primary configuration of filestore group ID FSG_S0928933_fsg1 with volume1, volume2, and volume3, enter the following command on a single line: Copy update_fms_configuration -u=admin-user -p=admin-password -g=dba -volumes=volume1,volume2,volume3 -filestore=FSG_S0928933_fsg1 To update multiple volumes with multiple FSC, filestore group, or load balancer IDs defined in a text file, enter the following command on a single line: Copy update_fms_configuration -u=admin-user -p=admin-password -g=dba -inputfile=d:\volumes.txt To add a new transient volume specific to the current pool server which has an FSC ID FSC_S0928933_fsc1, enter the following command: Copy update_fms_configuration -u=admin-user -p=admin-password -g=dba -addTransientVolume -fsc_id=FSC_S0928933_fsc1