Solutions

What configuration file is used by a project or project database?



ID:    S143618
Published:    01 March 2022
Updated:    27 June 2022

Operating System(s)

  • All Unix
  • All Windows

Product(s)

  • PVCS Version Manager
 

Description

How can I identify the configuration file (CFG) being used by a project database (PDB), or a project (yellow folder) in that project database?

Resolution

Using the Desktop Client GUI:
 
  • Select the Project Database root (drive icon), or the Project (yellow folder) you want to know the configuration file of.
     
  • Perform a right-click | Properties
     
  • Take note of the Configuration File path:



    (Only projects with a black tab on the yellow folder have a CFG file.)
     
Using PCLI:
 
  • To get the configuration file for a project database, execute:

    pcli GetConfigFile -pr"PathToProjectDatbase" -id"UserID:Password"

    The -id option is only necessary if you are normally prompted for a user ID.

    Example:

    C:\>pcli GetConfigFile -pr"C:\ProgramData\Serena\VM\SampleDB" -idAdmin
    Serena PVCS Version Manager (PCLI) v8.5.3.0 (Build 071) for Windows NT/80x86
    Copyright (C) 1985-2015 Serena Software. All rights reserved.
    C:\ProgramData\Serena\VM\SampleDb\archives\basecfg.cfg

    C:\>

     
  • If you cannot login to the project database but need to find the CFG to solve this, use the following trick:

    set PVCSFS_CLIENT_DEBUG=1
    pcli whoami -pr"PathToProjectDatbase"
    -idDummyCredentials

    Setting the environment variable PVCSFS_CLIENT_DEBUG=1 reveals the files being accessed, which includes the CFG file used to determine the credentials were invalid. Although there is no indicator which file is the CFG file, you can normally find out by looking for the .cfg file extension.

    Example:

    C:\>pcli whoami -pr"C:\ProgramData\Serena\VM\SampleDB" -idAdmin:BadPassword
    remotefcns::local_open(C:\pvcs\vm8630\vm\common\bin\win64\vmwfvc.dll sem=null) returned 3 first fault was -13
    remotefcns::remote_close(3) started
    remotefcns::remote_close(3) for file <null> returned: 0
    PVCS Version Manager (PCLI) v8.6.3.0 (Build 422) for Windows/x86_64
    (C) Copyright 2021 Micro Focus or one of its affiliates. All Rights Reserved.
    remotefcns::local_open(C:\ProgramData\Serena\VM\SampleDb\archives\basecfg.cfg sem=null) returned 4 first fault was -13
    remotefcns::remote_close(4) started
    remotefcns::remote_close(4) for file <null> returned: 0
    remotefcns::local_open(C:\ProgramData\Serena\VM\SampleDb\archives\access.db sem=null) returned 4 first fault was -13
    remotefcns::remote_close(4) started
    remotefcns::remote_close(4) for file <null> returned: 0
    15:12:36 Jun.27.22 [Error]
    You cannot access this project because your login account, Admin, is invalid. Please try to login again or contact your PVCS Version Manager administrator for further assistance.

    C:\>


    This works for both File Server and non-File Server based PDBs.
     
  • To get the configuration file for a project inside the project database, execute:

    pcli GetConfigFile -pr"PathToProjectDatbase" -id"UserID:Password" "ProjectEntityPath"

    The -id option is only necessary if you are normally prompted for a user ID.

    The ProjectEntityPath has the format "/top-level-project/sub-project/etc."

    Example:

    C:\>pcli GetConfigFile -pr"C:\ProgramData\Serena\VM\SampleDB" -idAdmin "/bridge"
    Serena PVCS Version Manager (PCLI) v8.5.3.0 (Build 071) for Windows NT/80x86
    Copyright (C) 1985-2015 Serena Software. All rights reserved.
    C:\ProgramData\Serena\VM\SampleDb\archives\bridge\bridge.cfg

    C:\>
If you are using a PVCS VM File Server and you need to locate the file on disk, you have to translate the path based on the Path Map it is accessed from.
 
For example, if the Configuration File shows:
 
 
and the Path Map this file is accessed from is defined as:
 
 
then the actual location on the File Server can be determined by replacing the Client name portion of the file with the Project DB path in the Path Map.
 
Using the example above, \\vmfs\One\archives\config.cfg would become F:\PDB\One\archives\config.cfg
 

 


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