运行Metabase OSS JAR文件
要在系统上通过JAR文件运行Metabase免费开源版本,您需要安装Java运行时环境(JRE)。
如果您有Metabase的专业或企业版令牌,请参阅激活您的Metabase商业许可证。
快速入门
快速入门旨在在本地运行Metabase。有关在生产环境中运行Metabase的说明,请参阅下文。
如果您已安装Java
- 下载Metabase OSS的JAR文件。如果您在Pro或企业计划中,请下载企业版的JAR文件。
- 创建一个新的目录并将Metabase JAR文件移动到其中。
- 切换到您的Metabase新目录并运行JAR。
java -jar metabase.jar
Metabase在启动时会将其进度记录在终端中。等待您看到“Metabase初始化完成”并访问https://127.0.0.1:3000/setup
。
如果您使用的是Pro或企业版,请确保激活您的许可证。
本地安装
如果您只想试用Metabase,玩玩Metabase,或者只在本地机器上使用Metabase,Metabase附带了一个默认的应用数据库,您可以使用它。此设置不适用于生产。如果您打算在您的组织中真正运行Metabase,请参阅生产安装。
以下说明与上述快速入门相同,只是对每个步骤都提供了一些更多背景信息。
1. 安装Java JRE
您可能已经安装了Java。要检查版本,请打开终端并运行
java -version
如果没有安装Java,您在运行Metabase之前需要安装Java。我们推荐使用Eclipse Temurin的版本11 JRE与HotSpot JVM。您可以在Java 11运行的任何地方运行Metabase。特定的处理器架构不应很重要(尽管我们只为x86和ARM测试了Metabase)。
2. 下载Metabase
下载JAR文件
如果您想安装Pro或企业版的Metabase,请参阅激活您的Metabase商业许可证。
3. 创建一个新目录并将Metabase JAR移动到其中
当您运行Metabase时,Metabase将创建一些新文件,因此,在运行之前将Metabase JAR文件放入新目录中很重要(所以将其从下载文件夹移动出来,并将其放入新目录)。
在posix系统中,命令可能如下所示
假设您下载到了/Users/person/Downloads
mkdir ~/metabase
然后
mv /Users/person/Downloads/metabase.jar ~/metabase
4. 切换到您的Metabase新目录并运行JAR
切换到步骤2中创建的目录
cd ~/metabase
现在Java运行正常,您可以从终端运行JAR
java -jar metabase.jar
Metabase将使用默认设置启动。您应该会在终端窗口中看到一些日志条目开始运行,显示应用程序启动时的进度。一旦Metabase完全启动,您将看到如下确认信息
...
06-19 10:29:34 INFO metabase.task :: Initializing task CheckForNewVersions
06-19 10:29:34 INFO metabase.task :: Initializing task SendAnonymousUsageStats
06-19 10:29:34 INFO metabase.task :: Initializing task SendAbandomentEmails
06-19 10:29:34 INFO metabase.task :: Initializing task SendPulses
06-19 10:29:34 INFO metabase.task :: Initializing task SendFollowUpEmails
06-19 10:29:34 INFO metabase.task :: Initializing task TaskHistoryCleanup
06-19 10:29:34 INFO metabase.core :: Metabase Initialization COMPLETE
此时您已准备好使用新服务器了!您可以通过端口3000访问您的Metabase服务器,通常是https://127.0.0.1:3000
。
您可以通过设置环境变量 MB_JETTY_PORT
来使用不同于3000的端口。
如果您使用的是Metabase的Pro或企业版本,请确保激活您的许可证。
生产安装
步骤与上述步骤类似,但有两个重要的区别:如果您想在生产环境中运行Metabase,您将需要
- 使用生产应用程序数据库来存储您的Metabase应用程序数据。
- 以服务方式运行Metabase。
如果您想使用Docker,请查看在Docker上运行Metabase。
生产应用程序数据库
以下是我们支持的数据库列表。
例如,假设您想使用PostgreSQL。您需要启动一个PostgreSQL服务并创建一个空数据库
createdb metabaseappdb
您可以随意命名您的应用数据库。您不需要在该数据库中创建任何表;Metabase会为您完成。您只需要设置Metabase启动时使用的环境变量,以便Metabase知道如何连接到该数据库。
您将创建一个类似于本地安装步骤中列出的Metabase目录,但在运行启动JAR的java -jar
命令时,您需要在命令前添加一些环境变量,以告诉Metabase如何连接到您创建的metabaseappdb
。
export MB_DB_TYPE=postgres
export MB_DB_DBNAME=metabaseappdb
export MB_DB_PORT=5432
export MB_DB_USER=username
export MB_DB_PASS=password
export MB_DB_HOST=localhost
java -jar metabase.jar
上述命令将通过localhost:5432
,使用用户名username
和密码password
连接Metabase到您的Postgres数据库metabaseappdb
。如果您将Metabase作为服务运行,您需要将这些环境变量放入单独的配置文件中。
作为服务运行Metabase JAR
如果您需要在生产环境中运行JAR,您应该将Metabase作为服务运行。作为服务运行Metabase将
- 确保Metabase自动运行(并保持运行)。
- 允许您以无权限用户运行Metabase(这对安全性很有好处)。
如何作为服务运行Metabase的具体说明将根据您的操作系统而有所不同。有关如何设置Metabase为服务的示例,请查看在Debian上运行Metabase。
迁移到生产安装
如果您使用默认的H2应用程序数据库运行Metabase,并且您的团队已经创建了问题、仪表板、集合等,您希望将这些数据迁移到生产应用程序数据库。您应该尽快这样做。请参阅从H2数据库迁移。
故障排除
如果在安装过程中遇到任何问题,请查看我们的故障排除页面。
升级Metabase
查看升级Metabase。
设置Metabase
现在您已经安装了Metabase,是时候设置并连接到数据库了。
阅读其他Metabase版本的文档。