Naar hoofdinhoud

Hoe werkt de installatie van TheModus?

Getting started

Laatst gewijzigd op 14 september 2021

INHOUDSOPGAVE



Algemeen 

Voordat u aan de slag gaat met TheModus adviseren wij u eerst onderstaande artikelen goed door te nemen.


Deze artikelen helpen u bij de installatie en configuratie van TheModus.


TheModus maakt gebruik van een module genaamd "Gebruikersbeheer". Het Gebruikersbeheer geeft u de mogelijkheid om zelf te bepalen wie in uw organisatie gebruik gaat maken van TheModus en welke producten zij mogen gebruiken. Zodra een aankoop plaatsvindt van TheModus wordt u met behulp van e-mails geïnstrueerd hoe en waar uw collega's toe te voegen.


De functionaliteiten van TheModus zijn verzameld in één addin voor Autodesk Revit. Deze addin moet worden geïnstalleerd alvorens de gebruikers ervan gebruik kunnen maken. Deze addin is beschikbaar in een klein installatiepakket, welke bij iedere gebruiker geïnstalleerd moet worden. Ook de gebruikers worden via e-mail geïnformeerd waar ze deze addin kunnen downloaden.


Eerste keer aanmelden

Zodra u als TheModus gebruiker bent aangemeld in het gebruikersbeheer van TheModus ontvangt u onderstaande mail. 


 

Als u reeds een TheModus gebruiker bent en TheModus is bij u geïnstalleerd, dan hoeft u niets meer te doen. U kunt Autodesk Revit opstarten en direct aan de slag gaan.

 

Als u een nieuwe gebruiker bent, dan moet u eerst uw account aanmaken en activeren. 

 

Volg onderstaande stappen om uw account te maken en te activeren:

  • Klik [ Naar Cadac TheModus ]
    U krijgt een inlogscherm. Ditzelfde inlogscherm krijgt u als u TheModus opstart in Autodesk Revit of direct naar het portaal gaat via https://themodus.cadac.com.

  • Klik Create an account;
    Een nieuw scherm verschijnt:
  • Geef uw email adres op;
  • Geef uw gewenste wachtwoord op;
  • Herhaal dit wachtwoord;
  • Klik [ Create account ]
    U krijgt nu een email, waarin u uw account moet valideren. 
  • Valideer uw account. 

 

Uw account is aangemaakt. U heeft nu toegang tot TheModus. U kunt nu TheModus installeren. Zie hiervoor de onderstaande artikelen.


Terug naar Inhoudsopgave


Systeemvereisten

Voor TheModus zijn de minimale systeemeisen primair overeenkomstig met de eisen van Autodesk Revit.

 

Besturingssysteem

  • Windows 7-sp1, x64
  • Windows 8, x64
  • Windows 10, x64

 

Programma’s

  • De actuele versie van Autodesk Revit en de drie voorgaande releases. Voor allen alleen inclusief de laatste service packs / updates. 
  • Microsoft .NET Framework 4.5
  • Internet browser: Microsoft Edge of Google Chrome

 

Systeem

  • Circa 50 MB vrije schijfruimte voor de applicatie
  • Grafische resolutie ten minste 1280x1024
  • Om met Cadac TheModus te werken dient u over een actieve internetverbinding te beschikken
  • De applicatie kan gewenste content cachen. Afhankelijk van de content moet hiervoor ruimte gereserveerd worden!

 

Toegangscontrole en Firewalls


Terug naar Inhoudsopgave



Software downloaden

Cadac TheModus wordt als ".msi" installatiepakket beschikbaar gesteld met een bestandsnaam "TheModus.Revit.Addin.Installer.

 

Volg onderstaande stappen voor het downloaden van de meest recente versie van TheModus:

  • Open een internetbrowser, bij voorkeur Google Chrome of Microsoft Edge;
  • Ga naar https://themodus.cadac.com
  • Op de startpagina staat een verwijzing naar de downloads. Klik hier en de download start. Afhankelijk van uw internet browser wordt het installatiebestand lokaal opgeslagen.


Terug naar Inhoudsopgave



Basisinstallatie

Een Microsoft Windows gebruiker die in Microsoft Windows bekend is als een “Standaard gebruiker” kan Cadac TheModus installeren. 

 

Volg onderstaande stappen voor het installeren van TheModus:

  • Dubbelklik op het installatiepakket “TheModus.Revit.Addin.Installer”. De installatie start met een welkom scherm.
  • Klik [ Volgende ]
    U wordt gevraagd de licentievoorwaarden te accepteren.
  • Activeer [] 'Ik heb de licentievoorwaarden gelezen en ik ga hiermee akkoord.'
    De knop [ Installeren ] wordt actief.
  • Activeer [] 'Installeer als trail' als u een 'Trail' licentie heeft
    Laat deze inactief als u een 'vaste' licentie heeft
  • Klik [ Installeren ]
  • De installatie duurt enkele seconden. Er wordt voortgang getoond.
  • Zodra de installatie gereed is wordt dit getoond.
  • Klik [ Afsluiten ] om de installatie procedure af te sluiten.
    Cadac TheModus is nu geïnstalleerd.


Terug naar Inhoudsopgave


Trail, of de eerste keer opstarten

Zodra Autodesk Revit wordt opgestart, wordt ook TheModus opgestart.


Als u tijdens de installatie heeft opgegeven dat u gebruik maakt van een 'Trail' dan wordt eerst het 'trail'-scherm getoond. Zo niet dan gaat u rechtstreeks door naar het inlogscherm.


TheModus - Addin - Algemeen - trial.PNG


  • Geef uw naam, e-mailadres en bedrijfsnaam op.
  • Selecteer het gewenste product:
    • Essential
    • Professional
  • Klik [ OK ]
    U kunt TheModus 30 dagen als trail gebruiken.


Heeft u inmiddels een licentie en heeft uw beheerder u toegang verleend tot TheModus, klik dan bij het 'Trail'-scherm op:

[ Ik heb een licentie ]
Daarna wordt alles geïnitialiseerd. De volgende keer dat u opstart zal deze vraag niet meer worden gesteld.


Vervolgens kunt u inloggen op het inlogscherm:


  • Geef uw E-mailadres
  • Geef uw Wachtwoord
  • Klik [ Inloggen ]
    U kunt TheModus gebruiken.


Terug naar Inhoudsopgave



Update

Het is van groot belang dat de gebruiker altijd gebruik maakt van de laatste addin. Daarmee maakt u altijd gebruik van de meest recente features.


TheModus controleert zelf bij het opstarten op kritieke updates. Als blijkt dat er een kritieke update beschikbaar is wordt direct na het opstarten gevraagd of u de update wilt installeren. Als u dit niet doet zal TheModus tijdelijk uitgeschakeld worden in Revit. Dit ter voorkoming van ernstige storingen omdat de client en de cloud niet correct met elkaar kunnen communiceren. U kunt dan wel doorwerken met Revit. TheModus wordt weer actief zodra de update is geïnstalleerd.

 

TheModus kent 3 typen updates:

  • De verplichte update (1.x.x)
    In geval van een verplichte update is er altijd sprake van een verplichte wijziging in de addin vaak als gevolg van nieuwe functionaliteiten en/of wijzigingen in de cloud. Als dit van toepassing is, krijgt u een melding tijdens het opstarten van Revit zodra TheModus actief wordt. U moet de addin updaten. Als u besluit dit op een later tijdstip te doen, dan wordt de addin uitgeschakeld. U kunt dan wel gewoon verder werken met Revit met alle beschikbare content in het Revit project.
  • De niet verplichte update (x.1.x)
    In geval van een niet verplichte update is er doorgaans sprake van functionele uitbreiding van één of meerdere beschikbare features binnen TheModus. Bij een niet verplichte update krijgt u een melding tijdens het opstarten van Revit zodra TheModus actief wordt. U kunt ervoor kiezen om deze update op een later tijdstip uit te voeren. Met de huidige addin kan gewoon verder gewerkt worden.
  • Fixes (x.x.1)
    In geval van Fixes is er sprake van een storing in de addin of een minimale gewenste aanpassing of uitbreiding. Deze kan zeer specifiek zijn voor een bepaalde klant. U wordt niet automatisch gewaarschuwd bij het opstarten. U kunt wel altijd zelf controleren op updates, via het about scherm.

 

Beheerders kunnen in het register afdwingen of update meldingen wel of niet mogen worden getoond. Zie hiervoor de paragraaf “Informatie voor ICT”.

 

In geval van verplichte updates is het cruciaal dat beheerders ervoor zorgen dat TheModus bij de eindgebruikers up-to-date is. Indien een verplichte update niet heeft plaatsgevonden wordt de addin uitgeschakeld ter voorkoming van storingen. De gebruiker heeft dan geen toegang meer.

 

U kunt zelf controleren of TheModus up-to-date is. Volg onderstaande stappen om naar updates voor Cadac TheModus te zoeken:

  • Ga naar de knoppenbalk [ Cadac Revit ]
  • Klik op [ Help ] in het paneel [ Algemeen ] en klik [ Over ]
  • Klik [ Controleer op updates ]
  • Klik [ Update ]
    Het downloadproces van de meest recente addin start nu. Afhankelijk van uw internet browser wordt het installatiebestand lokaal opgeslagen.
  • Sluit Revit af om de update te kunnen installeren.
  • Wanneer u de vraag krijgt of u de update wilt installeren, klik [ Ja ]
  • Volg de stappen in het installatieproces.

 

Bij een update procedure gelden de volgende opmerkingen:

  • Indien een update procedure is toegestaan, worden de paden gerespecteerd zoals bij de initiële installatie is meegegeven. Deze paden worden uit het register gehaald
  • Indien een update procedure is toegestaan, moet de gebruiker schrijfrechten hebben op die plekken waar nieuwe informatie geschreven kan worden
  • Bij een update procedure worden de volgende mappen bijgewerkt zoals ingesteld bij:
    1. TARGETDIR, waar de programma bestanden staan
    2. CONFIGPATH, waar de configuratie bestanden staan 
    3. CONTENTPATH, waar de content definities staan 
  • Niet alle bestanden worden bijgewerkt. Er zijn enkele bestanden die de gebruiker of beheerder zelf zal moeten bijwerken. Deze bestanden kunnen namelijk aangepast zijn door gebruikers. Deze bestanden zijn:
    1. TheModus_COG_Mapping.xml
    2. MepSystemTypes.xml
    3. PipeDefinitions.xml
    4. Pipesystems.xml
    5. PipeTypes.xml
    6. RevitMaterials.xml
    7. AECSettings.xml
    8. TagSettings.xml
    9. TopLevel.xml


Terug naar Inhoudsopgave


TheModus Fonts

TheModus heeft speciaal voor de constructeurs een aparte set met paalfunderingssymbolen. Deze symbolen zijn als lettertype verwerkt in het TheModus Font File.

U heeft beheerder privileges nodig op uw workstation. Indien u deze niet heeft zult u contact moeten opnemen met uw systeembeheerder voor het installeren van deze font file.

 

Volg onderstaande stappen om de installatie software te downloaden en te installeren.

  • Open de verkenner en ga naar de configuratie bestanden. Standaard vindt u deze onder %localappdata%\Cadac Group\TheModus Revit Addin\Config\Main.
    Indien uw beheerder de installatie heeft uitgevoerd, kan dit pad anders zijn. Neem dan content op met uw beheerder.
  • Zoek naar TheModus.ttf
  • Dubbel klik TheModus.ttf
  • Klik [ Installeren ]
    De installatie wordt opgestart
  • De installatie gebeurt zeer snel. Sluit de voorbeeld weergave zodra de knop [ Installeren ] is uitgeschakeld.

Terug naar Inhoudsopgave


Installatie herstellen of verwijderen

Wanneer u Cadac TheModus wilt herstellen, volg dan onderstaande stappen: 

  • Dubbelklik op het installatiepakket “TheModus.Revit.Addin.Installer.msi”.
    De installatie start met een welkom scherm.
    TheModus - Installatie - installatie wijzigen.PNG

  • Activeer [] 'Repareer TheModus Revit Addin'
  • Klik [ VOLGENDE ]
    De voortgang wordt getoond.
  • Klik [ AFSLUITEN ]
    De installatie is hersteld.

 

Wanneer u Cadac TheModus wilt verwijderen, volg dan onderstaande stappen: 

  • Dubbelklik op het installatiepakket “TheModus.Revit.Addin.Installer.msi”
    De installatie start met een welkom scherm.
  • Activeer [] 'Deinstalleer TheModus Revit Addin'
  • Klik [ VOLGENDE ]
  • Klik:
    • [ JA ] om TheModus te verwijderen
      De voortgang wordt getoond
    • [ NEE ] om TheModus te behouden
  • Klik [ AFSLUITEN ]
    De installatie is verwijderd.
    Specifieke gebruikersinformatie wordt niet verwijderd.

Terug naar Inhoudsopgave


Informatie voor ICT

Paden bij een standaard installatie

Nadat een standaard installatie is uitgevoerd zijn de programma bestanden geplaatst in: 

  • %localappdata%\Cadac Group\Base Revit Addin. Hier staan alle standaard Autodesk Revit gerelateerde programma bestanden van Cadac.
  • %localappdata%\Cadac Group\TheModus Revit Addin. Hier staan alle TheModus specifieke programma bestanden van Cadac.

 

Voor alle relevante instellingen is er een apart configuratiepad, namelijk: %localappdata%\Cadac Group\TheModus Revit Addin\Config. Dit pad bevat enkele submappen voor de specifieke toepassingen. Het is noodzakelijk dat de gebruiker schrijfrechten heeft in deze mappen! De specifieke toepassingen zijn:


Pad:Omschrijving:
..\\CoGBevat de configuratiebestanden voor de Center of Gravity
..\\ContentBevat de configuratiebestanden voor het plaatsen van (eigen) content
..\\DocumentationBevat de configuratiebestanden voor de documentatie onderdelen
..\\Logfiles Bevat de logfiles
..\\MainBevat de functie overstijgende configuratiebestanden


Nadat bepaalde functionaliteiten de eerste keer worden gebruikt worden extra paden toegevoegd. Dit zijn:


Pad:Omschrijving:
..\\PatternsBevat de patroonbestanden voor de verdeelfuncties
..\\SortBevat de configuratiebestanden voor de structureerfuncties
..\\UserDataBevat de bestanden van de actieve gebruikers

 

Verder staan in de map %localappdata%\Cadac Group\TheModus Revit Addin diverse andere instellingen, te weten:


Pad:Omschrijving:
..\\ContentAlle content gerelateerde bestanden
..\\UserContentAlle content gerelateerde bestanden uit uw eigen bibliotheek
..\\LogsAlle logbestanden
..\\nl-NLAlle taal resources
..\\CacheAlle gebruikte UOB data
..\\CadContentAlle gebruikte UOB template objecten

 

In de map %localappdata%\Cadac Group\Temp\20xx worden alle tijdelijke bestanden opgeslagen.


Tevens zijn de .addin bestanden toegevoegd aan de daarvoor aangewezen locaties van Autodesk Revit.


Terug naar Inhoudsopgave


Register bij een standaard installatie

Nadat de installatie wordt voltooid, worden er instellingen weggeschreven in het register.

 

De meeste instellingen kunnen via de addin worden gewijzigd! 

Het is niet toegestaan instellingen rechtstreeks te wijzigen in het register. Dit kan leiden tot storingen! 

 

Gedurende de installatie worden de settings ingesteld.

  • Bij een 'User Installatie' wordt alles weggeschreven in:
    Computer\HKEY_CURRENT_USER\SOFTWARE\Cadac Group\TheModus Revit Addin\
  • Bij een 'Admin Installatie' wordt alles weggeschreven in:
    Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Cadac Group\TheModus Revit Addin\'

Afhankelijk van het installatietype worden vervolgens de volgende instellingen weggeschreven:

  • ..\Config\Messages, met daarin:
    • Messagelevel    
      • 0 = Geen updatemeldingen in Addin
      • 1 = Alleen verplichte updatemelding
      • 2 = Alle updatemeldingen
    • Loggingsettings
      • append="true"
      • filename="{path}"
      • maxparts="20"
      • maxsize="10240"
      • rotate="weekly"
      • reconnect="true"
      • reconnect.interval="5"
  • ..\Config\Paths, met daarin:
    • Admin:
      • 0 = User installatie
      • 1 = Admin installatie
    • InstallPath: Padverwijzing naar installatiebestanden (bij admin procedure)
    • ConfigPath: Padverwijzing naar configuratiebestanden (bij admin procedure)
    • ContentPath: Padverwijzing naarcontentbestanden (bij admin procedure) 
    • TempPath: Padverwijzing naar tijdelijke bestanden 
    • UserContentPath: Padverwijzing naar eigen contentbestanden 
  • ..\Config\User
    • Language
      • En-US voor een Engelstalige TheModus
      • nl-NL voor een Nederlands talige TheModus
    • LastDB: verwijzing naar de laatst gebruikte database
    • Visibility:
      • 0 = uitgegrijsde ribbonknoppen worden niet getoond in de ribbon
      • 1 = uitgegrijsde ribbonknoppen zijn zichtbaar
  • ..\Config\Web:


Verder worden in de Computer\HKEY_CURRENT_USER\SOFTWARE\Cadac Group\TheModus Revit Addin\ diverse sleutels weggeschrevn afhankelijk van het gebruik van de verschillende toepassingen. De belangrijkste kunnen worden gewijzigd vanuit het 'instellingen' menu in de addin.


Terug naar Inhoudsopgave


Deployment

Een systeembeheerder kan Cadac TheModus uit laten rollen aan de hand van een “deployment procedure”. De systeembeheerder moet in Microsoft Windows bekend zijn als een “Beheerder”

 

Via een deployment procedure kunnen afwijkende paden worden opgegeven.

 

Voor een deployment is het noodzakelijk om parameters mee te geven. Zie onderstaande welke parameters beschikbaar zijn:


ParameterOmschrijving

ADMIN

Geeft aan dat er gebruik wordt gemaakt van een administratieve installatie

TARGETDIR

Geeft het pad aan waar TheModus geïnstalleerd wordt

CONFIGPATH

Geeft het pad aan waar TheModus de configuratiebestanden kan vinden

CONTENTPATH

Geeft het pad aan waar TheModus de content bestanden kan vinden

USERCONTENTPATH

Geeft het pad aan waar TheModus de eigencontent bestanden kan vinden

TEMPPATH

Geeft het pad aan waar TheModus tijdelijk mag schrijven

MESSAGELEVEL

Geeft aan in welke mate update meldingen getoond mogen worden bij de gebruiker. Bij deze parameter zijn de volgende opties:

  • 0 = Geen updatemeldingen in de addin
  • 1 = Alleen verplichte updatemeldingen worden getoond
  • 2 = Alle updatemeldingen worden getoond

VISIBILITY

Geeft aan of eventuele uitgegrijsde knoppen in de addin mogen worden getoond. Knoppen worden uitgegrijsd als de gebruiker geen rechten heeft voor de feature. Bij deze parameter zijn de volgende opties:

  • 0 = Uitgegrijsde knoppen worden verborgen
  • 1 = Uitgegrijsde knoppen worden getoond


Indien gebruik wordt gemaakt van een deployment procedure zijn enkele opmerkingen van toepassing:

  • De installatie kan alleen plaatsvinden onder beheerdersprivileges;
  • De beheerder is zelf verantwoordelijk voor de inrichting van TheModus;
  • Indien de beheerder kiest om de automatische update te blokkeren, dan moet de beheerder zelf tijdig de update faciliteren;
  • Bij het faciliteren van updates, moeten altijd de oorspronkelijke paden weer worden weergegeven. Als dit niet gebeurt kan dit leiden tot storingen;
  • Er zijn opmerkingen over de update procedure. Zie het hoofdstuk Updates;
  • De log paden kunnen niet worden gewijzigd;
  • De gebruiker moet schrijfrechten hebben in de 'Config' paden;
  • Bij een deïnstallatie altijd dezelfde procedure gebruiken. Bij deïnstallatie blijven altijd registry keys achter onder de HKEY_CURRENT_USER.


Voorbeeld deployment

Met name voor testdoeleinden zijn onderstaande voorbeelden beschikbaar gesteld. Onderstaande paden en naam installatiepakket moet worden gewijzigd.

Verwerk dit commando in een “Batch” bestand!

 

Terug naar Inhoudsopgave

Voor een installatie:

d:

msiexec /i TheModus.Revit.Addin.Installer.msi ADMIN="1" TARGETDIR="C:\ProgramData\Cadac Group" CONFIGPATH="C:\ProgramData\Cadac Group\TheModus Revit Addin\Config\" CONTENTPATH="C:\ProgramData\Cadac Group\TheModus Revit Addin\Content\" TEMPPATH="C:\ProgramData\Cadac Group\Temp\" USERCONTENTPATH="C:\ProgramData\Cadac Group\TheModus Revit Addin\UserContent\" MESSAGELEVEL="1" VISIBILITY="0" /l*v TheModusPROInstall.txt 

pause

 

 

Voor het verwijderen van een installatie:

d:

msiexec /uninstall TheModus.Revit.Addin.Installer.msi ADMIN="1" TARGETDIR="C:\ProgramData\Cadac Group" CONFIGPATH="C:\ProgramData\Cadac Group\TheModus Revit Addin\Config\" CONTENTPATH="C:\ProgramData\Cadac Group\TheModus Revit Addin\Content\" TEMPPATH="C:\ProgramData\Cadac Group\Temp\" USERCONTENTPATH="C:\ProgramData\Cadac Group\TheModus Revit Addin\UserContent\" MESSAGELEVEL="1" VISIBILITY="0" /l*v TheModusPROInstall.txt 

pause


N.B.

Een deployment kan alleen worden uitgevoerd al su admin privileges heeft in uw Windows omgeving!


Terug naar Inhoudsopgave

Installatie procedure t.b.v. admin installatie o.b.v. script (*.bat)

Nadat het installatie script is gemaakt dient de volgende werkwijze aangehouden te worden:


  • Start de Commandprompt (CMD) middels 'Run as administrator/Als administrator uitvoeren';
  • Wijzig de folder naar de folder waarin het script (*.bat) staat. (CD Folder\Subfolders);
  • Geef de naam van het script;
    • Indien er een spatie in de naam zit dient de naam tussen " " opgegeven te worden.
    • Indien er geen spatie in de naam zit kan de naam zonder " " opgegeven worden.
      De installatie wordt uitgevoerd.
  • Na de installatie kan de Commandprompt worden afgesloten.


Terug naar Inhoudsopgave


Register na deployment

Nadat de installatie via een deployment wordt voltooid, worden er instellingen weggeschreven in het register. Zie hiervoor het hoofdstuk “Basisinstallatie

 

Indien de installatie plaatsvindt op administratieve basis dan worden de instellingen in het register gezet onder de HKEY_Local_Machine. De eerste keer dat een gebruiker zich dan aanmeldt wordt gecontroleerd of er instellingen beschikbaar zijn onder de HKEY_Current_User. Indien dat niet het geval is dan worden deze overgenomen vanuit de HKEY_Local_Machine voor deze (nieuwe) gebruiker.

Als de beheerder een nieuwe installatie uitvoert op administratieve basis, dan moeten de oorspronkelijke paden worden meegegeven. Gedurende een nieuwe installatie of update worden altijd de paden zoals beschikbaar in het register gerespecteerd. 

Indien een beheerder besluit andere paden te kiezen, dan moet de beheerder deze paden zowel in de HKEY_Local_Machine bijwerken, alsmede bij de HKEY_Current_User. Bij het opstarten van TheModus worden altijd de paden gebruikt zoals opgegeven bij de HKEY_Current_User.


Terug naar Inhoudsopgave



Bij Cadac maken we onderscheid tussen Sales, Service & Support. Sales & Service vinden wij vanzelfsprekend. Wij helpen u met de aanschaf van uw product, dienst, training of expert en zorgen ervoor dat u probleemloos aan de slag kunt. Gratis en voor niets. U kunt zorgeloos met uw software starten, wij zorgen ervoor dat u het meeste uit uw software kunt halen.

Loopt u tegen technische softwareproblemen aan? Dan kunt u gebruik maken van Cadac Support. Door de juiste informatie in te dienen kunnen wij u zo snel mogelijk helpen

Stel een vraag

Waar heeft u een vraag over?

Kies een locatie

Europa

Wereld