Open Liberty Cheat Sheet

<variable name="variableName" value="some.value" />

<variable name="DB_SERVER" defaultValue="localhost"/>

@ApplicationScoped
public class MyService {

    @Inject
    @ConfigProperty(name = "foo", defaultValue = "bar")
    String fooProperty;

my-app.db.username=dbUser
my-app.db.password=dbPass

kind: Deployment
apiVersion: apps/v1beta1
metadata:
  name: my-app
spec:
# ...
      containers:
      - name: my-app
        image: ...
        volumeMounts:
        - name: database-credentials-volume
          mountPath: /opt/wlp/usr/servers/defaultServer/bootstrap.properties
          subPath: bootstrap.properties
          readOnly: true
      volumes:
      - name: database-credentials-volume
        secret:
          secretName: database-credentials

<dataSource ...>
    <properties ...
        user="${my-app.db.username}"
        password="${my-app.db.password}"/>
</dataSource>

<featureManager>
    <feature>appSecurity-3.0</feature>
    <feature>restConnector-2.0</feature>
    <feature>jdbc-4.2</feature>
</featureManager>

<!-- Any security mechanism can be used, <quickStartSecurity> is the simplest -->
<quickStartSecurity userName="admin" userPassword="admin"/>

<dataSource id="DefaultDataSource">
    <!-- the rest of your datasource config... -->
</dataSource>

<dataSource id="DefaultDataSource" jndiName="jdbc/myDB">
    <jdbcDriver libraryRef="jdbcLib"/>
    <properties.postgresql serverName="localhost" portNumber="5432"
                databaseName="myDB"
                user="exampleUser"
                password="examplePassword"/>

</dataSource>

docker run -it --rm=true --memory-swappiness=0 --ulimit memlock=-1:-1 \
           --name postgres-liberty \
           -e POSTGRES_USER=exampleUser \
           -e POSTGRES_PASSWORD=examplePassword \
           -e POSTGRES_DB=myDB \
           -p 5432:5432 postgres:10.5

<dataSource id="DefaultDataSource" jndiName="jdbc/test">
    <jdbcDriver libraryRef="jdbcLib"/>
    <properties.db2.jcc serverName="localhost" portNumber="50000"
                databaseName="test"
                user="db2inst1"
                password="foobar1234"/>

</dataSource>

docker run --ulimit memlock=-1:-1 -it --rm=true --memory-swappiness=0 \
           --name db2-liberty \
           -e AUTOCONFIG=false -e ARCHIVE_LOGS=false -e LICENSE=accept \
           -e DBNAME=test \
           -e DB2INSTANCE=db2inst1 \
           -e DB2INST1_PASSWORD=foobar1234 \
           -p 50000:50000 \
           --privileged \
           ibmcom/db2:11.5.0.0a

<dataSource id="DefaultDataSource" jndiName="jdbc/myDB">
    <jdbcDriver libraryRef="jdbcLib"/>
    <properties.microsoft.sqlserver serverName="localhost" portNumber="1433"
                databaseName="tempdb"
                user="sa"
                password="examplePassw0rd"/>

</dataSource>

docker run --ulimit memlock=-1:-1 -it --rm=true --memory-swappiness=0 \
           --name mssql-liberty \
           -e ACCEPT_EULA=Y \
           -e SA_PASSWORD=examplePassw0rd \
           -p 1433:1433 \
           mcr.microsoft.com/mssql/server:2019-GA-ubuntu-16.04

<dataSource id="DefaultDataSource" jndiName="jdbc/myDB">
    <jdbcDriver libraryRef="jdbcLib"/>
    <properties serverName="localhost" portNumber="3306"
                databaseName="myDb"
                user="exampleUser"
                password="examplePassword"/>
</dataSource>

docker run --ulimit memlock=-1:-1 -it --rm=true --memory-swappiness=0 \
           --name mysql-liberty \
           -e MYSQL_DATABASE=myDB \
           -e MYSQL_USER=exampleUser \
           -e MYSQL_PASSWORD=examplePassword \
           -p 3306:3306 \
           mcr.microsoft.com/mssql/server:2019-GA-ubuntu-16.04

<dataSource id="DefaultDataSource" jndiName="jdbc/myDB">
    <jdbcDriver libraryRef="jdbcLib"/>
    <properties.oracle URL="jdbc:oracle:thin:@//localhost:1521/myDB"/>
</dataSource>

<dataSource id="DefaultDataSource" jndiName="jdbc/myDB">
    <jdbcDriver libraryRef="jdbcLib"/>
    <properties.derby.embedded databaseName="memory:myDB" createDatabase="create"/>
</dataSource>

<featureManager>
    <feature>wasJmsServer-1.0</feature>
</featureManager>

<messagingEngine>
    <queue id="myQueue" />
    <topicSpace id="myTopicSpace" />
</messagingEngine>

<wasJmsEndpoint host="*"  wasJmsPort="7276" wasJmsSSLPort="7286" />

<featureManager>
    <feature>wasJmsClient-2.0</feature>
    <feature>jms-2.0</feature>
</featureManager>

<jmsConnectionFactory jndiName="jms/localCF">
    <properties.wasJms />
</jmsConnectionFactory>

<jmsConnectionFactory jndiName="jms/remoteCF">
    <properties.wasJms remoteServerAddress="example.com:7276:BootstrapBasicMessaging" />
</jmsConnectionFactory>

<jmsTopic jndiName="jms/jmsLocalTopic">
    <properties.wasJms topicName="myTopic" topicSpace="myTopicSpace" />
</jmsQueue>

<jmsQueue jndiName="jms/jmsRemoteQueue">
    <properties.wasJms queueName="myQueue" />
</jmsQueue>

<featureManager>
    <feature>jms-2.0</feature>
</featureManager>

<!-- The IBM MQ resource adapter is available here:  -->
<resourceAdapter id="mqJmsRa" location="/path/to/wmq.jmsra.rar">
    <classloader apiTypeVisibility="+third-party"/>
</resourceAdapter>

<jmsQueueConnectionFactory id="myRemoteQueueConnectionFactory" jndiName="jms/mqRemoteQCF">
    <properties.mqJmsRa channel="DEV.APP.SVRCONN" hostName="localhost" port="1414" queueManager="mqtest"/>
</jmsQueueConnectionFactory>

<jmsQueue id="myMQQueue" jndiName="jms/mqRemoteQueue">
    <properties.mqJmsRa baseQueueManagerName="mqtest" baseQueueName="DEV.QUEUE.1"/>
</jmsQueue>

<jmsTopicConnectionFactory id="myRemoteTopicConnectionFactory" jndiName="jms/mqRemoteTCF">
    <properties.mqJmsRa channel="DEV.APP.SVRCONN" hostName="localhost" port="1414" queueManager="mqtest" clientId="myClientId"/>
</jmsTopicConnectionFactory>

<jmsTopic id="myMQTopic" jndiName="jms/mqRemoteTopic">
    <properties.mqJmsRa baseQueueManagerName="mqtest" baseTopicName="dev1/"/>
</jmsTopic>

docker run -it --rm=true --name mq-liberty \
           -e LICENSE=accept \
           -e MQ_QMGR_NAME=mqtest \
           -e MQ_ADMIN_PASSWORD=testpassword \
           -p 1414:1414 \
           -p 9443:9443 \
           ibmcom/mq:9.1.4.0

import javax.jms.*;

// Note: In managed components (CDI beans, servlets, EJBs, etc) lookups can be replaced with @Resource annotations
QueueConnectionFactory factory = InitialContext.doLookup("jms/mqRemoteQCF");
Queue queue = InitialContext.doLookup("jms/mqRemoteQueue");

QueueConnection connection = factory.createQueueConnection();
QueueSession session = connection.createQueueSession(false, Session.AUTO_ACKNOWLEDGE);

// Send a message to the queue
TextMessage message = session.createTextMessage("Your Message Here");
MessageProducer producer = session.createProducer(queue);
producer.send(message);

producer.close();

// Receive a message from the queue
MessageConsumer consumer = session.createConsumer(queue);
TextMessage result = (TextMessage) consumer.receieve(5000L);
System.out.println("Got " + result);

consumer.close();

session.close();
conn.close();

<featureManager>
    <feature>appSecurity-3.0</feature>
</featureManager>

<basicRegistry id="basic">
    <user name="bob" password="bobpwd"/>
</basicRegistry>

<webApplication location="myApp.war">
    <application-bnd>
        <!-- this can also be defined in web.xml instead -->
        <security-role name="admin">
            <user name="bob"/>
        </security-role>
    </application-bnd>
</webApplication>

@Path("/")
@ApplicationScoped
@RolesAllowed("admin")
public class HelloEndpoint {

    @GET
    public String sayHello() {
        return "Hello World";
    }
}

<ssl id="defaultSSLConfig"  trustDefaultCerts="true" />

<featureManager>
    <feature>appSecurity-3.0</feature>
    <feature>mpJwt-1.1</feature>
</featureManager>

# If you set/override these values using environment variables,
# convert all '.' chars to '_' chars in property key names
mp.jwt.verify.publickey=<the JWT issuer's public key>
mp.jwt.verify.issuer=http://someJwtIssuer.com

@Path("/")
@RequestScoped
@RolesAllowed("users") // Requires jwts to have "group=users" claim
public class SecuredServiceEndpoint {