In questa sezione viene fornita una breve guida al setup di Extraway.

• docker-compose

1. Estrarre il contenuto dei due archivi
2. Copiare il contenuto di db.zip in xwee_mp_free_v2/xwee-docker/extraway-ee/db
3. Nella root del progetto (/xwee_mp_free_v2/xwee-docker) lanciare docker-compose:

   docker-compose up

In questa sezione viene fornita una breve guida al setup del progetto DocWay 5.

• NodeJS
• npm
• Maven

Scaricare il progetto da GitLab http://gitlab.bo.priv/docway5/docway5

In questa sezione vengono configurati Maven ed npm in modo tale da accedere alle repository interne 3D Informatica.

• Il file di configurazione di npm è .npmrc, normalmente nella home. Sostituire il contenuto del file con il seguente:

  #File di configurazione NPM, fare riferimento a https://docs.npmjs.com/misc/config
  
  # Registry ufficiale
  #registry=https://registry.npmjs.org/
  
  # Registry Nexus Group 3DI
  registry=http://ecatonchiro.bo.priv:8081/nexus/repository/npm-group/
  
  # Autenticazione a Nexus 3DI, hash generato con: $ echo -n 'myuser:mypassword' | openssl base64
  _auth="bWFyY2VsbG8uYm9sb2duZXNpOlFQdjhHTzVCa29MdkIxcGYxTUFo"
  
  # Forza npm ad effettuare sempre l'autenticazione
  always-auth=true

• Il file di configurazione maven è normalmente nella home in /.m2/settings.xml:

  <?xml version="1.0" encoding="UTF-8"?>
  <settings>
     <servers>
        <server>
           <id>deployment</id>
           <username />
           <password />
        </server>
     </servers>
     <mirrors>
        <mirror>
           <!-- This sends everything else to /public  -->
           <id>nexus</id>
           <mirrorOf>*</mirrorOf>
           <url>http://ecatonchiro.bo.priv:8081/nexus/content/groups/public</url>
        </mirror>
        <mirror>
           <id>nexus_releases</id>
           <mirrorOf>*</mirrorOf>
           <url>http://ecatonchiro.bo.priv:8081/nexus/content/repositories/releases/</url>
        </mirror>
        <mirror>
           <id>nexus_snapshots</id>
           <mirrorOf>*</mirrorOf>
           <url>http://ecatonchiro.bo.priv:8081/nexus/content/repositories/snapshots/</url>
        </mirror>
     </mirrors>
     <profiles>
        <profile>
           <id>nexus</id>
           <!-- Enable snapshots for the built in central repo to direct  -->
           <!-- all requests to nexus via the mirror  -->
           <repositories>
              <repository>
                 <id>central</id>
                 <url>http://central</url>
                 <releases>
                    <enabled>true</enabled>
                 </releases>
                 <snapshots>
                    <enabled>true</enabled>
                 </snapshots>
              </repository>
           </repositories>
           <pluginRepositories>
              <pluginRepository>
                 <id>central</id>
                 <url>http://central</url>
                 <releases>
                    <enabled>true</enabled>
                 </releases>
                 <snapshots>
                    <enabled>true</enabled>
                 </snapshots>
              </pluginRepository>
              <pluginRepository>
                 <id>com.springsource.repository.bundles.release</id>
                 <url>http://repository.springsource.com/maven/bundles/release</url>
              </pluginRepository>
           </pluginRepositories>
        </profile>
     </profiles>
     <activeProfiles>
        <!-- make the profile active all the time  -->
        <activeProfile>nexus</activeProfile>
     </activeProfiles>
  </settings>

Per poter avviare DocWay 5 occorre avviare una istanza di ElasticSearch e una di MongoDB. In questa guida si utilizza Docker che per creare i due container necessari e avviarli:

Run MongoDB Container:

docker run -it -v mongodata:/data/db -p 27017:27017 --name mongodb -d mongo:4.2.1

Run ElasticSearch Container:

docker run -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" --name elastic -e "cluster.name=elasticsearch" -d docker.elastic.co/elasticsearch/elasticsearch:6.4.2

Per avere i log dell'applicazione è necessario configurare il profilo dev. Su IntelliJ si trova in: Run > Edit Configurations…

Per testare il corretto funzionamento dell'applicazione è utile inserire alcuni dati. In docway5-services configurare il db corretto in application.properties (togliere la parte di test) e lanciare il test generateAll() che si trova in src/test/java/it/tredi/dw5/docway5/test/Dw5CustomFieldsTempGenerator.java.

C'è una cache lato java, quindi quando si inseriscono i dati di esempio tramite i test, occorre andare in modifica su una tipologia e salvare per rinnovare la cache.

Una volta lanciata l'applicazione andare alla pagina http://localhost:4200/docway5/ e loggarsi con username: admin e password: password.

Se capita che ci sia l'errore per la mancanza di alcuni modelli DTO occorre rigenerarli. In questo caso click destro su docway5-app > Run Maven > Plugins > typescript-generator-maven-plugin > typescript-generator:generate

In questa sezione viene fornita una breve guida al setup del progetto DocWay 4.

• Java 1.8
• Tomcat 8.5.x

In questa sezione vengono forniti i file di configurazione necessari per il setup dell'ambiente.

• tomcat_conf.zip contenente i files tomcat-users.xml e server.xml utili alla configurazione di Tomcat
• conf.zip per la cartella del configuratore di DocWay 4

1. Scaricare i seguenti progetti dal gruppo docway4 su GitLab:
   1. hj http://gitlab.bo.priv/docway4/hj
   2. common4 http://gitlab.bo.priv/docway4/it.tredi.common4
   3. acl4 http://gitlab.bo.priv/docway4/it.tredi.acl4
   4. xdocway http://gitlab.bo.priv/docway4/it.tredi.xdocway4
   5. docway4-service http://gitlab.bo.priv/docway4/docway4-service
   6. docway4 http://gitlab.bo.priv/docway4/docway4
2. Eseguire il Maven install dei progetti seguendo l'ordine sopra indicato

1. Settare il Realm corretto nel file di configurazione di Tomcat:

   <Realm className="org.apache.catalina.realm.LockOutRealm">
     <Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase">
       <CredentialHandler className="org.apache.catalina.realm.MessageDigestCredentialHandler" algorithm="MD5" />
     </Realm>
   </Realm>

oppure sostituire il file server.xml in apache-tomcat-8.5.x/conf/server.xml.

1. Settare ruoli e utenti di Tomcat aggiungendo i seguenti:

   <role rolename="noxdocwaydoc"/>
   <role rolename="alias3diws"/>
   <role rolename="xwdocway"/>
   <role rolename="manager"/>
   <role rolename="jwsuser"/>
   <role rolename="avepa"/>
   <role rolename="admin-gui"/>
   <role rolename="jspuser"/>
   <role rolename="admin-script"/>
   <role rolename="manager-status"/>
   <role rolename="thepublisher"/>
   <role rolename="manager-jmx"/>
   <role rolename="jwsadmin"/>
   <role rolename="manager-script"/>
   <role rolename="admin"/>
   <role rolename="admjspuser"/>
   <role rolename="sovnet-ANAGR"/>
   <role rolename="manager-gui"/>
   <user password="21232f297a57a5a743894a0e4a801fc3" roles="manager,jwsuser,jwsadmin,admjspuser,jspuser,sovnet-ANAGR,admin,thepublisher" username="sstagni"/>
   <user password="21232f297a57a5a743894a0e4a801fc3" roles="manager,jwsuser,jwsadmin,jspuser,sovnet-ANAGR,admin,thepublisher,xwdocway" username="ncandelora"/>
   <user password="21232f297a57a5a743894a0e4a801fc3" roles="manager,jwsuser,jwsadmin,jspuser,sovnet-ANAGR,admin,thepublisher,xwdocway" username="dpranteda"/>
   <user password="21232f297a57a5a743894a0e4a801fc3" roles="manager,jwsuser,jwsadmin,jspuser,sovnet-ANAGR,admin,thepublisher,xwdocway" username="tiommi"/>
   <user password="21232f297a57a5a743894a0e4a801fc3" roles="manager,manager-gui,jwsuser,jwsadmin,admjspuser,jspuser,sovnet-ANAGR,admin,thepublisher" username="admin"/>
   <user password="21232f297a57a5a743894a0e4a801fc3" roles="manager,manager-gui,jwsuser,jwsadmin,admjspuser,jspuser,sovnet-ANAGR,admin,thepublisher" username="3diws"/>

oppure sostituire il file tomcat-users.xml in apache-tomcat-8.5.x/conf/tomcat-users.xml.

1. Creare una configurazione di deploy del progetto DocWay4 su Tomcat locale:

1. Aggiungere i due file .war seguenti nelle configurazioni di Deployment:
   1. DocWay4.war exploded
   2. DocWay4-service.war exploded
2. In application context settare /DocWay4 per il primo e /DocWay4-service per il secondo.

Creare la cartella /opt/3di.it/conf:

Aggiungere alla cartella appena creata le configurazioni di DocWay4: