Fishbowl Anywhere

From Fishbowl
Jump to: navigation, search

Icon.Fishbowl Anywhere.png The Fishbowl Anywhere module, located in the Setup group, is an add-on module that can be installed from the Small.Plugin.png Plugin module. After configuring the plugin, any web browser can be used as a Fishbowl Client, even if Fishbowl isn't installed on the computer. It's also possible to connect from any smartphone or tablet, although screen size may cause some limitations.

Fishbowl Anywhere.png


Video

The documentation on this page is for the most recent version of the Small.Fishbowl Anywhere.png Fishbowl Anywhere plugin. To get the most recent version, Update Fishbowl.

Install

  1. In any Fishbowl Client, open the Small.Plugin.png Plugin module, located in the Integrations group.
  2. Select the Small.Fishbowl Anywhere.png Fishbowl Anywhere plugin and click Install Now.
  3. Completely close all Fishbowl Clients.
  4. Exit the Fishbowl Server by right-clicking the Fishbowl Server tray icon and selecting Exit.
  5. After re-opening the Fishbowl Server, the admin user can access the Small.Fishbowl Anywhere.png Fishbowl Anywhere module from any Fishbowl Client by opening the Setup module group.
  6. To grant access to additional users, assign the Fishbowl Anywhere-View access right to the appropriate groups in the Small.User Group.png User Group module

Setup

Fishbowl Anywhere Setup.png
The Small.Fishbowl Anywhere.png Fishbowl Anywhere module is simply used to configure the Fishbowl web server. After completing the setup, users will be able to use a web browser to connect to the Fishbowl Server.
  1. Open a Fishbowl Client, preferably on a computer other than the Fishbowl Server. If the link begins with localhost, it will only work from the server computer. Instead use the name or IP address of the Fishbowl Server. For more information, see address.
  2. Open the Small.Fishbowl Anywhere.png Fishbowl Anywhere module.
  3. Select the Checked.png Enable Fishbowl Anywhere checkbox.
  4. Enter a portal password and confirm the password.
  5. Click the Save Button.png Save button
  6. Right-click the Fishbowl Server tray icon and select Exit. Then restart the Fishbowl Server.

Client Memory

The server computer handles most of processing and memory needed for each Fishbowl Anywhere client. Each time a user connects from a browser, more resources will be used on the server computer. The Client Memory setting controls how much server memory is allocated to each client. 512 MB is the recommended setting in the Small.Fishbowl Anywhere.png Fishbowl Anywhere module. If many users are utilizing Fishbowl Anywhere simultaneously, it may be necessary to add more memory to the server computer.


Login

Any web browser can now be used as a Fishbowl Client to connect to the Fishbowl Server. To access Fishbowl from outside the local network requires additional configuration.

  1. Click the link at the top of the Small.Fishbowl Anywhere.png Fishbowl Anywhere module, or enter the address into any web browser. If the link begins with localhost, it will only work from the server computer. Instead use the name or IP address of the Fishbowl Server. For more information, see address.
  2. Enter fishbowl as the user name and the portal password selected during setup. The password will be fishbowl until a new password is created. Click Sign in.
    Fishbowl Anywhere Portal Login.png
  3. Select the Fishbowl Client or Checkout.
    Fishbowl Anywhere Select Application.png
  4. Enter the credentials of any Fishbowl user and then click Login.
    Fishbowl Anywhere Client Login.png

Tips

  • Don't use a browser address that starts with localhost. Instead use the name or IP address of the Fishbowl Server. For more information, see address.
  • If Fishbowl Anywhere works on the server computer, but not on other devices, the address or firewall may need to be adjusted.
  • When using Fishbowl Anywhere, some actions, such as printing a report, or clicking a How To button will open a new tab in the browser. Some browsers will prevent pop-ups and block these actions. In Chrome, for example, a blocked pop-up icon will appear on the right-side of the address bar. Click the icon to see the blocked windows. Clicking a blue link will open the blocked window, or selecting Always allow pop-ups will allow future windows to open automatically.
    Allow Chrome Pop-up blocked.png
  • The size of the Fishbowl Anywhere client can be changed with the zoom level of the browser. If part of Fishbowl is being cut-off, zoom out in the browser. In most browsers, this is done by holding the Ctrl key and then pressing the - key. In some cases, it may be necessary to click in the address bar of the browser first, to avoid the keyboard shortcut being processed by the client.
  • To use Fishbowl Anywhere on a Mac server, click here.
    • If you are seeing a flashing screen after logging in on a Mac with Safari, iPad, or iPhone, try using http instead of https. Safari seems to have issues with https connections.

Server address

Login dialog.png
The link at the top of the Small.Fishbowl Anywhere.png Fishbowl Anywhere module is created using the Server Address field from the login dialog. Any address that contains localhost will only work from the server computer. Instead, use the IP address of the Fishbowl Server computer. This can be found by using the link from the Small.Fishbowl Anywhere.png Fishbowl Anywhere module of a computer other than the Fishbowl server, or by clicking the Search Icon Button.png Find Fishbowl Servers button in the client login dialog.

These example URLs must be modified to match the actual Fishbowl Server address. The default HTTP port is 28182 and the default HTTPS port is 28282.

Some iOS devices may not be able to connect to Fishbowl Anywhere when using HTTPS.

  • INTERNAL/LOCAL/PRIVATE - These addresses can be used when the device is connected to the same network as the Fishbowl Server.
    • Local computer name: http://MyServerComputerName:28182
    • Local IP address: http://192.168.2.166:28182
  • VPN - A VPN can be used to access Fishbowl from anywhere in the world, using the local addresses listed above.
  • EXTERNAL/INTERNET/PUBLIC - A firewall can be configured to allow incoming connections from anywhere in the world. Since IP addresses can change from time to time, it is easiest to use an address or name that won't change. For example, this could be done by purchasing a static IP address from an internet service provider, and configuring the Fishbowl Server computer to always use that external IP address. When multiple devices are connected to the same router, it may be necessary to configure port forwarding to direct traffic to the Fishbowl Server. A static IP address typically involves a monthly fee to the internet service provider, whereas there are free solutions for dynamic DNS.
    Fishbowl recommends consulting with an IT professional to ensure that everything is configured properly and securely.
    • Static IP address: https://173.194.115.1:28282
    • Domain name: https://my-domain-name.com:28282
    • Dynamic DNS: https://my-dynamic-dns-name.com:28282

Troubleshooting

  • Assistance from a Network specialist is highly recommended throughout the setup process.
  • Anywhere works best with a VPN or Static IP set up, which, when configured correctly, would also facilitate using a normal Fishbowl Client.
  • Fishbowl Anywhere is only designed to operate with a single Fishbowl server per computer. Multiple Fishbowl servers will need to separated out to unique hardware per Fishbowl Anywhere instance.
  • Benefits of using Anywhere: iOS devices and resource-poor computers (i.e. Chromebook, MacBook Air) can access a client using the server’s resources.
  • Have a network specialist assist in opening Fishbowl’s ports through the firewall/network. Turn off any antivirus software and try connecting to see if it is blocking Anywhere. (DISCLAIMER: We do not recommend doing this without assistance from a trained professional).
  • Blank screen when logging in: remove the webclient folder within the Fishowl Directory (C:\Program Files\Fishbowl) and reinstall Fishbowl. This is usually a result of corrupted files.
  • If the system has a variable setup to point at its own Java installation rather than program-specific Java versions, it can cause issues. Advanced System Settings may have a variable set up that does this, which can be turned off.
  • Effectively restarting Anywhere includes ending the “Java(TM) Platform SE binary” task in Task Manager. If this is not ending on its own when the FB Server is shut down, it needs to be done manually. Restarting this may help connectivity.
  • For users that are having issues with browser certificates, a 3rd party certificate can be used by replacing the sample truststore.jks and keystore.jks files or by modifying the jetty.properties file. All of these files are located in the Fishbowl\webclient\bin\ssl directory.

Release Notes

Released on 10/13/2016

  • Issue: The user.properties file is encoding incorrectly when updating the Anywhere password.
  • Resolution: the password is being saved correctly again.