Solutions

VM 8.6 Administrative logging for critical actions



ID:    S142156
Published:    31 May 2017
Updated:    16 October 2019

Operating System(s)

  • All Unix
  • All Windows

Product(s)

  • PVCS Version Manager 8.6
 

Description

Version Manager 8.6 added Administrative logging for critical actions [ENH274527, ENH277977, ENH77674, ENH274946, ENH277979].
 
Where are these logs stored, what type of information is being logged and what are some sample values?
 

Resolution

  • The file change.log, located in the Project Database (PDB) directory, already logged changes made to projects. For more information, see KB doc S143017.

    As of VM 8.6 it additionally logs changes made to workspaces and configuration files via the Desktop Client GUI and PCLI.
     
  • The file security.log, located in the same directory, was newly added in VM 8.6 and contains a log of changes made to the Access Control Database via the Desktop Client GUI and PCLI.
     
  • Both files have Tab-separated values.
 
 
The additional information being logged, broken up by category:

 
Changes made to Projects

Additional log entry types have been added to the change.log file:
 
  • ChangeProjWorkspaceAttr:WorkPath    "WorkspaceName:ProjectEntityPath"    "ArchivePath"    "OldWorkfileDirectory"    "NewWorkfileDirectory"

    2017/01/25 16:45 GMT-08:00    root    ChangeProjWorkspaceAttr:WorkPath    "/@/RootWorkspace:/"    "\\vmfs\One\archives"    "C:\work"    "$HOME\work"
       
  • ChangeProjWorkspaceAttr:DefaultVersion    "WorkspaceName:ProjectEntityPath"    "ArchivePath"    "OldDefaultVersion"    "NewDefaultVersion"

    2017/03/16 14:36 GMT-07:00    root    ChangeProjWorkspaceAttr:DefaultVersion    "/@/RootWorkspace:/"    "\\vmfs\One\archives"   ""   "LATEST"
     
  • ChangeProjWorkspaceAttr:BaseVersion    "WorkspaceName:ProjectEntityPath"    "ArchivePath"    "OldBaseVersion"    "NewBaseVersion"

    2017/03/16 14:25 GMT-07:00    root    ChangeProjWorkspaceAttr:BaseVersion    "/@/RootWorkspace:/"    "\\vmfs\One\archives"    ""    "BASE_VER"
     
  • ChangeProjWorkspaceAttr:BranchVersion    "WorkspaceName:ProjectEntityPath"    "ArchivePath"    "OldBranchVersion"    "NewBranchVersion"

    2017/05/31 15:27 GMT-07:00    rgering    ChangeProjWorkspaceAttr:BranchVersion    "/@/RootWorkspace:/"    "\\vmfs\One\archives"    ""    "BRANCH_VER"
     
  • ChangeProjAttr:DefaultDevPromoGroup    "ProjectEntityPath"    "ArchivePath"    "OldDefaultPromotionGroup"    "NewDefaultPromotionGroup"

    2017/05/31 15:28 GMT-07:00    rgering    ChangeProjAttr:DefaultDevPromoGroup    "/"    "\\vmfs\One\archives"    ""    "Development"

 

 

Changed made to Versioned Files
 
 
Additional log entry types have been added to the change.log file:
 
  • ChangeVersionItemAttr:ArchivePath    "FileEntityPath"    "FileArchivePath"    "OldFileArchivePath"    "NewArchivePath"

    2017/05/31 16:06 GMT-07:00    rgering    ChangeVersionItemAttr:ArchivePath    "/ls.txt"    "//vmfs/One/archives/ls.txt-arc"    "//vmfs/One/archives/ls.txt-arc"    "//vmfs/One/archives/ls_RENAMED.txt-arc"
     
  • ChangeVersionItemAttr:Name    "FileEntityPath"    "FileArchivePath"    "OldFileName"    "NewFileName"

    2017/05/31 16:06 GMT-07:00    rgering    ChangeVersionItemAttr:Name    "/ls.txt"    "//vmfs/One/archives/ls.txt-arc"    "ls.txt"    "ls_RENAMED.txt"
     
  • ChangeVersionItemWorkspaceAttr:WorkPath    "WorkspaceName:FileEntityPath"    "ArchivePath"    "OldWorkfileDirectory"    "NewWorkfileDirectory"

    2017/05/31 17:05 GMT-07:00    root    ChangeVersionItemWorkspaceAttr:WorkPath    "/@/RootWorkspace:/test/GameLibrary.java"    "\\vmfs\One\archives\test\GameLibrary.java-arc"    "C:/work/One/test5"    "subdir"
 
 
Changes made to Configuration files
 
Additional log entry types have been added to the change.log file:

  • ChangeConfigProj:ConfigurationItemName    "ProjectEntityPath"    "OldValue"    "NewValue"    "ConfigurationFile"

    (The number of possible ConfigurationItemName values is very extensive; some random examples.)

    2017/05/31 16:12 GMT-07:00    rgering    ChangeConfigProj:RenameArchiveWhenWorkfileIsRenamed(SLOW)    "/"    "0"    "1"    "\\vmfs\One\archives\config.cfg"
    2017/02/07 16:21 GMT-08:00    root    ChangeConfigProj:EventTriggers    "/"    "{AllEvents=echo __EventClientWorkfile__}"    "{AllEvents=}"    "\\vmfs\One\archives\config.cfg"

    2017/05/31 17:20 GMT-07:00    root    ChangeLdapConfig:AddedServer    "/"    ""    "{BindAnonymously=false, LDAPServersAndPorts=my-ldap-server:389, UserDN=ldapquery, DereferenceAliases=N, FollowReferrals=false, UserNameAttribute=sAMAccountName, CertificateFile=C:\pvcs\vm8600\vm\common\bin\win64, UseSSL=false, BaseUserContext=OU=Users,DC=MyCompany,DC=com, ConnectionTimeoutSeconds=30, Password=TopSecret}"    "//vmfs/One/pvcsldap.ini"

 

 

Changes made to Access Control Database (ACDB) files

ACDB changes are logged in a new file called security.log:
 
  • ChangeProjSecurity    "ProjectEntityPath"    "ChangeOperation"    "DescriptionOfChanges, ..."    "AccessControlDatabase"

    2017/05/31 16:46 GMT-07:00    rgering    ChangeProjSecurity    "/"    "added users"    "[TestUser]"    "\\vmfs\One\archives\access.db"

    2017/05/31 16:46 GMT-07:00    rgering    ChangeProjSecurity    "/"    "privilege sets change for user: TestUser"    "[+UNLIMITED]"    "\\vmfs\One\archives\access.db"

    2017/05/31 16:46 GMT-07:00    rgering    ChangeProjSecurity    "/"    "privileges change for user: TestUser"    "[+Add Promotion Group, +Add Version Label, +Break Lock, +Modify Archive Access List, +Modify Comment Delimiter, +Modify Archive Owner, +Modify Archive Attributes, +Modify Versioned File Name, +Delete Promotion Group, +Delete Non-Tip, +Delete Tip, +Delete Version Label, +Get Non-Tip, +Get Tip, +Create Archive and Workfile, +Lock Non-Tip, +Modify Change Description, +Modify Promotion Group, +Modify Version Label Revision Number, +Modify Workfile Description, +Promote To The Next Promotion Group, +Put Tip, +Create Branch, +Unlock, +View Access Control Database, +View Archive Header, +View Archive Revisions]"    "\\vmfs\One\archives\access.db"

    2017/05/31 16:46 GMT-07:00    rgering    ChangeProjSecurity    "/"    "added password for user: TestUser"    "[******]"    "\\vmfs\One\archives\access.db"

    2017/05/31 16:46 GMT-07:00    rgering    ChangeProjSecurity    "/"    "changed password for user: TestUser"    "[******]"    "\\vmfs\One\archives\access.db"

    2017/05/31 16:46 GMT-07:00    rgering    ChangeProjSecurity    "/"    "removed password from user: TestUser"    "[******]"    "\\vmfs\One\archives\access.db"

    2017/05/31 16:47 GMT-07:00    rgering    ChangeProjSecurity    "/"    "privilege sets change for user: TestUser"    "[-UNLIMITED]"    "\\vmfs\One\archives\access.db"

    2017/05/31 16:47 GMT-07:00    rgering    ChangeProjSecurity    "/"    "privileges change for user: TestUser"    "[-Lock Non-Tip, +Put Branch, +Lock Tip]"    "\\vmfs\One\archives\access.db"

    2017/05/31 16:47 GMT-07:00    rgering    ChangeProjSecurity    "/"    "removed users"    "[TestUser]"    "\\vmfs\One\archives\access.db"

    2017/05/31 16:47 GMT-07:00    rgering    ChangeProjSecurity    "/"    "privileges change for user: TestUser"    "[-Modify Comment Delimiter, -Promote To The Next Promotion Group, -Break Lock, -Add Version Label, -Modify Archive Attributes, -Modify Archive Access List, -View Access Control Database, -Put Tip, -Put Branch, -Modify Versioned File Name, -Delete Promotion Group, -View Archive Header, -View Archive Revisions, -Lock Tip, -Modify Version Label Revision Number, -Add Promotion Group, -Unlock, -Create Branch, -Get Non-Tip, -Get Tip, -Delete Version Label, -Modify Archive Owner, -Create Archive and Workfile, -Delete Non-Tip, -Delete Tip, -Modify Change Description, -Modify Workfile Description, -Modify Promotion Group]"    "\\vmfs\One\archives\access.db"

 


Rate this Solution

Find Answers

Type a question or describe what you are looking for below

My Recent Searches

Welcome kb sso

Additional Assistance

  • Submit a Case Online
  • FAQs