Documentation

Support

Unity Version Control

Access the server administration console

Configure the settings of your server.
Read time 2 minutesLast updated 21 days ago

Access the server administration console to configure your Unity Version Control (UVCS) server settings. When you install the Unity Version Control server, you install it with default configuration values and it is ready for your UVCS clients to connect to it and run. The UVCS On-Prem server administration console is a cross-platform server configuration tool UI that the administrator can use to configure the server settings to suit the organization's needs.

Launch the administration console

To launch the server administration console, you can use one of the following methods:
  • Connect to the server address in your preferred web browser:
    • If you don't have any SSL ports defined in your server network configuration, use
      http://localhost:7178
      . The server administration console HTTP endpoint listens on port
      7178
      by default and it's bound to localhost only.
    • If you do have any SSL ports defined in your server network configuration, use
      https://ipserver:7179
      . You can configure that port using the
      WebAdminToolSslPort
      setting in the
      server.conf
      file. This endpoint will listen on any network interface.
    • Note: The web server automatically uses the first certificate you configured in your network settings. This means that the web interface will automatically use the same certificate for your UVCS SSL connections without any further configuration. If you don't have any SSL ports defined in your server network configuration, only the HTTP endpoint will start.
  • Directly run the server administration console:
    • On Windows: Launch the Server Admin Console from the Windows start menu.
    • On macOS: Run the Plastic SCM Server application.

Set a password

To open the administration console, you need to enter the required credentials. If your server is newly installed, set a password to access the administration console. If you’ve set the server up, but the administration console password isn’t set, use the
plasticd admindpwd
utility to configure a password:
  1. Open the command line as an administrator.
  2. Run the following command:
    • Windows:
      Plastic SCM installation directory\server\plasticd adminpwd--pwd=yourpassword
    • Linux:
      /opt/plasticscm5/server/plasticd adminpwd --pwd=yourpassword
    • macOS:
      /Applications/PlasticSCMServer.app/Contents/MacOS/plasticd adminpwd--pwd=yourpassword
  3. Navigate back to the administration console and select Refresh.
  4. Enter the configured password and select Log in.

Configure required settings

Settings

Description

NetworkEdit the UVCS listening ports for both encrypted and non-encrypted data.
AuthenticationConfigure the authentication mode that users and groups use. By default, the configuration mode is Local name.
Repository storageConfigure the storage parameters.
Advanced featuresSet up some advanced values related to global security settings, buffer pools, and trigger variables.
AuditChange the audit log level.
SecurityConfigure the data related to the UVCS server administrator.
Lock rulesSet up the exclusive checkout rules.
You can also access other relevant information:

Settings

Description

LicenseConfigure everything about the UVCS On-Prem license: buy a UVCS license, enter the
plasticd.lic
license file, or configure the autorenewal option.
SupportFind solutions to your issues, contact the UVCS support team, or send your suggestions.
MonitorMonitor the UVCS Server activity live.