Configuration Issues
Change OTP Issuer Name
Issue When a user configures an authentication app, such as Google Authenticator, for OTP, the entry is saved in their app with the issuer name of Lenovo Software. Is it possible to customize the Issuer name to our institution? Solution As of ...
Tuning Linux Servers for UW/webNetwork Performance
The following changes will make sure Linux will clear unused connections faster: Important: This solution requires adjusting Linux kernel parameters. You should make a note of the original values so you can reset them if necessary. To reduce the ...
Linux server tuning
Question Are there suggested TCP parameters that should be changed on a Linux server running webNetwork? Linux Server OS out of the box should function properly with webNetwork. However, some customers have had to follow this information due to their ...
Tuning Windows Servers for UW/webNetwork Performance
We've found over time, that making the following changes to Windows allows for improved performance from Unified Workspace: Making sure UW is able to listen on the necessary ports by adding exceptions for the Java.exe and webNetwork.exe executables: ...
Configure Mail Service to use Gmail SMTP
ISSUE How to configure the Mail Service in Unified Workspace to use Google's SMTP server. SOLUTION Open webAdmin Dashboard. Expand SystemConfig. Select the MailConfig object. Configure the Properties tab as follows: Mail Service: Enable - checked ...
TIME_WAITs in Netstat report
ISSUE When I run a netstat, I see most of the connections to our UW server are in TIME_WAIT status. How can I get those to close and open ports for connection again? SOLUTION By default the TCP Timed Wait Delay is 240 seconds. When you find that ...
Remove SSO information for application in AppSelector database
Problem: The admin has created a webPass SSO tile that utilize Stoneware variables or hardcoded credentials. This tile is showing the webPass key image indicating the user needs to set credentials, due to an existing webStore application that uses ...
The server does not have a valid license file
The customer is getting the error on the login page that says: The server does not have a valid license file. This means that the customer has a limited license and has used up all of the slots. One quick way to use up all of the licenses is OSX ...
Unable to authenticate Relay user. Multiple authentication exceptions.
When applying a password policy or login policy, customer’s stand-alone relay(s) will not load properly. They are giving an Unable to authenticate Relay user error. ERROR (12/03) 15:05:42 [com.stoneware.service.application.Relay[relay-SWRelay1]]: ...
Debug relay startup problems.
1) If you have your loaders clustered, make sure the cluster status is in sync by using the 8090 management console and checking the cluster status. 2) Use the 8090 console on the relay to turn on com.stoneware.client.stonewareclient debug. When the ...
How to adjust webRDP compression - webNetwork
How to adjust webRDP compression in webNetwork 6.2.1.159 and higher. WebRDP utilizes a technology which compresses RDP traffic into a PNG image format. A default value has been set to provide both good compression and network payload size. WebRDP ...
Migrate webNetwork to windows / linux
To move from Linux to Windows on the same hardware: Backup the current install to cd, pen drive, network, etc... Be sure to TAR, ZIP, GZ the files before transferring them or you risk corruption. * Install windows * Make a c:\stoneware directory * ...
Windows server tuning
Question Are there any suggested TCP parameters that should be changed on a Windows server running webNetwork. Windows Server OS out of the box should function properly with webNetwork. However, some customers have had to follow this information from ...
Find the current running version of webNetwork
How can I find the current version of our webNetwork server? There are multiple methods for finding the current version of webNetwork on your servers. Look in webAdmin for the current Relay Version: Open webAdmin. Expand Utilities. Click "About ...
Connection refused to host : 127.0.0.2
Customer moved loader to a new box. The box was Linux and during the install of linux, it auto added a host file entry for 127.0.0.2 myserver.example-cloud.com This causes the loader to tell the relay that when it comes back to connect to loader use ...
Server stops periodically
Every few days the webNetwork server (aka loader) stops. Start it back up and it will run for a few more days. Suggestions 1) anti-virus server like Symantec 10 which has issues (with windows) and causes box to run out of ram and then windows kills ...
Growing the number of UW servers
Here is a document that shows a typical growth progression of UW servers.
Unable to authenticate admin user - Illegal key size
This means that the user is using a Java encryption level that does not match the license file being used. This can happen if a different version of Java is being used other than what is shipped with webNetwork. If this is the case then you have to ...
Port 443 / 80 not available on Windows server.
443 / 80 not available for webNetwork Customer installed webNetwork on a brand new Windows 2012 server and can't bind to port 443 because it is already in use. What is using it and how can I fix it ? Most likely the built in IIS manager has 443 ...
Dump Roles and Features on Windows server
Go into powershell and type : Get-WindowsFeature This will dump a list of the features installed on this server. If you want to narrow things down you can type something like : Get-WindowsFeature -Name web-server | Format-List -Property *
Backup / Disaster recovery for webNetwork
The customer wants to know what directory structure required for restore in a disaster recovery situation of both loader and relay? Stoneware is self-contained in the stoneware directory, so as long as you back up that directory on each server you ...
Antivirus on Unified Workspace / webNetwork servers
If you need to run an antivirus on a Unified Workspace (formerly webNetwork) server then you will want to make sure that you do not see any side effects. You will want to know what your Antivirus product is going to scan and what it will do when it ...
Bind to specific ip address instead of all addresses
How do I tell Stoneware to bind its services to a specific IP address? I’d like public ports (80, 443) to bind to a specific address on the machine, and administrative ports (8090, etc) There are a few areas where you will want to hard code it. ...
How can I delay the startup of webNetwork
The following information comes from Microsoft: http://support.microsoft.com/default.aspx?scid=kb;en-us;193888 In some computers, especially older systems and those with slower peripherals, it may be necessary to delay the loading of a specific ...
How to activate the JMX remote console
How can I activate the JMX remote console to debug what Java is doing? As of version 6.1 of Unified Workspace (formerly webNetwork), there is now a checkbox in the 8090 to dynamically turn on / off the JMX and does not require modification to the ...
System Check / Java Check fails or takes long time
After upgrading to 6.2.1.111 or higher when the system check runs I get the following stack dump java.lang.NullPointerException at com.stoneware.taglib.GetCurrentJavaVersion.processEndTag(GetCurrentJavaVersion.java:83) at ...
Unable to select swExternal-users context for Registration
Unable to select swExternal-Users context for Registration under the relay’s Authentication options. We can’t browse two directories for that feature, so we have the External Directory excluded, which is why it is grayed out. You can work around ...
IP Address change on Unified Workspace server
Issue: My IP numbers need to change for Unified Workspace servers. Solution(s): Depending on server configuration, you'll need to do the following. If you have a Relay and that server needs the IP address changed then you will need to : Test ...
Too many open files
There are a few things to check and these should be done on the server that is having the issue. If your webNetwork Server (loader) is having the issue then your webNetwork Relay won't start up because it would not be able to obtain a connection with ...