LICQ to PSI roster converter with support for history and vCards

Introduction

licq2psi is tool for migrating LICQ contacts (with history) to PSI. Process is quite simple and involves following steps:

1. Close LICQ and PSI (make sure they are not in system tray).
2. Backup your PSI configuration (LICQ configuration isn't modified).
3. Run licq2psi converter, it will create following structure in specified output directory:
   • history/*.history - message history files in PSI format
   • vcard/*.xml - users vCards in PSI format
   • jru.patch - list of changes to your roster to be applied via Jabber Roster Utility
4. Apply changes stored in jru.patch to your roster using Jabber Roster Utility.
5. Copy output directory content to your PSI skipping jru.patch (which you can remove at this time).
6. Rerun PSI.

These steps are described below in more detail.

Prerequsites

Before you try to convert your contacts from LICQ to PSI you must have ICQ transport in your PSI roster and you must know it's host part. If you have any ICQ contact already in your roster you can check it's JID. It will be something like 1234567890@icq.jabber.pl. The icq.jabber.pl is an "ICQ transport host name" to which I will refer later.

If you don't have ICQ transport in your roster try to add one from your server using "Service Discovery" option or find another server providing ICQ transport. For more information see public servers listing on jabber.org

Backing up configuration

I strongly recommend that you backup your PSI configuration before using this converter. The converter does not modify any files in PSI configuration directory, but you will modify them and accidents happen.

One way of backing files up is to use tar program:
tar cfz ~/psi-backup.tar.gz ~/.psi
You can restore such backup by issuig commands:
rm -rf ~/.psi && cd && tar xfz ~/psi-backup.tar.gz

Running licq2psi

licq2psi is a Java program and it needs Java Runtime Environment version 1.5 (I may try to provide version working on JRE 1.4 later) or higher to run. If you don't have JRE, you can download it for free (see references). To run the program issue following command: java -jar licq2psi.jar <options>

Program needs several options to know where are files it has to read and where to write new files. Full list of options is specified bellow and you must pass all of them.

• --LicqConfigDir dir - path to LICQ configuration directory, usually ~/.licq
• --PsiConfigDir dir - path to PSI configuration directory, usually ~/.psi
• --PsiIcqTransportHost hostname - host name of your ICQ transport (see "prerequsites" above)
• --PsiOutputDir dir - directory to which files will be generated (in theory you could specify path to your PSI profile, such as ~/.psi/profiles/Michał, but don't do this as it is not supported and not tested). If there are files in this directory, they will be overwritten.
• --PsiProfile profile - name of your PSI profile (such as Michał)
• --PsiAccountaccount - name of your Jabber account in selected profile (such as michal@somewhere.pl)

For example, command to convert my profile is:
java -jar licq2psi.jar --LicqConfigDir ~/.licq --PsiConfigDir ~/.psi --PsiOutputDir /tmp/licq2psi --PsiProfile Michał --PsiAccount michal@somewhere.pl

To make it simpler, you can use shell script provided with converter. To convert you profile with default locations of LICQ and PSI configuration directories:
convert-my.sh --PsiIcqTransportHost icq.michal.waw.pl --PsiProfile Michał --PsiAccount michal@somewhere.pl
New files will be stored in /tmp/licq2psi.

Applying changes to your roster

Go to the Jabber Roster Utility and login to your roster following instructions on the page. When you see the content of your roster, append content of jru.patch and press "update my roster".

Copying generated files to your profile

Copy all generated files to your PSI profile. For example issue:
cp -rvi /tmp/licq2psi ~/.psi/profiles/Michał/

Download

References

• LICQ: home page
• PSI: home page
• Jabber: Jabber Software Foundation
• Jabber: public servers listing on jabber.org
• Jabber: Jabber Roster Utility
• Jabber (polish): JabberPL.org
• Jabber (polish): public servers in Poland listed on JabberPL.org
• Java: home page

CVS { filmy } / filmy / galeria / nokia -> siemens HOWTO / linki / webmail / incoming / listy mailingowe / jabber / licq2psi/ / początek