ftlm_accounts

Utility to show and manage user project and custom group definitions.


ftlm_accounts: Usage Message
  
  Utility to show and manage user project and custom group definitions.
  
  USAGE:
  
    ftlm_accounts [OPTIONS] <ACTION> ....
  
  PROJECT ACTIONS:
  
    showdb                    - Show ALL project assignments found for each user
                                in the database. For users with no project
                                assignments, the default of "none" is printed.
    autofill                  - Automatically assign projects to users by
                                searching for previously assigned projects. The
                                most frequently used project is assigned. If
                                none are found, a warning is printed.
    setdb <users> <project>   - Assign a project to one or more users. If a
                                user is not already in the database, an error is
                                printed for that user. To clear all project
                                assignments for the specified user(s), pass ""
                                as the <project>.
    reset                     - Clear all project assignments for all users.
                                WARNING: This is destructive and can take a
                                while.
    showlive                  - Show project assignments that are to be applied
                                to new checkouts as they occur.
    setlive <users> <project> - Assign a default project to one or more users
                                for checkouts that will be detected by
                                LicenseMonitor.
    setliveall                - Assign a default project for all live checkouts
                                based on the definitions in the project
                                configuration.
    clearlive                 - Clear all live project assignments.
  
  PROJECT OPTIONS:
  
    -origin <N>               - Restrict to given origin.
  
  CUSTOM GROUP ACTIONS:
  
    addmembership                        - Deprecated.  Use addusermembership.
    addhostmembership                    - Add a host to a host-based custom
      <type> <group> <host>                group. If overlap is detected, an
      <startDateSpec> <endDateSpec>        extension to the existing membership
                                           is made.
    addusermembership                    - Add a user to a user-based custom
      <type> <group> <user>                group. If overlap is detected, an
      <startDateSpec> <endDateSpec>        extension to the existing membership
                                           is made.
    backdatememberships                  - Backdate the start time of
      <TIMESPEC> [type] [group]            memberships that belong to the
                                           optionally specified type or
                                           type/group pair. If no type is
                                           passed, all memberships will be back-
                                           dated. TIMESPEC may be specified as a
                                           number of seconds or as a time
                                           abbreviation such as 1m, 1h, 1d,
                                           or 1w.
    deletegroup <type> <group>           - Delete a group.
    deletegrouptype <type>               - Delete a group type.
    deletemember                         - Delete all memberships for the member
      <type> <group> <member>              and group specified.
    deletemembership                     - Delete a specific membership for the
      <type> <group> <member>              member and group specified. Times
      <startDateSpec> <endDateSpec>        must match an existing membership
                                           exactly.
    dumpmemberships                      - Dump existing memberships in config
                                           file format.
    loadfromfile [external file path]    - Load membership information from
                                           configuration file. Default file is
                                           licmon.swd/config/accounts.cfg.
                                           Optionally, an external file may be
                                           specified.
    loadfromoptions                      - Load membership information from
      [external file path]                 FLEXlm options file. Specify a group
      <groupType> <optionsGroupList>       type and the options file group(s)
                                           that will be used to populate a group
                                           by the same name. To use all groups,
                                           specify "all".
                                           A user cannot be a member of more
                                           than one group of the same type, so
                                           make sure different group types are
                                           specified for each group that
                                           contains a common user.
    showgroups <type>                    - Show custom groups of specified type.
    showgrouptypes                       - Show custom group types.
    showmembers <type> <group>           - Show group members.
    showmemberships                      - Deprecated. Use showusermemberships.
    showhostmemberships <host>           - Show group memberships for the
                                           specified host.
    showusermemberships <user>           - Show group memberships for the
                                           specified user.
    updatemembership                     - Update a membership. Times must match
      <type> <group> <member>              an existing membership exactly. This 
      <oldStartDateSpec> <oldEndDateSpec>  is normally used to shorten a
      <newStartDateSpec> <newEndDateSpec>  membership due to how the 
                                           addmembership action creates
                                           extensions upon overlap.
  
  ABOUT CUSTOM GROUP DATESPECS:
  
    Times may be specified in the following formats:
  
    10-digit Unix timestamp
    YYYYMMDD
    YYYY-MM-DD
    Full date shown in "ftlm_accounts -showmemberships" output
  
    Examples:
    ftlm_accounts deletemembership location "San Jose" joe 1293655667 1293655668
    ftlm_accounts deletemembership location "San Jose" joe 20100101 20110101
  
  COMMON OPTIONS:
  
    -f                        - Force flag (use with reset to avoid dialog).
    -v                        - Increase verbosity.
    -h                        - This help.
  
  EXAMPLES: DATABASE MANIPULATION:
  
    % ftlm_accounts setdb "john mary dan" "ChipA"
    % ftlm_accounts reset
    % ftlm_accounts -f reset
    % ftlm_accounts autofill
  
  EXAMPLES: NEW CHECKOUTS:
  
    % ftlm_accounts showlive
    % ftlm_accounts setlive "john mary dan" "ChipA"
    % ftlm_accounts setliveall
    % ftlm_accounts clearlive
  
  SEE ALSO:
     ftlm_lmproject