バージョン 2.0.2 以降、Ticketix はライセンスを使って ARN から更新を取得します。お知らせ 画面には、インストール済みのバージョンが 現在のバージョン に表示され、利用可能な更新も表示されます。サーバーが ARN に接続できない場合などは、公式の更新パッケージ(更新用 ZIP)を使って手動で更新することもできます。
場所: セットアップ → システム → お知らせ(管理者のみ)。各管理ページ上部のバージョン表示からも開けます。
お知らせ画面から更新する
Ticketix は 12 時間ごとに ARN に更新を問い合わせます。問い合わせは、スケジュールタスクの実行時、または管理者が管理エリアを開いたときに行われます。お知らせ 画面で 更新を確認 をクリックすることもできます。
- 更新が利用可能な場合、上部バーに 更新 と新しいバージョンが表示されます。お知らせ には 最新バージョン、パッケージサイズ、リリースノート、更新の種類(必須(自動でインストール) または 任意(管理者を待機))が表示されます。
- 必須の更新は自動でインストールされます。それ以外の更新は、管理者が バージョン … をインストール をクリックして確定するまで待機します。
- 更新をインストールできるのは管理者のみです。
更新中に行われる処理:
- Ticketix は HTTPS で ARN からパッケージをダウンロードし、ARN の署名、チェックサム、サイズを確認します。何かを変更する前に、パッケージ全体を確認します。Ticketix 2.3.0 以降、ARN Smart の発行元署名を含むバージョンは、その署名がパッケージと一致する場合にのみインストールされます。一致しない場合、更新は「The publisher signature of Ticketix … does not match the package」というメッセージで拒否されます。
- データベースと変更されるファイルを
storage/updatesにバックアップします。 - 新しいファイルを書き込みます。約 1 分間、他のページには短いメンテナンスメッセージが表示されます。
- 次に開いたページで、新しいバージョンのデータベースアップグレードが実行されます。
- アップグレードに失敗した場合、Ticketix は以前のファイルとデータベースを元に戻し、お知らせ に理由を表示します。成功した場合、お知らせ に「Updated from 2.1.3 to 2.1.4 on …」のような行が表示されます。データベースのバックアップは削除されます。以前のバージョンのファイルは次の更新まで
storage/updatesに残り、お知らせ の 以前のバージョンのファイル に表示されます。
config.php、config.local.php、storage フォルダー、.htaccess、setup.php が変更されることはありません。新しいバージョンで使われなくなったファイルも、更新によって削除されることはありません。
重要: 更新が成功した後、Ticketix はデータベースのバックアップを保持しません。データベース、
config.php、storageフォルダー(storage/ai-secret.keyを含む)のバックアップを、ご自身で定期的に取得してください。
ARN からの更新には、PHP の ZIP 拡張と cURL 拡張、licence.arnsmart.com への HTTPS アクセス、およびアプリケーションフォルダーと storage への PHP の書き込み権限が必要です。拡張機能が不足している場合や PHP がフォルダーに書き込めない場合は、お知らせ に警告が表示されます。解決するまでは手動で更新してください。また、スケジュールタスクが 1 日実行されていない場合にも警告が表示されます。スケジュールタスクがないと、Ticketix は管理者が管理エリアを開いたときにしか更新を確認せず、必須の更新もインストールしません。スケジュールタスク(cron)を設定するをご覧ください。
2.0.2、2.1.0、2.1.1 から更新する場合
バージョン 2.0.2、2.1.0、2.1.1 の お知らせ 画面は、チケット API の api フォルダーを含むパッケージを、何も書き込む前に「The update package contains a file that is not allowed: api/ticket-create.php」というメッセージで拒否します。このようなインストールは、現在のバージョンの更新用 ZIP を使って一度だけ手動で更新してください(下記参照)。2.1.2 以降は、以後のバージョンを再び お知らせ 画面からインストールできます。
手動で更新する
サーバーが ARN に接続できない場合、および 2.0.2、2.1.0、2.1.1 からの更新時に一度だけ、更新用 ZIP を使用します。
始める前に
- ARN アカウントから新しいバージョンの更新用 ZIP をダウンロードし、その
README.mdをお読みください。 - インストール用 ZIP ではなく、更新用 ZIP を使用してください。更新用 ZIP には
config.php、storageフォルダー、顧客データは含まれていません。 - サーバーが引き続き動作要件を満たしていることを確認してください: PHP 8.3 以降、および PDO、mbstring、OpenSSL、cURL、ZIP、fileinfo、Sodium の各拡張機能。
- ライセンスの再有効化が必要になった場合に備えて、この製品とドメイン用の ARNA アクティベーションコードを請求できるようにしておいてください。
- チームに知らせておきましょう。以前のバージョンから Ticketix 2.0.1 以降に更新すると、すべての管理者とエージェントは次回のサインイン時に二要素認証の設定を求められます。
まずバックアップする
完全なバックアップを作成し、サーバー外に保存してください。
- アプリケーションファイル
- データベース(SQLite の場合は
storageフォルダー内のデータベースファイル) config.php(存在する場合はconfig.local.phpも)storageフォルダー全体
重要:
storage/ai-secret.keyはstorageのバックアップと一緒に保管してください。このファイルは、保存された AI プロバイダーのキーと二要素認証の認証アプリのシークレットを暗号化します。このファイルがないと、AI キーを再入力する必要があり、認証アプリのコードやバックアップコードも使えなくなります。
更新を適用する
- スケジュールタスクを停止し、可能であればサイトへの書き込みトラフィックも止めてください(例: Web サーバーでメンテナンスページを表示する)。
- 更新用 ZIP を既存のアプリケーションフォルダーに上書きで展開します。ZIP によってファイルが削除されることはありません。Ticketix 2.0.2 以降、ZIP には
setup.phpが含まれていません。データベースのアップグレードには不要です。 config.php、config.local.php、storageフォルダー、.env、サーバー固有のアクセスルールは削除・変更しないでください。- アップデートZIPは
.htaccessを変更しません。Apacheでは、既存のルールで設定ファイルおよびcore、scripts、lang、storageフォルダーへのアクセスが引き続き拒否されていることを確認してください。Nginxでは同等のルールを維持し、apiフォルダーでのPHP実行を許可してください。 - 管理画面を開きます。最初のリクエストで、ロックのもと一度だけのデータベースアップグレードが実行されます。その他のリクエストは完了を待ちます。
- Ticketixから求められた場合は、ライセンス画面でライセンスの有効化を完了してください。
- 管理者のサインイン、既存のチケット、設定、メール接続を確認してください。
- スケジュールタスクとトラフィックを元に戻します。
2.0.0より前のバージョンからのアップデート
インストール先の公開アドレス(サブフォルダーを含む)を、末尾のスラッシュなしでconfig.phpに追加してください。
'app_url' => 'https://support.example.com/ticketix',
これがないと、スケジュールタスクが送信するメール(キューに入った返信や、受信メールから作成されたチケットの確認メールなど)にはパスしか含まれず、メールクライアントから開けません。新規インストールでは、セットアップ時にapp_urlが設定されます。
更新に失敗した場合
古いアプリケーションファイル、設定ファイル、storageフォルダー、データベースのバックアップをまとめて復元してください。古いコードだけを復元しても十分ではありません。
SQLite から MySQL へ移行する
Ticketix 2.3.1 以降、新規インストールでは MySQL を使用します。SQLite で稼働しているインストールはアップデート後も引き続き動作し、データが MySQL に移行されるまで、すべての管理ページに「このサイトはまだ SQLite で稼働しています」と MySQL へ移行 が表示されます。
- 空の MySQL データベース(
utf8mb4)と、そのデータベースに対するすべての権限を持つユーザーを作成します。Ticketix は、すでに Ticketix のテーブルを含むデータベースを受け付けず、上書きすることもありません。 - 管理者として MySQL へ移行 をクリックします。データベース 画面でホスト、ポート、データベース名、ユーザー、パスワードを入力し、MySQL へ移行 をクリックします。大規模なインストールでは数分かかる場合があります。結果は再読み込み後も画面に表示されたままです。
- データのコピー中もサイトは閲覧できますが、新しいチケット、返信、設定などの変更は拒否され、1 分後に再試行するよう求められます。また、スケジュールタスクはその回の実行をスキップします。
- コピーを始める前に、すべての値が対応する MySQL の列と照合されます。列より長いテキスト、列に収まらない数値、または MySQL が同一とみなす 2 つの値(大文字と小文字を区別しないため)があると移行は停止し、修正が必要なテーブル、列、行が画面に一覧表示されます。値が切り詰められることはありません。無効な UTF-8 文字は置き換えられ、一覧に表示されます。
- すべてのテーブルが ID ごとコピーされ、比較されます。すべてのテーブルが一致した場合にのみ、Ticketix は新しいデータベース情報を
config.phpに書き込み、MySQL の使用を開始します。以前のファイルはstorage/backups/config-before-mysql-….phpとして保存されます。失敗や不一致があった場合、サイトは SQLite で稼働し続けます。 - SQLite ファイル(
config.phpで別のファイルが指定されていない限りstorage/support.db)は変更も削除もされません。バックアップとして保管してください。その後、管理者のサインイン、いくつかのチケットとその添付ファイル、ナレッジベースを確認してください。
SQLite に戻すには、以前の config.php を元に戻し、storage/database-move.json を削除します。移行後に行った変更は MySQL にのみ存在します。
更新後
- お知らせを開き、現在のバージョンを確認します。
- まだ設定していない管理者とエージェントは全員、次回のサインイン時に2段階認証を設定します。2段階認証とパスワードのリセットをご覧ください。
- AIを使用している場合は、AI設定を開いて各接続をテストし、各タスクのモデルを確認してください。AIの接続とAI制限の設定をご覧ください。
- 以前のバージョンから2.0.2以降にアップデートした後:各ロゴは個別のファイルに保存されます。ポータルまたは管理画面のロゴに別のロゴが表示される場合は、セットアップ → ポータル → 一般で再度アップロードしてください。
2.0.2から2.1以降にアップデートした後
- 管理メニューは実績、コンテンツ、インサイト、セットアップのグループに移動します。エクスポートとお知らせはセットアップ → システムにあり、プロフィールは右上のユーザーメニューにあります。ご自身で追加したメニューリンクはそのまま残ります。
- ゲストによる新しいコミュニティトピックと返信は、すぐに表示されず、コンテンツ → コミュニティのモデレーションキューで承認待ちになります。ゲストに閲覧のみを許可する場合は、セットアップ → ポータル → 一般でサインイン必須を選択してください。アップデート前の投稿はそのまま残ります。
- 以前に編集した「ゲストチケット確認」テンプレートでは
{{verify_link}}が維持されます。チケットを直接開く新しいリンクを使うには{{ticket_link}}を追加してください。メールテンプレートとチケットクローズメールをご覧ください。 - 2.1で使用されなくなった旧バージョンのファイルはサーバーに残りますが、害はありません。削除したい場合は、アップデートZIPの
README.mdに一覧が記載されています。 - 2.1.4より前にメールから作成されたチケットは、チャネルポータルと保存済みのテキストを保持します。2.1.3より前にメールから作成された顧客は、保存時の名前を保持します。名前は顧客ページで変更してください。
2.2.0にアップデートした後
- AI返信の下書きは、チケットの商品の最上位カテゴリーのアドレスが商品キーと一致する場合、その商品のナレッジベース記事を使用します。コンテンツ → ナレッジベースのカテゴリータブで商品カテゴリーのアドレスを確認してください。キーはセットアップ → サポート → 商品に一覧表示されています。チケットでAIアシスタントとトリアージを使うをご覧ください。
2.2.1または2.3.0にアップデートした後
- 変更は不要です。2.2.1と2.3.0はデータも設定も変更しません。2.3.0では、上記の発行元署名チェックが追加されます。
- 2.2.1以降、スタッフ向けの全体検索は検索ウィンドウのすべての結果から、また管理者はセットアップ → ポータル → 検索から開けます。チケット一覧にはエクスポートボタンがあり、チケットのチャネルはインターフェースの言語で表示されます。ポータル検索とスタッフ検索およびチケットの作成・整理・クローズをご覧ください。
2.3.1 へのアップデート後
- バージョン 2.1.2 から 2.3.0 は、お知らせ 画面から 2.3.1 をインストールします。
- SQLite で稼働しているインストールは、上記の「SQLite から MySQL へ移行する」の説明に従ってデータを MySQL に移行します。
- データベースのアップグレードにより、すべての記事、コミュニティトピック、検索エントリに言語が設定され、検索インデックスが一度再構築されるため、アラビア文字、キリル文字、その他の非ラテン文字のテキストも検索できるようになります。それ以降は、スケジュールタスクが新規および変更された記事、トピック、返信を検索インデックスに書き込みます。スケジュールタスクは常に実行しておいてください。
- 既存の記事とトピックには、サイトの デフォルト言語 が設定されます。記事が英語なのにデフォルト言語がトルコ語やアラビア語になっている場合は、記事一覧でそれらを選択し、言語を変更 を使用してください。
- ポータルは日本語とドイツ語でも表示できます。2.3.2 以降、ほとんどのサイトではアップデートによりこれらが有効になります。下記の「2.3.2 へのアップデート後」をご覧ください。
- 顧客のメッセージや送信済みの返信を削除できるのは管理者のみで、エージェントが削除できるのは自分の内部メモだけです。チケットへの返信、メモの追加、共同作業をご覧ください。
- 返信メールがチケットに追加されるのは、チケットの所有者または同じ顧客の連絡先から送信された場合か、件名にチケットの
[ARN:…]参照が残っている場合のみです。同僚が参照なしで別のアドレスから返信すると、新しいチケットが作成されます。メールからのチケット作成、メールボックス、メールセンターをご覧ください。
2.3.2 へのアップデート後
- バージョン 2.1.2~2.3.1 では、お知らせ 画面から 2.3.2 をインストールします。設定を変更する必要はありません。
- ポータル上部の言語リンクは、1つの言語メニュー(🌐 と現在の言語)になります。言語と翻訳コンテンツをご覧ください。
- サイトで保存済みの Portal languages が英語、トルコ語、アラビア語だった場合、アップデートにより日本語と Deutsch が一度だけ追加されます。この3言語のいずれかが非表示だった場合、リストはそのまま維持され、ページを保存するまで セットアップ → Portal → 一般 に「New visitor languages are available」と表示されます。必要に応じてそこで言語を有効にしてください。後から削除した言語は削除されたままになります。