{"id":25257258,"url":"https://github.com/zowe/explorer-ip","last_synced_at":"2025-10-27T02:31:48.604Z","repository":{"id":43316312,"uuid":"353812176","full_name":"zowe/explorer-ip","owner":"zowe","description":null,"archived":false,"fork":false,"pushed_at":"2024-08-29T11:46:03.000Z","size":682,"stargazers_count":1,"open_issues_count":2,"forks_count":4,"subscribers_count":13,"default_branch":"v2.x/master","last_synced_at":"2024-08-29T13:01:46.303Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zowe.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-01T19:57:45.000Z","updated_at":"2022-12-14T23:38:20.000Z","dependencies_parsed_at":"2024-04-10T19:29:01.662Z","dependency_job_id":"0a8d7860-5bae-4140-9654-5fad5d1af78f","html_url":"https://github.com/zowe/explorer-ip","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-ip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-ip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-ip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zowe%2Fexplorer-ip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zowe","download_url":"https://codeload.github.com/zowe/explorer-ip/tar.gz/refs/heads/v2.x/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238423951,"owners_count":19469947,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-12T06:38:29.146Z","updated_at":"2025-10-27T02:31:43.258Z","avatar_url":"https://github.com/zowe.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"This program and the accompanying materials are\nmade available under the terms of the Eclipse Public License v2.0 which accompanies\nthis distribution, and is available at https://www.eclipse.org/legal/epl-v20.html\n\nSPDX-License-Identifier: EPL-2.0\n\nCopyright Contributors to the Zowe Project.\n# explorer-ip\nThe Zowe Desktop application to monitor TCP/IP stack using the EZBNMIFR network management interface\n\n## Installation:\n### Building web content (webClient)\nThe webClient can be built on z/OS platform as well as off z/OS. \n\n**Note:** If you decide to build the webClient off z/OS then you should move the built content (content of the `web/` directory) to the z/OS anyway. Make sure you transfer the built artifacts to the z/OS as ASCII files and tag them as ASCII files in z/OS USS after they are transferred. An example how to tag the files: `chtag -Rtc ISO8859-1 /path/to/app-dir/web`  \n\n1. Clone zlux repository:\n    1. `git clone --recursive git@github.com:zowe/zlux.git`\n    2. `cd zlux`\n    3. `git submodule foreach \"git checkout master\"`\n\n2. Navigate to the `zlux-app-manager/virtual-desktop` directory and run `npm install` in the directory. If `npm install` fails then expand the following Hint block which contains information about how to possibly resolve the `npm install` failure.\n   \u003cdetails\u003e\u003csummary\u003eHint\u003c/summary\u003e\n    \n    1. If you get the following failure:\n        ```bash\n        npm ERR! Error while executing:\n        npm ERR! /C/Rocket/bin/git ls-remote -h -t https://github.com/zowe/zlux-widgets.git\n        npm ERR!\n        npm ERR! fatal: unable to access 'https://github.com/zowe/zlux-widgets.git/': SSL certificate problem: unable to get local issuer certificate\n        npm ERR!\n        npm ERR! exited with error code: 128      \n        ```\n        then it could mean that your local git is not properly configured to access github via **https**. Either configure your local git to access github using **https** or if you use **ssl** to access github then you can try to modify the `zlux-app-manager/virtual-desktop/package.json` file so that you change `git+https://github.com/zowe/zlux-widgets.git` to `git+git@github.com:zowe/zlux-widgets.git` in the line [here](https://github.com/zowe/zlux-app-manager/blob/1556eeac4ef844022bb60fa4dc2d75f2d09091a0/virtual-desktop/package.json#L32). \n    2. After configuring **https** or changing the package.json, please run the `npm install` again.\n    3. If it's installed sucessfully, you should see a message like:\n        ```\n        added 827 packages from 391 contributors and audited 833 packages in 54.331s\n        ```\n   \u003c/details\u003e\n3. Navigate back to the `zlux` root directory, e.g. using `cd ../..` command.\n4. Clone the IP explorer app repository `git clone ...`\n5. Navigate to the `webClient` part of the IP explorer app repository (`cd app-dir/webClient`) and run `npm install`.\n6. set and export the `MVD_DESKTOP_DIR` variable to point to the `zlux/zlux-app-manager/virtual-desktop/`:\n   ```\n   export MVD_DESKTOP_DIR=/your/path/to/zlux/zlux-app-manager/virtual-desktop/\n   ```\n7. Run `npm run build`. If successful, you should see some content in the `app-dir/web` directory. \n\n### Building dataService\nThe dataService has to built on z/OS platform.\n1. Go to the plugin's `/dataService` directory.\n2. In the `build/` directory, git clone https://github.com/zowe/zss/ OR create a symbolic link to already existing zss repository, e.g. using `ln -s /path/to/existing/zss build/zss`.\n3. Run the `build/build.sh` script. The build should succeed and create a `/lib` folder in the git root directory, which contains a compiled dll (.so).\n\n### File Structure Example\ninstall-dir\n  - dataService\n    - build\n      - build.sh\n      - pluginAPI.x\n      - tmp\n      - zss\n    - deploy.sh\n    - src\n      - ipExplorerDataService.c\n  - lib\n    - ipExplorer.so\n  - pluginDefinition.json\n  - web\n    - assets\n    - main.js\n  - webClient\n  - ...\n\n### Installing the plugin\nRun `\u003cyour-zowe-instance\u003e/bin/install-app.sh \u003cpath-to-plugin\u003e`.\n\nWhere `\u003cpath-to-plugin\u003e` is directory with `web/`, `lib/` and `pluginDefinition.json` files\n\n## Installing using pax\nIts recommended to install all your extensions in same folder. \nIf you have defined `ZWE_EXTENSION_DIR` in `instance.env`, specifying target directory via `-d` option is optional\n```\ncd $RUNTIME_DIR/bin\nzowe-install-component.sh -i $INSTANCE_DIR -o /path/to/explorer-ip.pax -d /var/zowe/extensions\n```\n\nYou will need to **restart zowe** for `ipExplorer.so` dataservice dll to load alongwith `zssServer` on startup.\n\nMore info, about [installing extension here](https://docs.zowe.org/stable/extend/install-configure-zos-extensions.html#install-with-zowe-install-component-sh-technical-preview)\n\n## Troubleshooting\nTo turn on logging, add the following snippet into your zluxserver.json file:\n\n```\n\"logLevels\": {\n   \"org.zowe.explorer-ip\": 4\n}\n```\n\nThe number after the plugin identifier represents the level of logging. This is read into the server at startup.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzowe%2Fexplorer-ip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzowe%2Fexplorer-ip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzowe%2Fexplorer-ip/lists"}