1 | PREPARATION (DO ONCE) -- LINUX
|
---|
2 |
|
---|
3 | - cvs checkout -P gsdl (make sure $CVSROOT is set)
|
---|
4 | - Run source setup.bash, in gsdl directory
|
---|
5 | - Set version number (GSDL_VERSION) in lib/gsdlconf.h
|
---|
6 | - Set version number for VERSION file near end of Install.sh, and commit
|
---|
7 | - Make "dist" directory as a sibling of gsdl
|
---|
8 |
|
---|
9 | - cvs checkout -P gli, in gsdl directory
|
---|
10 | - Update AboutDialog.Date in classes/dictionary*.properties, and commit
|
---|
11 | - Get month strings from within the file (Dates.*)
|
---|
12 | - Set PROGRAM_VERSION in src/org/greenstone/gatherer/util/Utility.java, and commit
|
---|
13 | - Set CURRENT_CONFIGURATION_VERSION in src/org/greenstone/gatherer/Configuration.java, and commit
|
---|
14 | - Set Configuration version in classes/xml/config.xml and configRemote.xml, and commit
|
---|
15 |
|
---|
16 | - Change version numbers and dates in /home/nzdl/gsdl-docs/README*.TXT
|
---|
17 | - Get month strings from the macrofiles (_textmonthXX_)
|
---|
18 | - Russian: use /home/nzdl/for-distributions/russian.dm.cp1251 and russian.dm.koi8-r
|
---|
19 | - Change version number in /home/nzdl/gsdl-docs/Support.htm
|
---|
20 | - Check PDF manuals are in /home/nzdl/gsdl-docs/docs
|
---|
21 |
|
---|
22 | # - Copy DistDates file from /home/nzdl/for-distributions into $GSDLHOME
|
---|
23 | - Copy any files in /home/nzdl/for-distributions/bin/script to $GSDLHOME/bin/script
|
---|
24 | - Copy any files in /home/nzdl/for-distributions/bin/linux to $GSDLHOME/bin/linux
|
---|
25 | - Copy /home/nzdl/for-distributions/bin/windows to become $GSDLHOME/bin/windows
|
---|
26 |
|
---|
27 | - Edit $GSDLHOME/collect/demo/etc/collect.cfg and remove non-core language strings
|
---|
28 | - Overwrite /home/nzdl/for-distributions/collect/demo/etc/collect.cfg and commit if different
|
---|
29 | - Edit $GSDLHOME/etc/main.cfg and comment out non-core Language lines and macrofiles
|
---|
30 | - Overwrite /home/nzdl/for-distributions/etc/main.cfg and commit if different
|
---|
31 | - Edit $GSDLHOME/gli/classes/xml/languages.xml and remove mds="true" from non-core languages
|
---|
32 | - Overwrite /home/nzdl/for-distributions/gli/classes/xml/languages.xml and commit if different
|
---|
33 |
|
---|
34 | - Add "-static" to LDFLAGS in configure.in
|
---|
35 | - Run autoconf configure.in > configure
|
---|
36 | - Run ./configure
|
---|
37 | - Fix up non-statically linked packages by adding "-static" to LDFLAGS in:
|
---|
38 | - packages/expat/expat-1.95.8/Makefile
|
---|
39 | - packages/isis-gdl/Makefile
|
---|
40 | - packages/pdftohtml/pdftohtml_gs/src/Makefile
|
---|
41 | - packages/wv/wv-gs/Makefile
|
---|
42 | - packages/xlhtml/xlhtml-0.4.9.0/xlhtml/Makefile
|
---|
43 | - packages/xlhtml/xlhtml-0.4.9.0/ppthtml/Makefile
|
---|
44 | - Add "-static" to the end of the "rtftohtml" rule in rtftohtml/rtftohtml_src/Makefile
|
---|
45 |
|
---|
46 | - Copy built demo collection (prepared earlier!) to collect/demo
|
---|
47 |
|
---|
48 | - Run Installshield X (/home/nzdl/installshieldX/InstallShieldUniversal)
|
---|
49 | - Open /research/mdewsnip/greenstone/installers/gsdl/Greenstone Digital Library Software.uip
|
---|
50 | - If you are not doing this on bedrock, copy the /research/mdewsnip/greenstone/installers/gsdl directory to somewhere on your computer. The parent directory will be the installer directory needed below.
|
---|
51 | - Edit the gsdl/Greenstone Digital Library Software.uip file and change any absolute paths as needed.
|
---|
52 | - Set Installation Information -> General Information: Version property
|
---|
53 | - Set Media -> Path Variables: GSDL_DISTRIBUTION_SOURCE to .../dist/gsdl-x.xx-cdrom
|
---|
54 | - Set Media -> Path Variables: GSDL_WEB_DISTRIBUTION_EXTRAS to .../dist/gsdl-x.xx-unix
|
---|
55 | - Set Media -> Path Variables: GSDL_INSTALLERS_DIR to installer directory specified above (if not on bedrock)
|
---|
56 |
|
---|
57 |
|
---|
58 | PREPARATION (DO ONCE) -- WINDOWS (KOHEKOHE)
|
---|
59 |
|
---|
60 | - Run CMD.exe
|
---|
61 | - Run H:\setupenv.bat, or (equivalently):
|
---|
62 | - Set PATH to include CVS and SSH executables (H:\bin)
|
---|
63 | - Set CVSROOT=:ext:<username>@cvs.scms.waikato.ac.nz:/usr/local/global-cvs/gsdl-src
|
---|
64 | - Set CVS_RSH=ssh
|
---|
65 | - Set EDITOR=edit
|
---|
66 |
|
---|
67 | - cvs checkout -P gsdl (requires about 120MB once compiled)
|
---|
68 | - Set version number (GSDL_VERSION) in gsdl\lib\gsdlconf.h
|
---|
69 | - Unzip the Crypt, Expat, GDBM and STLPort packages in gsdl\packages\windows
|
---|
70 |
|
---|
71 | - cvs checkout -P winbin
|
---|
72 | - Copy winbin\bin to gsdl\bin\windows
|
---|
73 | - Delete winbin directory
|
---|
74 |
|
---|
75 |
|
---|
76 | BUILDING (REPEAT AS OFTEN AS NECESSARY) -- WINDOWS (KOHEKOHE)
|
---|
77 |
|
---|
78 | - cvs update -dP, in gsdl directory (retrieve any new changes)
|
---|
79 |
|
---|
80 | - If Windows 3.1 support is absolutely not needed, Greenstone can be compiled with VC6:
|
---|
81 | - Run C:\Program Files\Microsoft Visual Studio\VC98\Bin\VCVARS32.BAT
|
---|
82 | - Run nmake /f win32.mak (from the gsdl directory)
|
---|
83 | - Run nmake /f win32.mak LOCAL_LIBRARY=1
|
---|
84 | (Errors compiling httpreq.c are due to VC++ -> use a different version, eg. 12.00.8804)
|
---|
85 |
|
---|
86 | - Otherwise, compile Greenstone with VC4 (using the STLPort package):
|
---|
87 | - Run C:\MSDEV\bin\VCVARS32.BAT
|
---|
88 | - Run nmake /f win32.mak USE_STLPORT=1 (from the gsdl directory)
|
---|
89 | - Run nmake /f win32.mak USE_STLPORT=1 LOCAL_LIBRARY=1
|
---|
90 |
|
---|
91 | - Move server.exe, cgi-bin\library.exe and cgi-bin\oaiserver.exe to bin\windows
|
---|
92 | - Copy all files in bin\windows to $GSDLHOME/bin/windows (Linux)
|
---|
93 |
|
---|
94 |
|
---|
95 | BUILDING (REPEAT AS OFTEN AS NECESSARY) -- LINUX
|
---|
96 |
|
---|
97 | - cvs update -dP, in gsdl directory (retrieve any new changes)
|
---|
98 | - Run make (from top level gsdl directory)
|
---|
99 | - In packages/wget/wget-1.9/src, delete wget, run make, rerun gcc command with -static at end
|
---|
100 | - Run make install (from top level gsdl directory)
|
---|
101 | - Run cgi-bin/library to check for segfaults, then copy it and cgi-bin/oaiserver into bin/linux
|
---|
102 | - Check all executables are statically-linked: ldd bin/linux/*
|
---|
103 | - Strip all executables: strip bin/linux/*
|
---|
104 |
|
---|
105 | - In the dist directory, remove any existing folders
|
---|
106 | - Run create_distributions.pl -version_num x.xx -output_dir `pwd` -no_cols
|
---|
107 | - The final time you do this (are you sure??) uncomment the two "cvs tag" lines in the perl script to tag the repositories for the release.
|
---|
108 | - Check no distribution contains non-core language interfaces (macrofiles, images)
|
---|
109 |
|
---|
110 | - For a Web release:
|
---|
111 | - Build Linux web distribution:
|
---|
112 | - Run Installshield X, open Greenstone Digital Library Software.uip
|
---|
113 | - Media -> Releases: select Linux Web Distribution and Build
|
---|
114 | - Close Installshield X
|
---|
115 | - Run finish-unix.sh linux-web
|
---|
116 | - Rename linux-web/disk1 folder to linux-web/gsdl-x.xx-unix
|
---|
117 | - Tar and gzip gsdl-x.xx-unix folder as gsdl-x.xx-unix.tar.gz
|
---|
118 |
|
---|
119 | - Build Windows web distribution:
|
---|
120 | - Edit Greenstone Digital Library Software.uip, replace all "storedAs">1< with "storedAs">0<
|
---|
121 | - Run Installshield X, open Greenstone Digital Library Software.uip
|
---|
122 | - Media -> Releases: select Windows Web Distribution and Build
|
---|
123 | - Close Installshield X
|
---|
124 | - Restore old Greenstone Digital Library Software.uip file
|
---|
125 | - Rename the windows-web/disk1/setup.exe file to gsdl-x.xx-win32.exe
|
---|
126 |
|
---|
127 | - Build Source distribution:
|
---|
128 | - In the dist directory, tar and gzip the gsdl-x.xx-src directory as gsdl-x.xx-src.tar.gz
|
---|
129 |
|
---|
130 | - For a CD-ROM release:
|
---|
131 | - Build Linux and Windows CD-ROM distributions:
|
---|
132 | - Run Installshield X, open Greenstone Digital Library Software.uip
|
---|
133 | - Media -> Releases: select Linux CD-ROM Distribution and Build
|
---|
134 | - Media -> Releases: select Windows CD-ROM Distribution and Build
|
---|
135 | - Close Installshield X
|
---|
136 | - Run merge-cds.pl
|
---|
137 | - Run finish-unix.sh linux-cd
|
---|
138 | - Zip up contents of merged-cd/disk1 directory, copy to Windows, then write to CD-ROM
|
---|
139 | - Don't forget any extra files for the CD (cd-files)
|
---|
140 |
|
---|
141 | - Test ad nauseum!
|
---|
142 |
|
---|
143 |
|
---|
144 | FINALISATION (DO ONCE) -- CD-ROM RELEASE
|
---|
145 |
|
---|
146 | - !! INCOMPLETE !!
|
---|
147 | - Write data to CD
|
---|
148 | - Use Sonic RecordNow DX
|
---|
149 | - Make sure CD-ROMs are created as Joliet CD-ROMs (this should be the default)
|
---|
150 | - Add in any extra stuff required (cd-files folder)
|
---|
151 |
|
---|
152 | - To make an ISO image: ensure CD is finalized when written. Linux: dd if=/dev/cdrom of=cd.iso
|
---|
153 |
|
---|
154 |
|
---|
155 | FINALISATION (DO ONCE) -- WEB RELEASE
|
---|
156 |
|
---|
157 | - Upload binaries and ChangeLog to sourceforges ftp site:
|
---|
158 | - ftp upload.sourceforge.net (username is "anonymous", password is your e-mail address)
|
---|
159 | ftp> cd incoming
|
---|
160 | ftp> bin
|
---|
161 | ftp> put gsdl-x.xx-unix.tar.gz
|
---|
162 | ftp> put gsdl-x.xx-win32.exe
|
---|
163 | ftp> put gsdl-x.xx-src.tar.gz
|
---|
164 | ftp> put gsdl-x.xx-ChangeLog.txt (rename the ChangeLog created by create_distributions: in dist/gsdl-x.xx-src/gsdl/ChangeLog)
|
---|
165 | - Add releases to sourceforge:
|
---|
166 | - login, file releases, add releases. type in release notes, select files from ones you have uploaded, choose some attributes (check previous release for values), notify all watchers.
|
---|
167 | - Add ChangeLog to new Source release
|
---|
168 | - edit the release and add the file
|
---|
169 | - Advertise (say GNU/Linux instead of Linux!):
|
---|
170 | - E-mail mailing lists with release notice
|
---|
171 | - Add item to http://www.greenstone.org - new item, and change the download paths in base.dm
|
---|
172 | - Open Source for Libraries: http://www.oss4lib.org - post a message
|
---|
173 | - FreshMeat: http://freshmeat.net - log in and add a release
|
---|
174 | - Take the updated DistDates file and commit it back into /home/nzdl/for-distributions
|
---|