IBM Sterling Order Management System Software

https://www.ibm.com/docs/en/order-management-sw/10.0.0
Admin
IBM Sterling Order Management System Software provides comprehensive capabilities for smart order...
Tokens:965,877
Snippets:16,649
Trust Score:10
Update:2 months ago
Show doc for...
Tokens:
Raw
### Operator installation examples

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=environment-installing-operator-online-without-operator-lifecycle-manager

Various command examples for installing different operators with specific versions, editions, and registry configurations.

```bash
op_util_linux_amd64 install oms --case-version 3.0.25 --edition pro
```

```bash
op_util_linux_amd64 install oms \
        --case-version 3.0.25 \
        --edition pro \
        --registry my.registry.com \
        --repository oms \
        --registry-user omsuser \
        --registry-pass omspass
```

```bash
op_util_linux_amd64 install sip --case-version 3.0.25
```

```bash
op_util_linux_amd64 install oms-gateway --case-version 3.0.25
```

--------------------------------

### Launch the Business Intelligence installation wizard

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=intelligence-business-setup

Execute this command from the directory containing the SCIInstallWizard.jar file to start the installation process.

```bash
<JAVA_HOME>/bin/java -Xmx512m -jar SCIInstallWizard.jar
```

--------------------------------

### Run setup upgrade

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=environment-enabling-oracle-database-developer-toolkit

Execute the upgrade setup script.

```bash
om-compose.sh setup-upg
```

--------------------------------

### Run Setup Files

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=software-post-migration-preparation-tasks

Execute setup scripts after modifying sandbox configuration.

```bash
setupfiles.sh
```

```cmd
setupfiles.cmd
```

--------------------------------

### Execute the setup script

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=center-setting-up-sterling-call

Run the script to complete the Sterling Call Center setup.

```bash
./call-center-setup.sh
```

--------------------------------

### Start the SBA Metrics agent

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=hub-enabling-metrics-workspaces-nodes-pages

Execute this command from the runtime/bin directory to start the metrics server.

```bash
./agentserver.sh SBAMetricsServer
```

--------------------------------

### Execute the setup script

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=model-setting-up-containerized-toolkit-environment

Run the setup script to initialize the environment, optionally providing a path to a customization package.

```bash
./om-compose.sh setup <optional: full_path_to_customization_package>
```

--------------------------------

### Run setup files

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=environment-enabling-oracle-database-developer-toolkit

Execute the setupfiles script.

```bash
./setupfiles.sh
```

--------------------------------

### Example Java startup command

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=overview-setting-up-weblogic-script-file

A complete example of the Java command line incorporating the required system properties.

```bash
${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} -Dweblogic.Name=${SERVER_NAME} -Djava.security.policy=
${WL_HOME}/server/lib/weblogic.policy ${JAVA_OPTIONS} -Dfile.encoding=UTF-8 -Dvendor=shell 
-DvendorFile=/servers.properties ${PROXY_SETTINGS} ${SERVER_CLASS}
```

--------------------------------

### Install factory setup for activator

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=overview-setting-up-order-orchestration

Configures the factory setup for the order orchestration activator using the integration load defaults script.

```bash
./sci_ant.sh -f integration_load_defaults.xml -DFunctionality=ORCH -DEnterpriseCode=value activator
```

--------------------------------

### Apply fix pack factory setup command

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=software-applying-fix-pack-factory-setup-manually

Execute this command from the runtime bin directory to install the fix pack factory setup. The FROM_FP parameter is optional and depends on the fix pack version.

```bash
cd <runtime>/bin

# Install the FP factory setup with optional FROM_FP to indicate which FP to install the FP factory setup from.
./sci_ant.sh -f FSHelper.xml [-DFROM_FP=<installed-fp-number>]
```

--------------------------------

### Run Reference Implementation Installation Script

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=implementation-install-reference-components-unix-linux

Executes the installation script from the bin directory to load configuration and demo data.

```bash
./sci_ant.sh -f ycd_load_oms_ref_impl.xml <-D optional property> -logfile <logfile>
```

```bash
./sci_ant.sh -f ycd_load_oms_ref_impl.xml -Drunmasterdata=Y -logfile logfile.txt
```

--------------------------------

### Run fix pack installation

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=containers-upgrading-from-non-container-application-container-model

Execute the InstallService script to apply the fix pack factory setup.

```bash
./InstallService.sh fpmode/fp-factorysetup.jar
```

--------------------------------

### Dockerfile samples for image customization

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=images-additional-build-process

Examples of how to extend base images by installing packages and configuring security settings.

```dockerfile
FROM om-app:10.0
USER root
RUN dnf install -y procps-ng ..... \
    && keytool .....
USER default
```

```dockerfile
FROM om-agent:10.0
USER root
RUN microdnf install procps-ng ..... \
    && keytool .....
USER omsuser
```

--------------------------------

### Example locale output

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=encoding-set-up-utf-8-character

Sample output from the locale command showing various installed locales, including an en_US.UTF-8 entry.

```text
   POSIX
   common
   en_US.UTF-8
   C
   iso_8859_1
```

--------------------------------

### Start Db2 instance with keystore

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=encryption-migrating-existing-unencrypted-db2-database-encrypted-database

Initialize the Db2 instance while providing the password for the keystore.

```bash
db2start open keystore USING Str0ngPassw0rd
```

--------------------------------

### Run Reference Implementation installation command

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=implementation-install-all-reference-components-windows

Executes the installation script from the bin directory to load configuration and demo data.

```batch
.\sci_ant.cmd -f ycd_load_oms_ref_impl.xml -Drunmasterdata=Y -logfile logfile.txt
```

--------------------------------

### Run a specific Docker container instance

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=toolkit-customizing-images-om-base-image

Example command to start a container using a specific image tag and volume mapping.

```bash
docker volume create oms-images
docker run -e LICENSE=accept -e LANG --privileged -v oms-images:/images \
    -v /path/to/oms-shared:/opt/ssfs/shared -it --name om-cust-container cp.icr.io/cp/ibm-oms-<edition>/om-base:10.0.0.21-amd64
```

--------------------------------

### Execute developer toolkit setup

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=environment-setting-up-containerized-developer-toolkit

Run the setup script to initialize the environment, which includes wiping existing containers and volumes.

```bash
./om-compose.sh setup optional: full_path_to_customization_package
```

--------------------------------

### Install PCAs

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=migration-process-be-performed-before-history-transaction

Optional command to create a package of PCAs installed in the old runtime for installation in the new directory.

```bash
${ANT_HOME}/bin/ant -Druntime=<INSTALL_DIR> -Druntime.old=<INSTALL_DIR_OLD> -f 
buildmigration.xml -logfile <logfile> -Dtarget=installPCAs migrate
```

--------------------------------

### Start development server

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=hub-creating-new-applications

Launch the development server on the local host.

```bash
yarn start --host=localhost
```

--------------------------------

### Set directory permissions for AIX installation

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=esnul-before-aix-installations-only

Use these commands to ensure the parent directory of the installation path has the necessary permissions for the installation process.

```bash
chmod -R 777 <absolute path>/install_dir_parent
```

```bash
chmod -R 777 test1
```

```bash
chmod -R 777 /AIX_1/applications/test1
```

--------------------------------

### Example ivtsetup.scp configuration

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=mq-configuring-access-by-webspheres-jndi-namespace

A sample configuration file for setting up a Queue Connection Factory and a queue object.

```text
def qcf(ivtQCF) qmgr(SYSTEM.TEST) transport(CLIENT) host(127.0.0.1) 
CHANNEL(SYSTEM.DEF.SVRCONN) port (1414)
def q(getATP) qu(getATP) QMGR(SYSTEM.TEST)
end
```

--------------------------------

### Execute silent installation command

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=iee-running-silent-installation

Run the installer JAR from the command line, specifying the silent installation configuration file and redirecting output to a log file.

```bash
java -jar SMCFS.jar -f silent.txt &> output.log
```

--------------------------------

### Execute setup and management commands

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=environment-setting-up-order-service-developer-toolkit

Commands to initialize the consumer setup or remove existing consumer containers.

```bash
./orderservice-compose.sh setup-upg
```

```bash
docker rm -f order-fetcher-consumer
```

```bash
docker rm -f order-indexer-consumer
```

```bash
./orderservice-composer.sh setup-upg
```

--------------------------------

### Start Podman socket

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=support-installing-developer-toolkit-using-podman-ubuntu

Command to start the Podman socket service.

```bash
systemctl start podman.socket
```

--------------------------------

### Start the local application server

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=applications-testing-existing-module-customizations-in-order-hub

Execute this command to start the local server for testing customizations.

```bash
yarn start-app
```

--------------------------------

### Install coreutils on macOS

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=prerequisites-setting-up-containerized-developer-toolkit-macos

Optional utility installation for the developer toolkit environment.

```bash
brew install coreutils
```

--------------------------------

### Configure WAS Client Environment and Startup

Source: https://www.ibm.com/docs/en/order-management-sw/10.0.0?topic=cmdm-configuringsterling-order-management-system-software-use-websphere-default-messaging

Export the WAS client home directory and execute the setup script within the startup configuration.

```bash
export WAS_CLIENT_HOME
${WAS_CLIENT_HOME}/bin/setupClient.sh
```
Tokens:
Raw