Access the server administration console

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 Enterprise 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](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

SettingsDescription
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:

SettingsDescription
LicenseConfigure everything about the UVCS Enterprise edition 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.

Note: If you edit the server.conf, network.conf, db.conf, and lock.conf files, the UVCS server reloads the configuration immediately.