The process of migrating applications and systems to a new server is a fact of life in the IT universe. Old hardware gets outdated; old disks don't have the capacity, virtualization, you name it. Just last month I migrated my development environment to a new system, so I understand the pain to an extent.
There are several areas where planning makes success when it comes to moving RPM Remote Print Manager®) (RPM) to a new environment:
- Create the configuration directory on the new system
- Recreate the external dependencies
- Copy the configuration
- Run the RPM installer on the new system
- Migrate the license from the old server to the new
- Select your printers one more time
Create the configuration directory on the new system
It's best that we create the configuration directory first. Later we'll copy the database to this directory. If your RPM setup uses overlays (or watermarks), they will go here as well.
On your system, you'll have a hidden "ProgramData" directory. On my old Windows 7 system, and on my Windows 10 system, this is "C:\ProgramData". You can often open this folder in explorer by entering the following in the address bar: %allusersprofile%. If that doesn't work, contact your system administrator for assistance or try searching the Internet.
In your "programdata" folder, create a folder called "Brooks Internet Software". In the new folder, create another folder called "RPM". We'll refer to this as our "configuration directory".
Here is a DOS directory listing of my configuration directory:
If your old system has an "Overlay" folder, then create it on the new system.
If you have job retention turned on in the old system and wished to try preserving the completed jobs, you can copy the spool folder from the old system to the new. The spool folder contains folders for individual queues so you'll be copying the job files as well. They should match up with the settings in the database.
Don't worry about the JOBS or the Temp folders. RPM will create them as needed.
Recreate the external dependencies
The external dependencies you need to create are:
- Windows printers RPM prints to
- folders it saves jobs to
- applications it runs external to RPM
- any files you insert or append
- any custom banner files
The first three items correspond to RPM devices. There is an easy way to list all the devices RPM is using. In this context, applications would also be considered devices by RPM.
- In the user interface, go to the View menu and select Devices
- switch to the Devices tab
- click the "Type" header to show all the devices ordered by type
Now, on the new system, you can recreate the folders and ensure your printers are installed and are named the same as they were on the old server.
A note on applications; most of the executables I run from RPM are part of an install package, so you will most likely need to track down an installer rather than a single executable. Install them in the same folder as on the previous server or update the RPM settings to point to the program in the new location.
Note: we recently added a page that talks more about migrating filter actions to a new server.
You will find watermarks in the "configuration directory" folder. Copy the files from the overlay folder on the old machine to this one. Watermarks are an Elite-only feature. If you do not have a Watermarks folder on your old server or it is empty, you can safely skip this step.
If you insert or append files, or use a custom banner file, then use a transform. You can see the list of current transforms by going to View in the user interface and selecting "Transform Master List." Then open the Transform Master List tab. Click the Type column header to arrange the transforms by type. You can get to the form for each transform by double-clicking. This way you should be able to track down each file you are using.
Copy the RPM configuration
We store the RPM configuration in our database. By default, the file is called RPM.fdb, and it is in the configuration directory on the old server. If you moved or renamed it, find it in the new location. Copy it to the default configuration directory on the new server.
Once you copy the database to the new server, please follow these important steps:
- Stop the RPM service
- Make sure the user interface is not running. If it's running at this point, just exit. If you don't see it on your screen or in the task bar, please use Task Manager to make sure it's not running.
- When you have the database in place, then run the installer to update RPM.
Please note that the installer will run a program that migrates your old database to a new database. We provide an empty database for this purpose. The database migration program that all the programmatic changes we've made to the RPM database since your old version, are installed in the new. Please note: it can be very troublesome if you don't do this.
Run the RPM installer on the new system.
You’ll want to get the installer that matches your current RPM license. At issue here is whether you are using RPM Elite or RPM Select and to decide which architecture (Win32 or x64). Since many people take this opportunity to upgrade to the latest version, we assume you may want to get the highest version available to you at this time, and we encourage you to do so. Most Windows workstations and servers today are running the x64 version of RPM, so that is the architecture we recommend.
The fastest way to identify whether you are using RPM Elite or RPM Select is to go open the user interface. The title bar will say either “Elite” or “Select.” On my system, it reads:
RPM Remote Print Manager(R) Elite 22.214.171.1245 x64 at localhost - Admin - Brooks Internet Software
If your product license is Select, the title bar will have “Select” after the product name, rather than “Elite.”
Migrate the license from the old server to the new
The first thing you will need to do is deactivate the license on your old system. To do this, go to the user interface, select Help -> License. The License Status window
Note the serial number shown here. You should send your serial number (not this one) via email to email@example.com with a request to deactivate this license. When you deactivate a license, the technician will direct you to uninstall the old software. If you would like to test the new installation, please take advantage of the 21-day trial inherent in an install and migrate your license later. The trial will afford you the opportunity of having two working installs simultaneously which is usually restricted by our EULA.
When it's time to activate the license on the new machine, you can use the Internet activation method, or you can contact us. If you do contact us, we will need the following information:
- order number (our sales receipt or invoice number) from the original order for this license
- the auth code we issued you via email at the time of purchase
- the serial number on the new machine; you would look this up the same way we did for your old device as shown above
Select your printers one more time
We've seen this go sideways so many times that we can't fail you by forgetting to mention: you should refresh your Windows printer definitions in RPM.
In the user interface, you can go to View -> Action Master List, then open the Action Master List tab. Click the Type column header and look for the "Text Printer" actions.
First, double-click the first Text Printer action. Next, click Browse beside the Printer Selection to open the standard Print dialog. Then click the Preferences button to select or review your desired printer preferences. Repeat these steps for each of the Text Printer actions. We highly recommend this because of the inevitable differences between systems such as the Windows or driver versions. Not doing so may result in intermittent problems which are difficult to track down.
If any of your Windows Printers have new names, you will need to double-click any Raw Printer actions and select the newly named printer from the Printer Selection list.
At this point, your new RPM should be in a workable state. If you had issues or encountered any errors along the way, we would encourage you to take a screenshot of the errors and send details to support [AT] brooksnet [DOT] com. It is also potentially a good idea to plan on calling if possible since there is likely to be some additional conversation required to establish the context that led to your problem.