Version 2.0 June 2006
Table of Content 1 Introduction...3 2...3 2.1 Overview...3 2.2 How To Customize OBM.ZIP...4 2.3 How To Customize INSTALL.ZIP...4 3 Languages & Terms of Use Files...6 4 Screenshots...7 5 Installers In Action...16 5.1 For MS Windows...16 5.2 For Mac OS X...20 Page 2 of 25
1 Introduction Due to the various problems and limitations of the InstallAnywhere installer for both the MSWindows and MacOSX, we have created a new customizable installer using Inno Setup for the MSWindows and Apple s Package Maker for the Apple Mac. These new installers will use all the existing customization and properties files from obm.zip. 2 2.1 Overview The customized installers can be built as follows:- 1. If you re a new user, please download the default OBM.ZIP, INSTALL.ZIP and PROPERTIES.XLS. If you re an existing user, just download the properties.xls. (See Figure 2.1.1). 2. Customize contents of OBM.ZIP. Please refer to section 2.2 below. 3. Customize contents of INSTALL.ZIP. Please refer to section 2.3 below. 4. Customize Customizing AhsayOBM section of website with your OBM options. (See Figure 2.1.2). 5. Upload INSTALL.ZIP. The previous version will be used if you don t upload. Within Upload Install.zip section, click [Browse] button and select your [install.zip] file. Then click [Upload] button to upload the file to server. 6. Upload OBM.ZIP. The previous version will be used if you don t upload. In Upload [obm.zip], click [Browse] button and select your [obm.zip] file. 7. To build installers, just click the [Build] button. 8. Wait a little while and click [Check Status] button to check build progress. (See Figures 2.1.3). 9. In OBM Download Area, if the links appears then the build was successful. Download the installers and test. 10. If the installers are OK, you can place them in your OBS download area. Page 3 of 25
2.2 How To Customize OBM.ZIP The obm.zip can be customized as follows:- 1. Extract [obm.zip] to a temp directory. (See Figures 2.2.1). 2. Replace [aboutbg.gif] (size 400 x 123) with a logo that you want to show in the [About] page of AhsayOBM. 3. Replace all the [icon*.ico] with the logo that you want to show in the MS Windows system tray area (the clock area). The animation produced ("running arrow") when backup is running is made up by showing [icon1.ico], [icon2.ico], [icon3.ico] and [icon4.ico] in sequence. You can change the animation by replacing these files (please note, they MUST be in size "16x16" and "96x96 dpi"; you can use more than 4 ICO files for your animation. Just make sure they are named in consecutive sequence) 4. Replace ALL properties files [*.properties] with your customized version. Generate the files using the [properties.xls]. 5. Customize the help file:- Replace [obm_help.chm] with your customized version. OR Add your customized pdf file [obm_help.pdf] and delete the [obm_help.chm] file. OR Add your customized html file [obm_help.htm] and delete the [obm_help.chm] file. OR If you want to disable the help just remove the [obm_help.chm] file. 6. Rezip the files back to [obm.zip]. Please ensure that multiple file spanning is not enabled and compression method must be normal. (See Figure 2.2.2). 2.3 How To Customize INSTALL.ZIP The install.zip can be customized as follows:- 1. Extract [install.zip] to a temp directory. (See Figures 2.3.1) Within [install.zip] you will find four folders icons, languages, termsofuse and Mac_Install. 2. Customize icons folder (See Figure 2.3.2). These are the default icons for the MS Windows installer. You can use any graphics program to modify these image files. a. icon1.ico is an icon file (size 32 x 32) and is used to display a little icon in the top-left corner of the installer s title bar. Page 4 of 25
b. aboutbg.bmp is a bitmap file (size 164 x 314) and is used to display an image on the left side of the installer. (See Figure 3.1). c. small.bmp is a bitmap file (size 55 x 55) and is used to display a small logo on the top-right of the installer. (See Figure 3.2). d. uninstall.ico is an icon file (size 32 x 32) for the uninstall shortcut. 3. Customize languages folder (See Figure 2.3.3). These are the default language files for the MS Windows installer. However, we have added a few custom messages at the end of each file which you need to customize using any text editor. The customized messages are as follows: a. GroupChoiceMessage=Please choose a group to which the software will be installed b. EveryOne=Everyone c. MeOnly=Me Only d. ConfirmUninstallMessage=You need to uninstall the previous version of this software before the installation. Do you want to continue? e. UninstallFailMessage=The uninstallation failed, please try to install the software again after rebooting the computer 4. Customize termsofuse folder (See Figure 2.3.4). Replace these Terms Of Use files with your own. 5. Customize Mac_Install folder (See Figure 2.3.5). These are the default resources for the Mac OS X installer. a. BundleNames.txt is a text file containing the name of the application when the mouse moves over the icon in the docking bar. b. GenericJavaApp.icns is an ICNS file for the scheduler. (See Figure 2.3.7). c. OBMLogo.icns is an ICNS file that is displayed in the Mac OS X docking bar. (See Figure 2.3.6). If you want to display your own background image instead of the default Mac OS X one, please add a background.jpg image file around 620x465 pixels to this directory. 6. Rezip the four folders back to [install.zip]. Please ensure that the path remains intact (see figure 2.3.8) and remember not to enable multiple file spanning and compression method must be normal. Page 5 of 25
3 Languages & Terms of Use Files The different installer languages and terms of use within the Languages and Termsofuse folders are as follows: Language Installer Language File Terms of Use File Czech Language_cs.isl termsofuse_cs.txt Danish Language_da.isl termsofuse_da.txt German Language_de.isl termsofuse_de.txt English (Default) Language_en.isl termsofuse_en.txt Spanish Language_es.isl termsofuse_es.txt French Language_fr.isl termsofuse_fr.txt Icelandic Language_is.isl termsofuse_is.txt Italian Language_it.isl termsofuse_it.txt Japanese Language_ja.isl termsofuse_ja.txt Dutch Language_nl.isl termsofuse_nl.txt Norwegian Language_no.isl termsofuse_no.txt Slovenian Language_sl.isl termsofuse_sl.txt Swedish Language_sv.isl termsofuse_sv.txt Chinese (Simplified) Language_zh_cn.isl termsofuse_zh_cn.txt Chinese (Traditional) Language_zh_tw.isl termsofuse_zh_tw.txt Please note that the languages available in the final MS Windows installer executable will require ALL the following conditions before it is available for selection. (See Figure 5.1.1). The language is checked in the Language to Show section. The [language_xx.isl] file of the respective language is uploaded. The [termofuse_xx.txt] file of the respective language is uploaded. Page 6 of 25
4 Screenshots Figure 2.1.1 Ahsay Customization Portal showing the Upload Install.zip section and the default downloads for obm.zip, install.zip and properties.xls on the right. Page 7 of 25
Figure 2.1.2 Ahsay Customization Portal showing the Customizing AhsayOBM section where the OBM options are entered. Page 8 of 25
Figure 2.1.3 Ahsay Customization Portal showing the OBM Download Area section where the customized installers can be downloaded. Page 9 of 25
Figure 2.2.1 Extracted obm.zip showing the contents. Page 10 of 25
Figure 2.2.2 Contents of obm.zip. Figure 2.3.1 Extracted install.zip showing the four subfolders. Page 11 of 25
Figure 2.3.2 Contents of the icons folder. Replace these with your own logos. Figure 2.3.3 Contents of the languages folder. Edit these files using any text editor. Page 12 of 25
Figure 2.3.4 Contents of the termsofuse folder. Edit these files using any text editor. Figure 2.3.5 Contents of the Mac_Install folder. Edit BundleNames.txt using any text editor. The two graphics file GenericJavaApp.icns and OBMLogo.icns must be edited using an icon editor that supports ICNS files. Page 13 of 25
Figure 2.3.6 Contents of OBMLogo.icns as displayed by Mac s ICNS Browser (1.1). Figure 2.3.7 Contents of GenericJavaApp.icns as displayed by Mac s ICNS Browser (1.1). Page 14 of 25
Figure 2.3.8 Contents of install.zip. Please note that the path must be maintained. Page 15 of 25
5 Installers In Action 5.1 For MS Windows Figure 5.1.1 MS Windows Installer in Action Select Language Screen Figure 5.1.2 MS Windows Installer in Action Welcome Screen Page 16 of 25
Figure 5.1.3 MS Windows Installer in Action Terms of Use Screen Figure 5.1.4 MS Windows Installer in Action Destination Path Screen Page 17 of 25
Figure 5.1.5 MS Windows Installer in Action Start Menu Folder Screen Figure 5.1.6 MS Windows Installer in Action Create Shortcut Screen Page 18 of 25
Figure 5.1.7 MS Windows Installer in Action Summary Screen Figure 5.1.8 MS Windows Installer in Action Completed Setup Screen Page 19 of 25
committed to the success of your business 5.2 For Mac OS X Figure 5.2.1 Mac OS X Installer in Action obm-mac.zip on desktop. Figure 5.2.2 Mac OS X Installer in Action Package obm.pkg extracted to desktop. Page 20 of 25
Figure 5.2.3 Mac OS X Installer in Action Request for authentication. Figure 5.2.4 Mac OS X Installer in Action Introduction Screen Page 21 of 25
Figure 5.2.5 Mac OS X Installer in Action Read Me Screen Figure 5.2.6 Mac OS X Installer in Action License Agreement Screen Page 22 of 25
Figure 5.2.7 Mac OS X Installer in Action License Agreement Confirmation Screen Figure 5.2.8 Mac OS X Installer in Action Destination Screen Page 23 of 25
Figure 5.2.9 Mac OS X Installer in Action Installation Type Screen Figure 5.2.10 Mac OS X Installer in Action Installation Confirmation Screen Page 24 of 25
committed to the success of your business Figure 5.2.11 Mac OS X Installer in Action Finished Installation Screen Figure 5.2.12 Mac OS X Installer in Action Installation Completed. Shortcut added to docking bar. Page 25 of 25