|
Computers & Writing Systems
You are here: Encoding > Conversion > Utilities SIL Converters 2.6 (and 2.6.1) Installation
Note This information is also available as a download:
OverviewSIL Converters version 2.6 is intended to be installed using the Master setup program found here. This document is intended to guide you through the Master Installer installation screens and initial SIL Encoding Converters2.6 Setup. This guide may be sufficient for many users. However, to make full use of SIL Encoding Converters 2.6, you should refer to the SIL Encoding Converters documentation. The Master Setup program runs a series of installers:
InstallationIf this is the first time you are running the installer, be sure to close all programs before starting the installation program, including the program that you are using to read this document. Several of the software prerequisite sub-installers will stop and tell you to shut down programs. Suggestion: If this is your first time installing SIL Converters, you may want to print out this document to guide you through the process. Software prerequisitesThese installers may require that you answer some dialog box questions. Be sure to allow these updates and add-ons to be installed; they are necessary for SIL converters to run properly. Several of the software prerequisite programs may stop and tell you to shut down programs you were not even aware were running. Be sure you follow all instructions. If it seems the installer has stalled, it may be there is a dialog box waiting for you to respond. However, be patient. Some of these installers take several minutes to finish. SIL Encoding Converters SetupOverviewThis section is intended as a guide for initial setup. For detailed information on the SIL Encoding Converters2.6 Setup see Help for SIL Converters 2.6.
Tip: You do not need to know exactly what you want to install the first time you run the Setup program. You can run the Master Setup program again to add or delete components. For more information on the SIL Converters components and features see Help for SIL Converters 2.6. Installation
For Advanced Users: As many of the components in the SIL Converters suite are shared utilities, the vast majority of the download will be installed in specific, fixed, shared locations. For example, most of the transduction engines are provided by DLL programs which must be in a folder that is in the Windows Path environment variable. For this reason, the TECkit, CC, ICU, Perl, and Python DLLs are put into the C:Program FilesCommon FilesSIL folder, which is also added to your system Path variable. However, the majority of the client applications, which otherwise don’t need to be in one of these shared locations (e.g. the Bulk SFM converter, the Clipboard EncConverter, etc), will be installed in the folder which you select from this dialog box. Select featuresThis screen allows you to select which conversion applications are installed and which conversion Maps and Tables are copied to your hard drive. Selected Map and Tables will need to be activated using the Converter Installer dialog latter in the installation process.
SIL Converters for Office 2003The SIL Converters for Office 2003 Setup currently only installs a critical operating system update. However, the update is needed by all users, whether or not you have Office 2003.
Tip: This installer does not check to see if update has already been installed. If you know the update has been installed, you may click and to skip this installer.Converter Installer
Tip: Do not activate all the converters. Too many active converters will slow down your system considerably, particularly if you are using the Clipboard Encoding Converter application.
Known issues at release time (for version 2.6.1)SIL Converters documentation not updatedSince this 2.6.1 release is an intermediate release meant to fix some compatibility problems with FieldWorks and Speech Tools programs, the SIL Converters documentation was not updated for the 2.6.1 release. Therefore any references to version 2.6 in the documentation should be considered as applying to v 2.6.1. This applies especially to the Help for SIL Converters 2.6 and Help for SILConverters 2.6 Installation menu items in .CC Unrecognized keyword errorIf you see this error message: begin > utf8 ?CC-F-Unrecognized keyword, it means that there is a version of the file cc32.dll somewhere in your Windows Path that is older than the one installed by SIL Converters into the C:Program FilesCommon FilesSIL folder. It is best if you delete any older copy of cc32.dll. The existing application which installed it will be able to use the newer version installed by SIL Converters because it is also on the Path. Alternatives
Python 2.5 required for Python script conversionsIf you want to use a Python script converter, you must also install a separately-available Python distribution of the same version number. SILConverters 2.6.1 supports encoding conversions using Python Version 2.5. This means you must have a Python Version 2.5.x. installed on your computer. It will not work with an earlier or later Python version (e.g. 2.4.2 or 2.6.1). As of this writing, Python Version 2.5.1 is available for download from http://www.python.org. Perl 5.8.8 required for Perl expression conversionsIf you want to use a Perl expression converter, you must also install a separately-available Perl distribution of the same version number. SIL Converters 2.6.1 supports encoding conversions using only Perl Version 5.8.8. It will not work with any other Perl version (e.g. 5.8.7). The Perl converter has been tested with the following freely available Perl distribution: ActiveState Perl. FieldWorks 5.0 Compatibility issuesIf you use SIL Encoding Converters 2.6 or earlier versions, the FieldWorks 5.0 installer will automatically uninstall SIL Encoding Converters. This is done to avoid compatibility problems. See the upgrade information which follows. Upgrading Speech Analyzer and SIL Encoding ConvertersIf you are using FieldWorks, Speech Analyzer, and/or SIL Converters, you should upgrade them all to avoid eventual conflicts with older versions of the others. If you no longer need one of these products, first remove it, then upgrade to FW 5.0, SA 3.0.1, and/or SIL Converters 2.6.1. The new software is available on the SIL Language Freeware CDs or may be downloaded from:
Technical Details: Old and new versions can be installed and work together normally. However, if you then emun}install any of the programs, it will remove some core encoding converter registry settings that the remaining program(s) depend on. As a result, encoding converters within FW or SA will lose some functionality until the registry settings are restored. Typical error messages may state “Encoding Converter not found” or “Error initializing Document reader”. The problem can be fixed as follows: download or copy RegisterSEC.bat to your hard disk, then execute the batch file while logged in to an administrative user account. On Vista, you must run it by right-clicking the batch file, then selecting ‘Run as Administrator’. RegisterSEC.bat is found on each installation package in the , , or directory. Alternatively, you can fix the problem by rerunning the appropriate installer and choosing the option. For those that know how, you can also fix the problem by using regasm to register SilEncConverters22.dll in c:Program FilesCommon FilesSIL2.6.0.0 or 2.6.1.0. Vista users upgrading to SILConverters 2.6.1Non-administrative Vista users may discover that some of their encoding converters, pictures, and media files are no longer available. This is due to Vista’s virtual store ‘feature’. For encoding converters, it is usually simplest to re-add the missing encoding converters. Technical Details: When a non-administrative Vista user creates a file under Program Files, instead of writing the files under , the files are created under c:UsersYourLoginNameAppDataLocalVirtualStoreProgram Files where YourLoginName is your Vista login name. If multiple users log on to a machine, there will be multiple copies of these files. FieldWorks 4.9, Speech Analyzer 3.0.1, and SIL Encoding Converters 2.6.1 and later versions no longer write any files under Program Files, so this problem will be avoided. When upgrading from older versions of these programs, user files from Program Files are copied to the new location under c:ProgramDataSIL. However, the installers do not catch files from these virtual directories. If you are missing encoding converters after an upgrade, you should copy the contents from the MappingFiles and Repository folders from your VirtualStoreProgram FilesCommon FilesSIL to similar directories under c:ProgramDataSIL. Known issues at release time (for version 2.6)SIL Converters for Word absent if Word not installed.When you run the installer if you do not have a suitable version of MS Word installed then SIL Converters for Word will be missing from the selection list. This is because SIL Converters for Word cannot be installed without Word already being present. CC Unrecognized keyword errorCC Error dialog box If you see this error message: begin > utf8 ?CC-F-Unrecognized keyword, it means that there is a version of the file cc32.dll somewhere in your Windows Path that is older than the one installed by SIL Converters into the C:Program FilesCommon FilesSIL folder. It is best if you delete any older copy of cc32.dll. The existing application which installed it will be able to use the newer version installed by SIL Converters because it is also on the Path. Alternatives
Python 2.4 required for Python script conversionsIf you want to use a Python script converter, such as 'UnicodeName' (installed when you select the 'Python Script Functions 2.4' transduction engine feature in the SILConverters' installer), you must also install a separately-available Python distribution of the same version number. SILConverters 2.6 supports encoding conversions using Python Version 2.4. This means you must have a Python Version 2.4.x. installed on your computer. It will not work with an earlier or later Python version (e.g. 2.3.1 or 2.5.2). As of this writing, Python Version 2.4.4 is available for download from http://www.python.org/download/. Perl 5.8.7 required for Perl expression conversionsIf you want to use a Perl expression converter, you must also install a separately-available Perl distribution of the same version number. SIL Converters 2.6 supports encoding conversions using only Perl Version 5.8.7. It will not work with any other Python version (e.g. 5.8.8). The Perl converter has been tested with the following freely available Perl distributions: ActiveState Perl or PXPerl. The PXPerl 5.8.7 installer may be downloaded here:
Unable to add converters with PXPerl installedThe PXPerl program inserts its path Path environment variable ahead of the Windows path folders. This causes certain problems (e.g. unable to add an ICU Transliterator from certain SIL Converters’ client applications). If you have trouble installing some converters, you should follow these steps to rectify this problem:
Tip Open a text editor like Notepad. Right after clicking CTRL + C to copy the path statement from the box of the dialog window, then paste the path into the text editor. After editing you can paste it back. , clickResult: When you’re finished, your Path variable should look something like this (though it may be much longer, and there should be no line breaks): %SystemRoot%system32;%SystemRoot%;%SystemRoot%System32Wbem; C:Program FilesCommon FilesSIL;C:PXPerlparrotbin;C:PXPerlbin © 2003-2024 SIL International, all rights reserved, unless otherwise noted elsewhere on this page. |