app2container remote inventory command - AWS App2Container

app2container remote inventory command

Run this command from a worker machine to retrieve an inventory of all running Java processes (Linux) or all IIS websites (Windows) on the application server specified in the --target parameter. The target application server is specified by its IP address or Fully Qualified Domain Name (FQDN). The inventory details are captured in the inventory.json file and stored on the worker machine under the target server folder.

Syntax

app2container remote inventory --target IP/FQDN [--help]

Parameters and options

Parameters

--target IP/FQDN

Specifies the IP address or FQDN of the application server targeted for the inventory (required).

Options

--help

Displays the command help.

Output

Information about the Java processes or IIS websites is saved to the inventory.json file in one of the following locations:

  • Linux: <workspace>/remote/<target server IP or FQDN>/inventory.json

  • Windows: <workspace>\remote\<target server IP or FQDN>\.app2container-config\inventory.json

The application ID that is used by other App2Container commands is the key for each application object in the JSON file. The application objects are slightly different depending on your application language and the application server operating system. Choose the operating system tab for your application in the Examples section below to see the differences.

Examples

Choose the operating system tab for the application server or worker machine where you run the command.

Linux

Each Java process has a unique application ID (for example, java-tomcat-9e8e4799). You can use this application ID with other AWS App2Container commands. Inventory information is saved to /root/inventory.json.

The following example shows the remote inventory command with the --target parameter.

$ sudo app2container remote inventory --target IP/FQDN : Retrieving inventory from remote server 192.0.2.0 √ Server inventory has been stored under <workspace>/remote/<target server IP or FQDN>/inventory.json ��Remote inventory retrieved successfully
Windows

Each IIS website has a unique application ID (for example, iis-smarts-51d2dbf8). You can use this application ID with other AWS App2Container commands. Inventory information is saved to C:\Users\Administrator\AppData\Local\.app2container-config\inventory.json.

The following example shows the remote inventory command with the --target parameter.

PS> app2container remote inventory --target IP/FQDN : Retrieving inventory from remote server 192.0.2.0 √ Server inventory has been stored under <workspace>\remote\<target server IP or FQDN>\inventory.json ��Remote inventory retrieved successfully