> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Admina Tracker のインストール（macOS）ソロセットアップ

> Admina Tracker を macOS にインストールする手順です。管理画面からインストーラーをダウンロードし、API キーを設定してデバイス情報の自動収集を開始します。

## 動作要件

| 項目      | 要件                            |
| ------- | ----------------------------- |
| OS      | macOS 10.15（Catalina）以降       |
| アーキテクチャ | Apple Silicon（M1 以降）または Intel |
| 権限      | インストール時に管理者パスワードが必要           |
| ネットワーク  | インターネット接続（データ送信用）             |

インストール先がシステムディレクトリ（`/usr/local/bin/`）であり、システムサービス（LaunchDaemon）を登録するため、macOS の管理者パスワードが必要です。アンインストール時にも管理者パスワードの入力を求められます。

## インストール手順

<h3 id="generate-api-key">
  ステップ 1: API キーを生成する
</h3>

Admina Tracker がデータを送信するには、組織ごとの API キーが必要です。

1. Admina の管理画面にログインします
2. **設定** > **Admina Tracker** タブを開きます
3. **API キー** セクションで **新しい API キーを生成する** をクリックします
4. 生成された API キーをコピーします

<Info>
  API キーは生成時にのみ表示されます。必ずコピーして安全な場所に保管してください。紛失した場合は **再生成** で新しいキーを発行できますが、既存のすべての Admina Tracker で更新が必要になります。
</Info>

同じ画面に表示される **Organization ID** もメモしておいてください。インストール時に入力します。

<h3 id="download-installer">
  ステップ 2: インストーラーをダウンロードする
</h3>

1. **設定** > **Admina Tracker** タブの **ダウンロード** セクションを開きます
2. お使いの Mac に合ったインストーラーをダウンロードします
   * macOS（Apple Silicon） — M1 / M2 / M3 / M4 チップ搭載の Mac
   * macOS（Intel） — Intel チップ搭載の Mac

<Info>
  お使いの Mac のチップを確認するには、画面左上の **Apple メニュー** > **この Mac について** を開きます。**チップ** に「Apple M1」などと表示されていれば Apple Silicon、**プロセッサ** に「Intel」と表示されていれば Intel です。
</Info>

<h3 id="install">
  ステップ 3: インストールする
</h3>

1. ダウンロードした DMG ファイルをダブルクリックして開きます
2. **Admina Tracker Installer** アプリケーションを起動します
3. インストール画面で以下を入力します
   * `API key` — ステップ 1 で生成した API キー
   * `Organization ID` — 管理画面に表示されている Organization ID
   * `User email`（任意） — 利用者のメールアドレス
4. **Install** をクリックします
5. macOS の管理者パスワードを入力して許可します
6. 「Installation complete」と表示されたら完了です

インストールが完了すると、Admina Tracker はバックグラウンドサービスとして自動的に起動します。

## 動作確認

ターミナルで以下のコマンドを実行して、Admina Tracker が正常に動作していることを確認できます。

```bash theme={null}
admina-tracker status
```

正常に動作している場合、エージェントのステータスと LaunchAgent の状態が表示されます。

## インストールされるリソース

Admina Tracker のインストールにより、以下のリソースがコンピューターに作成されます。

### プロセス

| プロセス                            | 説明                                 |
| ------------------------------- | ---------------------------------- |
| `admina-tracker daemon`         | デバイス情報の収集・送信を行うエージェント（LaunchAgent） |
| `admina-tracker-updater daemon` | 自動アップデートを管理するプロセス（LaunchDaemon）    |

### フォルダとファイル

| パス                                      | 内容                   |
| --------------------------------------- | -------------------- |
| `/usr/local/bin/admina-tracker`         | エージェント本体             |
| `/usr/local/bin/admina-tracker-updater` | アップデーター              |
| `~/.admina-tracker/`                    | データディレクトリ            |
| `~/.admina-tracker/agent.db`            | 収集データの SQLite データベース |
| `~/Library/Logs/AdminaTracker/`         | エージェントのログディレクトリ      |
| `/Library/Logs/AdminaTracker/`          | アップデーターのログディレクトリ     |

### LaunchAgent / LaunchDaemon

| plist                                                                  | ラベル                                       | 種別                        |
| ---------------------------------------------------------------------- | ----------------------------------------- | ------------------------- |
| `~/Library/LaunchAgents/com.moneyforward.admina.tracker.plist`         | `com.moneyforward.admina.tracker`         | LaunchAgent（ユーザーログイン時に起動） |
| `/Library/LaunchDaemons/com.moneyforward.admina.tracker.updater.plist` | `com.moneyforward.admina.tracker.updater` | LaunchDaemon（システム起動時に起動）  |

## アンインストール

Admina Tracker をアンインストールするには、インストール時に使用した DMG ファイルを再度使用します。

1. DMG ファイルをダブルクリックして開きます
2. **Admina Tracker Installer** を起動します
3. 既にインストール済みの場合、**Uninstall** ボタンが表示されます
4. **Uninstall** をクリックし、管理者パスワードを入力します
5. データとログの削除を選択します
   * Keep data and logs — データを残して再インストールに備える
   * Remove data and logs — データとログをすべて削除する

<Info>
  DMG ファイルを紛失した場合は、管理画面から再度ダウンロードできます。
</Info>

## 自動アップデート

Admina Tracker は自動アップデートに対応しています。新しいバージョンが利用可能になると、バックグラウンドで自動的に更新されます。手動でのアップデート作業は不要です。

## トラブルシューティング

### 「開発元が未確認」と表示される場合

macOS のセキュリティ設定により、インストーラーの初回起動時にこのメッセージを表示することがあります。**システム設定** > **プライバシーとセキュリティ** を開き、「このまま開く」を選択してください。

### API キーのエラーが表示される

| エラーメッセージ                   | 原因               | 対処法                       |
| -------------------------- | ---------------- | ------------------------- |
| api\_key is not configured | API キーが設定されていない  | インストーラーで API キーを再入力してください |
| Invalid API key (401)      | API キーが無効または期限切れ | 管理画面で API キーを再生成してください    |

### Admina Tracker が停止している

Admina Tracker は macOS の launchd によって自動起動されます。

* エージェント本体は LaunchAgent としてユーザーログイン時に自動起動します。sudo は不要です
* アップデーターは LaunchDaemon としてシステム起動時に自動起動します

Mac を再起動した場合やログアウト・ログインした場合も、ユーザーがログインすると自動的に開始されます。

手動で再起動する場合は、ターミナルで以下のコマンドを実行してください。

```bash theme={null}
admina-tracker restart
```

### サポートからログの取得を依頼されたら

Admina Tracker のログは以下のディレクトリに保存されています。サポートから依頼があった場合は、該当するログファイルを送付してください。

| 種別         | パス                              |
| ---------- | ------------------------------- |
| エージェントのログ  | `~/Library/Logs/AdminaTracker/` |
| アップデーターのログ | `/Library/Logs/AdminaTracker/`  |