{"id":670,"date":"2021-07-23T12:35:16","date_gmt":"2021-07-23T12:35:16","guid":{"rendered":"https:\/\/ssdsunucum.com\/blog\/how-to-build-and-install-custom-rpms\/"},"modified":"2021-07-23T12:35:16","modified_gmt":"2021-07-23T12:35:16","slug":"how-to-build-and-install-custom-rpms","status":"publish","type":"post","link":"https:\/\/ssdsunucum.com\/blog\/how-to-build-and-install-custom-rpms\/","title":{"rendered":"How to Build and Install Custom RPMs"},"content":{"rendered":"<\/p>\n
\n
<\/div>\n
\n

Overview<\/h2>\n

cPanel, L.L.C. ships many of cPanel & WHM\u2019s third-party dependencies as RPMs. In order to customize these dependencies on your server, you must<\/strong> custom-build the RPM and then reinstall it. For example, use this method to build and install Roundcube customizations in cPanel & WHM version 58 and later.<\/p>\n

\n
Note:<\/div>\n
\n You must<\/strong> log in through SSH as the root user to install an RPM.\n <\/div>\n<\/div>\n

Before you begin<\/h2>\n

Perform the following steps to ensure your system\u2019s readiness to build and install an RPM:<\/p>\n

    \n
  1. \n

    Install the rpm-build package.<\/p>\n

    Use the following command to install the rpm-build package on your system:\n<\/p>\n

    \n
    yum install rpm-build<\/code><\/pre>\n<\/div>\n<\/li>\n
  2. \n
    Enable the devel<\/code> target for cPanel & WHM.<\/p>\n
    Run the update_local_rpm_versions<\/code> and check_cpanel_rpms<\/code> scripts before you install a custom RPM. These scripts ensure that the devel<\/code> target is enabled and up-to-date. The devel<\/code> target installs the devel<\/code> versions of RPMs, which cPanel & WHM uses to compile SRPMs locally.<\/p>\n
    \n
    \n\n\n
    \n
    1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
    		\n
    \/scripts\/update_local_rpm_versions --edit target_settings.cpanel-devel installed\n\/scripts\/check_cpanel_rpms --targets cpanel-devel --fix<\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
    \n
    Note:<\/div>\n
    \n        To rebuild some cPanel-provided RPMs, you may need to install additional RPMs that cPanel & WHM does not<\/strong> include in default installations. These additional RPMs contain files that the system only needs to rebuild, but not run, the cPanel-provided RPMs.\n    <\/div>\n<\/div>\n<\/li>\n
  3. \n
    Install additional prerequisites.<\/p>\n
    Before you can build and install a custom-built RPM, you must<\/strong> install all of the RPM\u2019s prerequisites. You can find all of an RPM\u2019s prerequisites, and the required version numbers, in its .spec<\/code> file.<\/p>\n
      \n
    • Lines in the .spec<\/code> file that begin with BuildRequires:<\/code> indicate a prerequisite that the RPM requires for the build process.<\/li>\n
    • Lines in the .spec<\/code> file that begin with Requires:<\/code> indicate a prerequisite that the RPM requires for installation.<\/li>\n<\/ul>\n
      For example, BuildRequires: cpanel-mysql >= 5.0.95<\/code> indicates that the RPM requires the cpanel-mysql<\/code> RPM of MySQL\u00ae version 5.0.95 or higher.<\/p>\n<\/li>\n
    • \n
      Ensure that you have installed all necessary RPMs.<\/p>\n
      Run the \/scripts\/sysup<\/code> script to ensure that you have installed all of the prerequisite RPMs.<\/p>\n
        \n
      • If all of these RPMs exist on your server, you will receive the following message: All Needed RPMS are installed.<\/code><\/li>\n
      • If you receive an error message, correct those installation problems first to avoid additional errors when you build and install your custom RPM.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n
        Build and install custom RPMs<\/h2>\n
        Perform the following steps to build and install Roundcube customizations in cPanel & WHM version 58 and later:<\/p>\n
          \n
        1. \n
          Create the .rpmmacros<\/code> file.<\/p>\n
          Use your preferred text editor to create the .rpmmacros<\/code> file in the \/root\/<\/code> directory.<\/p>\n
          \n
          \n\n\n
          \n
          1\n<\/span>2\n<\/span>3\n<\/span><\/code><\/pre>\n<\/td>\n
          		\n
          %_topdir \/root\/rpmbuild\n# enable debug RPM package by commenting this out.<\/span>\n%debug_package %{<\/span>nil}<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n<\/li>\n
        2. \n
          Create the directories to rebuild the RPM.<\/p>\n
          If not present on your server, create the following directories:\n<\/p>\n
          \n
          \n\n\n
          \n
          1\n<\/span>2\n<\/span>3\n<\/span>4\n<\/span>5\n<\/span>6\n<\/span><\/code><\/pre>\n<\/td>\n
          		\n
          \/root\/rpmbuild\/BUILD\n\/root\/rpmbuild\/SPECS\n\/root\/rpmbuild\/SOURCES\n\/root\/rpmbuild\/BUILDROOT\n\/root\/rpmbuild\/RPMS\n\/root\/rpmbuild\/SRPMS<\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
          Run the following command to create these directories:\n<\/p>\n
          \n
          mkdir -p \/root\/rpmbuild\/BUILD \/root\/rpmbuild\/SPECS \/root\/rpmbuild\/SOURCES \/root\/rpmbuild\/BUILDROOT \/root\/rpmbuild\/RPMS \/root\/rpmbuild\/SRPMS<\/code><\/pre>\n<\/div>\n
          \n
          Important:<\/div>\n
          \n        You must<\/strong> use these names for the BUILD, SPECS, SOURCES, BUILDROOT, RPMS, and SRPMS directories. You must capitalize the entire name for each of these directories.\n    <\/div>\n<\/div>\n<\/li>\n
        3. \n
          Install the source RPM.<\/p>\n
          Use the rpm<\/code> command to install the source RPM (SRPM).<\/p>\n
            \n
          • The .spec<\/code> file will install to the \/root\/rpmbuild\/SPECS\/<\/code> directory.<\/li>\n
          • The source tarball, patches, and any additional files for the RPM will install to the \/root\/rpmbuild\/SOURCES\/<\/code> directory.<\/li>\n<\/ul>\n
            \n
            Note:<\/div>\n
            \n        You can find the correct SRPM for your version of cPanel & WHM on our httpupdate server. Click on your server\u2019s version of cPanel & WHM, and then click on the src\/<\/code> directory to view a list of all available SRPMs for that version.\n    <\/div>\n<\/div>\n
            Your command will resemble the following example:<\/p>\n
            \n
            rpm -Uvh http:\/\/httpupdate.cpanel.net\/RPM\/11.42\/src\/cpanel-php54-5.4.23-4.cp1142.src.rpm <\/code><\/pre>\n<\/div>\n
            When the installation finishes, you will see a message that resembles the following example:<\/p>\n
            \n
            Retrieving http:\/\/httpupdate.cpanel.net\/RPM\/11.42\/src\/cpanel-php54-5.4.23-4.cp1142.src.rpm 1<\/span>:cpanel-php54 ########################################### [100%]<\/span><\/code><\/pre>\n<\/div>\n<\/li>\n
          • \n
            Edit the .spec<\/code> file.<\/p>\n
            Use your preferred text editor to modify the .spec<\/code> file in the \/root\/rpmbuild\/SPECS\/<\/code> directory. Add the desired configuration settings for your RPM.<\/p>\n
            \n
            Note:<\/div>\n
            \n        To change any of the sources that ship with the SRPM, modify the files in the \/root\/rpmbuild\/SOURCES\/ directory.\n    <\/div>\n<\/div>\n
            The following example section of a .spec<\/code> file includes the SOAP protocol:<\/p>\n
            \n
            %configure --prefix=<\/span>%{<\/span>_prefix}<\/span>  <\/span>--with-libdir=<\/span>%{<\/span>_lib}<\/span>  <\/span>--verbose  <\/span>--enable-static  <\/span>--with-mcrypt=<\/span>%{<\/span>_3rdparty_prefix}<\/span>  <\/span>--with-iconv --enable-mbstring  <\/span>--with-gd  <\/span>--enable-soap  <\/span>--enable-mbregex  <\/span>--with-imap-ssl --with-imap=<\/span>%{<\/span>_3rdparty_libdir}<\/span>\/imap\/  <\/span><\/code><\/pre>\n<\/div>\n<\/li>\n
          • \n
            Rebuild the RPM.<\/p>\n
            Run the rpmbuild<\/code> command on the modified .spec<\/code> file to build the new RPM locally. Your command should resemble the following example:<\/p>\n
            \n
            rpmbuild -bb \/root\/rpmbuild\/SPECS\/php.spec<\/code><\/pre>\n<\/div>\n
            The rpmbuild<\/code> tool writes the RPM and any subpackages to the \/root\/rpmbuild\/RPMS\/<\/code> directory.<\/p>\n
            \n
            Note:<\/div>\n
            \n        The system may report dependencies issues when you run this command. If so, install these dependencies with yum before you continue.\n    <\/div>\n<\/div>\n<\/li>\n
          • \n
            Run the command to update your RPM with force.<\/p>\n
            Navigate to the \/root\/rpmbuild\/RPMS\/<\/code> directory and run the rpm<\/code> command to install your new custom-built RPM.<\/p>\n
            \n
            rpm -Uvh cpanel-php54-5.4.23-4.cp1142.x86_64.rpm --force<\/code><\/pre>\n<\/div>\n<\/li>\n
          • \n
            Prevent unintentional updates.<\/p>\n
            \n
            Warning:<\/div>\n
            \n        This step is optional<\/strong> and may freeze updates to this RPM and prevent future cPanel & WHM upgrades. However, if you do not perform this step, cPanel & WHM may overwrite your custom RPM on its next update or upgrade.\n    <\/div>\n<\/div>\n
            \n
            \/scripts\/update_local_rpm_versions --add srpm_versions.cpanel-php54 5<\/span>.4.23-4.cp1142<\/code><\/pre>\n<\/div>\n
            To verify your custom RPM\u2019s configuration, view the \/var\/cpanel\/rpm.versions.d\/local.versions<\/code> file.<\/p>\n
            The contents of the local.versions<\/code> file should resemble the following example:<\/p>\n
            \n
            --- file_format:   version: 2<\/span> srpm_versions:   cpanel-php54: 5<\/span>.4.23-4.cp1142<\/code><\/pre>\n<\/div>\n<\/li>\n<\/ol>\n
            Return to the cPanel & WHM version of an RPM<\/h2>\n
            Perform the following steps if you wish to return to the cPanel & WHM version of an RPM:<\/p>\n
              \n
            1. \n
              Run the following command to remove the custom RPM from the local.versions file:<\/p>\n
              \n
              \/scripts\/update_local_rpm_versions --del srpm_versions.cpanel-php54<\/code><\/pre>\n<\/div>\n<\/li>\n
            2. \n
              Run the following script to reinstall the cPanel & WHM version of the RPM:<\/p>\n
              \n
              \/scripts\/check_cpanel_rpms<\/code><\/pre>\n<\/div>\n<\/li>\n<\/ol><\/div>\n","protected":false},"excerpt":{"rendered":"
              Overview cPanel, L.L.C. ships many of cPanel & WHM\u2019s third-party dependencies as RPMs. In order to customize these dependencies on your server, you must custom-build the RPM and then reinstall it. For example, use this method to build and install Roundcube customizations in cPanel & WHM version 58 and later. Note: You must log in …<\/p>\n","protected":false},"author":1,"featured_media":671,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/670"}],"collection":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/comments?post=670"}],"version-history":[{"count":0,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/670\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media\/671"}],"wp:attachment":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media?parent=670"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/categories?post=670"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/tags?post=670"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}