メインコンテンツまでスキップ

インストール及び起動

2.1. インストール方法​

1. パッケージダウンロード​

2. システム環境変数設定​

  1. 必須環境変数
    • EXEM_DOTNET_PATH=exemフォルダまでのパス設定 ex)C:\workspace\package\exem
    • EXEM_DOTNET_PROFILE_TARGET_PROCESS=Exem.DotNet.Profilerがターゲットとするプロセス設定 ex)w3wp.exe
  2. 選択環境変数
    • EXEM_DOTNET_DEBUG=Exem.DotNet.Profilerのデバッグログオプション ex)true
    • EXEM_DOTNET_DEBUG2=Exem.DotNet.Agentのデバッグログオプション (Agent Id発行以前までのロギング) ex)true

3. ランタイムライブラリ追加及びDotNetエージェントインストール​

  1. 最新のVisual C++再配布可能パッケージのインストール=tools/Visual Studio 2017 C++ Redistributableフォルダ内のプロセッサに合ったアーキテクチャをインストール
  2. Exem.DotNet.Profilerをレジストリ命令コンポーネントとして登録=tools/dll_regsvr/DLL_Install.batファイルを管理者権限で実行
  3. Exem.DotNet.Agent GAC登録=tools/Assembly/assembly_regist.batファイルを管理者権限で実行 (x86の場合はassembly_regist_x86.batを実行)
  4. exem-dotnet-agentサービス登録=tools/profile_for_service_start.batファイルを管理者権限で実行

3-1. 3.0.3パッケージ以降にインストール可能な方法 (システム環境変数設定及びインストールの簡素化)​

  1. 最新のVisual C++再配布可能パッケージのインストール=tools/Visual Studio 2017 C++ Redistributableフォルダ内のプロセッサに合ったアーキテクチャをインストール
  2. netfw_agent_install.batバッチファイルを管理者権限で実行

4. ゲートウェイアドレス設定​

  • config/net.confファイルのDG_ADDRオプションにIP:port設定

2.2 削除方法​

1. 削除前の確認事項​

  • 管理者権限のコマンドプロンプトまたはバッチ実行権限が必要です。
  • 対象サービスまたはIIS worker processが動作中の場合、削除直後の再起動要否を確認します。
  • パッケージパスが維持された状態で削除するのが安全です。削除バッチはEXEM_DOTNETFW_HOMEまたはシステムレジストリの同一値を参照します。

2. 推奨削除方法​

  • tools/netfw_agent_uninstall.batを管理者権限で実行

このバッチは以下の作業を順番に実行します。

  • Exem.DotNetFw.Service.exe --standalone-stop呼び出し
  • GAC登録されたアセンブリの削除
  • profiler DLLのCOM登録解除
  • システム環境変数の削除

削除対象の環境変数:

  • EXEM_DOTNETFW_HOME
  • EXEM_DOTNETFW_DEBUG
  • EXEM_DOTNETFW_DEBUG2
  • EXEM_DOTNET_PROFILE_TARGET_PROCESS
  • EXEM_DOTNET_RETRY_COUNT

3. 手動削除方法​

3-1. エージェントサービス停止​

  • tools/profile_for_service_stop.batを管理者権限で実行

このスクリプトは以下のコマンドを呼び出します。

  • binary/Exem.DotNetFw.Service.exe --standalone-stop

3-2. GAC登録アセンブリの削除​

  • x64: tools/Assembly/assembly_remove.bat
  • x86: tools/Assembly/assembly_remove_x86.bat

削除対象:

  • Exem.DotNetFw.Agent
  • log4net
  • System.Buffers
  • System.Runtime.CompilerServices.Unsafe
  • System.Memory
  • Google.Protobuf

3-3. profiler DLL登録解除​

  • tools/dll_regsvr/DLL_Remove.batを管理者権限で実行

内部的には以下のように動作します。

  • tools/dll_regsvr/DLL_Regsvr.bat -u
  • Exem.DotNetFw.Profiler.x86.dll、Exem.DotNetFw.Profiler.x64.dllの登録解除

3-4. システム環境変数の削除​

以下のシステム環境変数を削除します。

  • EXEM_DOTNETFW_HOME
  • EXEM_DOTNETFW_DEBUG
  • EXEM_DOTNETFW_DEBUG2
  • EXEM_DOTNET_PROFILE_TARGET_PROCESS
  • EXEM_DOTNET_RETRY_COUNT

例:

reg delete "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\Environment" /v EXEM_DOTNETFW_HOME /f
reg delete "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\Environment" /v EXEM_DOTNETFW_DEBUG /f
reg delete "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\Environment" /v EXEM_DOTNETFW_DEBUG2 /f
reg delete "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\Environment" /v EXEM_DOTNET_PROFILE_TARGET_PROCESS /f
reg delete "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\Environment" /v EXEM_DOTNET_RETRY_COUNT /f