Changes

Jump to navigation Jump to search
m
Line 2: Line 2:  
==Adding new software ==
 
==Adding new software ==
 
New software should be installed from RPMs<br>
 
New software should be installed from RPMs<br>
Red Hat or Centos Version .el4 rpms should be compatible<br>
+
Red Hat or Centos Version .el4 rpms should be compatible for SME7, use .el5 for SME8 and .el6 for SME9.<br>
 
Often these rpms are configured with a SME Server integration rpm.   
 
Often these rpms are configured with a SME Server integration rpm.   
   Line 31: Line 31:  
With everyone having yum repositories set up the same way, Howto authors can now use instructions like:
 
With everyone having yum repositories set up the same way, Howto authors can now use instructions like:
   −
  yum --enablerepo=dag install dansguardian
+
  yum --enablerepo=dag install packagename
      Line 38: Line 38:  
To install an RPM already on your system you can also use yum to install:
 
To install an RPM already on your system you can also use yum to install:
   −
  yum localinstall /path/to/filename.rpm
+
  yum localinstall /path/to/packagename.rpm
   −
To satisfy dependencies you can enable or disable other repositories using the --enablerepo or the --disablerepo option.
+
To satisfy dependencies you can enable or disable other repositories using the --enablerepo=xxx or the --disablerepo=xxx option.
 
{{Note box|msg=Using yum will run other actions such as updating server-manager menus, that rpm -Uvh will not!}}
 
{{Note box|msg=Using yum will run other actions such as updating server-manager menus, that rpm -Uvh will not!}}
    
===Yum Repositories===
 
===Yum Repositories===
 
Yum repositories on SME Server are to be configured by the internal configuration database. Repositories are stored in the yum_repositories database. The yum configuration file, located at /etc/yum.conf holds the actual configuration and is generated using the data in the yum_repositories database.
 
Yum repositories on SME Server are to be configured by the internal configuration database. Repositories are stored in the yum_repositories database. The yum configuration file, located at /etc/yum.conf holds the actual configuration and is generated using the data in the yum_repositories database.
 +
 +
====Checking status of installed repositories====
 +
To check which repositories are installed and their status do
 +
/sbin/e-smith/audittools/repositories
 +
On an unmodified sme server only the following are enabled
 +
 +
base: enabled
 +
 +
smeaddons: enabled
 +
 +
smeextras: enabled
 +
 +
smeos: enabled
 +
 +
smeupdates: enabled
 +
 +
updates: enabled
 +
 +
Any other repository that is installed and listed should have a status of disabled.
 +
This is to prevent the inadvertant and potentially undesirable update of packages.
 +
To update packages from other repos, use the --enablerepo=reponame switch in the yum update command eg
 +
yum update --enablerepo=dag
 +
which will also bring in any rpm updates from the dag repo (only for packages that are already installed on your system). See more details below.
    
====Installing or modifying a repository====
 
====Installing or modifying a repository====
For the syntax of modifying or adding see the examples below in the 3rd-Party Yum Repositories setup section. For more details on the configuration database and how to work with it you can have a look at the [http://mirror.contribs.org/smeserver/contribs/gordonr/devguide/html/book1.htm SME Server Developer's Guide].
+
For the syntax of modifying or adding see the examples below in the 3rd-Party Yum Repositories setup section. For more details on the configuration database and how to work with it see the [SME_Server:Documentation SME Server Developer's Guide].
 
After adding or modifying the yum_repositories database you will have to make sure you regenerate the configuration file using the following command:
 
After adding or modifying the yum_repositories database you will have to make sure you regenerate the configuration file using the following command:
   −
  expand-template /etc/yum.conf
+
  signal-event yum-modify
    
====Options for the yum_repositories database====
 
====Options for the yum_repositories database====
Line 57: Line 80:  
*Visible yes|no - yes displays in server manager
 
*Visible yes|no - yes displays in server manager
 
*status enabled|disabled - disabled are ignored unless specified with --enablerepo=
 
*status enabled|disabled - disabled are ignored unless specified with --enablerepo=
*Exclude - don't fetch these rpms
+
*Exclude=xxx,yyy - don't fetch these rpms
*IncludePkgs - only fetch these rpms
+
*IncludePkgs=xxx,yyy - only fetch these rpms
    
====3rd-Party Yum Repositories setup====
 
====3rd-Party Yum Repositories setup====
 
A list of repositories for SME Server is available in [[:Category:Yum Repository]].
 
A list of repositories for SME Server is available in [[:Category:Yum Repository]].
   −
If you use the commands below to add 3rd party yum repositories, they will be added to the yum-repositories database, but not enabled by default, so this will not affect automatic yum upgrades. It only adds options for running yum manually. They are also set up to block you from installing RPMs that exist already in SME Server 7.0.
+
If you use the commands below to add 3rd party yum repositories, they will be added to the yum-repositories database, but not enabled by default, so this will not affect automatic yum upgrades. It only adds options for running yum manually.  
    
To reflect the changes in the database you will have to regenerate the yum.conf file:
 
To reflect the changes in the database you will have to regenerate the yum.conf file:
   −
   expand-template /etc/yum.conf
+
   signal-event yum-modify
    
{{Warning box|msg=Be sure to never set the status of one of these repositories to enabled as this imposes the risk of installing newer versions SME Server core packages which might break your server. If you want to install software from them you can enable them using the SME Server shell and the yum option --enablerepo=reponame.}}
 
{{Warning box|msg=Be sure to never set the status of one of these repositories to enabled as this imposes the risk of installing newer versions SME Server core packages which might break your server. If you want to install software from them you can enable them using the SME Server shell and the yum option --enablerepo=reponame.}}
Line 89: Line 112:  
Now you have a clean install, you can re-add 3rd party repos as described above <br>
 
Now you have a clean install, you can re-add 3rd party repos as described above <br>
   −
  expand-template /etc/yum.conf
+
  signal-event yum-modify
    
and check  
 
and check  
Line 95: Line 118:  
  yum update
 
  yum update
   −
<noinclude>[[Category:Howto]]</noinclude>
+
<noinclude>[[Category:Howto]][[Category:SME Server]]</noinclude>
3,069

edits

Navigation menu