Plastic for Penguins

Find out how to install Plastic SCM in your Linux distro

Debian & Ubuntu

Debian & Ubuntu

Debian uses the dpkg package system, which manages .deb packages. But since this is a pretty basic tool, this Linux distribution ships with several front-ends. Particularly, we’ll be using apt for our needs.

Supported versions: We currently support Debian 6, Debian 8 and Ubuntu 14.04. However, the Debian 6 repository is compatible with Debian 7 and Ubuntu 12.04 as well.

Warning! Our repository is not currently compatible with Ubuntu 16.04. Please click here. to find out more.

Warning! (2016-02-08) We’ve updated our bundled Mono version, starting with Plastic SCM 5.4.16.726. Our packages will now require Mono 4.3 as a dependency, which might cause conflicts during package upgrade. To upgrade your Plastic SCM Linux installation, check the following guide: http://blog.plasticscm.com/2016/02/mono-4-upgrade.html.

Adding the repository

To make Debian recognize our repository, we have to edit the sources file for apt, which can be found under /etc/apt/sources.list.

Each line of this file contains a URL pointing to a particular repository, complemented with some metadata. You'll need to install the 'apt-transport-https' package to access our repositories, since all communications take place under a SSL layer:

apt-get install apt-transport-https

So, for our public repository, you just need to add the following lines with your favorite text editor (remember that you'll need administrator access since this is a system file), replacing <distro_id> with "Debian_6.0", "Debian_8.1" or "Ubuntu_14.04" (removing quotation marks) depending on your target distribution:

# PlasticSCM common packages repository
deb https://www.plasticscm.com/plasticrepo/plasticscm-common/<distro_id>/ ./

# PlasticSCM-latest repository
deb https://www.plasticscm.com/plasticrepo/plasticscm-latest/<distro_id>/ ./

The apt system verifies the repository integrity using the public key from the repository as well as the checksum of some index files.

That means that you’ll have to add our public key to apt.

First, you must download the key file and add it to your system keyring:

# PlasticSCM common repository
wget https://www.plasticscm.com/plasticrepo/plasticscm-common/<distro_id>/Release.key -O - | sudo apt-key add -

# PlasticSCM-latest repository
wget https://www.plasticscm.com/plasticrepo/plasticscm-latest/<distro_id>/Release.key -O - | sudo apt-key add -

After that, you have to reload the apt cache by executing the following command as root:

apt-get update
Installing Plastic SCM

At this point you are only one step away from having Plastic SCM installed on your system!

You just have to execute the following line:

apt-get install plasticscm-complete

Once the process is complete, you'll be able to use Plastic SCM with the default configuration options.

Happy versioning!

If you want to customize your Plastic SCM installation, we encourage you to go through our package list to find out which configuration suits you best. The plasticscm-complete package will get you a default Plastic SCM installation, but you can also choose from these:

  • plasticscm-complete: the whole Plastic SCM experience!
    • plasticscm-client-complete: would you like all our client tools? Choose this package, then!
      • plasticscm-client-core: only command line client utilities
      • plasticscm-client-gtk: our brand new GTK# GUI. You've got to try it!
    • plasticscm-server-complete: the rock-solid Plastic SCM server and everything related to it.
      • plasticscm-server-core: just the server and CLI configuration tools.
      • plasticscm-server-tools: our GUI server configuration tools.
Installing Plastic SCM Cloud Edition

To install Plastic SCM Cloud Edition, please follow the instructions above to configure the software repositories in "Adding the repository" section. Once they are properly configured, execute the following command:

apt-get install plasticscm-cloud

When the install process is finished, run "gtkplastic" command. The first time the application is launched, a configuration form will be shown to enter your Plastic SCM Cloud Edition Subscription credentials in order to push/pull code from your organization.

Installing Plastic SCM Proxy

If you would like to install the Plastic SCM proxy server in your machine, please follow the instructions above to configure the Plastic SCM repositories. When they are properly setup, execute this command:

apt-get install plasticscm-proxy-server

The proxy server will be up and running after install, listening on port 8085.

Installing Eclipse

Once Plastic SCM client is installed, the steps to setup Eclipse plugin are the following:

  1. Locate the root path of Eclipse IDE (From now on, the location root path will be referred as "$ECLIPSE_ROOT").
  2. Remove the old Plastic SCM Eclipse plugin ".jar" files:
    rm -f $ECLIPSE_ROOT/plugins/com.codicesoftware.*.jar
  3. Copy the ".jar" files located in Plastic SCM Client folder into the Eclipse plugins folder:
    cp /opt/plasticscm5/client/eclipse_plugin/com.codicesoftware.*.jar $ECLIPSE_ROOT/plugins/
  4. Run Eclipse. To ensure the new ".jar" plugin files are loaded, you can use the "-clean" option:
    $ECLIPSE_ROOT/eclipse -clean

    (The "-clean" option is only useful the first time Eclipse IDE is launched after copying the new ".jar" files).

For further info, or in case of any assistance, please contact Plastic SCM support team: "support@codicesoftware.com"

Fedora

Fedora

Fedora uses RPM packages, managed with the yum front-end. We’ll now show you how to add the repository and install our packages.

Supported versions: Our repository currently supports Fedora 17 and Fedora 20.

Warning! (2016-02-08) We’ve updated our bundled Mono version, starting with Plastic SCM 5.4.16.726. Our packages will now require Mono 4.3 as a dependency, which might cause conflicts during package upgrade. To upgrade your Plastic SCM Linux installation, check the following guide: http://blog.plasticscm.com/2016/02/mono-4-upgrade.html.

Adding the repository

The way of working with yum is placing a repository file on the /etc/yum.repos.d/ directory.

We have already prepared one for you to download, so only two commands are necessary (replace <distro_id> with your desired version: "Fedora_17" or "Fedora_20", without quotation marks):

# PlasticSCM common repository
dnf config-manager --add-repo https://www.plasticscm.com/plasticrepo/plasticscm-common/Fedora_20/plasticscm-common.repo

# PlasticSCM-latest repository
dnf config-manager --add-repo http://www.plasticscm.com/plasticrepo/plasticscm-latest/Fedora_20/plasticscm-latest.repo

If you're using an old version of Fedora (21 or older) you'll need to use the deprecated YUM command. You're required to store the .repo files inside the /etc/yum.repos.d directory:

# PlasticSCM common repository
wget http://www.plasticscm.com/plasticrepo/plasticscm-common/Fedora_20/plasticscm-common.repo -O /etc/yum.repos.d/plasticscm-common.repo

# PlasticSCM-latest repository
wget http://www.plasticscm.com/plasticrepo/plasticscm-latest/Fedora_20/plasticscm-latest.repo -O /etc/yum.repos.d/plasticscm-latest.repo

Once the file is in place, you can proceed to install our packages!

Installing Plastic SCM

You can perform the installation with a single command:

dnf install plasticscm-complete

If you're using yum:

yum install plasticscm-complete

That's it! You are good to go!

If you want to customize your Plastic SCM installation, we encourage you to go through our package list to find out which configuration suits you best. The plasticscm-complete package will get you a default Plastic SCM installation, but you can also choose from these:

  • plasticscm-complete: the whole Plastic SCM experience!
    • plasticscm-client-complete: would you like all our client tools? Choose this package, then!
      • plasticscm-client-core: only command line client utilities
      • plasticscm-client-gtk: our brand new GTK# GUI. You've got to try it!
    • plasticscm-server-complete: the rock-solid Plastic SCM server and everything related to it.
      • plasticscm-server-core: just the server and CLI configuration tools.
      • plasticscm-server-tools: our GUI server configuration tools.
Installing Plastic SCM Cloud Edition

To install Plastic SCM Cloud Edition, please follow the instructions above to configure the software repositories in "Adding the repository" section. Once they are properly configured, execute the following command:

dnf install plasticscm-cloud

If you're using yum:

yum install plasticscm-cloud

When the install process is finished, run "gtkplastic" command. The first time the application is launched, a configuration form will be shown to enter your Plastic SCM Cloud Edition Subscription credentials in order to push/pull code from your organization.

Installing Plastic SCM Proxy

If you would like to install the Plastic SCM proxy server in your machine, please follow the instructions above to configure the Plastic SCM repositories. When they are properly setup, execute this command:

dnf install plasticscm-proxy-server

If you're using yum:

yum install plasticscm-proxy-server

The proxy server will be up and running after install, listening on port 8085.

Installing Eclipse

Once Plastic SCM client is installed, the steps to setup Eclipse plugin are the following:

  1. Locate the root path of Eclipse IDE (From now on, the location root path will be referred as "$ECLIPSE_ROOT").
  2. Remove the old Plastic SCM Eclipse plugin ".jar" files:
    rm -f $ECLIPSE_ROOT/plugins/com.codicesoftware.*.jar
  3. Copy the ".jar" files located in Plastic SCM Client folder into the Eclipse plugins folder:
    cp /opt/plasticscm5/client/eclipse_plugin/com.codicesoftware.*.jar $ECLIPSE_ROOT/plugins/
  4. Run Eclipse. To ensure the new ".jar" plugin files are loaded, you can use the "-clean" option:
    $ECLIPSE_ROOT/eclipse -clean

    (The "-clean" option is only useful the first time Eclipse IDE is launched after copying the new ".jar" files).

For further info, or in case of any assistance, please contact Plastic SCM support team: "support@codicesoftware.com"

RHEL & CentOS

RHEL & CentOS

Red Hat Enterprise and Fedora have a very similar install procedure, since Fedora is the free version of RHEL (free, as in free beer).

Supported versions: Our repository currently supports RedHat Enterprise Linux 6.x and CentOS 6.x.

Warning! (2016-02-08) We’ve updated our bundled Mono version, starting with Plastic SCM 5.4.16.726. Our packages will now require Mono 4.3 as a dependency, which might cause conflicts during package upgrade. To upgrade your Plastic SCM Linux installation, check the following guide: http://blog.plasticscm.com/2016/02/mono-4-upgrade.html.

Warning! Some serious performance issues have been reported when working with large codebase DB (> 1 GB) using the SQLite version provided by CentOS (3.7.x). We recommend you to upgrade your local SQLite version to 3.8 or higher, where the issue has been fixed.

Adding the repository

You just need to download the .repo file:

# PlasticSCM common repository
wget http://www.plasticscm.com/plasticrepo/plasticscm-common/RHEL_6.3/plasticscm-common.repo -O /etc/yum.repos.d/plasticscm-common.repo

# PlasticSCM-latest repository
wget http://www.plasticscm.com/plasticrepo/plasticscm-latest/RHEL_6.3/plasticscm-latest.repo -O /etc/yum.repos.d/plasticscm-latest.repo

Once the file is in place, you can proceed to install our packages!

Installing Plastic SCM

You can perform the installation with a single command:

yum install plasticscm-complete

Once this command is executed, Plastic SCM will be up and running for you to fiddle with!

If you want to customize your Plastic SCM installation, we encourage you to go through our package list to find out which configuration suits you best. The plasticscm-complete package will get you a default Plastic SCM installation, but you can also choose from these:

  • plasticscm-complete: the whole Plastic SCM experience!
    • plasticscm-client-complete: would you like all our client tools? Choose this package, then!
      • plasticscm-client-core: only command line client utilities
      • plasticscm-client-gtk: our brand new GTK# GUI. You've got to try it!
    • plasticscm-server-complete: the rock-solid Plastic SCM server and everything related to it.
      • plasticscm-server-core: just the server and CLI configuration tools.
      • plasticscm-server-tools: our GUI server configuration tools.
Installing Plastic SCM Cloud Edition

To install Plastic SCM Cloud Edition, please follow the instructions above to configure the software repositories in "Adding the repository" section. Once they are properly configured, execute the following command:

yum install plasticscm-cloud

When the install process is finished, run "gtkplastic" command. The first time the application is launched, a configuration form will be shown to enter your Plastic SCM Cloud Edition Subscription credentials in order to push/pull code from your organization.

Installing Plastic SCM Proxy

If you would like to install the Plastic SCM proxy server in your machine, please follow the instructions above to configure the Plastic SCM repositories. When they are properly setup, execute this command:

yum install plasticscm-proxy-server

The proxy server will be up and running after install, listening on port 8085.

Installing Eclipse

Once Plastic SCM client is installed, the steps to setup Eclipse plugin are the following:

  1. Locate the root path of Eclipse IDE (From now on, the location root path will be referred as "$ECLIPSE_ROOT").
  2. Remove the old Plastic SCM Eclipse plugin ".jar" files:
    rm -f $ECLIPSE_ROOT/plugins/com.codicesoftware.*.jar
  3. Copy the ".jar" files located in Plastic SCM Client folder into the Eclipse plugins folder:
    cp /opt/plasticscm5/client/eclipse_plugin/com.codicesoftware.*.jar $ECLIPSE_ROOT/plugins/
  4. Run Eclipse. To ensure the new ".jar" plugin files are loaded, you can use the "-clean" option:
    $ECLIPSE_ROOT/eclipse -clean

    (The "-clean" option is only useful the first time Eclipse IDE is launched after copying the new ".jar" files).

For further info, or in case of any assistance, please contact Plastic SCM support team: "support@codicesoftware.com"

OpenSUSE

OpenSUSE

OpenSUSE uses the RPM package format, too. In this case, we will use the zypper front-end, which works similarly to yum, except for repository management.

Supported versions: All OpenSUSE versions starting from OpenSUSE 12.2 are currently supported. The OpenSUSE 12.2 repository can be safely used by more recent OpenSUSE versions.

Warning! (2016-02-08) We’ve updated our bundled Mono version, starting with Plastic SCM 5.4.16.726. Our packages will now require Mono 4.3 as a dependency, which might cause conflicts during package upgrade. To upgrade your Plastic SCM Linux installation, check the following guide: http://blog.plasticscm.com/2016/02/mono-4-upgrade.html.

Adding the repository

zypper does not force the user to modify a file in order to manage the repositories: it includes options to do it from the application itself.

First, we have to add our repository:

# PlasticSCM common repository
zypper ar -f http://www.plasticscm.com/plasticrepo/plasticscm-common/openSUSE_12.2/ plasticscm-common

# PlasticSCM-latest repository
zypper ar -f http://www.plasticscm.com/plasticrepo/plasticscm-latest/openSUSE_12.2/ plasticscm-latest

You'll note that ar means "add repository" and plastic_repo is the name we've given to that repository. Of course, you can choose your own.
Once you have added the Plastic SCM binaries repository, you need to reload the zypper cache so that the change takes effect:

zypper refresh
Installing Plastic SCM

Now you have added our repositories and the repository cache is up to date. You only need to ask zypper to install the Plastic SCM packages for you:

zypper install plasticscm-complete

Just like that, you’ll have Plastic SCM running at the end of the process. We hope you’ll enjoy it!

If you want to customize your Plastic SCM installation, we encourage you to go through our package list to find out which configuration suits you best. The plasticscm-complete package will get you a default Plastic SCM installation, but you can also choose from these:

  • plasticscm-complete: the whole Plastic SCM experience!
    • plasticscm-client-complete: would you like all our client tools? Choose this package, then!
      • plasticscm-client-core: only command line client utilities
      • plasticscm-client-gtk: our brand new GTK# GUI. You've got to try it!
    • plasticscm-server-complete: the rock-solid Plastic SCM server and everything related to it.
      • plasticscm-server-core: just the server and CLI configuration tools.
      • plasticscm-server-tools: our GUI server configuration tools.
Installing Plastic SCM Cloud Edition

To install Plastic SCM Cloud Edition, please follow the instructions above to configure the software repositories in "Adding the repository" section. Once they are properly configured, execute the following command:

zypper install plasticscm-cloud

When the install process is finished, run "gtkplastic" command. The first time the application is launched, a configuration form will be shown to enter your Plastic SCM Cloud Edition Subscription credentials in order to push/pull code from your organization.

Installing Plastic SCM Proxy

If you would like to install the Plastic SCM proxy server in your machine, please follow the instructions above to configure the Plastic SCM repositories. When they are properly setup, execute this command:

zypper install plasticscm-proxy-server

The proxy server will be up and running after install, listening on port 8085.

Installing Eclipse

Once Plastic SCM client is installed, the steps to setup Eclipse plugin are the following:

  1. Locate the root path of Eclipse IDE (From now on, the location root path will be referred as "$ECLIPSE_ROOT").
  2. Remove the old Plastic SCM Eclipse plugin ".jar" files:
    rm -f $ECLIPSE_ROOT/plugins/com.codicesoftware.*.jar
  3. Copy the ".jar" files located in Plastic SCM Client folder into the Eclipse plugins folder:
    cp /opt/plasticscm5/client/eclipse_plugin/com.codicesoftware.*.jar $ECLIPSE_ROOT/plugins/
  4. Run Eclipse. To ensure the new ".jar" plugin files are loaded, you can use the "-clean" option:
    $ECLIPSE_ROOT/eclipse -clean

    (The "-clean" option is only useful the first time Eclipse IDE is launched after copying the new ".jar" files).

For further info, or in case of any assistance, please contact Plastic SCM support team: "support@codicesoftware.com"

Get the latest news