Difference between revisions of "Test PBIs/9.2"

From PC-BSD Wiki
Jump to: navigation, search
Line 20: Line 20:
 
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|PBI-dev}} mailing list describing how to recreate the problem. Include the text of any error messages you receive.
 
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|PBI-dev}} mailing list describing how to recreate the problem. Include the text of any error messages you receive.
  
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:
+
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.
  
'''bunzip2 build.log.bz2''' to unzip the file so you can send it to a text processor to read it.
+
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.
  
or
+
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.
 
+
'''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.
+
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|PBI-dev}} mailing list so the changes can be uploaded to the build server.
 
+
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 {{citelink|url=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.
+
 
+
'''svn co <nowiki>svn://svn.pcbsd.org/pbibuild/modules/math/scilab</nowiki>'''
+
 
+
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 {{citelink|url=http://lists.pcbsd.org/mailman/listinfo/pbi-dev|PBI-dev}} mailing list so the changes can be uploaded to the build server.
+
  
 
<noinclude>{{refheading}}</noinclude>
 
<noinclude>{{refheading}}</noinclude>

Revision as of 11:55, 16 August 2012

(Sorry for the inconvenience)

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 actually several build locations, according to PC-BSD version and architecture:

Figure 11.6a shows a sample from the PC-BSD 9.x 64-bit location:

Figure 11.6a: Viewing the Status of PBIs on the Build Server

Build1.png

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 [5][5] mailing list describing how to recreate the problem. Include the text of any error messages you receive.

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 [6][5] mailing list so the changes can be uploaded to the build server.

References


  1. http://pbibuild.pcbsd.org/index.php?ver=8
  2. http://pbibuild64.pcbsd.org/index.php?ver=8
  3. http://pbibuild.pcbsd.org/index.php?ver=9
  4. http://pbibuild64.pcbsd.org/index.php?ver=9
  5. 5.0 5.1 http://lists.pcbsd.org/mailman/listinfo/pbi-dev