Line 1: |
Line 1: |
− | {{WIP box}} | + | {{Level|Developer}} |
| ==jigdo== | | ==jigdo== |
| ===Introduction=== | | ===Introduction=== |
Line 16: |
Line 16: |
| If you have read this far, you may be confused now, asking yourself what jigdo does and doesn't do. :-) It seems that the jigdo concept is a bit difficult to grasp at first. If you're still interested, have a look at the respective section of the HOWTO and at the Examples section of the jigdo-file manual. | | If you have read this far, you may be confused now, asking yourself what jigdo does and doesn't do. :-) It seems that the jigdo concept is a bit difficult to grasp at first. If you're still interested, have a look at the respective section of the HOWTO and at the Examples section of the jigdo-file manual. |
| | | |
− | ====Installing jigdo on CentOS and RHEL====
| + | ===Installing jigdo on CentOS and RHEL=== |
| | | |
| You need to download and install the correct RPM file from http://dag.wieers.com/rpm/packages/jigdo/ . The choices currently available are for RHEL/CentOS 1 through 5 (they're the ones labelled eg jigdo-0.7.3-1.el5.rf.i386.rpm where the text in bold indicates Enterprise Linux 5), Red Hat 9, and Fedora 1 through 3. There are also source RPMs available. | | You need to download and install the correct RPM file from http://dag.wieers.com/rpm/packages/jigdo/ . The choices currently available are for RHEL/CentOS 1 through 5 (they're the ones labelled eg jigdo-0.7.3-1.el5.rf.i386.rpm where the text in bold indicates Enterprise Linux 5), Red Hat 9, and Fedora 1 through 3. There are also source RPMs available. |
| | | |
− | Download the file first, and then use yum from the command line so install it running either as the root user, or using the sudo command: | + | Download the file first, and then use yum from the command line to install it running either as the root user, or using the sudo command: |
| | | |
| Downloading files for CentOs 5 workstation: you can see this folder http://pkgs.repoforge.org/jigdo/ | | Downloading files for CentOs 5 workstation: you can see this folder http://pkgs.repoforge.org/jigdo/ |
Line 27: |
Line 27: |
| [Note: download the el4 files for CentOs 4 (SME7) if you do the job on this platform...] | | [Note: download the el4 files for CentOs 4 (SME7) if you do the job on this platform...] |
| ok | | ok |
| + | |
| + | ===Generic Use of jigdo by mirroring repository on SME Server=== |
| + | |
| + | This is generic instruction when you need to build an iso for test purpose on a SME Server (what else). Before formally releasing an iso on SME Server mirrors, the developers work on a pre-release to test and debug it, so you have to use jigdo to create the iso, the aim being to test it .<br /> |
| + | |
| + | First you have to verify that jigdo is installed on your SME server, see instructions [[JIGDO_-_create_SME_Server_ISOs#Installing_jigdo_on_CentOS_and_RHEL|above]] or below for [[JIGDO_-_create_SME_Server_ISOs#Getting_SME_8.1_Beta_2|debian]]. |
| + | |
| + | * If you want to build an iso of our marvellous work, you need to download packages from our mirrors. Firstly, make a couple of folders to organize your work (choose the right SME Server needed) : |
| + | mkdir -p /root/jigdo/sme9 |
| + | or for SME Server 8 |
| + | mkdir -p /root/jigdo/sme8 |
| + | |
| + | * Download all contents from the repos (see below), best to make a cup of coffee, it can take some time...This is an example of what you have to do to build a sme9.0beta3, you should take a look to the repository to adapt a new url. This command Line can update rpm in your folder, there is no need to download again which is already downloaded. |
| + | rsync --progress -aHS --partial --delete-after rsync://mir1.ovh.ca/smeserver/releases/testing/9.0beta3/ /root/jigdo/sme9 |
| + | or for SME Server 8 |
| + | rsync --progress -aHS --partial --delete-after rsync://mir1.ovh.ca/smeserver/releases/testing/8.1beta3/ /root/jigdo/sme8 |
| + | |
| + | * Once finished you need to go to the right folder |
| + | |
| + | cd /root/jigdo/sme9/iso/x86_64/ |
| + | or for SME Server 8 |
| + | cd /root/jigdo/sme8/iso/x86_64/ |
| + | |
| + | * Perform this command |
| + | |
| + | jigdo-lite --noask --scan ../../smeos/x86_64/ *.jigdo |
| + | |
| + | of course you have to adapt the architecture which you want to build (i386 or x86_64). '''A known issue is that jigdo fails with a code 3 if an ISO is already present in its current folder.''' |
| + | |
| + | === Getting SME 8.1 Beta 2 on Debian === |
| + | The [http://atterer.org/jigdo/debian-jigdo-mini-howto mini-HOWTO for jigdo] describes it's format and justification for use. |
| + | |
| + | * Download the jigdo file: |
| + | |
| + | mkdir -p /home/dluser/smeserver |
| + | wget http://mirror.contribs.org/releases/testing/8.1beta2/smeos/i386/smeserver-8.1beta2-i386.jigdo |
| + | |
| + | * Since it is only beta, edit the '''Servers''' section for the '''SMEmirror''' parameter to be: |
| + | SMEmirror=http://mirror.contribs.org/releases/testing/8.1beta2/smeos/i386/ |
| + | * When it becomes final, the above step will not be necessary as the '''/8.1beta2/''' folder will become '''/8/'''. |
| + | * Trying to get it in debian will entail the install of [https://help.ubuntu.com/community/JigdoDownloadHowto jigdo-file] |
| + | apt-get install jigdo-file |
| + | * Get the ISO using '''jigdo-lite''' (yes, not ''jigdo-file'') |
| + | jigdo-lite smeserver-8.1beta2-i386.jigdo |
| + | * On 2013-10-15, when the ISO was built, it was 727,961,600 bytes in length and had the following MD5: |
| + | a509d21d476f66b9d27135599b3e6936 smeserver-8.1beta2-i386.iso |
| + | * The end log was |
| + | <pre> |
| + | ... |
| + | ... |
| + | FINISHED --2013-10-15 16:41:30-- |
| + | Total wall clock time: 18s |
| + | Downloaded: 3 files, 718K in 14s (49.7 KB/s) |
| + | Found 3 of the 3 files required by the template |
| + | Successfully created `smeserver-8.1beta2-i386.iso' |
| + | |
| + | ----------------------------------------------------------------- |
| + | Finished! |
| + | The fact that you got this far is a strong indication that `smeserver-8.1beta2-i386.iso' |
| + | was generated correctly. I will perform an additional, final check, |
| + | which you can interrupt safely with Ctrl-C if you do not want to wait. |
| + | |
| + | OK: Checksums match, image is good! |
| + | </pre> |
| | | |
| ===GET SME 8=== | | ===GET SME 8=== |
Line 73: |
Line 137: |
| '''Note:''' Not working because jidgo file points to 8, not 8rc1. Editing the file <tt>smeserver-8.0rc1-i386.jigdo</tt> for correct path for SMEmirror under the Servers section allows completion of ISO downloading. | | '''Note:''' Not working because jidgo file points to 8, not 8rc1. Editing the file <tt>smeserver-8.0rc1-i386.jigdo</tt> for correct path for SMEmirror under the Servers section allows completion of ISO downloading. |
| Should work for final release.... | | Should work for final release.... |
− |
| |
− | ===Generic Use of jigdo by mirroring repository===
| |
− |
| |
− | This is generic instruction when you need to build an iso for test purpose on a SME Server (what else)
| |
− | first you have to verify that jigdo is installed, see instructions above.
| |
− |
| |
− | If you want to build an iso of our marvellous work, we need to download packages from our mirrors but you should make folders to organize this a bit.
| |
− |
| |
− | mkdir -p /root/jigdo/sme9
| |
− |
| |
− | and then download all contents, you should take a coffee...This is an example of how you have to do to build a sme9.0beta2, you should take a look to the repository to adapt a new url.
| |
− | rsync --progress -aHS --partial --delete-after rsync://mir1.ovh.ca/smeserver/releases/testing/9.0beta2/ /root/jigdo/sme9
| |
− |
| |
− | once finished you need to go to the right folder
| |
− |
| |
− | cd /root/jigdo/sme9/iso/x86_64/
| |
− |
| |
− | and perform this command
| |
− |
| |
− | jigdo-lite --noask --scan ../../smeos/x86_64/ *.jigdo
| |
− |
| |
− | of course you have to adapt the architecture which you want to build (i386 or x86_64). A known issue is that jigdo fails with a code 3 if an ISO is already present in its current folder.
| |
− |
| |
− | == Getting SME 8.1 Beta 2 ==
| |
− | The [http://atterer.org/jigdo/debian-jigdo-mini-howto mini-HOWTO for jigdo] describes it's format and justification for use.
| |
− |
| |
− | * Download the jigdo file:
| |
− | <source source lang="bash">
| |
− | mkdir -p /home/dluser/smeserver
| |
− | wget http://mirror.contribs.org/releases/testing/8.1beta2/smeos/i386/smeserver-8.1beta2-i386.jigdo
| |
− | </source>
| |
− | * Since it is only beta, edit the '''Servers''' section for the '''SMEmirror''' parameter to be:
| |
− | SMEmirror=http://mirror.contribs.org/releases/testing/8.1beta2/smeos/i386/
| |
− | * When it becomes final, the above step will not be necessary as the '''/8.1beta2/''' folder will become '''/8/'''.
| |
− | * Trying to get it in debian will entail the install of [https://help.ubuntu.com/community/JigdoDownloadHowto jigdo-file]
| |
− | apt-get install jigdo-file
| |
− | * Get the ISO using '''jigdo-lite''' (yes, not ''jigdo-file'')
| |
− | jigdo-lite smeserver-8.1beta2-i386.jigdo
| |
− | * On 2013-10-15, when the ISO was built, it was 727,961,600 bytes in length and had the following MD5:
| |
− | a509d21d476f66b9d27135599b3e6936 smeserver-8.1beta2-i386.iso
| |
− | * The end log was
| |
− | <pre>
| |
− | ...
| |
− | ...
| |
− | FINISHED --2013-10-15 16:41:30--
| |
− | Total wall clock time: 18s
| |
− | Downloaded: 3 files, 718K in 14s (49.7 KB/s)
| |
− | Found 3 of the 3 files required by the template
| |
− | Successfully created `smeserver-8.1beta2-i386.iso'
| |
− |
| |
− | -----------------------------------------------------------------
| |
− | Finished!
| |
− | The fact that you got this far is a strong indication that `smeserver-8.1beta2-i386.iso'
| |
− | was generated correctly. I will perform an additional, final check,
| |
− | which you can interrupt safely with Ctrl-C if you do not want to wait.
| |
− |
| |
− | OK: Checksums match, image is good!
| |
− | </pre>
| |
| [[Category: Howto]] | | [[Category: Howto]] |