Configuration files

[Guest]

I'm evaluating PlasticSCM and I'm trying to understand what is the function of each configuration file.

From client side, I understood all files with .conf extension, but from server side, I have some doubts.

Please, can you explain the function of each server configuration file?

Thanks in advanced.

[danipen]

Hello Sam.

Here, there is a summary of client and server configuration files.

CLIENT CONFIGURATION FILES

client.conf

-----------------------

This is a general configuration file for PlasticSCM clients. Contains information about language, Workspace Server, Users/security working mode, Current Workspace, Merge Tools, etc ...

On windows systems, this file is located in "c:\Documents and Settings\USER\Local Configurationl\Program Data\plastic" folder

On linux systems this file is located on "/home/USER/.local/shared/plastic" folder

Each user account in a machine has its own client configuration file.

You don't need to edit this file manually, because there are tools to manage this file. From command line:

"plastic --configure" to launch a GUI wizard

"configureclient" to launch a text based wizard

guiclient.conf

------------------------

This is a GUI client specific configuration file. This file stores preferences of GUI tool. You don't need to edit this file manually. You can launch the GUI client preferences and edit values there.

This file is located in the same path that client.conf file.

SERVER CONFIGURATION FILES

server.conf

-------------------------

This file is the main server configuration file. All configuration files are located in server installation directory. You don't need to edit this file manually. You can launch:

"configureloader" to launch a GUI wizard

"configureserver" to launch a text based wizard

loader.log.conf

-------------------------

This is the server log configuration file. PlasticSCM uses log4net (http://logging.apache.org/log4net/) to log output messages, so this configuration file is log4net-based syntax. With this file you can configure server log level (INFO, ERROR, FATAL ...) and the output of the log. Here is a configuration example:

<log4net>
<appender name="FileAppender" type="log4net.Appender.FileAppender">
       	  <file value="log-file.txt" />
          <appendToFile value="true" />
          <layout type="log4net.Layout.PatternLayout">
       	  	  <conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />
         	  </layout>
</appender>

<root>		
		<level value="ERROR" /> 
	<appender-ref ref="FileAppender" />
</root>
</log4net>

db.conf (optional)

----------------------------

When you want to change default database backend for server, you must include this file. By default, PlasticSCM uses firebird database to store all data. You can switch to SQL Server and others database server.

Here is a SQL Server database backend example:

<DbConfig>
<ProviderName>sqlserver</ProviderName>
<ConnectionString>SERVER=MORDOR\SQLEXPRESS;User Id=sa;Pwd=xxxxx;DATABASE={0};</ConnectionString>
<DatabasePath>D:\repositories</DatabasePath>
</DbConfig>