DWP A - Cloning and Restoring DWP Basic/Advanced Environments

Version 1
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    PRODUCT:

    MyIT Digital Workplace


    APPLIES TO:

    DWP A 18.05 and beyond Don't use when: DWP 18.05 and beyond are installed on the same Tomcat as SmartIT



    DETAILS:

    NOTE: Don't use for Smart IT. This is meant for DWP only.
    SmartIT has a different architecture. Applications were separated from 18.05 and beyond.

    You need to update the below values in the new environment.

    A) ITSM Side

     

      1) Go to /SHR:SHR_KeyStore Form and do a search on any field using %  
    2) Take note of Secret and Token. You will need it for further steps.  
    3) Update hostname as needed, it should match with the new Environment. 
      

     NOTE: Make sure to update the hostname as needed. 
      
      
    B) DWP Tomcat Side
      
       
      1) Edit the below files 
       
       
    • /opt/apache/tomcat8.5/conf/Catalina/localhost/dwp.xml
    •  
    • /opt/apache/tomcat8.5/conf/Catalina/localhost/social.xml
       
      Update SQL/Oracle database details as needed 
       
      2) Edit the below file
       
       
    • /opt/apache/tomcat8.5/external-conf/connect-dwp.properties
       
      You should be able to see a few lines like this at the bottom:  
       
    api.token.                                               -- Step A.2 ~ Compare the values and update as needed  
       
    myit.server.host=  
    myit.server.port=  
       
    Update as needed 
      

      

    C) SQL/ORACLE Side
      
       
      Check that the cloned database has the new/right AR Server Name/Port/Password references. If not, update: 
      
      
    1) AR Server
       
       
    • Select * from DWP_Business.CONFIGURATION_PARAMS where KEY_NAME ='connect.arsystem.hostName' and VALUE = <Primary AR server name>  --this one is to check what the actual value is
    •  
    • update DWP_Business.CONFIGURATION_PARAMS SET VALUE= <AR LB Name> where KEY_NAME ='connect.arsystem.hostName' and VALUE = <Primary AR server name> -- this is how you fix it
      
      
    2) Port
       
       
    • Select * from DWP_Business.CONFIGURATION_PARAMS where KEY_NAME ='connect.arsystem.port'   
    •  
    • update DWP_Business.CONFIGURATION_PARAMS SET VALUE = <AR LB Port Number> where KEY_NAME ='connect.arsystem.port' and VALUE = <Primary AR Port> -- this is how you fix it
      
      
    3) AR System Password
       
       
    •     Select * from DWP_Business.CONFIGURATION_PARAMS where KEY_NAME ='connect.arsystem.password' and VALUE = <password> --this one is to check what the actual value is
    •  
    •     update DWP_Business.CONFIGURATION_PARAMS SET VALUE = <new password> where KEY_NAME ='connect.arsystem.password' and VALUE = <password> -- this is how you fix it
      
      
     4) Do the same for DWP_System.PROVIDER_SETTINGS , use the queries above for a reference.
       
       
    •  update DWP_System.PROVIDER_SETTINGS where  KEY_NAME like '%arsystem%hostname' SET VALUE= <AR LB Name> where KEY_NAME ='connect.arsystem.hostName'
    •  
    • update DWP_System.PROVIDER_SETTINGS where  KEY_NAME like '%arsystem%port' SET VALUE <port> where KEY_NAME ='connect.arsystem.port'
    •  
    • update DWP_System.PROVIDER_SETTINGS where  KEY_NAME like '%connect%password' SET VALUE = <new password> where NAME ='connect.arsystem.password'
      
      NOTE: you have to update hostname, port and password. 
      
      
    PROD and cloned encrypted passwords should match. If you need to reset it. This is only available on previous versions: DWP 18.02/ SmartIT 2.0
       
      If the password has changed then password has to be encrypted. for this you have to use DWP Installment Utility.  
       
        Go To : Program files -> BMC Software -> SmartIT/MyIT ->SmartITMaintTool -> SmartIT Maintenance Tool -> Right Click, run that as an administrator -> click on encrypt tab -> encrypt the password  
     
        Copy/Paste it and update with the above queries. 
              

                 
    D) DWP Admin Console Side
       
      Update the Pluggable Providers under  
     
      /dwp/admin/configuration/features.html 
       
    With the right AR Server, port and credentials where needed. 
      
      
    E) Mobile Apps
       
      If you are using mobile apps on your cloned enviroment, make sure to update the info.plist if needed  
    https://docs.bmc.com/docs/display/dwpbas18011/Deploying+clients 
      
      
      
    F) RSSO  
      You  also need to edit RSSO agents files and update the rsso-agent.properties with the new RSSO Server URL, sso-sdk.properties with the ignore-tenant=true. 
      
     
      Files location 
     
    (apache install directory)/external-conf/ 
      


    NOTE: If anything was updated, please restart Tomcat for the changes to take effect. 


    Confirm everything's working, if not. Collect the below logs in debug mode and reach out to BMC Support.  
       
    • MyIT: dwp.log, dwp-metadata
    •  
    • Tomcat: all current logs.

     


    Article Number:

    000169175


    Article Type:

    Product/Service Description



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles