Plastic SCM to Perforce P4 Migration Guide

Introduction

Version control is the foundation for your development pipeline. When it works, teams get the files and feedback they need quickly. They can collaborate without overriding files. When it doesn’t, velocity slows, and developers and artists are left waiting. If you are building the next great game or immersive cinematic experience, you eventually are going to push the boundaries of scale and performance. Picking the right version control will set you up for success.

Plastic SCM can work for smaller teams and repos. But over time, performance declines, causing major issues. Whether you are a current Plastic SCM customer, or you are going through a proof of concept, start here to learn about your options.

While this guide provides considerations for migrating, it should not be considered technical documentation. Perforce Professional Services can provide further insight on how to successfully migrate to P4.

Plastic SCM vs. Perforce P4 Comparison

If you are just starting to look at Plastic SCM, compare functionality with P4.

Functionality	Plastic SCM	Perforce P4
Centralized (check files in and out from a central repo)	Yes	Yes
Distributed (push and pull between repos)	Yes	Yes — DVCS is also available for your teams to push and pull between repos.
File commit restrictions	Yes – Plastic SCM uses a per-changeset model that requires the entire workspace be up to date before being allowed to commit. This introduces unnecessary delays and restrictions.	No – In P4, only modified files are required to be up to date before being allowed to commit. This allows developers to quickly commit changes without having to update the entire project every time they want to submit a change.
Time-lapse views	No — Plastic SCM users have been asking for this functionality and it’s been on their backlog for a while. They do offer version tree 2D, which does allow you to review a list of revisions to a file. But this feature does not show the entire history of a file. It lacks the ability to show merges impacting a file (cherry picked) and does not display revert actions, which can lead to confusion.	Yes – Scroll through your history to understand how your code evolves. With Time-lapse View in P4 Visual Client, you can review a single revision, incremental diffs, and even multiple revisions. This gives you a better understanding of not just when, but why the changes were made and by whom.
Workspace types for different GUIs	Yes — “Regular" workspaces for non-Glueon vs. “partial” workspaces for Glueon are not compatible with each other.	No — In P4, all workspaces are the same. In P4 Visual Client, you can switch in between workspaces. Using P4 Sync — the desktop client for artists/designers — you can set up workspaces that allow users to drag and drop files into the depot.
Manage large to huge repos	Not Really — Plastic SCM’s own performance tests conveniently top out with a repo that is less than 8 GB, which is tiny in the modern game development word.	Yes — P4 was built to scale and can manage 100s TBs and millions of files in a single repo (without the wait).
Stores large files (binaries)	Yes — But it severely impacts performance.	Yes — P4 can handle everything with the speed required for high-performing teams.
Locks to avoid merge conflicts	Yes	Yes
Built-in code review	No	Yes — P4 Code Review, which is free with P4, is a scalable code review and collaboration tool for all types of intellectual property. It seamlessly handles 100s or 1000s of reviews at once, regardless of file type or size.
GUIs for developers and designers	Yes —But they are completely disconnected. You cannot work on code and digital assets in the same workspace since they require different GUIs by performance.	Yes — Use P4 Visual Client (P4V) for code, binaries, and even Git files. Use P4 Sync for drop and drag version control, no matter your toolset. You can easily switch back and forth between them and work in the same workspace.
Task branches	Yes	Yes — Using Perforce Streams, developers can make task streams.
Detecting merges and showing history	No	Yes — Stream and revision browsers show the entire merge and version history, plus how files and streams have changed over time.
Merge process and automation	No	Yes — Streams light up red and green to show copy/merge events that are available, easily guiding the user through the merge process. You can even use Streams to automate.
Graphical model, Stream/branch workflow management	Yes — But there are some limitations.	Yes – The Stream Graph allows you to create streams and determine the relationships between them. This helps automate the flow of your code and digital assets. You can even drag and drop to re-organize how you work.

Migration Checklist

If you already have Plastic SCM, you can seamlessly migrate to Perforce P4. But first, it is key to review your entire development environment. If you do not have Plastic SCM, these steps and methods can be used with other version control systems.

Identify Your Stakeholders
Include IT and your Plastic SCM admins. It is important to incorporate daily users — developers, managers, and artists.
Assess the Current State of Your System
Document the version, server location, and any customizations. Run any data verification utilities. If you have corrupt data, it’s better to know about it up front.
Plan Your Deployment
Will you be deploying P4 on the same platform as your existing Plastic deployment? Will your P4 deployment include multiple servers (standbys for High Availability, edges for locating data close to users, etc.)? Determine the optimal approach for migrating your data, including a discussion with our Professional Services team.
Document Your Current Plastic SCM Configuration
What is your branching strategy? How many releases do you need to continue to support? Migration is a good time to address any issues with your current configuration. Do you have in-house tools to support your users? Those may have to be ported to work with P4.
Consider Key Milestones
Is there a big release coming up that can’t be disrupted? Migrations can impact release timelines. It is important to consider the improvements in switching to a new version control and how it may impact velocity.
Identify How Much History to Import
Will the latest file versions work — or do you need detailed history? Review Migration Strategies to learn more about your options.
Evaluate Integrations and Topology
What tools and automations interact with Plastic SCM? Do you use a game engine or other build runner integration?
Plan Your Cutover Strategy
Will your users transition to P4 at the same time or will you plan a phased approach? Do you need to continue supporting other version control systems, like Git?
Determine Training Required
Determine what level of training your users and admins will need — online or classroom-based P4 training, beginner or advanced.
Decide on Success Metrics
Possibilities include verification of imported data, reproducibility of important builds, and a measure of impact on productivity.

Migration Approaches

Determining what and how much history to import requires careful consideration. You may have different approaches for different products. This may depend on where they are in their lifecycle and importance to your organization.

Not all organizations need their entire imported history. For many, migrating over the milestones and art assets is enough. Figure out what you’ll really need before you take the time and effort required for imports.

There are three migration approaches you can consider: Tips Only, Detailed History Import (DHI), or Baseline and Branch Import (BBI).

Tips Only

This approach involves getting the latest file versions, or “tips,” from Plastic SCM (or other version control system) and adding them to P4. No history is preserved. This approach is sometimes appropriate for documentation but is rarely ideal for source code, except for prototype and demo code. This is, in essence, a “start over” approach.

Detailed History Import (DHI)

This is the most comprehensive conversion approach. It captures as much detailed branch/merge information as possible. This allows you to conduct historical research in the new system without requiring the old one. A DHI captures elements such as properties, user descriptions, and check-in comments. With this approach, you can see your old history in a new light with P4’s powerful visualization tools. Depending on your plans, you may or may not need all information. Many customers will do a BBI (Baseline and Branch Import) first, and if needed, proceed with a DHI.

Baseline and Branch Import (BBI)

The BBI approach offers a lightweight migration alternative to the DHI. It’s more sophisticated than the Tips Only approach and avoids the technical complexity of a DHI. The BBI approach uses a branch diagram to select the history to import. The diagram shows the baselines, which are snapshots of a directory structure at a specified time, and major branching operations. It imports branching operations at a high level, capturing the sum of merge operations. A BBI lets you get started quickly and is very reliable.

Technical Tips

As you move from Plastic SCM to Perforce P4, consider the following technical tips to help your migration go smoothly.

Convert on the same platform as the server to prevent complications. After the migration, you can always change platforms.
Migrations can be hardware intensive, so you may want a separate migration server. (This applies mostly for DHI migrations).
Consider typemap, file types, and scripting. You’ll want to plan according based on the data types you have.
Use the flexibility of workspace mapping to manage other version control systems.

Reevaluate Your Branching Strategy

When setting up your version control, it is important to consider your branching strategy and what you want it to look like. Plastic SCM does offer standard branching capabilities — task branching, diff, and 3-way merge tools. They claim to handle complex integration scenarios like move/rename + readd better than P4. But that is not true.

P4 handles merges for the world’s largest and most complex codebases. In continuing to deliver on its best-in-class capability, P4’s latest release delivered improvements to the namespace merge algorithm.

With Perforce Streams — the branching mechanism in P4 — developers’ lives are easier. It helps them code more instead of dealing with overhead. The structure is built-in to support complex branching for development and releases (no matter your branching strategy). Plus, this foundation is flexible enough to adapt to how your team works.

📘 Related Resource: Get a complete guide to version control branching

Perforce P4 Branching

Plastic SCM highlights their task branches and claims that 95% of scenarios and teams use this strategy. This may be true for smaller teams. But as teams expand and products become more complex, branching strategies need to adapt.

P4 has task streams, as well as other types of streams to handle different operations — from basic branching to implementing CI/CD. With Streams, complex workflows and relationships are made simple. There are several benefits for users:

Streams defines the purpose of each branch: mainline, development, task, or release.
Streams follow the mainline model — all changes flow toward the mainline.
Each stream (except the mainline, which is the root) has a parent stream that defines a clear hierarchy along which changes flow.
The Stream Graph identifies changes that still need to be propagated.
Client workspaces are locked to a stream, eliminating the need to set up the view manually. Client workspaces can be switched from one related stream to another. Only the files that differ between these Streams will be updated.

Types of Streams

Mainline: A stream with no parent. Expects merging down from more stable child streams. Expects copying up from less stable child Streams. Used as the stable “main” of a stream system.

Release: A stream that is more stable than its parent. Expects merging down from more stable child streams. Does not expect copying up from its parent stream. Useful for ongoing stabilization, bug fixing, and release maintenance.

Development: A stream that is less stable than its parent. Expects merging down from its parent stream. Expects copying up from its less stable child streams. Does not expect to have more stable child streams. Useful for longterm projects and major new features.

There are two additional Stream types with special characteristics:

Task streams are lightweight, short-term branches that can be used for work that affects a small portion of a full project branch. Task streams enable work to be done privately, let developers switch contexts quickly, and reduce the amount of metadata managed by the P4 server.

Virtual streams provide users with the ability to restrict the workspace view of a real stream. Virtual streams act as a filter. They are used to sync a particular set of files, rather than all the files in the stream view to a workspace.

Plastic SCM vs. Perforce Cloud

Plastic SCM offers a cloud hosting solution, which removes some of the ongoing maintenance requirements. However, any customers that need to work at scale quickly find that they need to move from their cloud offering to their enterprise offering. With P4, you can get everything you need in your preferred cloud (AWS, Azure, DigitalOcean, and coming soon GCP) in just a few clicks.

With the Enhanced Studio Pack from Perforce, you get everything you need for development in a single, preconfigured environment. It includes:

P4 Version Control
P4 Code Review
P4 Plan Project Management
Windows Workstation – Virtualized desktop with GPU
Perforce clients and 3rd party tools like Blender, Epic Game Launcher, and Visual Studio

Get Free Cloud Tools

Looking to spend less time backing up data and managing your server? There are a couple of solutions available. They can help you focus more on innovation and less on the technical details.

P4 Remote Administration

Looking for a solution where you choose your own cloud provider? P4 Remote Administration (HRA) lets you pick your cloud. Then our Perforce experts set up and manage P4 and P4 Code Review remotely, making sure you get the most out of your cloud investment. Think of Perforce as your admins. But instead of paying for someone to optimize your deployment, you get access to the people who know the product best.

P4 Remote Administration Resources

Other Hosting Options

Sometimes you just want someone else to host and manage your environment. With Assembla, you get the benefits of P4 fully hosted and backed by Perforce Assembla pros. They can help you with regular performance checkups and security audits.

P4 in the Cloud

Key Terminology

Plastic SCM	Perforce P4	Description
Branch	Stream	Branching is how development work is organized. In P4, Perforce Streams is the branching mechanism used by teams. It helps to streamline workflows and guides changes. This is because Streams creates a “parent and child” relationship between related streams. This helps to reduce merge conflicts. Plus, Streams can be used to automate development and release process. More on Streams >>
Main	Mainline	The main branch in version control in Plastic SCM is known as “main.” In P4, it is referred to as the “mainline” stream.
Repository	Depot	A depot is where you store place where all versions of files in P4.
Workspace	Workspace	Workspaces refer to a directory where your project is located. Files from that workspace are worked on locally and then submitted back to the depot. In both Plastic SCM and P4, you can use multiple workspaces in the same repo/depot.
Checkin	Submit	You use “submit “when checking changes into the depot.
Changeset	Changelist	With P4, every time you check files in it creates a numbered changelist. To help organize your submits, you can either put changes into your default changelist, or cherry pick changes and assign them a changelist number.
Update	Sync	To update files displayed in your depot or changelist, use sync.
Checkout	Edit	To work on a file, you need to check it out. In P4, you can also use “exclusive checkout” to prevent other teammates from overriding your work.

Frequently Asked Questions

Does Plastic SCM Perform Better Than Perforce P4?

On their website, Plastic SCM lays out a performance scenario that they refer to as “medium.” It makes sense that Plastic SCM would avoid comparing “large” and “extra-large” scenarios since they cannot scale like P4.

Their “medium” test only involves a repo that is 7.16GB in total size. P4 would label this test “small” (if not “extra-small”). This test was run on a Windows environment. P4 install base is approximately split between Linux and Windows, but skews more heavily towards Linux.

In addition, this performance comparison was run against P4 version 2018.2. Recent changes to P4 have resulted in >10% performance gains on both “sync” and “submit” operations on Windows servers.

Does Plastic SCM Have a Better Artist GUI Than P4?

Plastic SCM has a GUI — Glueon. It is positioned to be more user friendly. But not everyone on a team, especially artists and designers, want to learn a new tool. To avoid version control, some team members may even start using email or DropBox instead.

P4 has been serving teams of developers for years. Artists and designers that need to version and do not want to learn a new tool can use P4 Sync — the free desktop client.

Using P4 Sync, all assets can be stored in the same depot. Non-coders drag and drop assets to seamlessly version. Plus, teams know that assets are always protected and can be reused. With P4 Sync, teams get a single source of truth for all digital assets, leading to faster builds and seamless collaboration.

Does Perforce P4 Work With Git?

Plastic offers a 2-way sync with Git because plastic “adheres to the Git protocol.” Developers can push and pull and to Git, it just looks like another client.

Perforce also offers a Git solution. With P4 Git Connector, you get a mirroring system that allows developers to continue using their current preferred Git code hosting & collaboration solutions. To them, it looks like Git. But all the code is stored in the powerful P4 server. Teams get a single source of truth for all assets, and they can view code from both Git and P4 in a single P4 workspace.

You can also use our Perforce TeamHub Git code hosting & collaboration solution to take advantage of unique to-Perforce Git functionality like multi-repo code reviews and the new hth-cli command line offering.

Learn More

Get the most out of your version control. With P4, you can accelerate development and scale as your grow. Learn why 19 of the top 20 AAA game development studios trust Perforce P4.

Get Started For Free

Try P4 for free and deploy your way.

Try P4 Free

Need Help?

Our team of experts is available to walk you through your migration.

Plastic SCM vs. Perforce P4 Migration Guide

Introduction

Plastic SCM vs. Perforce P4 Comparison

Migration Checklist

Identify Your Stakeholders

Assess the Current State of Your System

Plan Your Deployment

Document Your Current Plastic SCM Configuration

Consider Key Milestones

Identify How Much History to Import

Evaluate Integrations and Topology

Plan Your Cutover Strategy

Determine Training Required

Decide on Success Metrics