WhereHows 项目安装和配置指南

1. 项目基础介绍和主要编程语言

项目介绍

WhereHows 是一个由 LinkedIn 开发的开源数据发现和元数据管理平台。它旨在帮助用户发现、理解和管理企业中的数据资产。WhereHows 提供了一个集中的平台，用于存储、搜索和分析数据集的元数据，从而提高数据的可发现性和可理解性。

主要编程语言

WhereHows 项目主要使用以下编程语言：

• Java
• Python
• JavaScript

2. 项目使用的关键技术和框架

WhereHows 项目使用了多种关键技术和框架，主要包括：

• Spring Framework: 用于构建企业级 Java 应用程序。
• React: 用于构建前端用户界面。
• Apache Kafka: 用于处理实时数据流。
• MySQL: 用于存储元数据和配置信息。
• Elasticsearch: 用于全文搜索和数据分析。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装 WhereHows 之前，请确保您的系统满足以下要求：

• 操作系统: Linux 或 macOS（推荐）
• Java: JDK 8 或更高版本
• Python: Python 3.6 或更高版本
• Node.js: 12.x 或更高版本
• MySQL: 5.7 或更高版本
• Elasticsearch: 7.x 或更高版本
• Apache Kafka: 2.x 或更高版本

安装步骤

步骤 1: 克隆项目仓库

首先，从 GitHub 克隆 WhereHows 项目仓库到本地：

git clone https://github.com/linkedin/WhereHows.git
cd WhereHows

步骤 2: 配置数据库

在 MySQL 中创建一个新的数据库，并配置 WhereHows 的数据库连接信息。编辑 application.yml 文件，设置数据库连接字符串：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/wherehows
    username: your_username
    password: your_password

步骤 3: 配置 Elasticsearch

确保 Elasticsearch 服务正在运行，并编辑 application.yml 文件，设置 Elasticsearch 连接信息：

elasticsearch:
  host: localhost
  port: 9200

步骤 4: 配置 Kafka

启动 Kafka 服务，并确保 Kafka 代理正在运行。编辑 application.yml 文件，设置 Kafka 连接信息：

kafka:
  bootstrap-servers: localhost:9092

步骤 5: 构建项目

使用 Maven 构建项目：

mvn clean install

步骤 6: 启动 WhereHows

构建完成后，启动 WhereHows 服务：

java -jar wherehows-backend/target/wherehows-backend.jar

步骤 7: 启动前端

进入前端目录并安装依赖：

cd wherehows-frontend
npm install

启动前端服务：

npm start

完成

至此，WhereHows 项目已经成功安装并配置完成。您可以通过浏览器访问 http://localhost:3000 来使用 WhereHows 平台。

---

通过以上步骤，您可以顺利地在本地环境中安装和配置 WhereHows 项目。如果在安装过程中遇到任何问题，请参考项目文档或社区支持。