Difference between revisions of "OX Outlook Uploader"

(Usage - Interactive mode)
Line 50: Line 50:
 
For example, to predefine a Server URL that should be used for the migration afterwards, one would execute e.g.:<br>
 
For example, to predefine a Server URL that should be used for the migration afterwards, one would execute e.g.:<br>
 
"PST2OX Migration Tool.msi" SERVERURL="http://ox.example.invalid"
 
"PST2OX Migration Tool.msi" SERVERURL="http://ox.example.invalid"
 +
 +
=Usage - Configuration=
 +
The application's configuration settings can be adjusted in config files, both for the PST2OX.exe main application for interactive mode and for the command line version of the tool PST2OXc.exe (see below). The files are named as the corresponding executable, with the file extension ".config": <br>
 +
PST2OX.exe.config and PST2OXc.exe.config respectively.
 +
 +
Furthermore, the application can be started with command line parameters. All supplied options overwrite the default settings from the configuration file, which are assumed if an option is missing. The following parameters are recognized:
 +
 +
-adminuser <Admin username on the OX server (for admin migration)><br>
 +
-adminpassword <Admin password on the OX server (for admin migration)><br>
 +
-batchmode <true/false><br>
 +
-ignorejunkfolder <true/false><br>
 +
-ignoretrashfolder <true/false><br>
 +
-importfoldername <Name of the migration target subfolder><br>
 +
-logautoflush <true/false><br>
 +
-logconsole <true/false><br>
 +
-loglevel <off/error/warning/info/verbose><br>
 +
-logtextfile <Path to logfile><br>
 +
-migrateappointments <true/false><br>
 +
-migratecontacts <true/false><br>
 +
-migrateemails <true/false><br>
 +
-migratenotes <true/false><br>
 +
-migratetasks <true/false><br>
 +
-password <Password on the OX server><br>
 +
-profilename <Name of the profile><br>
 +
-pstfile <Path to PST file><br>
 +
-pstpassword <Password for the PST file><br>
 +
-serverurl <URL of the OX server><br>
 +
-skipemptyfolders <true/false><br>
 +
-storename <Name of the store inside the profile><br>
 +
-uploadchunksize <Number of uploaded mails per request><br>
 +
-uploadthresholdbytes <Threshold of bytes for sending forced><br>
 +
-username <Username on the OX server><br>
 +
-recoverableexceptionmaxretries <max. retries after web error><br>
  
 
=Usage - Interactive mode=
 
=Usage - Interactive mode=

Revision as of 11:45, 24 June 2010

Open-Xchange Outlook© Uploader (Beta)

Description

Later this year, Open-Xchange will release Open-Xchange Outlook© Uploader for migration of Outlook© PST-files to Open-Xchange OXtender for Microsoft Outlook©.

Download

Please note that everything from this page and beyond is in Beta: That means that nothing is final, changes will be made before final release, stability is not guaranteed and nothing from this site should be used in production.

To download the Open-Xchange Outlook© Uploader (Beta) installation packages and Release Notes, follow this link

The access-data are:

  • User name: oloxupdater2beta
  • Password: first$cut

Installation

The Open-Xchange Outlook© Uploader Beta tool itself can be installed without the need for elevated access rights by the end user, as the installer only accesses the local non-roaming application data directory and the HKCU hive in the registry. It can't be installed 'per machine', which means that it is not allowed to set the value of the ALLUSERS msi property to "1". The tool can be pre-configured for the end-users by setting public properties at the command line for the installation process. These are processed by the installer and then written into the tool's config-file.

The following parameters can be adjusted (the values in square brackets that are listed below indicate the default values of the properties when not overridden by the msi command line - so that would be the default pre-configuration):

ADMINUSER []
ADMINPASSWORD []
BATCHMODE [False]
IGNOREJUNKFOLDER [True]
IGNORETRASHFOLDER [True]
IMPORTFOLDERNAME []
LOGAUTOFLUSH [True]
LOGCONSOLE [False]
LOGLEVEL [Info]
LOGTEXTFILE [.\pst2ox.log]
MIGRATEAPPOINTMENTS [True]
MIGRATECONTACTS [True]
MIGRATEEMAILS [True]
MIGRATENOTES [True]
MIGRATETASK [True]
PASSWORD []
PROFILENAME []
PSTFILE []
PSTPASSWORD []
SERVERURL [http://]
SKIPEMPTYFOLDERS [True]
STORENAME []
UPLOADCHUNKSIZE [25]
UPLOADTHRESHOLDBYTES [2097152]
OXUSERNAME []
RECOVERABLEEXCEPTIONMAXRETRIES [3]

For example, to predefine a Server URL that should be used for the migration afterwards, one would execute e.g.:
"PST2OX Migration Tool.msi" SERVERURL="http://ox.example.invalid"

Usage - Configuration

The application's configuration settings can be adjusted in config files, both for the PST2OX.exe main application for interactive mode and for the command line version of the tool PST2OXc.exe (see below). The files are named as the corresponding executable, with the file extension ".config":
PST2OX.exe.config and PST2OXc.exe.config respectively.

Furthermore, the application can be started with command line parameters. All supplied options overwrite the default settings from the configuration file, which are assumed if an option is missing. The following parameters are recognized:

-adminuser <Admin username on the OX server (for admin migration)>

-adminpassword <Admin password on the OX server (for admin migration)>
-batchmode <true/false>
-ignorejunkfolder <true/false>
-ignoretrashfolder <true/false>
-importfoldername <Name of the migration target subfolder>
-logautoflush <true/false>
-logconsole <true/false>
-loglevel <off/error/warning/info/verbose>
-logtextfile <Path to logfile>
-migrateappointments <true/false>
-migratecontacts <true/false>
-migrateemails <true/false>
-migratenotes <true/false>
-migratetasks <true/false>
-password <Password on the OX server>
-profilename <Name of the profile>
-pstfile <Path to PST file>
-pstpassword <Password for the PST file>
-serverurl <URL of the OX server>
-skipemptyfolders <true/false>
-storename <Name of the store inside the profile>
-uploadchunksize <Number of uploaded mails per request>
-uploadthresholdbytes <Threshold of bytes for sending forced>
-username <Username on the OX server>
-recoverableexceptionmaxretries <max. retries after web error>

Usage - Interactive mode

1. Choose the migration source
a. First, either choose a personal storage file (.pst file) or a mail profile to be imported.
b. When having made a selection, click on Next

2. Select a personal storage file to migrate a.
a. When clicking on Browse the standard folder for saving .pst files opens.
b. As some .pst files are password protected the password can be entered in the second field.
c. When having chosen a file, click on Next.

3. Select a data file from a profile to migrate a.
a. Select one of the existing profiles from the drop-down menu.
b. Select a store from the profile.
c. Finally, enter a password if needed.
d. To proceed, click Next.

4. Please enter information about the server
a. In the Server URL field, enter the Open-Xchange Server address.
b. Enter your username in the second field.
c. Enter your password in the third field.
d. In order to make further settings, activate the Configure advanced settings checkbox.
e. To proceed, click on Next.

5. Configure advanced options a. The folder id is preselected but can be changed.
b. In the second field enter the name of the folder in which the E-Mails are to be saved.
c. In case not all mail folders are to be exported from the .pst file, an Outlook folder can be selected by clicking on the Select button.
d. In order to ignore the Trash or Junk folder for the migration, activate the respective checkbox.

6. Migration in process
a. This window displays the status and a log protocol of the migration.
b. When the process is finished, click on Next.

7. Migration completed
a. This window displays an overview of the migration and you can view the log file by clickin on the respective button.
b. To close the wizard, click on Finish.

Reporting of Bugs

Please report bugs and missing features via Open-Xchange Bugzilla. Many thanks in advance for your support.

Product: OXtender 2 for MS Outlook (OLOX 2.0)