MeeGo wiki - User contributions [en]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-30T13:46:15Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<p>
This is enough to build packages, but there are security concerns of running just qemu for builds. You can setup the build machines to use either KVM or Xen. Chose one and follow the instructions below. Most people use KVM.
</p>

<code>
# yast2
</code>
<p>
Within YaST2 Control Center, there is a <b>Virtualization</b> option on the left which makes available an <b>Install Hypervisor and Tools</b> option on the right. Install the tools and setup a bridge ethernet device. Be suer to change the default route to use br0.
</p>
<h3>KVM</h3>
<p>
Only install KVM or Xen, not both. Only one will be used at a time.
</p>
<code>
# yast -i kvm virt-manager
# chkconfig libvirtd on
</code>
<p>
Reboot. If you run <b>ps aux|grep bs_worker</b>, the worker should now have a <i>--kvm</i> option within the command.
</p>
<h3>Xen</h3>
<p>
Only install KVM or Xen, not both. Only one will be used at a time.
</p>
<p>
Reboot the machine and be sure to select the Xen kernel in the grub menu. If you run <b>ps aux|grep bs_worker</b>, the worker should now have a <i>--xen</i> option within the command.
</p>
<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
Start the lighttpd server.
</p>
<code>
rclighttpd start
</code>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner obsapidelayed obswebuidelayed
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<p>
The prj and prjconf settings are available from [http://meego.gitorious.org/meego-developer-tools/obs-project-config the git tree] or directly from the OBS server:
</p>
<code>
osc -A <remote API URL> meta prj <repository name> prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
To clone Trunk off MeeGo's api server: <remote API URL> is http://api.meego.com and <repositor name> is Trunk, for example.
</p>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>
<p>
In this setup page, the <local API URL> is http://192.168.1.1:81. Continuing on with the previous example, the <repository name> would be Trunk again.
</p>
<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-29T18:33:24Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<p>
This is enough to build packages, but there are security concerns of running just qemu for builds. You can setup the build machines to use either KVM or Xen. Chose one and follow the instructions below. Most people use KVM.
</p>
<h3>KVM</h3>
<p>
Only install KVM or Xen, not both. Only one will be used at a time.
</p>
<code>
# yast -i kvm virt-manager
# chkconfig libvirtd on
</code>
<p>
Reboot. If you run <b>ps aux|grep bs_worker</b>, the worker should now have a <i>--kvm</i> option within the command.
</p>
<h3>Xen</h3>
<p>
Only install KVM or Xen, not both. Only one will be used at a time.
</p>
<code>
# yast2
</code>
<p>
Within YaST2 Control Center, there is a <b>Virtualization</b> option on the left which makes available an <b>Install Hypervisor and Tools</b> option on the right. Install the tools and reboot the machine. Be sure to select the Xen kernel in the grub menu. If you run <b>ps aux|grep bs_worker</b>, the worker should now have a <i>--xen</i> option within the command.
</p>
<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
Start the lighttpd server.
</p>
<code>
rclighttpd start
</code>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner obsapidelayed obswebuidelayed
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<p>
The prj and prjconf settings are available from [http://meego.gitorious.org/meego-developer-tools/obs-project-config the git tree] or directly from the OBS server:
</p>
<code>
osc -A <remote API URL> meta prj <repository name> prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
To clone Trunk off MeeGo's api server: <remote API URL> is http://api.meego.com and <repositor name> is Trunk, for example.
</p>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>
<p>
In this setup page, the <local API URL> is http://192.168.1.1:81. Continuing on with the previous example, the <repository name> would be Trunk again.
</p>
<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-29T18:01:39Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<p>
This is enough to build packages, but there are security concerns of running just qemu for builds. You can setup the build machines to use either KVM or Xen. Chose one and follow the instructions below. Most people use KVM.
</p>
<h3>KVM</h3>
<p>
Only install KVM or Xen, not both. Only one will be used at a time.
</p>
<code>
# zypper in kvm virt-manager
# chkconfig libvirtd on
</code>
<p>
Reboot. If you run <b>ps aux|grep bs_worker</b>, the worker should now have a <i>--kvm</i> option within the command.
</p>
<h3>Xen</h3>
<p>
Only install KVM or Xen, not both. Only one will be used at a time.
</p>
<code>
# yast2
</code>
<p>
Within YaST2 Control Center, there is a <b>Virtualization</b> option on the left which makes available an <b>Install Hypervisor and Tools</b> option on the right. Install the tools and reboot the machine. Be sure to select the Xen kernel in the grub menu. If you run <b>ps aux|grep bs_worker</b>, the worker should now have a <i>--xen</i> option within the command.
</p>
<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
Start the lighttpd server.
</p>
<code>
rclighttpd start
</code>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner obsapidelayed obswebuidelayed
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<p>
The prj and prjconf settings are available from [http://meego.gitorious.org/meego-developer-tools/obs-project-config the git tree] or directly from the OBS server:
</p>
<code>
osc -A <remote API URL> meta prj <repository name> prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
To clone Trunk off MeeGo's api server: <remote API URL> is http://api.meego.com and <repositor name> is Trunk, for example.
</p>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>
<p>
In this setup page, the <local API URL> is http://192.168.1.1:81. Continuing on with the previous example, the <repository name> would be Trunk again.
</p>
<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-29T14:47:07Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<p>
This is enough to build packages, but there are security concerns of running just qemu for builds. You can setup the build machines to use either KVM or Xen. Chose one and follow the instructions below. Most people use KVM.
</p>
<h3>KVM</h3>
<p>
Only install KVM or Xen, not both. Only one will be used at a time.
</p>
<code>
yast -i kvm virt-manager
chkconfig libvirtd on
</code>
<p>
Reboot. If you run <b>ps aux|grep bs_worker</b>, the worker should now have a <i>--kvm</i> option within the command.
</p>
<h3>Xen</h3>
<p>
Only install KVM or Xen, not both. Only one will be used at a time.
</p>
<code>
# yast2
</code>
<p>
Within YaST2 Control Center, there is a <b>Virtualization</b> option on the left which makes available an <b>Install Hypervisor and Tools</b> option on the right. Install the tools and reboot the machine. Be sure to select the Xen kernel in the grub menu. If you run <b>ps aux|grep bs_worker</b>, the worker should now have a <i>--xen</i> option within the command.
</p>
<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
Start the lighttpd server.
</p>
<code>
rclighttpd start
</code>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner obsapidelayed obswebuidelayed
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<p>
The prj and prjconf settings are available from [http://meego.gitorious.org/meego-developer-tools/obs-project-config the git tree] or directly from the OBS server:
</p>
<code>
osc -A <remote API URL> meta prj <repository name> prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
To clone Trunk off MeeGo's api server: <remote API URL> is http://api.meego.com and <repositor name> is Trunk, for example.
</p>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>
<p>
In this setup page, the <local API URL> is http://192.168.1.1:81. Continuing on with the previous example, the <repository name> would be Trunk again.
</p>
<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-29T14:44:53Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<p>
This is enough to build packages, but there are security concerns of running just qemu for builds. You can setup the build machines to use either KVM or Xen. Chose one and follow the instructions below. Most people use KVM.
</p>
<h3>KVM</h3>
<code>
yast -i kvm virt-manager
chkconfig libvirtd on
</code>
<p>
Reboot. If you run <b>ps aux|grep bs_worker</b>, the worker should now have a <i>--kvm</i> option within the command.
</p>
<h3>Xen</h3>
<code>
# yast2
</code>
<p>
Within YaST2 Control Center, there is a <b>Virtualization</b> option on the left which makes available an <b>Install Hypervisor and Tools</b> option on the right. Install the tools and reboot the machine. Be sure to select the Xen kernel in the grub menu. If you run <b>ps aux|grep bs_worker</b>, the worker should now have a <i>--xen</i> option within the command.
</p>
<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
Start the lighttpd server.
</p>
<code>
rclighttpd start
</code>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner obsapidelayed obswebuidelayed
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<p>
The prj and prjconf settings are available from [http://meego.gitorious.org/meego-developer-tools/obs-project-config the git tree] or directly from the OBS server:
</p>
<code>
osc -A <remote API URL> meta prj <repository name> prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
To clone Trunk off MeeGo's api server: <remote API URL> is http://api.meego.com and <repositor name> is Trunk, for example.
</p>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>
<p>
In this setup page, the <local API URL> is http://192.168.1.1:81. Continuing on with the previous example, the <repository name> would be Trunk again.
</p>
<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-22T19:47:23Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper mr -d openSUSE_Tools
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner obsapidelayed obswebuidelayed
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<p>
The prj and prjconf settings are available from [http://meego.gitorious.org/meego-developer-tools/obs-project-config the git tree] or directly from the OBS server:
</p>
<code>
osc -A <remote API URL> meta prj <repository name> prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
To clone Trunk off MeeGo's api server: <remote API URL> is http://api.meego.com and <repositor name> is Trunk, for example.
</p>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>
<p>
In this setup page, the <local API URL> is http://192.168.1.1:81. Continuing on with the previous example, the <repository name> would be Trunk again.
</p>
<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-22T19:14:10Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper mr -d openSUSE_Tools
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner obsapidelayed obswebuidelayed
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<p>
The prj and prjconf settings are available from [http://meego.gitorious.org/meego-developer-tools/obs-project-config the git tree] or directly from the OBS server:
</p>
<code>
osc -A <remote API URL> meta prj <repository name> prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
To clone Trunk off MeeGo's api server: <remote API URL> is http://api.meego.com and <repositor name> is Trunk, for example.
</p>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-22T19:13:20Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper mr -d openSUSE_Tools
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner obsapidelayed obswebuidelayed
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<p>
The prj and prjconf settings are available from [http://meego.gitorious.org/meego-developer-tools/obs-project-config the git tree] or directly from the OBS server:
</p>
<code>
osc -A <remote API URL> meta prj <repository name> prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
To clone Trunk off MeeGo's api server: <remote API URL> is http://api.meego.com and <repositor name> is Trunk, for example.
</p>
</p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-22T19:12:41Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper mr -d openSUSE_Tools
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner obsapidelayed obswebuidelayed
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<p>
The prj and prjconf settings are available from <a href="http://meego.gitorious.org/meego-developer-tools/obs-project-config">the git tree</a> or directly from the OBS server:
</p>
<code>
osc -A <remote API URL> meta prj <repository name> prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
To clone Trunk off MeeGo's api server: <remote API URL> is http://api.meego.com and <repositor name> is Trunk, for example.
</p>
</p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-17T16:48:23Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper mr -d openSUSE_Tools
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner obsapidelayed obswebuidelayed
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-16T21:36:29Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper mr -d openSUSE_Tools
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-devel mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro

2010-06-16T19:27:40Z

Liam:

These pages are in preparation - contributions welcome on the discussion page

== The MeeGo VM appliance ==
... WIP ...
== How to setup an Build Service locally for testing ==
The software driving the openSUSE Build Service (OBS) is available for different distributions.
Take the packages suitable for your distribution of choice hosted at the openSUSE Build Service instance:
* [http://download.opensuse.org/repositories/openSUSE:/Tools 1.7.x (current version)]
* [http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/ 1.8 ('MeeGo' release)]

For the distributions mentioned below we provide setup-howtos:
* [[Build_Infrastructure/Sysadmin_Distro/OBS_setup_openSUSE112|OBS 1.7 on openSUSE 11.2]]
* [[Build_Infrastructure/Sysadmin_Distro/OBS1.8_setup_openSUSE112|OBS 1.8 on openSUSE 11.2]]

A good source of documentation is the upstream project wiki hosted at [http://wiki.opensuse.org/Portal:Build_Service http://wiki.opensuse.org/Portal:Build_Service]

You can review a bare-metal to operational setup at the [http://wiki.maemo.org/OpenSuse_Build_Service/Installation maemo.org and MeeGo community OBS setup notes]

== Advanced setup topics ==
== Seamless cross-compilation, cross-toolchain integration ==
== Whats the metadata (prjconf/prj), attributes, admin-tools for. ==
== Troubleshooting ==
== irc / mailinglists / contact ==

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro

2010-06-16T18:54:27Z

Liam:

These pages are in preparation - contributions welcome on the discussion page

== The MeeGo VM appliance ==
... WIP ...
== How to setup an Build Service locally for testing ==
The software driving the openSUSE Build Service (OBS) is available for different distributions.
Take the packages suitable for your distribution of choice hosted at the openSUSE Build Service instance:
* [http://download.opensuse.org/repositories/openSUSE:/Tools 1.7.x (current version)]
* [http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/ 1.8 ('MeeGo' release)]

For the distributions mentioned below we provide setup-howtos:
* [[Build_Infrastructure/Sysadmin_Distro/OBS_setup_openSUSE112|OBS 1.7 on openSUSE 11.2]]
* [[Build_Infrastructure/Sysadmin_Distro/OBS18_setup_openSUSE112|OBS 1.8 on openSUSE 11.2]]

A good source of documentation is the upstream project wiki hosted at [http://wiki.opensuse.org/Portal:Build_Service http://wiki.opensuse.org/Portal:Build_Service]

You can review a bare-metal to operational setup at the [http://wiki.maemo.org/OpenSuse_Build_Service/Installation maemo.org and MeeGo community OBS setup notes]

== Advanced setup topics ==
== Seamless cross-compilation, cross-toolchain integration ==
== Whats the metadata (prjconf/prj), attributes, admin-tools for. ==
== Troubleshooting ==
== irc / mailinglists / contact ==

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro

2010-06-16T18:52:35Z

Liam: /* How to setup an Build Service locally for testing */

These pages are in preparation - contributions welcome on the discussion page

== The MeeGo VM appliance ==
... WIP ...
== How to setup an Build Service locally for testing ==
The software driving the openSUSE Build Service (OBS) is available for different distributions.
Take the packages suitable for your distribution of choice hosted at the openSUSE Build Service instance:
* [http://download.opensuse.org/repositories/openSUSE:/Tools 1.7.x (current version)]
* [http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/ 1.8rc3 ('MeeGo' release)]

For the distributions mentioned below we provide setup-howtos:
* [[Build_Infrastructure/Sysadmin_Distro/OBS_setup_openSUSE112|OBS 1.7 on openSUSE 11.2]]
* [[Build_Infrastructure/Sysadmin_Distro/OBS18_setup_openSUSE112|OBS 1.8 on openSUSE 11.2]]

A good source of documentation is the upstream project wiki hosted at [http://wiki.opensuse.org/Portal:Build_Service http://wiki.opensuse.org/Portal:Build_Service]

You can review a bare-metal to operational setup at the [http://wiki.maemo.org/OpenSuse_Build_Service/Installation maemo.org and MeeGo community OBS setup notes]

== Advanced setup topics ==
== Seamless cross-compilation, cross-toolchain integration ==
== Whats the metadata (prjconf/prj), attributes, admin-tools for. ==
== Troubleshooting ==
== irc / mailinglists / contact ==

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-16T18:48:36Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools and OpenSUSE:Tools:Meego repository to zypper.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
wget http://download.opensuse.org/repositories/openSUSE:/Tools:/MeeGo/openSUSE_11.2/openSUSE:Tools:MeeGo.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper mr -d openSUSE_Tools
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-16T18:04:23Z

Liam:

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is now released. These instructions cover the new 1.8 release.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper mr -d openSUSE_Tools
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS1.8 setup openSUSE112

2010-06-16T18:03:32Z

Liam: Created page with '<p> These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as…'

<p>
These steps are to setup Open Build Service 1.8 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.
change priority to avoid installing obs 2.0:

<code>
zypper mr -p 60 openSUSE_Tools_MeeGo
zypper mr -r openSUSE_Tools_MeeGo
zypper mr -d openSUSE_Tools
zypper ref
</code>

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-16T17:24:26Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
<p>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-16T17:23:49Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
Make sure you set the permissions on the api and webui directories.
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>
If this doesn't work then try to recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-16T17:21:22Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
<h3>Cannot load person data for Admin in application_helper</h3>
<p>
This is a database issue. Recreate the databases:
</p>
<code>
# mysql -u root -p
mysql> drop database api_production;
mysql> drop database webui_production;
</code>
<p>
Rerun the mysql database setup from above and re-run rake.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-16T16:16:12Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Make sure vhosts are enabled by uncommenting the following line:
<code>
# vi /etc/lighttpd/lighttpd.conf
include_shell "cat /etc/lighttpd/vhosts.d/*.conf"
</code>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T19:59:15Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Fremantle_Setup Maemo Fremantel Setup]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T19:54:05Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T19:51:00Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Installation]
</li>
<li>
</li>

</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

User:Liam

2010-06-04T19:50:30Z

Liam:

<p>
Liam is a Linux Developer at [http://www.windriver.com Wind River].
</p>
<p>
You can find him on freenode as jedix
</p>

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T19:48:30Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo OBS Setup Installation]
</li>
<li>
</li>

</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T19:48:09Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo documentation]
</li>
<li>
</li>

</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T19:47:56Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[[http://wiki.maemo.org/OpenSuse_Build_Service/Installation Maemo documentation]]
</li>
<li>
</li>

</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T19:47:42Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[[http://wiki.maemo.org/OpenSuse_Build_Service/Installation | Maemo documentation]]
</li>
<li>
</li>

</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T19:47:21Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
<h2>External Links</h2>
<p>
<ul>
<li>
[[Maemo documentation | http://wiki.maemo.org/OpenSuse_Build_Service/Installation]]
</li>
<li>
</li>

</ul>
</p>
----
[[User:Liam | Liam]]

[[User:Dl9pf | Dl9pf]]

[[Category:Build Infrastructure]]

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T17:35:26Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Setting up Cross Compile</h2>
<h3>Configure build types</h3>
<p>
To setup cross compile, add the appropriate machine types to /etc/sysconfig/obs-server. For example, the following will enable ARM builds.
</p>
<code>
# vi /etc/sysconfig/obs-server
OBS_SCHEDULER_ARCHITECTURES="i586 armv5el armv7el“
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
[[User:Liam | Liam]]

dl9pf

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T15:05:57Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h2>Troubleshooting</h2>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h3>HTTP Error 500</h3>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
[[User:Liam | Liam]]

dl9pf

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T15:05:36Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h3>Troubleshooting</h3>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h4>HTTP Error 500</h4>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
[[User:Liam | Liam]]

dl9pf

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T15:05:12Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h3>Troubleshooting</h3>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h2>HTTP Error 500</h2>
<p>
Check <b>/srv/www/obs/api/config/environments/production.rb</b>
and <b>/srv/www/obs/webui/config/environments/production.rb</b> for configuration of the
<b>SOURCE_HOST</b> and <b>FRONTEND_HOST</b>.
</p>
----
[[User:Liam | Liam]]

dl9pf

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T15:04:05Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

<h3>Troubleshooting</h3>
<p>
Here are common issues that have been seen and how to resolve them.
</p>

<h2>HTTP Error 500</h2>
<p>
</p>
----
[[User:Liam | Liam]]

dl9pf

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T14:51:47Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and login to OBS. Port 80 should be the webui, port 81 should be the api, and port 82 should be the repository directory. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

----
[[User:Liam | Liam]]

dl9pf

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T14:48:03Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Verification</h3>
<p>
At this point you should be able to open a browser and go to your server and log into OBS. Port 80 (the default port) should get you to the webui. Port 81 should get you to the API login. The default username/password is Admin/opensuse.
</p>
<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

----
[[User:Liam | Liam]]

dl9pf

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T14:02:03Z

Liam:

<p>
These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation. Currently this document describes how to setup an evaluation/test setup and is not meant as a production setup.
</p>
<p>
Most users won't need to install their own OBS and can just use an account on a publicly accessible OBS. Once public access is allowed to the global MeeGo OBS, there will be a link to obtain access.
</p>
<p>
There are cases where vendors may rather have full control of their builds and keep source private due to licensing restrictions, etc. These instructions are for these special cases.
</p>
<p>
MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. These instructions will be updated for the new version as soon as possible.
</p>

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

----
[[User:Liam | Liam]]

dl9pf

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T13:45:01Z

Liam:

These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation.
It's an evaluation/test setup and not meant as a production setup.

MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. We'll update the instructions.

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

----
[[User:Liam | Liam]]

dl9pf

User:Liam

2010-06-04T13:43:33Z

Liam:

<p>
Liam is a Linux Developer at [[http://www.windriver.com Wind River]].
</p>
<p>
You can find him on freenode as jedix
</p>

User:Liam

2010-06-04T13:42:33Z

Liam:

Liam is a Linux Developer working at [[http://www.windriver.com Wind River]].
He goes by the nick jedix on freenode

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T13:41:17Z

Liam:

These steps are to setup Open Build Service 1.7.5 on an openSuSE 11.2 installation.
It's an evaluation/test setup and not meant as productive setup.

MeeGo will switch to [http://lists.opensuse.org/opensuse-buildservice/2010-05/msg00094.html version 1.8] of the Build Service which is to be released soon. We'll update the instructions.

<h2>Add Repositories</h2>

First, we have to add the openSUSE:Tools repository to zypper for qemu-svn and other updated tools.

<code>
cd /etc/zypp/repos.d/;
wget http://download.opensuse.org/repositories/openSUSE:/Tools/openSUSE_11.2/openSUSE:Tools.repo
zypper ref
</code>

Accept the trust key.

<h2>Setup the Client</h2>
<h3>Install the Client Packages</h3>

*For obs worker:
<code>
zypper in obs-worker qemu-svn mount-static bash-static
</code>

<h3>Point To The Server</h3>
<p>
Edit the file /etc/sysconfig/obs-worker in order to point to correct repository server. (The example server is 192.168.1.1)
</p>
<code>
# vi /etc/sysconfig/obs-worker
OBS_SRC_SERVER="192.168.1.1:5352"
OBS_REPO_SERVERS="192.168.1.1:5252"
</code>

<h3>Start the Client</h3>
<p>Start the worker service
</p>
<code>
chkconfig --add obsworker
rcobsworker start
</code>

<h2>Setup the server</h2>

<h3>Install the Server packages</h3>

*For server:
<code>
zypper in obs-server obs-signer obs-utils createrepo nfs-client obs-api memcached lighttpd
</code>

<h3>MySQL Setup</h3>
Start daemon by default:
<code>
chkconfig --add mysql
rcmysql start
</code>

Secure the installation
<code>
/usr/bin/mysql_secure_installation
</code>

Create the databases:
<code>
mysql -u root -p
mysql> create database api_production;
mysql> create database webui_production;
</code>

Add the obs user for these databases (substitute the correct password in):

<code>
GRANT all privileges
ON api_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
GRANT all privileges
ON webui_production.*
TO 'obs'@'%', 'obs'@'localhost' IDENTIFIED BY '************';
FLUSH PRIVILEGES;
</code>

Now, configure OBS to use MySQL, first the API server.

<code>
vi /srv/www/obs/api/config/database.yml
#change the production section
production:
adapter: mysql
database: api_production
username: obs
password: ************
</code>
And setup the webui to use MySQL...
<code>
vi /srv/www/obs/webui/config/database.yml
#change the production section
production:
adapter: mysql
database: webui_production
username: obs
password: ************
</code>

Populate the database
<code>
cd /srv/www/obs/api/
RAILS_ENV="production" rake db:migrate

cd /srv/www/obs/webui/
RAILS_ENV="production" rake db:migrate
</code>
If this fails, check /srv/www/obs/api/config/environments/production.rb and /srv/www/obs/webui/config/environments/production.rb for configuration of the SOURCE_HOST and FRONTEND_HOST.

<h3>Setup lighttpd for webui</h3>
Setup the regular webui on 80, api on 81, and 82 is the repository.
<code>
vi /etc/lighttpd/vhosts.d/obs.conf
$SERVER["socket"] == ":80" {
rails_app = "webui"
rails_root = "/srv/www/obs/webui"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/webui/log"
include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":81" {
rails_app = "api"
rails_root = "/srv/www/obs/api"
rails_procs = 3
# production/development are typical values here
rails_mode = "production"
log_root = "/srv/www/obs/api/log"

include "vhosts.d/rails.inc"
}
$SERVER["socket"] == ":82" {
server.name = "192.168.1.1"
server.document-root = "/srv/obs/repos/"
dir-listing.activate = "enable"
}

</code>
<p>
lighttpd requires some extra modules to be enabled: mod_access, mod_rewrite, mod_magnet, and mod_fastcgi. Do so by editing /etc/lighttpd/modules.conf:
</p>
<code>
# vi /etc/lighttpd/modules.conf
server.modules = (
"mod_access",
# "mod_alias",
# "mod_auth",
# "mod_evasive",
# "mod_redirect",
"mod_rewrite",
# "mod_setenv",
# "mod_usertrack",
)

##
## mod_magnet
##
include "conf.d/magnet.conf"

##
## FastCGI (mod_fastcgi)
##
include "conf.d/fastcgi.conf"
</code>

<p>
You need also to configure /srv/www/obs/webui/config/environments/production.rb to point to correct server names:
</p>
<code>
# vi /srv/www/obs/webui/config/environments/production.rb
FRONTEND_HOST = "192.168.1.1"
FRONTEND_PORT = 81
FRONTEND_PROTOCOL = 'http'
BUGZILLA_HOST = nil
DOWNLOAD_URL = "http://192.168.1.1:82"
ICHAIN_MODE = "off"
BASE_NAMESPACE = nil
</code>

<p>
Do the same for /srv/www/obs/api/config/environments/production.rb. As soon your backend is not on the same machine as the api (frontend), change the following:
</p>
<code>
# vi /srv/www/obs/api/config/environments/production.rb
SOURCE_HOST = "192.168.1.1"
</code>

<p>
Add the server to start by default.
</p>
<code>
chkconfig --add memcached
chkconfig --add lighttpd
chkconfig --add obsapidelayed
chkconfig --add obswebuidelayed
</code>

<p>
ligthttpd user and group need to be the onwer of api and webui dirs (as well as log and tmp):
</p>
<code>
chown -R lighttpd.lighttpd /srv/www/obs/{api,webui}
</code>

<h3>BSConfig.pm</h3>
<p>
The file <i>/usr/lib/obs/server/BSConfig.pm</i> is used to configure several settings for the Build Service. One of the major components is setting up the $hostname variable to the correct value. Currently I have this set to the IP address of the server.
</p>

<code>
my $hostname = '192.168.1.1';
</code>

<p>
The list of directories in /srv/obs/repos/ is the repositories, so I changed the $repodownload:
</p>

<code>
our $repodownload = "http://$hostname:82/";
</code>

<h3>Start By Default</h3>

<p>The OBS should start automatically, so they should be added to chkconfig to do so:</p>
<code>
chkconfig --add obsrepserver obssrcserver obsscheduler obsdispatcher obspublisher obswarden obssigner
</code>

<h2>Cloning Repositories</h2>

<h3>prj and prjconf</h3>
<p>The project settings and the project config is an important part of the project and should be copied to the local project setup.</p>
<code>
osc -A <remote API URL> meta prj <repository name> > prj.txt
osc -A <remote API URL> meta prjconf <repository name> > prjconf.txt
</code>
<p>
Modify the prj.txt file to name valid users in the userid fields. Once modified, the settings and configuration can be applied to the local project.
</p>
<code>
osc -A <local API URL> meta prj <repository name> -F prj.txt
osc -A <local API URL> meta prjconf <repository name> -F prjconf.txt
</code>

<h3>Mirror</h3>
<p>
obs_mirror_project (/usr/sbin/obs_mirror_project) is used to copy an external OBS project. The script needed to be modified to use build.meego.com as apposed to the hard coded download.opensuse.org site. You need an login to build.meego.com to execute this script.
</p>
<code>
/usr/sbin/obs_mirror_project <repository name> <type> <arch>
</code>

<h3>Rescan Repository</h3>
<p>Once the download of the project is complete, you have to rescan the local repository.</p>
<code>
/usr/lib/obs/server/bs_admin --rescan-repository <repository name> <type> <arch>
</code>

----
[[User:Liam | Liam]]

dl9pf

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T13:40:10Z

Liam:

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T13:39:36Z

Liam:

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T13:39:12Z

Liam:

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T13:38:47Z

Liam:

Build Infrastructure/Sysadmin Distro/OBS setup openSUSE114

2010-06-04T13:38:18Z

Liam:

User:Liam

2010-06-03T20:57:37Z

Liam:

Liam is a Linux Developer working at [[http://www.windriver.com Wind River]].

User:Liam

2010-06-03T20:57:21Z

Liam:

Liam is a Linux Developer working at [[http://www.windriver.com "Wind River"]].

User:Liam

2010-06-03T20:56:21Z

Liam:

Liam works for [[http://www.windriver.com "Wind River"]].

User:Liam

2010-06-03T20:56:01Z

Liam:

Liam works for [[http://www.windriver.com|"Wind River"]].