content server · document management · enterprise connect · microso · records management · windows

Troubleshooting Enterprise Connect Client Issues

Earlier today I was asked to help troubleshoot an OpenText Enterprise Connect client issue in a pre-production quality assurance environment.  It appears that testers were experiencing issues trying to open or edit documents stored in Content Server with the new desktop client.  Today, the QA team was testing Enterprise Connect 10.5.2.178 with Content Server 10.5.0 and Enterprise Connect module 10.5.2.

The error being raised was:

Method ‘PrepareEditOpen’ not implemented for repository ‘CSTest2’

There was no problem accessing the test documents from the Content Server 10.5.0 web UI or via WebDAV.

Since the issue was showing up on the clients, I decided to turn on error logging in Enterprise Connect

Enabling Enterprise Connect Logging

1.Right-clicking the Enterprise Connect desktop icon.

2. Choose “Options” from the pop-up contextual menu.

3. When the Options window appears, click the “Logging Options…” button.

4. On the Logging Options page, check “Log Enabled” and select “Error” from the “Apply to All” drop down menu.

5. Set the “File Location” field to which ever folder works best for you.

6. Click the “Apply” and “Exit” buttons.  Close the Options window.

7. Logout of Windows and login in again to activate logging.

At this point, I reproduced the error trying to view a document in Content Server using the Enterprise Connect client.  when the error was reproduced, go back into the logging options and disable logging.

On my test machine, three logs were created: uc_explorer.log, uc_ucscore.log and uc_ucsync.log.  Open the uc_ucscore.log file in your favorite text editor.  I suggest Notepad++ over Notepad.

Scroll down to the bottom of the log to see the errors.  I found the following:

08:15:18.41 [UCSCORE    ](4588): ERROR: Could not get service.
08:15:21.58 [UCSCORE    ](4588): ERROR: Can’t query Office Editor Documents: Could not find a part of the path ‘C:\Users\[WindowsAccountName]\AppData\Roaming\OpenText\OTEdit\[CSInstanceName]\c2149\’.
.
.
.
08:16:27.62 [    ](4588): ERROR: WebEditRequest.GetDocumentInfo: exception.type=System.NotImplementedException; exception.message=Server not capable of Webedit.Unreserve;

During my investigation, I noticed that the \c2149\ folder was not created on my client.  Don’t get fooled by that error message.  The real clue was the next line:

exception.message=Server not capable of Webedit.Unreserve;

This error says that the Content Server webedit module can’t do it’s job.

To verify the problem was with the Content Server instance and not the Enterprise Connect client installed on the PC, I added another URL connection string to Enterprise Connect for a disaster recovery instance and tested the ability to open documents.  Enterprise Connect was able to open a copy of a test document that was in the DR instance just fine.  So, the problem was at the QA Content Server.

Taking a look at the installed modules, I quickly discovered that the OpenText Enterprise Connect, Email Services and Content Server Web Edit modules where all at version 10.5.0.  The Enterprise Connect client being tested as 10.5.2.

To finally resolve the issue, I backed up the OTHome directory (the path Content Server is installed into) and the SQL database and performed the upgrades to each of the modules to bring them up to version 10.5.2.  Once that was complete, the QA test clients were able to open, edit and update documents without further trouble.

apple · ios 9 · ipad · iphone · ipod touch

Thoughts Regarding the iOS 9 Public Beta

It’s that special time of year once again where we have been shown all of the wonderful software enhancements that Apple is cooking up for us this fall.  It is also the time when we, the brave nerds, install not quite fully finished software on our iDevices and Macs.  All of this is done in the name of being nerdy.

Actually, what I’m talking about is the pre-release public beta versions of Apple’s upcoming operating systems: iOS 9 and Mac OS X El Capitan 10.11.

Both of these new operating systems are still under development so it’s not fair to judge either of them on their technical merits, stability or performance.  The completed versions of both iOS 9 and El Capitan are due out “this fall.”  What I want to talk about here are some of the user facing enhancements in iOS 9.

Keyboards

Last year, one of the big ticket items in iOS 8 was Apple allowing third-party keyboards to be installed on iOS.  While having alternate keyboards available was fun, I dumped all of them inside a week.

This year, I’m far more interested in the tweak Apple has baked into the iOS 9 public beta: changing keyboard key cap states.  With iOS 8, I could never keep the Shift key state straight in my head: What was the CAPS mode icon state again? Solid white?  Or was that grey?  I can’t remember.  Better keep mashing the Shift key and retyping.  At least half the time while I was banging out a long text in Messages, a tweet in Twitter or a long email in Mail, I would get the state wrong.  So annoying!

In iOS 9, now the key caps change state depending on whether or not Shift is engaged or not.  Below is a sample of iOS 9 Public Beta 1 running on my iPhone 5S (left) and iOS 8.4 running on my iPhone 6 (right).

I think I really like that enhancement.

News and iCloud Drive

After installing iOS 9, you will get two new stock apps: News (as featured in the WWDC June 8 keynote) and iCloud Drive.

News appears to be everything Apple showed in the keynote.  I was really excited about News when is was unveiled during the keynote address.  As I said in my summary post on this year’s WWDC keynote, I think this will be a worthwhile feature for both the iPhone and iPad.  With Apple’s focus on user privacy, I think this could become the go-to alternative for things like Facebook Instant Articles.  The beta apps has lots of great articles from across the spectrum of publishers and topics.  I think the biggest challenge users will face is taking the time to fine tune their news feeds.

iCloud Drive, in my opinion, is a new iOS client app to help round out the features of iCloud document storage that launched as part of iOS 8 and OS X Yosemite last year.  With iCloud Drive, you now have access to the folders and documents that you have stored in iCloud.  iCloud Drive works similarly to Microsoft’s OneDrive or Google’s Drive iOS apps.

On the left, you can see the top level folder view for iCloud Drive.  On the right, you see the list view of the contents of the Keynote folder.  It’s pretty basic stuff to be sure, but is also a utilitarian feature that Apple needs to gain parity with Google and Microsoft.

iOS 9 will be released later this year and is expected to run on any iOS device that is already running iOS 8.

For more information about iOS 9, check out Apple’s iOS 9 preview website.

apple · ios 8 · ipad · ipad mini · iphone · ipod touch

Apple Rolls Out iOS 8.4 with Apple Music, Beats 1 Radio

At 11:00am EDT this morning Apple released iOS 8.4 bringing a redesigned Music app, launching the new Apple Music service with Beats 1 24/7 live radio and updates to the iBooks apps.

Below are the release notes for iOS 8.4.

iOS 8.4 Release Notes
This update introduces Apple Music—a revolutionary music service, 24/7 global radio, and a way for fans to connect with their favorite artists—all included in the redesigned Music app. iOS 8.4 also includes improvements for iBooks and bug fixes.
Apple Music
  • Become an Apple Music member to play from millions of songs in the Apple Music catalog, or keep them offline for playback later
  • For You: Members can see playlist and album recommendations, handpicked by music experts
  • New: Members can find the latest, greatest new music available—direct from our editors
  • Radio: Tune in to music, interviews, and exclusive radio shows on Beats 1, play radio stations created by our editors or create your own from any artist or song
  • Connect: See shared thoughts, photos, music, and videos from artists you follow, then join the conversation
  • My Music: Play from all of your iTunes purchases, songs from Apple Music, and playlists in one place
  • Completely redesigned music player that includes new features such as Recently Added, MiniPlayer, Up Next, and more
  • iTunes Store: Still the best place to buy your favorite music—one song or album at a time
  • Availability and features may vary by country
iBooks improvements and fixes
  • Browse, listen and download audiobooks from inside iBooks
  • Enjoy the all-new Now Playing feature, designed specifically for audiobooks
  • Books that are Made for iBooks now work on iPhone in addition to iPad
  • Find and pre-order books in a series right from your library
  • Improves accessibility of widgets, glossary and navigation in books made with iBooks Author
  • New default Chinese font
  • New setting to turn off Auto-Night theme in your library
  • Resolves an issue that may have prevented Hide Purchases from working
  • Resolves an issue that may have prevented downloading books from iCloud
Other improvements and bug fixes
  • Fixes an issue where receiving a specific series of Unicode characters causes device to reboot
  • Fixes an issue that prevented GPS accessories from providing location data
  • Fixes an issue where deleted Apple Watch apps could re-install
For information on the security content of this update, please visit this website:

iOS 8.4 can be installed on any current model iPhone, iPad and iPod touch.

apple · apple watch · ios · iphone · watchos

The Apple Watch – Part Three: Day-to-Day Usage

I’ve been struggling for a long time now to write a meaningful review of the Apple Watch. So many other well-respected writers, who are much better at their craft than I, have already written many pages about Apple’s new device. Yet here we are.

Rather than trying to talk specifically about Watch and watchOS, I think I’d much rather just talk about how it has integrated into my life and how I use it day in and day out.

The two most frequently asked questions I get about my Apple Watch Sport are: “Do you like it?” followed immediately by, “What can you do with it?”  So let’s get the answers to those questions out of the way first.

The answer to those questions are: Yes, very much so. As an Apple fanboy, I woke up at 3:00am to place my order with the hopes of getting it on launch day, which I did. The second is a very personal answer and will vary from user to user. I use my Watch primarily for: getting important notifications for text messages and email. I have replaced my previous fitness trackers with Apple Watch (more on that later). And, lastly, quick view apps like Weather, Phone, Wunderlist and Twitterific.

Setup and Configuration

Configuring your Apple Watch is a journey.  As a technology enthusiast, it was a road of discovery that I was looking forward to traveling down.  It’s not every day, or even every year, that an Apple fan like myself gets to play with something completely new.

As I showed in my last post about Watch, The Apple Watch – Part Two: Unboxing the Sport Edition, pairing and Apple Watch with an iPhone is a very simple process. It is the simplest process of pairing a device and a peripheral that I’ve ever had.  What came next can only be described as the excitement-fueled haze that came from eating too much candy at the summer fair as a boy.

Apple Watch runs watchOS, is believed to be a variant of iOS 8.2. Much like the original Apple TV runs a variant of Mac OS X 10.4 Tiger, watchOS and iOS are not exactly the same thing. Knowing how to use one does not mean you automatically know how to effectively use he other. And so, as a new Watch owner I was forced to do the one thing that any wife or girlfriend will tell you that men had to do: read the directions. (Stopping to ask for directions was the number one answer until we all started carrying iPhones with us everywhere; but I digress.)

The fold out instruction sheet gives you all of the basics about how to use the Watch, but I didn’t quite feel that I fully understood how to use it.  Only the basic of settings can be controlled on from Watch. For the heavy lifting to configure Apple Watch, you really need to use the Apple Watch app on your iPhone. From there, you can do the real configuration work for settings up Notifications, Glances, your synchronized Music playlists, synchronized Photos albums, Apple Pay and third-party applications. That can seem a bit overwhelming, event to a seasoned Apple fan. To really understand how all of these things work you need to spend time playing with Watch and it’ companion iOS app.

I chose to tackle Notifications first since it was one of the two main reasons why I chose to get Apple Watch. (The Workout and Activity apps are the second.). I found that the out of the box option of ”Mirror my iPhone” was too broad and that I was getting notifications on my wrist for things that I really didn’t find all that important. My time, as yours, is too important for just any app to interrupt you. So as I started using Apple Watch over the initial two-week period, I found myself constantly adjusting the notifications until I found a balanced that worked for me. What’s important to me and important to you are probably vastly different, so I won’t list out my configurations here.  What I will say is that key take away for me is what that only the most important information make it from the phone in my pocket to the watch on my wrist.

The Workout and Activity Apps

As I said earlier, the Workout and Activity apps, together, made up the second reason why I wanted and Apple Watch. You see, before getting Apple Watch, I was using a Nike+ FuelBand and the Jawbone UP. Both are good devices in their own ways.  Nike has undeniable consumer brand recognition just like other iconic brands like the Walt Disney Company and the Coca-Cola Company.  But they never quite pulled off the illusion of complete integration with my iPhone and iOS. With Apple Watch, everything is seamless and just works.

I would say that I’m not a fan of exercises nor do I enjoy going to the gym. I’m more like that guy on TV who goes around from greasy spoon to greasy spoon trying to stuff his face with the largest what-ever-it-is for this week. But I do want to try to be healthy and keep as much weight off as I can and so I do like to go out for walks when the weather permits.

When getting started with the Workout app, Apple advises you to bring your iPhone with you. That way, Watch can calibrate how you walk or run more accurately and track how far you’ve gone.  From my very unscientific comparison of the data collected by my Jawbone UP as compared with the data collected by the Workout app and reported in the Activity app, I can say things are ‘close enough.’  Some people have reported that stand-alone devices that have their own integrated GPS receivers do a better job of tracking activity and distance while exercising outside. That criticism may have been true. When Apple released watchOS 1.0.1 back on May 19, distance and pace of outdoor activities was one of the featured enhancements.

Overall, I’m pretty happy with the Workout and Activity apps. I have added Activity “complication”, that the watch world’s fancy name for the computing world’s “widget”, to the bottom center slot of the Modular watch face that I use. It helps me “gamify” my daily activity to reach my goal of filling in all three activity rings daily.

Third-Party Apps

Apple Watch had a large selection of apps available on April 24 then it officially launched.  The trick, however, is finding good apps.

watchOS 1.0, now updated to watchOS 1.0.1, runs all of the third-party apps as “projections” from the iPhone it is paired with.  Apple Watch doesn’t have it’s own app store.  iPhone apps that support the Watch install small applications – like Mac OS X Dashboard widgets – on to the iPhone.  When you run an app on the Watch, it connects to the iPhone over Bluetooth or Wi-Fi and displays the information from the iPhone on the Watch.  I won’t call it a “cheat” necessarily, but what you will see is the “I’m busy” spinner on the Watch while information is being retried from the iPhone.  This back and forth can be a bit laggy at times and frustrating.  Just the other day I got tired of waiting for the Weather app to launch on Apple Watch and I pulled out my iPhone and checked the forecast before the Watch was able to update.  While these kinds of problems can be annoying or inconvenient at times, many of us who are using the Watch today are early adopters.  Apple will surely work to improve performance over time.  Look for the first signs of improvement later this year for the release of watchOS 2.0.  In that update, Apple will be giving software developers more access to the hardware resources and the ability to run apps natively on Watch.

My best advice to you is to try out the Apple Watch apps that are extensions of the apps you use on your iPhone.  My rule of thumb is to limit the number of apps that I have installed to a bare minimum.

For example, I like to read the Wall Street Journal and the New York Times on my iPhone or my iPad.  But I don’t want notifications for breaking stories on my wrist, nor do I care to even try to read a news summary on a 42mm screen.  Those kinds of apps, for me, are just impractical.  Your needs will vary from mine.  For me, I’ve chosen to use just a handful of apps, including: Overcast, Twitterific, Wunderlist, and Starbucks.  That’s it.  Of the four, I use Overcast and Wunderlist the most.  Wunderlist, which has my list of things to buy at the grocery store, just works so well for me when I’m shopping.  The iPhone stays securely in my pocket and I have fast access to my shopping list simply by raising my wrist.  Nothing gets dropped, scratched or forgotten.

Siri, Dictation and Making Calls

The Apple Watch doesn’t have a keyboard.  When you need to reply to a text message, my primary use case, I do with Siri dictation.  Yes, you kinda look like the cartoon character Dick Tracy, but hey, that’s cool, right?  I’ve used Siri dictation all over the place.  For the most part, Siri gets the job done, but just like on the iPhone and iPad sometimes Siri just can’t pick up the works I’m dictating correctly.  On those occasions, I’ve had to pull out my iPhone…or I’ve used Siri to place a call from Watch.

Making calls from your Watch makes you look and feel like the aforementioned Dick Tracy.  I usually only use this feature in my office, from the car, or when I’m not in a crowded location.  Social etiquette aside, when in a noisy environment, I’ve found it hard to hear what the other person is saying and find myself holding the Watch closer to my ear, and well, that starts to sound a lot like a use case for the iPhone or better yet, to call the person back later.

Battery Life and Durability

I had two major concerns when making the decision about buying the Apple Watch without ever having played with one.  How long will the battery last and will I need multiple charge cables at home and at the office?  And, how long would it be before I scratched the hell out of the screen.

I’m happy to report that both concerns now look silly two months into my daily use of Apple Watch.  Yes, using the Workout app causes the battery to drain more quickly when the heart rate sensor is sampling data more frequently and the Watch is checking distance and speed by poling the iPhone’s GPS.

If I’m being really lazy, and I don’t do my 30 minutes of exercise, at the end of the day, my 42mm Sport has around 50-60% battery life left.  If I do get out and get my 30 minutes of exercising in, my battery will get down to about 20-30%.  Recently, while on vacation with the family, we went on a 14-mile bike ride along the Cape Code Rail Trail.  We were out on the ride for about an hour and forty minutes.  The whole time the Workout app was going full tilt tracking my heart rate, speed and distance.  In other words, the Watch was in constant contact with my iPhone for the whole time.  At the end of the ride, my battery was down to about 10%.  It was in the low 90’s when I started.  To save power until I got back to the house, I put the Watch into Power Reserve mode.

I’m also happy to report that my Watch is still 100% scratch, ding and knick free.  I’m not saying that the Watch can “Take a licking and keep on ticking” as the old ad slogan goes.  What I will say, is by all rights, my Apple Watch Sport should be in really bad shape.  I’ve smacked it into three large office file cabinets, metal storage and server racks, metal lawn chairs…the list goes on and on…and nadda.  No scratches.  No pits. Nothing.  Mileage will vary, but if you are careful of your surroundings, you should be fine.

Early on, I purchased a screen protector for the Ion-X display.  Don’t waist your time and money on them.  The fit was horrible and I only left it on for about 45 minutes.

Parting Thoughts

All-in-all, I really like my Apple Watch and it has integrated into my day-to-day Apple centric lifestyle and workflow.  The Watch is a more personal type of device than your iPhone, Mac or iPad is and so how it gets used will vary from person to person.  I don’t expect the Apple Watch to be replacing an iPhone any time soon.  There are still plenty of uses that demand a larger screen – the iPhone 6 Plus is proof of that.  But the Watch really does let me quickly check the incoming notification and make a decision to take action now or later.  The watchOS 2.0 update, due out later this year, will add a fresh batch of features and functionality.

While not every iPhone owner needs an Apple Watch, the Apple Watch will only work with an iPhone so take that into consideration before placing your order.

If you are considering buy and Apple Watch, I encourage you to go to the Apple Store.  Play with the demo units.  Try on the bands to see which one you like the best.  When you are ready, place your order via the online Apple Store.

For more information, visit the Apple Watch website.