IBM Client Self Assist

Problem:

After restart Docs server, it is found that most of spreadsheet document can’t be opened in Docs. This function used to work fine.

In Conversion logs, it shows:

[9/13/18 11:07:02:669 CST] 000000c5 Job           E   /opt/IBM/docs_data/job_cache/default_org/job_cache/123/411/124318145/4cccf7021ccaddd86c0aed79280edd7/error.json

                                 com.ibm.concord.job.exception.JobExecutionException: com.ibm.concord.platform.exceptions.ConversionException: Exception occurred with error code: CLFAD1209, message: The file extension mismatches with the content of the document, and additional data: {"target":"\/opt\/IBM\/docs_data\/draft\/external.rest\/default_org\/draft\/123/411/124318145/4cccf7021ccaddd86c0aed79280edd7\/concord","correctFormat":"unsupported null","detail_msg":"Invalid document type: asFormat=unsupported null","jobid":"2a0fcccc-79d0-4cfd-952e-7cc97969c5fe","source":"\/opt\/IBM\/docs_data\/draft\/external.rest\/default_org\/draft\/307\/450\/169118145\/temp\/673548f1-a1db-4ed4-883e-95a8eaaacd82\/contentfile.xlsx","native_err_code":415}

               at com.ibm.concord.job.object.ImportDraftFromRepositoryJob.exec(ImportDraftFromRepositoryJob.java:181)

Environment:

2.0 CR3 IFIX004

Diagnostic:

Enable Trace for Conversion server , set com.ibm.symphony to FINEST.

In trace, it shows:

[9/13/18 15:24:52:665 CST] 0000011c MSOfficeOOXML 2   The source file is not a valid zip file.

This info indicate that there is something wrong with source file.

Run test against:

media_meta_url and media_get_url (these two URL can be found in concord-config.json file)

Through test, it is found that meta can be opened, but fail to download from file repository via media_get_url

Cause:

Docs uses API to get files from 3^rd party file repository, when get the source file failed. It would cause Docs to fail to open the specific format document.

Solution:

Ask 3^rd party file repository engineer to fix their repository issue and make sure file can be download via API and the downloaded zip file can be opened without any issues. Then, Docs shall work.

Problem:

In IBM Connections 6.0 CR2 or previous version, Rich Content widget misses its title if the viewer is anonymous or a member of the community.

Environment:

6.0 CR2 or previous 6.0 version.

Cause:

This is a known issue caused by “the h2 text would be hidden unexpectedly”

Solution:

Upgrade to 6.0 CR2 if your Connections environment is not at the this level.

Then, follow below step to enable communities-rich-content-widget-show-title-to-members :

1. Use a user who has  Common Admin Role to login to Connections page(for example Homepage). If you don’t know how to add a user to Admin Role for Common, please refer below documentation:

              https://www.ibm.com/support/knowledgecenter/SSYGQH_6.0.0/admin/admin/t_create_admin_blogs.html

2. Then, access below URL:

              http://<ServerName>/connections/config/highway.main.gatekeeper.tiles

              (Note: If you have authentication issue, try to add Admin Role of Homepage,Common and Community to the same user, then try to access gatekeeper page)

3. On Gatekeeper page, find “communities-rich-content-widget-show-title-to-members” and click Edit.
4. Set the value to “True”, then save the option.
5. Restart Common, Homepage and Communities app to let the new setting takes effect.

Problem:

In Some scenario, after remount Network Shared Drive. Docs can preview documents but fail to edit it. It shows "Docs service is not available" on the web page, "com.ibm.concord.draft.exception.DraftDataAccessException: Exception occurred with error code: CLFAD1601, message: cannot access the draft data, and additional data: {"detail_msg":"Read or write draft meta file error","draftDesc":"default_org 12343314-293b-4ed1-92bb-4444228d7a2e E:\\cdata\\docs_data\\draft\\default_org\\draft\\912\\251\\12343314-293b-4ed1-92bb-4444228d7a2e}" on server side.

Environment:

Docs 2.0 or higher version.

Cause: (if applicable)

Review Network Shared Drive privileges, you can see that the authentication had been changed between two mountings. This cause Docs fail to open related folders on network shared drive. 

Solution:

There are two temp solution:

1. Download the issue document, then delete the original one in Connections Files. Re-upload document back to Connections Files.

2. Go to docs_data on Network shared drive. use Document ID to locate the specific folder for this document, then, delete msg.json ,meta.json of inside that folder.

Problem:

It is found that if the content is more than around 600  Chinese characters in an Activity description of an Entry, it failed to be saved.

Environment:

Connections 5.0, 5.5, 6.0

Cause: 

Activity description will be saved into ACTIVITIES.OA_NODE table Description column. The default length for this column is 2048 bit. Which mean, it can store 666 Chinese characters at the most. If including punctuation and spaces, it would save less Chinese characters.(one Chinese Characters will take 3 bit when Language is set to GTF-8)

Solution:

It is suggested not to input so many characters. If customer has such requirement, they can consider to add details to a document then attach to this Entry.

Problem:

During the maintenance, customer found that their CCM server fails to start.

There is no change to their servers.

Environment:

Windows 2012

Cause: 

CCM server Java process hangs in the back end, and fail to be shut down. And it also cause new CCM process fail to start.

Solution:

Kill the Java process or reboot hosting OS will resolve this issue.

活动名称

IBM智慧服务开发大赛

活动规则

报名截止日期：2018年7月31日

项目时间 ：2018年7月31日至2018年10月31日 

1. 以团队方式报名，每个团队2-4人，并选出队长一人，组员2-3人。

2. 队长负责收集团队成员的信息，请填写报名表，并发送到指定地址。具体信息请扫描海报右侧二维码获得。

3. 队长负责项目的进度报告和沟通过程，项目开始后，如果有人员变动，允许更换队长和补充队员各一次。

4. 项目代码在Github上进行托管，交付时，交付的文档和代码都应保存在Github上，并使用MIT License。

5. 项目到达截止日期时，IBM专家将对所有项目结果进行评审，优胜队伍的成员将会获得额外奖励。

你的收获

1. 学校和IBM双重认可的实习经历，IBM出具的实习经历证书。

2. IBM Executive的亲笔中英文推荐信。

3. 获得行业领先的软件设计方法（Design Thinking）和敏捷开发方法的指导。

4. 体验和理解国际公司的工程师文化和人才要求，增加自己的国际化视野，帮助自己建立良好的职业发展规划。

5. 优胜队伍将获得额外奖励。

报名方式

队长负责收集团队成员的信息，请填写如下报名表文件，并发送到邮箱 huangyp@cn.ibm.com 。

报名表.xlsx|View Details

项目列表

1. 针对IBM产品Detail System Requirement 知识的问答系统|View Details

2. 利用已有故障分析报告进行自动故障诊断的多轮问答系统|View Details

3. 自然语言理解中时间表达方式的识别和转换|View Details

4. 使用图片区块识别技术进行网页清洗方法|View Details

5. 基于现有知识库的自然语言校准系统|View Details

6. 自然语言多轮对话中上下文的识别与分类|View Details

Problem:

How to change Language of IBM Docs (On-Prem Version)

Cause: 

IBM Docs only follow Browser Language settings.

Solution:

Change Browser Language settings in each supported browser will get IBM Docs Language changed.

Problem:

Some users can't get policies even default policies that is defined on SSC.

Environment:

Sametime 9.0.1

Diagnostic: (if applicable)

1. Use issue user to login with Sametime Client that other user can get the default policies.  This issue user still can't policies.

2. Check SSC logs, it shows fail to update db POLICY.ASSIGNMENT

Cause: (if applicable)

The essence of the problem is that the STSC database - in the assignment table - the column size is 128 - it appears the records that are stored (the assignment usernames) are 'really close to that size'
 

Solution:

Change Table length to a bigger value:
ALTER TABLE POLICY.ASSIGNMENT
ALTER COLUMN USER_ID SET DATA TYPE VARCHAR(256);

1. From {DMGR_Install_Root}/config/cells/{Cell_Name}/IBMDocs-config/,

  "build-info": {

    "build_version": "2.0.0.3",

    "build_description": "IBM Connections Docs 2.0.0",

    "ifix_version": 25,

    "product_name": "IBM Connections Docs",

    "build_timestamp": "20170331-1216"

  }

  for concord-config.json, viewer-config.json and conversion-config.json, modify "build_version" from  "2.0.0.3" to "2.0.0" manually.

2. Add Docs, Conversion and Viewer Nodes, follow this –https://www.ibm.com/support/knowledgecenter/SSFHJY_2.0.0/deploy/add_new_nodes_into_connections_docs_clusters.html

After this, Docs, Conversion and Viewer Applications are already CR3, we just need to upgrade Conversion binary file.

3. Upgrade Conversion Server.

Copy the file [CR3_Package]/DocsConversion/docs_remote_installer.zip to the Conversion server you just added. Extract it to directory [DOCS_REMOTE_INSTALLER], for example, C:\temp\docs_remote_installer. Make sure that UAC(User Account Control) on Conversion server.

From Start, run cmd.exe, and then run command:

a. cd [DOCS_REMOTE_INSTALLER]\installer\

b. upgrade_node.bat --installroot [CONVERSION_INSTALL_ROOT] --symcount

[SYM_COUNT]

• [CONVERSION_INSTALL_ROOT] is the install directory of Conversion, you can get it

through WebSphere Console > Environment > WebSphere variables >

CONVERSION_INSTALL_ROOT

• [SYM_COUNT] is the number of symphony instances, you can get this by counting how

many inst* in [CONVERSION_INSTALL_ROOT]\symphony. Usually it is 4 or 8, but

you should confirm it by yourself.

c. Check fixpack.log in directory [CONVERSION_INSTALL_ROOT]\logs\.

4. Do the same from Step1 to Step3, if you want to add more nodes.

Problem:

In Some scenario, customer has to self-build schedule task for Docs.  how to check if it is working fine

Solution:

Try to open a task manager or prompt, kill soffice instance, check few minutes later and see soffice auto start again.

Problem:

Number of pages of docx file is different between IBM Docs and Microsoft Word

Environment:

Docs on cloud

Solution:

This is working as design.

The composing format is different between Docs and Microsoft Office.

The line height defined in Docs Document Paragraph is different from the Office Word's.  That may cause different lines in one page between Docs Document and Office Word.

Workaround: insert a page break when there needs a new page.

Problem:

It is found that some of users can't access to specific Library files. These files can be accessed by other users.

Environment:

Connections 5.5 CR2

Solution:

Stop Server and Nodeagent.

Clear Server Cache. (Both Temp and wstemp folder but keep these two folder)

Relevant links:

https://developer.ibm.com/answers/questions/200115/how-do-i-clean-the-websphere-application-servers-c/

Problem:

Customer wants to customize URL of Connections Social Cloud from apps.na.collabserv.com to some URL like connectoins.test.com

Environment:

Connections Social Cloud S2

Solution:

IBM doesn't support support customize URL of Connections Social Cloud URL

Problem:

When launch Sametime client v9.0.1.1 hotfix dated 2017-12-12
(9011-ST-Client-FP-GSAI-AUH33Z) on XenDesktop
User get this error:
Sametime audio and video is unavailable. Ask your administrator to
update your media engine

Environment:

XenDesktop server version: v7.15                                        
Citrix Receiver version: v4.9 

Sametime Media Engine version:  9.0.1HF_2016-06-24
Sametime client version Standalone 9.0.1_20171212
(9011-ST-Client-FP-GSAI-AUH33Z)
End user local machine OS Windows 7 Professional SP1 (64 bit)

Troubleshooting:

The prompt message is different in various scenario:

• No software installed:
  Audio and video is unavailable.
  Contact your administrator to install the necessary software.
  [Continue without installing]
• Old version installed:
  Audio and video is unavailable. Ask your administrator to update your Media Engine.
  [Continue]

Solution:

Open a service request and request to obtain and install hotfix JSMH-AWLMYF to resolve this problem.