The former Porticor support site is now frozen. Please refer to our Intuit page.

How to Restore Your Project

The Porticor virtual appliance is highly reliable and under normal conditions, can serve your project for many months and years. However, accidents do happen. For example, you may have spilled coffee into accidentally terminated your appliance. Do not panic! You can still restore your data.

Follow the list of steps carefully to restore the project, and your data.

Before we begin: if you see any surprises during this process, please do contact Porticor Support. Your data is important to us, and we don't want to see it vanish because of human or software mistakes.

If your project is running on VMware, please check the bottom of this article.

  1. Get hold of the master key you saved when you created the project. If you cannot find it, I'm afraid you're in real trouble. Porticor does not store a copy of your key.
  2. Enter the Select Project management page on our central PVKM application. Login, and then locate your project in the list.
  3. Press the Manage this project link. Wait a few seconds for the project's status to be displayed. It may be Unreachable in such cases.
  4. Press Restore Project on New Instance. You will enter a variant of the same wizard you used to create the initial virtual appliance. Enter the required information (including if necessary your Amazon credentials). When you press Finish, you will log into your new instance. We're almost there!
  5. When logged into the instance, enter your Master Key. The appliance validates that it is correct.
  6. Reattach any PEFS disk volumes you had on the old instance. This is done on the AWS Management Console. Notice that the volumes are tagged with the project name and with additional information, to help you identify the right volumes to restore. We recommend that you reuse the old mountpoint: the old /dev/sdf should be reattached as /dev/sdf.
  7. The virtual appliance is now ready to use! Remount the disks on your client machines, and if necessary, configure S3 clients to access the new appliance.

VMware-based Projects

This is a small variation on the steps above.


  • Start by deploying a new VM using the Porticor OVF image file.
  • In step #4, enter the IP address of your VM at the bottom of the page.
  • The rest of the process is similar to the above steps. Of course you will use the vCenter client (or vCloud Director) to manage your disks, rather than the AWS user interface.

Restoring Agents

Porticor Agents are deployed on your cloud instances, and need to be reconfigured after restoring the project, so that they use the new virtual appliance. You need to go through the following steps:

  1. Ensure that the project has been restored, and you have a usable virtual appliance. Note down its address (iXXX-pXXX.d.porticor.net).

  2. Ensure that you have a copy of the API keys used in the agent, or generate a new API key on the API Keys page.

  3. Unmount the encrypted disks:

        sudo unmount <disk-mount-point>
    
  4. Lock the disks:

        sudo porticor_agent list-disks
        sudo porticor_agent lock-disk <disk-name>
    
  5. Reconfigure the Agent (several optional parameters can be used with this command, see the Agent's Knowledge Base article):

        sudo porticor_agent reconfigure <appliance-address> --api-key-file <key-file>
    
  6. Unlock the disks:

        sudo porticor_agent unlock-disk <disk-name>
    
  7. You can now remount the disks and start using them.