HCL DX Portal, DAM e CC in docker compose

Nel corso degli anni una delle complicazioni relative a portal era la sua complessità di installazione. 

Da qualche tempo, HCL ha avviato la transizione di portal verso container e k8s, rilasciando immagini docker ,  prima per il container di DX poi per quelli "accessori" nuovi, come il DAM (la nuova media gallery).

Durante lo scorso luglio  è stato pubblicato un repository git , con un docker compose file per avviare facilmente l'ambiente in pochi minuti su un qualunque computer con docker-compose.

Il supporto ha inoltre rilasciato questo video, con una guida passo passo che può aiutare i meno esperti ad avere un ambiente completo disponibile in pochi minuti.

HCL DX 9.5 , come essere online con un portale di sviluppo in 20 minuti

HCL con il rilascio della versione 9.5 di DX ha rilasciato il software con gli installer classici e sotto forma di immagine docker , pensata per essere eseguita in ambiente di produzione su OpenShift 4.x , con il supporto anche a Kubernets vanilla che dovrebbe arrivare a breve.

Un possibile utilizzo che potete fare di questa immagine docker è quella di poter disporre di ambienti di sviluppo sui vostri portatili passando da 0 allo sviluppo in circa 20 minuti !

Ho effettuato quanto vi vado a raccontare sul mio portatile con Windows 10 e Hyper-V.
Se non avete già installato docker o non lo conoscete vi consiglio di partire da questa pagina.

Preparazione

Dopo installazione di docker, ( o se lo avete già e non lo avete mai configurato) vi consiglio di andare a fare il seguente tuning sulla virtual machine per assegnare maggiori risorse:

Bottone destro su icona di docker (vicino orologio windows) e setting

Qui ho cambiato i parametri della docker machine aumentandoli ai seguenti:

Vi consiglio ora di creare una cartella sul vostro filesystem , dove redirigere il mount della wp_profile per rendere persistente il container di portal.

Per questioni di performance e integrità del dato, vi consiglio di escludere questa cartella dalla scansione del vostro antivirus ( al primo lancio viene generata la wp_profile e vi trovereste l'antivirus a scansionare i quasi 40k file risultanti)

Esecuzione

Scompattare l'archivio scaricato da Flexnet (al momento in cui scrivo hcl-dx-openshift-v95-20190929-1242.zip

Ora dovete importare nel registro immagini di docker l'immagine del portale con il comando

docker load -i .\hcl-dx-core-image-v95_20190928-2258.tar.gz 

dopo alcuni min in cui docker importerà i diversi layer dell'immagine riceverete la conferma dell'import:

Loaded image: hcl/dx/core:v95_20190928-2258 

Ora per crare il container di portal e poterci accedere usate il seguente comando :

PS C:\Users\matteo.bisi\Downloads\hcl-dx-openshift-v95-20190929-1242(1)> docker run -p 10038:10038 -p 10039:10039 -p 10041:10041 -p 10042:10042 -p 10200:10200 -p 10202:10202 -v C:\docker\dx-store\wp_profile:/opt/HCL/wp_profile hcl/dx/core:v95_20190928-2258

dove  C:\docker\dx-store\wp_profile  è la directory di lavoro dove verrà mappato il profilo del portale per renderlo persistente.

Il primo avvio creando il profilo può impiegare alcuni minuti a seconda della velocità del vostro HD. 

L'immagine non comprende HTTP e Plugin quindi per entrare nel portale potete usare i seguenti riferimenti:

Url Portal   :       http://localhost:10039/wps/portal   
Url Console :     https://localhost:10041/ibm/console

Utenza default:  wpsadmin / wpsadmin

se dovete accedere al container per lanciare comandi o altro 

 
                                               docker exec -it  nome_container  bash

Il container gira su RHEL 8.0  , security local was e database Derby

Chiudo questo post con alcuni comandi docker

per vedere i container attivi

docker ps

per vedere quali container avete compresi gli spenti

docker ps -a

per rinominare il container se volete assegnargli un nome preciso

docker rename nome container dx95

per fermare il container 

docker stop nome_container

per accendere il container
docker start nome_container

La documentazione relativa a queste immagini la trovate a questa pagina.

Docker su Windows10 come risolvere errore "unauthorized: incorrect username or password" alla partenza di un container

Lavorando sul mio portatile Win10, ho deciso di passare da Virtualbox a Hyper-V , decisione che comporta il cambio da Docker toolbox (legacy)  a Docker for Windows.


Dopo aver disinstallato docker toolbox, cambiato hyper visor al classico test hello world ricevevo l'errore seguente:

C:\Users\mbisi>docker run hello-world
Unable to find image 'hello-world:latest' locally
docker: Error response from daemon: Get https://registry-1.docker.io/v2/library/hello-world/manifests/latest: unauthorized: incorrect username or password.
See 'docker run --help'.

In questo caso il problema era dovuto a vecchie credenziali del docker hub salvate in

%USERPROFILE%/.docker/config.json

la via migliore per correggere le credenziali e riguadagnare l'accesso al docker hub è quella di eseguire


C:\Users\mbisi>docker logout
Removing login credentials for https://index.docker.io/v1/

seguito da un nuovo login

C:\Users\mbisi>docker login
Login with your Docker ID to push and pull images from Docker Hub. If you don't have a Docker ID, head over to https://hub.docker.com to create one.
Username:


a questo punto inserendo le creadenziali docker risolverete il problema.

In prima battuta ho inserito la mail come user name , ricevendo il messaggio seguente, nonostante le credenziali fossero corrette

Username: matteo.bisi@factor-y.com
Password:
Error response from daemon: Get https://registry-1.docker.io/v2/: unauthorized: incorrect username or password

se siete in questo caso, vi consiglio di riprovare con lo username, che potete trovare loggandovi sul docker hub via web:

ho ripetuto quindi l'accesso con mbisi

C:\Users\mbisi>docker login
Login with your Docker ID to push and pull images from Docker Hub. If you don't have a Docker ID, head over to https://hub.docker.com to create one.
Username: mbisi
Password:
Login Succeeded

ripristinando l'accesso al dockerhub.


In generale se passate da Docker toolbox a docker hub, vi consiglio di :

1. disinstallare docker toolbox
2. andare nelle variabili di sistema operativo e cancellare se presenti tutte le variabili docker_*
3. rimuovere docker dal path di sistema
4. cambiare hypervisor, riavviare e riprovare

IBM Notes e Domino 9.0.1 , cosa succederà dopo il Feature Pack 9 ? Alcune delle (importanti) novità in arrivo da Settembre

IBM da qualche giorno ha rilasciato il Feature pack 9 per Notes e Domino che continua ad implementare nuove funzionalità e bugfix.

In questo post vorrei spendere alcune righe riguardo al futuro di Notes e Domino che dal Fp10 (in programma per fine 2017) in avanti si annuncia vivace come mai negli ultimi 5+ anni.

Supporto a Docker

Dalla versione FP10 (come riportato in questo post dall'amico Bill ) , sarà supportato Domino in container Docker (clicca qui se non sai cosa è Docker) . 

Questa nuova possibilità darà una nuova flessibilità agli ambienti Domino perchè sfruttando le caratteristiche di Docker sarà ad esempio possibile:

• Creare nuovi server in pochi secondi
• Distribuire immagini Docker con applicativi ai clienti in modo agevole in modalità blackbox
• Ospitare piu' server Domino in modo trasparente , isolato e  ottimizzato su un  unico server
• Sfruttare Domino come microservizio dedicato , per applicazioni/LDAP/Smtp relay e distruggerlo in modo veloce e sicuro quando questo non dovesse piu' servire

Docker viene usato principalmente in ambito Linux , ma da poco più di un anno è  possibile utilizzarlo anche con immagini Windows 2016 core. 

Sarà necessario verificare le modalità di supporto IBM per vedere su quali OS sarà possibile usarlo. Io ho testato Domino in entrambi gli OS e devo dire che Linux risulta perfettaemente usabile mentre su Windows quando l'ho provato alcuni mesi fa, sono riuscito ad utilizzare Domino ma con alcune limitazioni.  La configurazione su Windows sarebbe da riverificare per vedere se gli aggiornamenti degli ultimi mesi hanno portato a miglioramenti.

Una delle caratteristiche di Docker è quella di avere un hub di immagini pubbliche dal quale scaricare le immagini dei container , anche uffiali e realizzate dai relativi developer. 

IBM al momento pare non abbia intenzione di rilasciare un immagine ufficiale , quindi dovrete probabilmente installare domino.

Se volete un ispirazione su come iniziare ad usare Domino in Docker container potete leggere il mio post relativo alla presentazione che io  e Daniele Vistalli abbiamo presentato a IBM Connect 2016 su questo argomento ;-) . 

IBM Domino community server

Durante il mese di Settembre dovrebbe essere rilasciato il Domino Community server, ovvero il tanto atteso Domino free per sviluppatori. In questo modo IBM andrà  a facilitare la realizzazione ed il supporto applicativo .
Unica limitazione di questa installazione Domino dovrebbe essere l'utilizzo che non potrà ovviamente essere in produzione. 

Eclipse e Java upgrade

Nel Feature Pack 8 è stata aggiornata la versione di Java alla 1.8 per Notes e Domino. 

Il client designer verrà aggiornato nella Fp10 che includerà anche Eclipse 4.6x (sia Notes che Designer). Questi upgrade aumenteranno la stabilità e le funzionalità a disposizione dei dev nelle proprie applicazioni.

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

Tutte queste novità del prossimo futuro, insime a quelle rilasciate da quando esistono i Feture Pack rendono il periodo veramente interessante per i  clienti e partner IBM Domino che vedono ripagata la fedeltà tecnologica.
IBM è in un periodo molto recettivo , propone spesso survey per conoscere opinione di clienti e partner come il seguente dedicato alle appliazioni , compilatelo !

Se siete clienti Domino ed attraversate una fase di valutazione tecnologica, pensateci bene , è un ottimo momento per essere clienti (e consulenti) Domino ! 

Di seguito vi lascio le slides della sessione relativa a Domino&Docker presentata a Orlando durante IBM Connect 2016 .

Connect2016 - 1172 Shipping domino from Matteo Bisi

How to: come creare una immagine docker con Websphere 9 http9 e plugin 9 e configurare la cella

Durante la nostra sessione a ICONUK 2016 abbiamo effettuato una demo live durante la quale abbiamo anche fatto vedere la build live di una docker image di WebSphere 9.0 con HTTP e plugin e la configurazione di una cella.

Ho eseguito l'upload del docker file e dei response file , con alcune ulteriori info nel mio github

https://github.com/matteobisi/docker/tree/master/was9

Come potete vedere , abbiamo eseguito la creazione dell'immagine su Ubuntu 16.04 LTS che vi ricordo essere ufficialmente supportata da IBM come anche Docker.

ICON UK 2016, la mia presentazione

Ecco le slide della mia presentazione tenuta oggi a Londra con l'amico Andrea Fontana.

Abbiamo affrontanto il tema Docker , fornendo un overview sulla piattaforma  e dato alcuni spunti e suggerimenti su come utilizzarlo con sw IBM.

Nei prossimi giorni pubblicherò anche alcuni dei dockerfile usati durante la presentazione.

docker : how to deploy Digital Experience in a container drinking a cup of coffee from Matteo Bisi

IBM Connect 2016, le slide della mia sessione " IBM Domino inside a Docker container" con i dockerfile

Quest'anno io ed il mio collega Daniele Vistalli abbiamo avuto l'onore di avere accettata una nostra sessione a IBM Connecti 2016 che si è tenuto ad Orlando all'inizio di Febbraio dal titolo "AD-1772, Shipping Domino, How to put Domino in a Container and live happy".

Docker è una tecnologia open source per Linux che permette di virtualizzare le applicazioni rinchiudendole in container che possono quindi girare in modo indipendete fra di loro su un server. Docker permette quindi di ottimizzare maggiormente l'utilizzo delle risorse del sistema host , utilizzando meno risorse di una intera macchina virtuale.

Prima che iniziate a leggere il post preciso subito che al momento Docker non è una piattaforma ufficialmente supportata da IBM, quindi se pensate di usarla in produzione sui vostri server dovete farlo a vostro rischio.

Dopo l'avvertenza d'obbligo però ci tengo a precisare che Domino dentro un container docker gira ottimamente e se non possiamo pensare di utilizzarlo in produzione possiamo almeno pensare di utilizzarlo per agevolarci nei test e negli sviluppi ( potete trovare i pro leggendo le slides).

Connect2016 - 1172 Shipping domino from Matteo Bisi


Oltre alle slides ho voluto condividere i docker file che abbiamo mostrato durante la parte di demo live della sessione, quindi ho creato un account su github con un repository dedicato che potete trovare a questo link..

La creazione di immagini Docker da cui fare partire i container che andranno eseguiti si può fare manalmente o tramite script chiamati docker file.

Ecco i 3 docker file mostrati durante la sessione che ho condiviso:

1. Dockerfile-domino4ubuntu-install
2. Dockerfile-domino4ubuntu-setup
3. Dockerfile-domino4ubuntu-FP5

Per avere una migliore leggibilita e flessibilità  abbiamo deciso di spezzare la creazione dell'immagine in 3 script, che ovviamente volendo potete racchiudere in 1.

Questi script per essere lanciati richiedono una cartella di lavoro con i seguenti requisiti: 

• una folder chiamata domino901 che contiene il setup scompattato di domino
• una folder initscripts che contiene Domino init script form Daniel Nashed (grazie Daniel !) , 
• serverconfig che contiene i certificatori domino ,il file id dell'amministratore il file pds per l'autoconfiguraizone ed  il txt file con le pw degli id.

Dopo la preparazione della folder di lavoro utilizzando i docker file nell'ordine giusto sarà possibile avere l'immagine :

Lo script Install creerà un immagine partendo da Ubuntu SRV 14.04 LTS installando silenziosamente Domino al suo interno, dopo aver preparato l'ambiente (utenze, etc)

Lo scipt  setup eseguirà il build partendo dall'immagine precedente ed eseguirà anche il setup di domino in modo silenzioso utilizzando un file pds di autoconfigurazione  ( questo file lo otete ottenere utilizzando serverconfig -record dal vostro Notes ) , il corrispondente file txt txt con le pw e gli id coinvolti (certificatore e amministratore).

Per fare il build dell'immagine è necessario utilizzare il comando docker build

docker build -t mbisi/domino901-ready-playground:1.0 -f Dockerfile-domino4ubuntu-setup .

per fare partire l'immagine , mappando le porte in modo statico su quelle dell'host docker run con le seguenti opzioni

docker run -it -p 1352:1352 -p 80:80 -p 443:443 mbisi/domino901-ready-playground:latest

Lo script FP5, esegue un upgrade dell'immagine al fp, rendendo quindi semplice l'upgrade ogni qual volta che IBM rilascia una nuova versione.

Dentro le immagini abbiamo definito come docker volume /local/notesdata rendendo quindi persistenti i dati al suo interno.

Questi dockerfile vogliono essere un esempio ed uno spunto per farvi capire come Domino possa essere installato e configurato velocemente all'interno di un immagine docker rendendone cosi semplice la sua esecuzione dentro un container.

Se non conoscete docker ed ora volete saperne di piu  vi consiglio questi video tutorial per avere un bel quadro della piattaforma.