# glpi

**Repository Path**: ivedio/glpi

## Basic Information

- **Project Name**: glpi
- **Description**: GLPI 10.0.6 应用包，包含了多数插件
- **Primary Language**: PHP
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-08-23
- **Last Updated**: 2023-08-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 运行 GLPI

1. 构建 GLPI 镜像

```
mkdir /data/glpi -p

cat > Dockerfile <<EOF
FROM centos:7.9.2009
LABEL MAINTAINER="ably@vip.163.com"
LABEL VERSION="10.0.6"
LABEL Description="GLPI Asset Management System, using php7.4 and httpd."
RUN curl -o /etc/yum.repos.d/epel.repo http://mirrors.aliyun.com/repo/epel-7.repo && \
    curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo && \
    sed -i -e '/mirrors.cloud.aliyuncs.com/d' -e '/mirrors.aliyuncs.com/d' /etc/yum.repos.d/CentOS-Base.repo
RUN yum -y update && yum -y upgrade
RUN yum -y install epel-release && rpm -Uvh http://rpms.remirepo.net/enterprise/remi-release-7.rpm
RUN yum -y install gcc gcc-c++ flex bison autoconf automake bzip2-devel zlib-devel ncurses-devel libjpeg-devel libpng-devel libtiff-devel freetype-devel pam-devel openssl-devel libxml2-devel gettext-devel pcre-devel net-tools
RUN yum -y install --enablerepo=remi --enablerepo=remi-php74 php php-opcache php-devel php-mbstring php-mysqli php-intl php-gd php-zip php-ldap php-dom php-simplexml httpd
RUN yum clean all
RUN sed -ri 's@^(session.cookie_httponly =)\$@\1 true@g' /etc/php.ini
RUN sed -ri 's@^#(ServerName ).*@\1localhost@g' /etc/httpd/conf/httpd.conf
RUN echo #!/bin/bash > /httpd-start.sh
RUN echo chown -R apache:apache /var/www/html/ >> /httpd-start.sh
RUN echo chmod 755 -R /var/www/html/config/ >> /httpd-start.sh
RUN echo chmod 755 -R /var/www/html/files/ >> /httpd-start.sh
RUN echo httpd -D "glpi" -k start >> /httpd-start.sh
RUN echo tail -f /dev/null >> /httpd-start.sh
RUN chmod +x /httpd-start.sh
RUN chmod 755 /var/www/html
WORKDIR /var/www/html
EXPOSE 80/tcp
CMD ["/bin/bash", "/httpd-start.sh"]
EOF

# yum -y install --enablerepo=remi --enablerepo=remi-php74 php-dom php-simplexml
# httpd -D "glpi" -k start

docker build -t glpi .

docker build -t glpi --no-cache .
```


2. 启动数据库，密码自行修改：

```
# 启动 mysql
# 启动 mysql
mkdir /data/glpi/sql -p
cat > /data/glpi/sql/init.sql <<EOF
use mysql;
select * from user where User='root' \G;
ALTER USER 'root'@'%' IDENTIFIED BY '3Tpa9LTOn22kgqLMWOoJ';
ALTER USER 'root'@'localhost' IDENTIFIED BY '3Tpa9LTOn22kgqLMWOoJ';
flush privileges;
EOF

docker stop glpi-db && docker rm glpi-db
docker volume rm glpidb
docker volume create glpidb
docker volume ls
docker run -d -p 12306:3306 -v glpidb:/var/lib/mysql -v /data/glpi/sql:/docker-entrypoint-initdb.d -e MYSQL_ROOT_PASSWORD=QkpTGTTOnUCpaNr9W244 --name=glpi-db --restart always mysql:latest

docker exec -it glpi-db /bin/bash
mysql -u root -p < /docker-entrypoint-initdb.d/init.sql

docker logs glpi-db

```

3. 下载 [GLPI 10.0.6 应用包](https://gitee.com/ivedio/glpi/archive/refs/tags/10.0.6.tar.gz)

```
cd /data/glpi/
# 将 glpi-10.0.6.tar.gz 拷贝到 /data/glpi/ 目录下
tar -xvf glpi-10.0.6.tar.gz
mv glpi-10.0.6 html

# 启动 glpi
docker stop glpi-app && docker rm glpi-app
docker run -d -p 12308:80 -v /data/glpi/html:/var/www/html --name glpi-app --restart always glpi
docker ps -a

# 初始化完成后
docker exec -it glpi-app /bin/bash
rm -f /var/www/html/install/install.php
php bin/console migration:timestamps

```

4. Win 安装 FusionInventory Agent 2.6

FusionInventory Agent 2.6 Remote Targets：
#内网终端配置服务端地址：
http://ip:port/plugins/fusioninventory/
#公网终端配置服务端地址：
http://domain.com[:port]/plugins/fusioninventory/

5. Linux 安装 fusioninventory-agent

```
# CentOS 8.x 增加镜像源 epel
wget http://mirrors.cloud.tencent.com/epel/epel-release-latest-8.noarch.rpm
rpm -ivh epel-release-latest-8.noarch.rpm
cat > /etc/yum.repos.d/epel.repo <<EOF
[epel]
name=Extra Packages for Enterprise Linux 8 - \$basearch
#baseurl=http://mirrors.cloud.tencent.com/epel/8/Everything/\$basearch
metalink=https://mirrors.fedoraproject.org/metalink?repo=epel-8&arch=\$basearch&infra=\$infra&content=\$contentdir
enabled=1
gpgcheck=1
gpgkey=https://mirrors.tuna.tsinghua.edu.cn/epel/RPM-GPG-KEY-EPEL-8
EOF

# CentOS 7.x 增加镜像源 epel
cat > /etc/yum.repos.d/epel.repo <<EOF
[epel]
name=Extra Packages for Enterprise Linux 7 - \$basearch
metalink=https://mirrors.fedoraproject.org/metalink?repo=epel-7&arch=\$basearch&infra=\$infra&content=\$contentdir
failovermethod=priority
enabled=1
gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
EOF

# 安装代理服务及任务服务
yum install -y fusioninventory-agent fusioninventory-agent-task-inventory

# 修改代理配置文件
sed -ri "s@^#server = http://server.domain.com/ocsinventory@@g" /etc/fusioninventory/agent.cfg
sed -ri "s@^#(server = ).*@\1http://ip:port/plugins/fusioninventory/@g" /etc/fusioninventory/agent.cfg
sed -ri "s@^(server = ).*@\1http://ip:port/plugins/fusioninventory/@g" /etc/fusioninventory/agent.cfg
# 验证服务端地址信息
grep -r '^server = .*' /etc/fusioninventory/agent.cfg
# sed -ri "s@^(server = ).*@\1http://domain.com/plugins/fusioninventory/@g" /etc/fusioninventory/agent.cfg

# 修改代理服务的配置
sed -ri "s@^(ExecStart=/usr/bin/fusioninventory-agent ).*@\1-d --conf-file=/etc/fusioninventory/agent.cfg --no-fork \$OPTIONS@g" /usr/lib/systemd/system/fusioninventory-agent.service
systemctl daemon-reload

# 代理服务的启停控制
systemctl enable fusioninventory-agent
systemctl stop fusioninventory-agent
systemctl start fusioninventory-agent
systemctl restart fusioninventory-agent
systemctl status fusioninventory-agent

# 立即同步信息到服务端
fusioninventory-agent

# 防火墙的控制
firewall-cmd --permanent --zone=public --add-port=62354/tcp
firewall-cmd --reload

# 配置同步计划
# Example of job definition:
# .---------------- minute (0 - 59)
# |  .------------- hour (0 - 23)
# |  |  .---------- day of month (1 - 31)
# |  |  |  .------- month (1 - 12) OR jan,feb,mar,apr ...
# |  |  |  |  .---- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
# |  |  |  |  |
# *  *  *  *  * user-name  command to be executed
echo '*/59 * * * * /usr/bin/php /var/www/html/glpi/front/cron.php > /dev/null 2>&1' >> /etc/crontab
echo '* */1 * * * fusioninventory-agent > /dev/null 2>&1' >> /etc/crontab
systemctl restart crond
systemctl status crond

# 配置时区
sed -ri 's@^;(date.timezone =).*@\1 Asia/Shanghai@g' /etc/php.ini
sed -ri 's@^(date.timezone =).*@\1 Asia/Shanghai@g' /etc/php.ini
```

6. 常见问题

```
# 问题一、重启服务时报错：FusionInventory Agent is already running
# 方案：查询进程ID，然后根据ID强制退出进程
ps -aux | grep fusioninventory
# USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
# root      5859  0.0  0.0 198904 42760 ?        S    10:30   0:04 fusioninventory-agent: waiting
# root         2  0.0  0.0      0     0 ?        S    7月03   0:07 [kthreadd]
kill -9 5859

# 问题二、启动服务时报错：start request repeated too quickly for fusioninventory-agent
# 查看并确认服务及代理的配置文件是否正确，然后退出进程再启动服务。

# rpm 的相关问题
rpm -ivh *.rpm
rpm -qa | grep rpm-name
rpm -e name
```


![GLPI Logo](https://raw.githubusercontent.com/glpi-project/glpi/main/pics/logos/logo-GLPI-250-black.png)

![GLPI CI](https://github.com/glpi-project/glpi/workflows/GLPI%20CI/badge.svg?branch=9.5%2Fbugfixes)
[![Github All Releases](https://img.shields.io/github/downloads/glpi-project/glpi/total.svg)](#download)
[![Twitter Follow](https://img.shields.io/twitter/follow/GLPI_PROJECT.svg?style=social&label=Follow)](https://twitter.com/GLPI_PROJECT)

## About GLPI

GLPI stands for **Gestionnaire Libre de Parc Informatique** is a Free Asset and IT Management Software package, that provides ITIL Service Desk features, licenses tracking and software auditing.

GLPI features:

* Inventory of computers, peripherals, network printers and any associated components through an interface, with inventory tools such as: [FusionInventory](http://fusioninventory.org/) or [OCS Inventory](https://www.ocsinventory-ng.org/)
* Data Center Infrastructure Management (DCIM)
* Item lifecycle management
* Licenses management (ITIL compliant)
* Management of warranty and financial information (purchase order, warranty and extension, damping)
* Management of contracts, contacts, documents related to inventory items
* Incidents, requests, problems and changes management
* Knowledge base and Frequently-Asked Questions (FAQ)
* Asset reservation

Moreover, GLPI supports many [plugins](http://plugins.glpi-project.org) that provide additional features.

## Demonstration

Check GLPI features by asking for a free personal demonstration on **[glpi-network.cloud](https://www.glpi-network.cloud)**

## License

![license](https://img.shields.io/github/license/glpi-project/glpi.svg)

It is distributed under the GNU GENERAL PUBLIC LICENSE Version 3 - please consult the file called [LICENSE](https://raw.githubusercontent.com/glpi-project/glpi/main/LICENSE) for more details.

## Some screenshots

**Tickets**

![Tickets Timeline](pics/screenshots/ticket.png)

**DCIM**

![DCIM drag&drop](pics/screenshots/dcim_racks_draganddrop.gif)

**Assets**

![asset view](pics/screenshots/asset.png)

**Dashboards**

![Asset dashboard](pics/screenshots/dashboard.png)

## Prerequisites

* A web server (Apache, Nginx, IIS, etc.)
* MariaDB >= 10.2 or MySQL >= 5.7
* PHP (See compatibility matrix below)

  | GLPI Version | Minimum PHP | Maximum PHP |
  | ------------ | ----------- | ----------- |
  | 9.4.X        | 5.6         | 7.4         |
  | 9.5.X        | 7.2         | 8.0         |
  | 10.0.X       | 7.4         | 8.1         |
* Mandatory PHP extensions:

  - dom, fileinfo, json, session, simplexml (these are enabled in PHP by default)
  - curl (access to remote resources, like inventory agents, marketplace API, RSS feeds, ...)
  - gd (pictures handling)
  - intl (internationalization)
  - libxml (XML handling)
  - mysqli (communication with database server)
  - zlib (handling of compressed communication with inventory agents, installation of gzip packages from marketplace, PDF generation)
* Suggested PHP extensions

  - exif (security enhancement on images validation)
  - ldap (usage of authentication through remote LDAP server)
  - openssl (email sending using SSL/TLS)
  - zip and bz2 (installation of zip and bz2 packages from marketplace)
* Supported browsers:

  - Edge
  - Firefox (including 2 latest ESR versions)
  - Chrome

Please, consider using browsers on editor's supported version

## Download

See :

* [releases](https://gitee.com/ivedio/glpi/releases) for tarball packages.

## Documentation

* [GLPI Administrator](https://glpi-install.readthedocs.io)

  * Install & Update
  * Command line tools
  * Timezones
  * Advanced configuration
  * [Contribute to this documentation!](https://github.com/glpi-project/doc-install)
* [GLPI User](https://glpi-user-documentation.readthedocs.io)

  * First Steps with GLPI
  * Overview of all modules
  * Configuration & Administration
  * Plugins & Marketplace
  * GLPI command-line interface
  * [Contribute to this documentation!](https://github.com/glpi-project/doc)
* [GLPI Developer](https://glpi-developer-documentation.readthedocs.io)

  * Source Code management
  * Coding standards
  * Developer API
  * Plugins Guidelines
  * Packaging
  * [Contribute to this documentation!](https://github.com/glpi-project/docdev)
* [GLPI Agent](https://glpi-agent.readthedocs.io)

  * Installation (Windows / Linux / Mac OS / Source)
  * Configuration / Settings
  * Usage / Execution mode
  * Tasks / HTTP Interface / Plugins
  * Bug reporting / Man pages
  * [Contribute to this documentation!](https://github.com/glpi-project/doc-agent)

## Additional resources

* [Official website](http://glpi-project.org)
* [Demo](https://www.glpi-network.cloud)
* [Translations on transifex service](https://www.transifex.com/glpi/public/)
* [Issues](https://github.com/glpi-project/glpi/issues)
* [Suggestions](http://suggest.glpi-project.org)
* [Forum](http://forum.glpi-project.org)
* [Development documentation](http://glpi-developer-documentation.readthedocs.io/en/master/)
* [Plugin directory](http://plugins.glpi-project.org)
* [Plugin development documentation](http://glpi-developer-documentation.readthedocs.io/en/master/plugins/index.html)

## Support

GLPI is a living software. Improvements are continuously made, new functionalities are being developed, and issues are being fixed.

To ease support and development, we need your help when encountering issues.
There is a GLPI version typical lifecycle:

* A new major version (9.3) is released.
* Minor versions (9.3.x), fixing bugs or issues, are published after several weeks.
  Please consider updating to the latest released minor version if you encounter some bugs or performance issues.
* Several months after major version released, a new major version (9.4) is released.
  Previous major versions become unsupported, please update to the new major version.
  Obviously, we provide support for the migration tools too!