Configure
Use the
configure
command to set up FactoryTalk Activation
with specific configuration options.Usage:
configure [options]
This table describes the command options.
Option | Description |
---|---|
-v|--verbose | Use this option to turn on trace messaging. |
-a|--autorenew | Configures the AutoRenew option. Specify 'enable' or 'disable'. Example: 'configure -a enable' |
-c|--codemeterserver | Configures whether the computer serves CodeMeter activations. Specify 'enable' or 'disable'. Example: 'configure -c disable' |
-f|--codemeterfirst | Configures whether CodeMeter activations will be used first before Flexera activations. Specify 'enable' or 'disable'. Example: 'configure -f enable' |
-r|--refreshserver | Refreshes the Activation server. Example: 'configure -r' |
-sf|--showalwaysfailco | Displays which activation strings or feature names are configured to always fail activation and checkout attempts. Example: 'configure -sf' |
-af|--alwaysfailco | Configures this client computer to always fail activation and checkout attempts of the specified activation strings or feature names. This can be helpful if you know you do not want to ever use or acquire a particular feature and want to ensure the feature is available for others to use. Specify 'feature name1,feature name2,...'. Example: 'configure -af FEAT1.EXE,FEAT2.EXE,FEAT3.EXE' You can also use the --user and --group sub-options to always fail activation and checkout attempts for specificed feature names from specific logged-in users, or groups the the logged-in user is a member of. Example: 'configure -af FEAT1.EXE,FEAT2.EXE,FEAT3.EXE -u=Domain\jsmith' Example: 'configure -af FEAT1.EXE,FEAT2.EXE,FEAT3.EXE -g=Domain\FailFeatGroup' If you do not specify --user or --group then activations and checkouts will fail for the specified feature names for all users on the computer. |
-sg|--showfeaturegroupcol | Displays which feature groups are currently configured. Example: 'configure -sg' |
-fg|--featuregroupcol | Configures this client computer to process Flex_CheckOutListEx() in the following way. The first activation string or feature name is considered the parent group name of a feature group. The subsequent activation strings/feature names are the children of the feature group. The logic of the CheckOutList method will first attempt to checkout the parent and, if that checkout succeeds, will fail the checkouts of the children. If the parent checkout fails then the checkout of the children will be attempted. Specify 'parent feature name,child feature name1,child feature name2,...'. Example: 'configure -fg PARENT.EXE,CHILD1.EXE,CHILD2.EXE' |
-cg|--clearfeaturegroupcol | Configures this client computer to no longer process the specified activation string or feature name as a feature group. See 'configure -fg -h' for details regarding a feature group. This command undoes a previous 'configure -fg' command. Specify the 'feature group name'. If you do not specify an activation string or feature name, all previously specifed 'feature groups' are cleared. Example: 'configure -cg=PARENT.EXE' |
-u|--user | This option is used in conjunction with the --alwaysfailco or --clearalwaysfailco options. You can also use this option alone to display the name of the currently logged in user. The specified user qualifies the 'alwaysfailco' or 'clearalwasyfailco' specifications for the specified user. Specify a username: Example: 'configure -af feat1,feat2 -u=domain\jasmith' Display the currently logged on user name: Example: 'configure -u' |
-g|--group | This option is used in conjunction with the --alwaysfailco or --clearalwaysfailco options. You can also use this option alone to display the name of the groups that the currently logged in user belongs to. The specified group qualifies the 'alwaysfailco' or 'clearalwasyfailco' specifications to those users that belong to the specified group. Specify a group name: Example: 'configure -af feat1,feat2 -g=Domain\MaintenanceGroup' Display the groups that the currently logged on user belongs to: Example: 'configure -g' |
-cf|--clearalwaysfailco | Configures this client computer to clear the specified activation strings or feature names so checkout attempts will no longer always fail. This command undoes a previous 'configure -af ...' command. Specify 'feature name1,feature name2,...'. Example: 'configure -cf=FEAT1.EXE,FEAT2.EXE,FEAT3.EXE' Note: If you do not specify activation strings or feature names, all previously specified 'always fail' activation strings or feature names will be cleared. Example: 'configure -cf' You can also use the --user and --group sub-options to clear or remove the specified 'user' or 'group' qualified feature names. Example: 'configure -cf -u=Domain\jsmith' Example: 'configure -cf=FEAT1.EXE -u=Domain\jsmith' Example: 'configure -cf -g=Domain\GroupName' Example: 'configure -cf=FEAT1.EXE -g=Domain\GroupName' |
-s|--allowstandard | Configures whether this command-line utility can be run by a standard (non-Administrator) user. By default a standard user is not able to use this command-line utilty to execute any command. This option can only be executed by Administrators. Specify 'enable' or 'disable'. Example: 'configure -s enable' |
-gm|--ignoregoldmaster | Configures whether, during a checkout of an activation, a GoldMaster activation is checked for. By default the check for a GoldMaster activation does occur. Enabling this option can improve performance when checking out or accessing an activation because the GoldMaster activation is not looked for. Specify 'enable' or 'disable'. Example: 'configure -gm enable' |
-?|-h|--help | Show help information. |
Provide Feedback