4.0.0/ipsmgw-sdk/installing-the-sdk

user@machine:~$ $JAVA_HOME/bin/java -version
openjdk version "11.0.6" 2020-01-14 LTS
OpenJDK Runtime Environment 18.9 (build 11.0.6+10-LTS)
OpenJDK 64-Bit Server VM 18.9 (build 11.0.6+10-LTS, mixed mode, sharing)
1	Ensure that Ant version 1.10.5 or later is in your `PATH` environment variable. To verify type ant -version
2	Within the SDK, run `sdkadm` in interactive mode. This can be done through using `ant sdkadm` from the command line, or running the `sdkadm` command from within the `build/bin` directory.
3	Type `help` within `sdkadm` to view available commands.
4	Use the `list-modules` command to view modules available in the repository for you to use. For details on `list-modules`, type `help list-modules`.
5	Next create a deployment module, which will let you install Sentinel IP-SM-GW components into Rhino. To view the available service deployment modules, use the `list-modules +service-deploy` command, which gets you something like this: > list-modules +service-deploy Listing modules based on module tags. Modules matching all of the following tags will be listed: service-deploy opencloud#ipsmgw-full-deploy#sentinel-ipsmgw/4.0.0;4.0.0.0 opencloud#ipsmgw-mapra-deploy#sentinel-ipsmgw/4.0.0;4.0.0.0 opencloud#sentinel-registrar-full-deploy#sentinel-registrar/4.0.0;4.0.0.0 opencloud#sentinel-registrar-test-full-deploy#sentinel-registrar/4.0.0;4.0.0.0 opencloud#sentinel-sip-full-deploy#sentinel-sip/4.0.0;4.0.0.0 opencloud#sentinel-sip-modules-deploy#sentinel-sip/4.0.0;4.0.0.0 opencloud#sentinel-sip-test-full-deploy#sentinel-sip/4.0.0;4.0.0.0 7 modules matched search criteria out of a total possible 483. Pagination was set to display unlimited results per page. Specify a pagination entry count as an argument (e.g. '10') to pause output during display. Specify '-tag' arguments to narrow results by excluding modules matching one or more -tags. Specify '-v' or '--verbose' to enable display all module details including descriptions. Specify '--show-all-versions' to list modules for all versions instead of only the latest version. As can be seen, there is one Sentinel IPSMGW service-deployment module suitable for installation.
6	Now create a deployment module for the service, using the `create-deployment-module` command with the following arguments (the output from this command is quite long and has been edited for brevity here): > create-deployment-module deploy-ipsmgw deploy-ipsmgw opencloud#ipsmgw-full-deploy#sentinel-ipsmgw/4.0.0;4.0.0.0 The following dependencies will be included in the new module: opencloud#ipsmgw-full-deploy#sentinel-ipsmgw/4.0.0;4.0.0.0 Creating deployment module 'deploy-ipsmgw' in directory 'deploy-ipsmgw'. downloading https://repo.opencloud.com/artifactory/opencloud-internal-snapshots/opencloud/sentinel-core/4.0.0/deployment-template/4.0.0.0/deployment-template-module-pack-4.0.0.0.zip ... .. (2kB) .. (0kB) [SUCCESSFUL ] opencloud#deployment-template#sentinel-core/4.0.0;4.0.0.0!deployment-template-module-pack.zip(module-pack) (236ms) Populating '/home/testuser/ipsmgw-sdk/deploy-ipsmgw/config' with configuration artifacts. downloading https://repo.opencloud.com/artifactory/opencloud-internal-snapshots/opencloud/sentinel-ipsmgw/4.0.0/ipsmgw-determine-network-operator-profile/4.0.0.0/ipsmgw-determine-network-operator-profile-config-4.0.0.0.zip ... .. (0kB) .. (0kB) [SUCCESSFUL ] opencloud#ipsmgw-determine-network-operator-profile#sentinel-ipsmgw/4.0.0;4.0.0.0!ipsmgw-determine-network-operator-profile-config.zip(config) (145ms) ... edited for brevity ... downloading https://repo.opencloud.com/artifactory/opencloud-internal-snapshots/opencloud/sentinel-ipsmgw/4.0.0/ipsmgw-full-deploy/4.0.0.0/ipsmgw-full-deploy-config-4.0.0.0.properties ... .. (0kB) .. (0kB) [SUCCESSFUL ] opencloud#ipsmgw-full-deploy#sentinel-ipsmgw/4.0.0;4.0.0.0!ipsmgw-full-deploy-config.properties (148ms) [warn] Default value for configuration property 'cdr.maxinterval' is being changed from '6000000' to '600000'. Please review. [warn] Default value for configuration property 'cdr.maxlines' is being changed from '1000' to '0'. Please review. [warn] Default value for configuration property 'cdr.maxsize' is being changed from '0' to '10000000'. Please review. Finished writing deployment module to: /home/testuser/ipsmgw-sdk/deploy-ipsmgw The purpose of deployment modules is to be able to install a complete product in one go, and creating one is therefore typically one of the first things to do in an SDK. For more information about deployment modules see Modules. Custom features can also be added to deployment modules, see Creating a Feature.
7	Now that the deployment module has been created successfully, you can use the `list-sdk-modules` command to view the modules inside your SDK: > list-sdk-modules Searching for modules in: /home/testuser/ipsmgw-sdk Found 1 module: deploy-ipsmgw The new module `ipsmgw-deploy` should show up in the output.
8	Exit the sdkadm program: type `quit`, and press Enter. The file system will have a new directory called `ipsmgw-deploy`. This contains the deployment module. Here’s what it includes: $ cd deploy-ipsmgw/ /deploy-ipsmgw$ ls build.xml config doc ivy.xml module.properties
9	Look at the contents of each of the files and directories, to 'get a feel' for what is included in a deployment module.
10	Make sure that you are in the `ipsmgw-deploy` module. Type `ant clean publish-local` to build the module. The output should look like this: $ ant clean publish-local Buildfile: /home/testuser/ipsmgw-sdk/build.xml ... edited for brevity ... init-ivy-common: [echo] Ivy Resolvers: /home/testuser/ipsmgw-sdk/build/ivy/resolvers-remote.xml [echo] Configuring Ivy with settings: /home/testuser/ipsmgw-sdk/build/ivy/ivysettings.xml [ivy:resolve] :: loading settings :: file = /home/testuser/ipsmgw-sdk/build/ivy/ivysettings.xml [echo] Build infrastructure lib/ directory is up to date. init: init-branch: publish-local-branch: [oc:ivymultimodulebuild] Modules to be built: [UNSET#deploy-ipsmgw] [oc:ivymultimodulebuild] [oc:ivymultimodulebuild] ======================================== [oc:ivymultimodulebuild] Entering module UNSET#deploy-ipsmgw [oc:ivymultimodulebuild] ======================================== [oc:ivymultimodulebuild] init-build-extensions: pre-init-ivy-common: init-ivy-common: [echo] Ivy Resolvers: /home/testuser/ipsmgw-sdk/build/ivy/resolvers-remote.xml [echo] Configuring Ivy with settings: /home/testuser/ipsmgw-sdk/build/ivy/ivysettings.xml [ivy:var] :: loading settings :: file = /home/testuser/ipsmgw-sdk/build/ivy/ivysettings.xml [ivy:resolve] :: loading settings :: file = /home/testuser/ipsmgw-sdk/build/ivy/ivysettings.xml [echo] Build infrastructure lib/ directory is up to date. init: ... edited for brevity ... set-default-build-revision: do-build: [echo] Initialising build extensions. [echo] Retrieving ivy configuration "antlib" into /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/libs/antlib [copy] Copying 1 file to /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/generated [echo] Skipping default module src build - no source available. [echo] Skipping default module test build - no test source available. [mkdir] Created dir: /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/artifacts [echo] [echo] [touch] Creating /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/artifacts/deploy-ipsmgw-deploy.xml [echo] [copy] Copying 133 files to /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/generated/config [zip] Building zip: /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/artifacts/deploy-ipsmgw-config.zip [copy] Copying 1 file to /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/artifacts [echo] [echo] Building module as a module pack. [echo] Building module pack using the following properties: [echo] module.pack.include.path=*/ [echo] module.pack.exclude.path= [echo] module.pack.basedir=/home/testuser/ipsmgw-sdk/deploy-ipsmgw [echo] module.pack.prepend.file= [echo] module.pack.prepend.include.path=*/.java [echo] module.pack.prepend.exclude.path= [mkdir] Created dir: /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/module-pack [copy] Copying 139 files to /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/module-pack [oc:update-module-pack-dependencies] Updating module-pack ivy dependencies for: /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/module-pack [oc:update-module-pack-dependencies] [oc:update-module-pack-dependencies] [oc:verify-module-pack] Verifying module-pack content: /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/module-pack [oc:verify-module-pack] [zip] Building zip: /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/artifacts/deploy-ipsmgw-module-pack.zip build: test: [echo] Skipping default module test - no tests available. publish-local-module: [echo] Publishing module to local repository. [ivy:publish] :: delivering :: UNSET#deploy-ipsmgw#trunk;working@testmachine :: 1.0.0.0-DEV0-testuser :: integration :: Fri Apr 01 14:23:11 NZDT 2016 [ivy:publish] delivering ivy file to /home/testuser/ipsmgw-sdk/deploy-ipsmgw/target/artifacts/ivy.xml [ivy:publish] :: publishing :: UNSET#deploy-ipsmgw [ivy:publish] published deploy-ipsmgw-config to /home/testuser/.ivy2/opencloud-local/UNSET/trunk/deploy-ipsmgw/1.0.0.0-DEV0-testuser.part/deploy-ipsmgw-config-1.0.0.0-DEV0-testuser.zip [ivy:publish] published deploy-ipsmgw-config to /home/testuser/.ivy2/opencloud-local/UNSET/trunk/deploy-ipsmgw/1.0.0.0-DEV0-testuser.part/deploy-ipsmgw-config-1.0.0.0-DEV0-testuser.properties [ivy:publish] published deploy-ipsmgw-module-pack to /home/testuser/.ivy2/opencloud-local/UNSET/trunk/deploy-ipsmgw/1.0.0.0-DEV0-testuser.part/deploy-ipsmgw-module-pack-1.0.0.0-DEV0-testuser.zip [ivy:publish] published ivy to /home/testuser/.ivy2/opencloud-local/UNSET/trunk/deploy-ipsmgw/1.0.0.0-DEV0-testuser.part/ivy.xml [ivy:publish] publish commited: moved /home/testuser/.ivy2/opencloud-local/UNSET/trunk/deploy-ipsmgw/1.0.0.0-DEV0-testuser.part [ivy:publish] to /home/testuser/.ivy2/opencloud-local/UNSET/trunk/deploy-ipsmgw/1.0.0.0-DEV0-testuser [oc:ivymultimodulebuild] [oc:ivymultimodulebuild] ======================================== [oc:ivymultimodulebuild] Exiting module UNSET#deploy-ipsmgw [oc:ivymultimodulebuild] ======================================== [oc:ivymultimodulebuild] [oc:ivymultimodulebuild] [oc:ivymultimodulebuild] ======================================== [oc:ivymultimodulebuild] Build Report: [oc:ivymultimodulebuild] ======================================== [oc:ivymultimodulebuild] [oc:ivymultimodulebuild] deploy-ipsmgw: [oc:ivymultimodulebuild] [SUCCESS] (1m, 12.976s) [oc:ivymultimodulebuild] Tests: none publish-local: BUILD SUCCESSFUL Total time: 1 minute 18 seconds