webadmin – introducing the new server admin tool

Friday, October 20, 2017 2 Comments

We have just released a new cross-platform (web-based) admin tool to configure and monitor the Plastic SCM server. We call it webadmin and it is included in release

How to use it?

New install? Easy, just open a browser to localhost:7178 in your server after installing Plastic SCM and you are done.

Existing install – the webadmin will also listen on locahost:7178 on your server machine. But it won’t let you login before you set a password for it. Just open a browser to localhost:7178 and follow the steps.

We are not currently using HTTPS to avoid the warning message about self-signed certificates that will throw lots of users back when using it for the first time, but this is something we obviously need to add soon.

What it is all about?

It is a new administration console for the server. Historically we had admintool.exe, configureserver.exe and umtoolgui.exe to configure and administer the server, including creating users and groups. The 3 tools were Windows only.

We needed to come up with a cross-platform solution for the Linux and OS X servers, and a web interface made a lot of sense. And that’s what webadmin is about. A tool to let you tune the server params, monitor it, create users and groups, and even migrate to different backends.

And everything made self-explanatory with texts detailing what every setting is about.

What can webadmin do exactly?

The new admin console allows you to:

  • Configure the network, including ports (TCP, SSL), the auto-discovery service and more (REMARK: UDT is not working at this point, but it will be ready soon).
  • Configure authentication: to select the authentication mode (user-password, LDAP, Active Directory, etc), finely tune each mode (different params in LDAP, for instance) and even configure users and groups in UP.
  • Repository storage: to tune settings and migrate to a different backend.
  • Advanced parameters like forcing specific client versions, timeouts, threadpool settings and more.
  • Configure the audit log.
  • Configure lock rules: that now are also auto-reloaded without having to restart the server.
  • Comprehensive license configuration: both during evaluation and server operation.
  • A new support functionality to easily create "support bundles" to send relevant info in seconds when an issue happens.
  • An option to recover access to the system if the sysadmin was incorrectly revoked.
  • Monitor: a server monitoring panel to track health and performance parameters.

Bonus track – config files are now reloaded on the fly

As part of this project we made some key changes to the Plastic SCM server. Now it monitors all the relevant configuration files and reloads them when it detects changes. So there is no need to restart the Plastic SCM server when you manually edit server.conf, db.conf, remoting.conf and lock.conf.

We develop Plastic SCM, a version control that excels in branching and merging, can deal with huge projects and big binary assets natively, and it comes with GUIs and tools to make everything simpler.

If you want to give it a try, download it from here.

We are also the developers of SemanticMerge, and the gmaster Git client.


  1. I admin 2 PlasticScm Servers (1 personal and 1 at my work) and i can't change the repository storage from the webAdmin.

    In both the current backend is JET, but i want one to be MYSQL, it's not posible migrate from jet to another?.

    1. Hi Kevin,

      JET is our fastest and more solid backend. It took us years to decide to go forward with it, but now it is in use in some of our largest deployments, with hundreds of concurrent users and TBs of repo sizes.

      So, our belief was: JET is the best, so no reason to migrate out of it :-)

      JET uses memory mapped files to access the underlying metadata files, and pointer arithmetic, so it runs circles around MySQL and SQL Server with Plastic.

      Now, if you still want to migrate, and until we release a proper database-to-database migration for Jet, you can always replicate between servers :)