Installing the IPS4 converter package is the same as installing any other of our application into the suite. You do this by uploading a fresh set of files from your client area, and then installing from System>Site Features>Applications, as shown in the images below.
Where to get them
The first thing that you will need to do, is to get the converter application itself. Go to your client area, and download the full package, however ensure that you select the "Include Converters" checkbox before downloading.
Downloading the converters
Installing the application
To install the application, you will need to visit the following area within the admin cp
If you have uploaded the files correctly, you will see the converters available to install at the bottom of the list, as shown below
Installing the application
Checking the application is installed
Once you have done this, you have installed the converter and you should see these within system>Conversions where you can start your conversion.
Converter application installed
Before you start to go ahead with the conversion, there are a few things that you will need to ensure you have ready for this. This is an important step, so ensure that these simple things are followed before you begin.
Is your old site accessable? - This sounds an obvious step, but you need to ensure that your installation is on the server that you have your IPS installation on.
Is everything working? - Before you begin, if you have moved the old site to a new server ready for this, ensure that everything is working correctly. Ensure paths are correct on your installation and everything is correct as if you were going to continue to use it. This important step can save you a lot of time by ensuring you do not have to start the process again due to mistakes.
Clean up your site - Before you start the conversion, clean up your site. Ensure you dont have things there to convert that you are just going to delete afterward. The less you have to convert, the quicker it will be. There is little point in converting things you do not need.
Have the details you need! - Ensure you have your old sites paths and database credentials to hand. You will need these details during the conversion process.
Is everything accessable? - Ensure that your files and database are accessable from your IPS installation location. Check permissions to ensure that you can read from both of these.
Set up groups, profile groups etc - During the conversion, you will be asked to map your current usergroups, profile fields etc over to the relevant fields in the IPS software, so ensure you have these set up ready for you to just map them.
Change your settings - Things such as images will be imported with the sizes that are specified within the invision software. You should change any settings that you wish to, within the software, prior to importing.
Whilst the conversion process itself can take a while on a large system, and can appear complicated, the process is actually quite simple to do. In my example below, I will be starting the conversion of a vbulletin 4 database into the IPS4 software. The process itself is very similar for each conversion you do.
If you have not read the previous step in this guide, I would advise you to do this now. Reading that step will save you a lot of time.
To start a new conversion, visit the following location within your admin cp
"System>Conversions>Start New Conversion"
It is important to know before you begin, that you will convert the system in stages. So the first stage would be to select the "system and member information" conversion. This will be the only one in the list shown below when you first start. Select this and the select "Select Source Software"
You will then be asked to select the software that you are converting from. Please select this from the list provided, and select "Enter Database Details"
On the next screen you will be asked for the database details. These are the database details for the "Source" database (the database you are converting from. You will be given a hint at the top as to where you can obtain this information if you are unsure.
Once you have entered the database details, you will enter the converter screen. You need to ensure that you follow these in order as showed in the image below. So this would be:
Convert your old settings over to IPS Community Suite
Run each conversion
Either 'finish' or 'begin another conversion'
Note you will see that some are showing "Cannot convert". This is not an error or an issue with the software. This would show if there are previous steps that have to be completed first. Select each "Begin Conversion" in order to convert your software.
When selecting the link at the very top to convert over settings, you will be asked which settings you want to convert over. In the case of this conversion the site name is available to be converted.
Whilst progressing through each step, you may be asked for further details that you will need to complete. Here I have selected the Emoticons conversion, and I am asked for the path to the emoticons folder. You will generally be given hints as to where you can find these where the system can do so. You can also select to merge these into the default IPS Emoticon pack.
You will see when selecting other conversions in the list, you may be asked to 'map' fields from your old database to the fields in IPS. The 2 examples below show the profile fields and there groups.
If you select "None" when you are mapping, a new item of the same name will be created for you. So if you have a profile field in which you have nothing to map it to, then it will create a profile field of this name.
Once finished, you can select "Finish" at the bottom of the list. Alternatively you can select the button you see in the screenshot below. This will rebuild the items, counters, caches and many other items required to ensure that the system functions correctly with your new data.
Remember, we have now only converted system and members. So you will want to convert other items such as forums, posts, gallery data and more. For this you would start a new conversion of these items. You will notice after the first conversion, you now have many of these items available as you can see in the screenshot below. Select another item to continue with another conversion.
You can convert more than one set of data into the software. So if you have for example 2 instances of vbulletin, you can import both into the one IPS instance if you wish to do so.
When getting to the database details screen, you will notice that you have the ability to select a parent conversion. As we are continuing from the steps prior, we would select the conversion we have just done to now add forums etc. Unless the database is different, you can then ignore the database details.
You would continue this process, until you have converted all of the data you wish to convert into the IPS Community Suite.