Cool Solutions

dsapp – Mobility Administration Tool

tdharris

By: and

April 12, 2013 9:56 am

Reads: 3874

Comments:17

License:
Created by Tyler Harris and Shane Nielson

download url: ftp://ftp.novell.com/outgoing/dsapp.tgz

dsapp.sh is designed to be a server-side tool aimed to help customers and engineers troubleshoot and solve common support issues for the Novell DataSync product according to KCS standards. Many of the features found in dsapp automate the processes defined in Technical Information Documents (TIDs). The purpose of this tool is to make these procedures simpler.

menu

Logs

  • Upload logs and server information to Novell FTP (TID 7014307)
  • Configure all logs to default or diagnostic/debug
  • Log capture (see test item’s flow through DataSync connectors)
  • Remove log archives to free up space (TID 7010533)

logs

Register & Update

dsapp

Database

  • Vacuum & Reindex (TID 7009453)
  • Backup & Restore (TID 7008163)
  • Re-initialize all users (special option)
  • Fix targets/membershipCache (TID 7012163)
  • CUSO+ (Clean-Up Start Over – refreshing the Mobility server TID 7014473)

3-databases

Certificates

4-certs

User Issues

  • Finds authentication issues, suggests steps to resolve (TID 7012048)
  • Remove user references (TID 7008852)
  • Check GroupWise Folder Structure (remotely)
  • List all subjects deleted by a specific device
  • Etc, etc.

5-users

Checks & Queries

  • Nightly Maintenance Check
  • Show Sync Status (shows queues according to log and events in pending tables)
  • View Mobility syncevents pending per user
  • View attachments per user
  • Check Mobility attachments (cleans up invalid, old, orphaned attachments)

checks

Command-line parameters (v119+):

Run dsapp with switches to automate tasks without the need of menu selections.

helpSwitches

 

We added two features in v138:

  1. dsapp autoupdate. dsapp will check for latest version on launch and update itself if needed. By default this is set to true, but can be turned off by configuring autoUpdate variable to false.
  2. dsapp alias. A permanent location has been set for dsapp.sh in /opt/novell/datasync/tools/dsapp/ You can launch dsapp anywhere by just entering the word dsapp in a terminal window.

We believe this can be an extremely helpful tool when working to troubleshoot and resolve problems with the DataSync application. There are more features we wish to include, but believe this is a great start.

Created by Tyler Harris & Shane Nielson.

VN:F [1.9.22_1171]
Rating: 5.0/5 (4 votes cast)
dsapp - Mobility Administration Tool, 5.0 out of 5 based on 4 ratings

Tags: , , , , , ,
Categories: Cool Tools, GroupWise, Mobility, Technical

Disclaimer: This content is not supported by Novell. It was contributed by a community member and is published "as is." It seems to have worked for at least one person, and might work for you. But please be sure to test it thoroughly before using it in a production environment.

17 Comments

  1. By:mconradt

    Will this still work with GMS 2.0 ?

    VN:D [1.9.22_1171]
    Rating: 5.0/5 (1 vote cast)
    • By:tdharris

      Absolutely! It supports GMS 2.0 and is still backwards compatible with 1.2.5 and lower.

      VN:F [1.9.22_1171]
      Rating: 5.0/5 (2 votes cast)
  2. By:hpcl

    Hello, thanks for this amazing tool. it has really brought down my headache in managing mobility servers.
    With GMS 2.0 update I have seen that a lot of issues have come up, including increased server resource utilization. I wish I could go back to good old v 1.2.5 build 499.
    I have one question: can we use dsapp with command line parameters to automate vacuuming and reindexing mobility system database. I will then feed this command to crontab, to be executed every fortnight may be??

    VN:F [1.9.22_1171]
    Rating: 5.0/5 (1 vote cast)
    • By:tdharris

      Great idea! We’ll start working on this. For the performance issue, take a look at TID 7013038 – Slow sync of Mobility – Master TID. That covers the most frequent causes for high utilization or low performance. I’d make sure Nightly Maintenance is completing and perhaps check disk i/o performance as a start. Again, thanks for the suggestion!

      VN:F [1.9.22_1171]
      Rating: 5.0/5 (1 vote cast)
      • By:hpcl

        As far as I know Nightly maintenance restarts gms services. I have infact queued up this command to run 3 times a day on crontab! Here’s the script. And that loop is to make sure that any datasync process is killed!

        #date time stamp
        echo $(date) >> /opt/novell/datasyncrestart.log
        echo ‘\n’ >> /opt/novell/datasyncrestart.log
        #stop datasync services
        /usr/sbin/rcgms stop >> /opt/novell/datasyncrestart.log

        #loop 1
        for ((count=1; count> /opt/novell/datasyncrestart.log
        echo ‘\n’ >> /opt/novell/datasyncrestart.log

        VN:F [1.9.22_1171]
        Rating: 0.0/5 (0 votes cast)
    • By:tdharris

      Added command-line switches to dsapp (v119+): see above for a screenshot. For details:
      ./dsapp.sh -h or ./dsapp.sh –help

      To run both vacuum and reindex, you can do either:
      ./dsapp -v -i OR ./dsapp –vacuum –index

      VN:F [1.9.22_1171]
      Rating: 5.0/5 (1 vote cast)
  3. version 113 doesn’t like ldap passwords containing ‘!’ when trying to fix membershipcache

    VN:F [1.9.22_1171]
    Rating: 0.0/5 (0 votes cast)
    • By:snielson

      Updated dsapp to v114 to fix this membershipcache issue.

      Should also not display password in clear text when typing the password now.

      VN:F [1.9.22_1171]
      Rating: 0.0/5 (0 votes cast)
  4. By:aporzec

    Hi, just updated to Mobility 2.0.1
    tried to run dsapp (used it before many times) and it is now asking me to enter the database password and or datasync_user password.
    I can find the passwords in the xml files, but they are very long and cryptic. I think if I am putting them in I will not put them in correctly.

    What can I do?

    VN:F [1.9.22_1171]
    Rating: 0.0/5 (0 votes cast)
    • By:tdharris

      GMS 2.0.x now encrypts password information for xml storage, so we are unable to retrieve them from the outside using the script. You must enter the db password in order to access db related functions in dsapp, you can skip that db check, but most functions won’t work properly, so we don’t suggest this. The encrpyted string won’t work when entered directly into the dsapp prompt. If you can’t remember the dsapp password, you can use the ./dsapp -db or ./dsapp –database to change the database password. This new feature works with GMS 2.0.x and only with dsapp v132+ (current is available on ftp).

      VN:F [1.9.22_1171]
      Rating: 0.0/5 (0 votes cast)
  5. By:hpcl

    I have one more suggestion. The user functions that are part of dsapp.sh accept the edirectory Id (employee number in my case) and not the groupwise Id.
    I also sometimes use mcheck.pyc, there it takes groupwise Id and not edirectory id.
    It gets so confusing at times. Why cant we have a search based on either of Groupwsie Id and edirectory id.

    VN:F [1.9.22_1171]
    Rating: 0.0/5 (0 votes cast)
    • By:tdharris

      Great suggestion, thank you! I believe we can handle this so it won’t matter which you enter, as it will check either case. We’ll look into this.

      VN:F [1.9.22_1171]
      Rating: 0.0/5 (0 votes cast)
    • By:Shane

      I’ve made some changes dsapp so it should look for the directory id first, and if not found will then try the groupwise id.

      This change has been put in v142+

      VN:F [1.9.22_1171]
      Rating: 0.0/5 (0 votes cast)
  6. By:hpcl

    remove user & db reference has stopped with GMS 2.0.1 :(

    VN:F [1.9.22_1171]
    Rating: 0.0/5 (0 votes cast)
  7. By:tdharris

    We added two features in v138:

    dsapp autoupdate. dsapp will check for latest version on launch and update itself if needed. By default this is set to true, but can be turned off by configuring autoUpdate variable to false.
    dsapp alias. A permanent location has been set for dsapp.sh in /opt/novell/datasync/tools/dsapp/ You can launch dsapp anywhere by just entering the word dsapp in a terminal window.

    VN:F [1.9.22_1171]
    Rating: 0.0/5 (0 votes cast)

Comment

RSS