Skip to content

Updated documentation for rebuild mod_lsapi #230

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 11, 2023
Merged

Updated documentation for rebuild mod_lsapi #230

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 32 additions & 3 deletions docs/control_panel_integration/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1562,7 +1562,7 @@ FIND_PATH (APACHE2_2_HTTPD_INCLUDE_DIR

### mod_lsapi

1. Install the packages needed to build mod_lsapi from the source
1. Install the packages needed to build mod_lsapi from the source. Some packages may be missing on some platforms, this is not critical

<div class="notranslate">

Expand All @@ -1574,7 +1574,7 @@ yum install -y python-lxml pytest python-mock
```
</div>

On CloudLinux OS Shared 7 you also should install criu related packages
On CloudLinux OS Shared 7 and above you also should install criu related packages

<div class="notranslate">

Expand All @@ -1583,6 +1583,15 @@ yum install -y criu-lve python-criu-lve criu-lve-devel crit-lve
```
</div>

On CloudLinux OS Shared 8 and above you also should install next packages

<div class="notranslate">

```
yum install -y alt-python37-mock alt-python37-pytest httpd-devel
```
</div>

2. Download mod_lsapi sources

<div class="notranslate">
Expand All @@ -1601,6 +1610,11 @@ rpmbuild --rebuild mod_lsapi-ver.el7.cloudlinux.src.rpm
```
</div>

:::tip Note
This command will fail, but it will create a ~/rpmbuild/SPECS/mod_lsapi.spec file.
This ~/rpmbuild/SPECS/mod_lsapi.spec file will need to be modified.
:::

4. Remove building dependency from `httpd-devel` in the <span class="notranslate">`mod_lsapi.spec`</span> spec file located in the <span class="notranslate">`~/rpmbuild/SPECS/`</span> directory.

5. Change the paths to copy `mod_lsapi.so` and `mod_lsapi.conf` in the %install section of the `mod_lsapi.spec` file. For example, if Apache root is `/usr/local/apache`, then modules directory and config files directory will be <span class="notranslate">`/usr/local/apache/modules`</span> and <span class="notranslate">`/usr/local/apache/conf.d`</span> respectively. So for the config file you should substitute the following line in the <span class="notranslate">`%install`</span> section:
Expand Down Expand Up @@ -1649,8 +1663,16 @@ Also you should add mentions of both module and config files in the <span class=
```
</div>

6. Rebuild the package again, this time you should get to the compilation stage. During compilation, you may encounter some errors:
6. Rebuild the package again, this time you should get to the compilation stage.

Use this command to rebuild a package
<div class="notranslate">
```
rpmbuild -bb ~/rpmbuild/SPECS/mod_lsapi.spec
```
</div>

During compilation, you may encounter some errors:
<div class="notranslate">

```
Expand Down Expand Up @@ -1721,6 +1743,13 @@ The requirements to the `config.ini` file and script file are described in the f

8. Rebuild the package again, if you set everything correctly, there shouldn't be any problems.

Use this command to rebuild a package
<div class="notranslate">
```
rpmbuild -bb ~/rpmbuild/SPECS/mod_lsapi.spec
```
</div>

9. Install the module, check that it is successfully loaded into Apache.

#### How to integrate switch_mod_lsapi script with custom panels
Expand Down