• Sign in to follow this  
    Followers 0

    Migrating From Another Platform


    4 steps in this guide

    1. 1

      Installing the converters

      Installing the IPS4 converter package is the same as installing any other application into the suite. For the purposes of this guide, I will assume that you have never installed any application previously. Where to get them The first thing that you will need to do, is to get the converter application itself. You can download this from the IPS Extras section within the Marketplace. A direct link to this can be found below. Installing the application To install the application, you will need to visit the following area within the admin cp System>Site Features>Applications Once you are here, you will need to select the install button as seen in the image below   After selecting install, you will need to look for the convert.tar file which is in the download package that you downloaded in the first step of this guide, and select "Install"   Once you have done this, you have installed the converter and you will see these within system>Conversions where you can start your conversion.
    2. 2

      Before you start

      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.
    3. 3

      Running the conversion

      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. Warning 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.  Tip 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. Tip 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.
    4. 4

      Redirecting old links

      Congratulations on successfully converting your software over to IPS Community Suite. All your data is now there and you are ready to go. There is however one important step you may want to complete before you continue on your way. Redirection. After converting the software over, you will have links to locations which no longer exist. So for example, you may have converted over from vbulletin, and any links to vbulletin posts will no longer work. This is however not a problem, as we can redirect these to their equivalent posts that are on within the IPS Community Suite. The first thing you will need in order to do this, is to download the redirects for your particular software. You can find the download for these in the same location as the converters.   Once you have downloaded these, unzip the package and you will see a directory structure similar to the image below.   Choose the directory in which you have converted the software for, and you will see the files required for your redirects   You will need to upload these to the root of your IPS Community Suite installation folder. Before we do this however, we need to configure the software so that it knows which conversion this is for. You can do this by opening up the config.php file in a text editor. In here you need to enter the full path to your IPS4 installation. Warning This is the path on your server, not the URL. You will also need to enter the identifiers for your conversion (see below)   You can find the identifiers for your conversion within your conversion program by visiting the following location System>Conversions>Manage Conversions You can see the identifiers that you need here, as shown in the screenshot below. All that is needed now is for you to upload the files to your server. Your conversion, and redirection, is now complete.

    Other guides in Getting Started


    Sign in to follow this  
    Followers 0