FAQ

Have questions? Email us at support@patchcablemgr.com

How do I upgrade a Self-Hosted deployment?

Login to your PatchCableMgr server and run the command below to upgrade a self-hosted PatchCableMgr deployment:

ansible-playbook pcm_selfhosted/playbook.yaml --ask-become-pass --tags upgrade

Note: You must be in the parent directory of the pcm_selfhosted repository.

How do I perform a clean reinstall of a Self-Hosted deployment?

Login to your PatchCableMgr server and run the command below to perform a clean reinstall of a self-hosted PatchCableMgr deployment:

ansible-playbook pcm_selfhosted/playbook.yaml --ask-become-pass --tags install --skip-tags prevent-destruction

Warning: This command will delete all data and reinstall the application from scratch.

Note: You must be in the parent directory of the pcm_selfhosted repository.

How do I migrate from legacy?

Starting with version 1.0.0, PatchCableMgr has been completely rebuilt using modern frameworks to help deliver features, enhancements, and fixes faster. Unfortunately, this means there is no direct upgrade path from legacy (<1.0.0). Follow these steps to upgrade from legacy to mainline code.

  1. Verify Legacy Version:

    Login to your legacy PatchCableMgr app and ensure that you are running version >=0.3.19 by clicking on the user icon in the top right corner of the page and click About. If your current version is <0.3.19, please contact us at support@patchcablemgr.com for assistance.
    Accessing About

  2. Install New Version:

    Follow the installation instructions here to get started with PatchCableMgr mainline code.

  3. Download Legacy Archive:

    Login to your legacy PatchCableMgr app and navigate to the Admin->Integration page. Click the Backup button to download a legacy archive.
    Download Legacy Archive

  4. Convert Legacy Archive:

    Follow the installation instructions here to convert the legacy archive into one that can be imported into your new PatchCableMgr installation.

  5. Import Archive:

    Login to your new PatchCableMgr app and navigate to the Archive page. Click the Import button to upload your converted archive.
    Import Archive

At this point, you should have a new PatchCableMgr installation with your data migrated from legacy. Your users will need re-register with the new installation. If you have any issues, contact us at support@patchcablemgr.com.