Difference between revisions of "Test PBIs/9.2"

From PC-BSD Wiki
Jump to: navigation, search
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<noinclude>{{NavHeader|back=Submit PBI Requests|forward=PBI Module Builder Guide}}</noinclude>
+
<translate>
The previous section indicated that new PBI modules are uploaded to the PBI build server. There are actually several build locations, according to PC-BSD version and architecture:
+
  
* [http://pbibuild.pcbsd.org/index.php?ver=7 PC-BSD 7.x - i386]
+
<!--T:1-->
* [http://pbibuild64.pcbsd.org/index.php?ver=7 PC-BSD 7.x - amd64]
+
<noinclude>{{NavHeader|back=Submit PBI Requests|forward=Create PBIs}}</noinclude>
* [http://pbibuild.pcbsd.org/index.php?ver=8 PC-BSD 8.x - i386]
+
* [http://pbibuild64.pcbsd.org/index.php?ver=8 PC-BSD 8.x - amd64]
+
* [http://pbibuild.pcbsd.org/index.php?ver=9 PC-BSD 9.x - i386]
+
* [http://pbibuild64.pcbsd.org/index.php?ver=9 PC-BSD 9.x - amd64]
+
  
Figure 10.6a shows a sample from the PC-BSD 8.x 32 bit location:
+
<!--T:2-->
 +
The previous section indicated that new PBI modules are uploaded to the PBI build server so that they can be built and tested. There are two build locations, one for each PC-BSD® architecture: [[File:Build1a.png|thumb|393px|'''Figure 11.6a: Viewing the Status of PBIs on the Build Server''']]
  
'''Figure 10.6a: Viewing the Status of PBIs on the Build Server'''
+
<!--T:3-->
 +
* {{citelink|url=http://pbibuild.pcbsd.org/index.php?ver=9|txt=PC-BSD® 9.x 32-bit}}
  
[[File:Build.png|border]]
+
<!--T:4-->
 +
* {{citelink|url=http://pbibuild64.pcbsd.org/index.php?ver=9|txt=PC-BSD® 9.x 64-bit}}
  
 +
<!--T:5-->
 
There are two ways you can assist in testing PBIs.
 
There are two ways you can assist in testing PBIs.
  
First, if you wish to help test a PBI before it has been approved, go to the build location for your version and architecture. Find the name of the PBI you wish to test in the Module column and click its hyperlink. You can then download the file with the ''.pbi'' extension. Once downloaded, run '''pbi_add /path/to/pbi'''  to install the PBI. If you find any problems with the PBI, send an email to the [http://lists.pcbsd.org/mailman/listinfo/pbi-dev PBI-dev] mailing list describing how to recreate the problem. Include the text of any error messages you receive.
+
=== Help with approval process === <!--T:6-->
  
Second, you can try to resolve PBI modules that have a Build Status of FAILED. If you click on the name of a failed module, you can download the ''build.log.bz2'' for that module. To access this file, you can either:
+
<!--T:7-->
 +
First, if you wish to help test a PBI before it has been approved, go to the build location for your version and architecture. Find the name of the PBI you wish to test in the "Module" column and click its hyperlink. You can then download the file with the ''.pbi'' extension. Once downloaded, run '''pbi_add /path/to/pbi'''  to install the PBI. If you find any problems with the PBI, send an email to the {{citelink|url=http://lists.pcbsd.org/mailman/listinfo/pbi-dev|txt=PBI-dev}} mailing list describing how to recreate the problem. Include the text of any error messages you receive. Figure 11.6a shows a sample from the PC-BSD® 9.x 64-bit location.
  
'''bunzip2 build.log.bz2''' to unzip the file so you can send it to a text processor to read it.
+
=== Investigate or fix failed build === <!--T:8-->
  
or
+
<!--T:9-->
 +
Second, you can try to resolve PBI modules that have a "Build Status" of "FAILED". If you click on the name of a failed module, you can download the ''build.log'' for that module. This file is in ASCII text so it can be viewed in any text editor.
  
'''bzcat build.log.bz2''' to read the file without unzipping it. It will scroll down to the end, where the error occurred. Use '''bzcat build.log.bz2 | more''' if you prefer to scroll through the file.
+
<!--T:10-->
 +
If the file ends in a ''.bz2'' extension, it has been compressed. To uncompress the file, type '''bunzip2 build.log.bz2'''. Or, you can read the compressed file directly using the command '''bzcat build.log.bz2'''. This command will scroll down to the end, where the error occurred. Use '''bzcat build.log.bz2 | more''' if you prefer to scroll through the file.
  
If you think you know the cause of the problem after reading the error messages, you will need the module itself to try to resolve the problem. Modules are located in the PC-BSD [http://svn.pcbsd.org/browser/pbibuild/modules/ subversion repository]. To download the module, you can use the '''svn''' command. To give an example, the math/scilab PBI was flagged as FAILED in Figure 10.6a. To download that module, '''cd''' to a suitable directory and issue the following command. Note that the '''svn''' command uses the ''svn://'' URI (instead of <nowiki>''http://''</nowiki>) and does not include the ''/browser/'' section you see in the URL if you use your web browser to browse the modules.
+
<!--T:11-->
 +
If you think you know the cause of the problem after reading the error messages, you can review the PBI's module by clicking its "svn" hyperlink. If you decide to download a file to edit it, look for the "Plain Text" link in the "Download in other formats" section at the bottom of the page.
 +
 +
If you make an edit to correct the problem, send the modified file (or a diff) to the {{citelink|url=http://lists.pcbsd.org/mailman/listinfo/pbi-dev|txt=PBI-dev}} mailing list so the changes can be uploaded to the build server.
  
'''svn co <nowiki>svn://svn.pcbsd.org/pbibuild/modules/math/scilab</nowiki>'''
+
<!--T:12-->
 
+
This example command will create a directory called ''scilab/'' and place the module's files in that directory. If you make changes to these files to correct the problem, create a ''tar.gz'' of the directory and send the tarball to the [http://lists.pcbsd.org/mailman/listinfo/pbi-dev PBI-dev] mailing list so the changes can be uploaded to the build server.
+
 
<noinclude>
 
<noinclude>
 +
{{refheading}}
 
[[category:handbook]]
 
[[category:handbook]]
[[category:Supporting PC-BSD]]
+
[[category:Supporting PC-BSD®]]
 
[[category:Test PBIs]]
 
[[category:Test PBIs]]
 +
<languages/>
 
</noinclude>
 
</noinclude>
 +
</translate>

Revision as of 12:56, 22 April 2013

(Sorry for the inconvenience)

Contents

The previous section indicated that new PBI modules are uploaded to the PBI build server so that they can be built and tested. There are two build locations, one for each PC-BSD® architecture:
Figure 11.6a: Viewing the Status of PBIs on the Build Server

There are two ways you can assist in testing PBIs.

Help with approval process

First, if you wish to help test a PBI before it has been approved, go to the build location for your version and architecture. Find the name of the PBI you wish to test in the "Module" column and click its hyperlink. You can then download the file with the .pbi extension. Once downloaded, run pbi_add /path/to/pbi to install the PBI. If you find any problems with the PBI, send an email to the PBI-dev[3] mailing list describing how to recreate the problem. Include the text of any error messages you receive. Figure 11.6a shows a sample from the PC-BSD® 9.x 64-bit location.

Investigate or fix failed build

Second, you can try to resolve PBI modules that have a "Build Status" of "FAILED". If you click on the name of a failed module, you can download the build.log for that module. This file is in ASCII text so it can be viewed in any text editor.

If the file ends in a .bz2 extension, it has been compressed. To uncompress the file, type bunzip2 build.log.bz2. Or, you can read the compressed file directly using the command bzcat build.log.bz2. This command will scroll down to the end, where the error occurred. Use bzcat build.log.bz2 | more if you prefer to scroll through the file.

If you think you know the cause of the problem after reading the error messages, you can review the PBI's module by clicking its "svn" hyperlink. If you decide to download a file to edit it, look for the "Plain Text" link in the "Download in other formats" section at the bottom of the page.

If you make an edit to correct the problem, send the modified file (or a diff) to the PBI-dev[3] mailing list so the changes can be uploaded to the build server.


References


  1. http://pbibuild.pcbsd.org/index.php?ver=9
  2. http://pbibuild64.pcbsd.org/index.php?ver=9
  3. 3.0 3.1 http://lists.pcbsd.org/mailman/listinfo/pbi-dev
Other languages:German 20% • ‎English 100% • ‎French 20%
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox