app2container remote inventory command - AWS App2Container
SyntaxParameters and optionsOutputExamples

app2container remote inventory command

Run this command from a worker machine to retrieve an inventory of all Java or .Net processes (Linux) or all IIS websites and Windows services (Windows) that are running 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 --type [iis | service | java | dotnet] [--nofilter] [--help]

Parameters and options

Parameters
--target IP/FQDN

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

--type [iis | service | java | dotnet]

Use this parameter to specify the application type (required), as follows.

  • For .NET applications running on Windows, you can specify an IIS web application (iis), or a Windows service (service).

  • For Java applications running on Linux, you must specify java.

  • For .NET applications running on Linux, you must specify dotnet.

Options
--nofilter

For applications running on Windows, this option prevents App2Container from filtering out default system services when building the inventory output. This can be used for complex Windows .NET applications that have dependent web apps that need to be included in the container.

--help

Displays the command help.

Output

Information about the Java processes, .NET applications, or IIS websites is saved to inventory.jsonfile 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 platform for your application in the Examples section to see the differences.

Examples

Expand the section that matches the operating system platform for the worker machine where you run the command.

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

Java

The following example shows the remote inventory command with results for Java processes running on Linux, with no additional options.

$ 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

Sample inventory data:

{
    "java-jboss-5bbe0bec": {
        "processId": 27366,
        "cmdline": "java ...",
        "applicationType": "java-jboss"
    },
    "java-tomcat-9e8e4799": {
        "processId": 2537,
        "cmdline": "/usr/bin/java ...",
        "applicationType": "java-tomcat"
    }
}
ASP.NET

The following example shows the remote inventory command with results for .NET applications running on Linux, with no additional options.

$ 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

Sample inventory data:

{
    "dotnet-single-c2930d3132": {
        processId": 1,
        "cmdline": "./MyCoreWebApp.3.1 ...",
        "applicationType": "dotnet-single",
        "webApp": ""
	},
	"dotnet-generic-a27b2829": {
        processId": 2,
        "cmdline": "./MyCoreWebApp.3.1 ...",
        "applicationType": "dotnet-generic",
        "webApp": ""
	}
}

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 results for .NET applications running in IIS on Windows, with no additional options.

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

Sample inventory data:

{
    "iis-smarts-51d2dbf8": {
        "siteName": "Default Web Site",
        "bindings": "http/*:80:,net.tcp/808:*",
        "applicationType": "iis",
        "discoveredWebApps": []
    },
    "iis-smart-544e2d61": {
        "siteName": "smart",
        "bindings": "http/*:82:", 
        "applicationType": "iis",
        "discoveredWebApps": []       
    },
    "service-colorwindowsservice-69f90194": {
                "serviceName": "colorwindowsservice",
                "applicationType": "service"
	}
}