View source for Fishbowl Anywhere

[[File:Fishbowl Anywhere Banner.png]]


[[Fishbowl Anywhere]] is an add-on that can be installed from the {{Module|Plugin}}. 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 also offers a completely separate web-based solution called [https://fishbowlonline.com Fishbowl Drive].
{{IntroImage}}

==Remote access comparison==

Every company is different, so Fishbowl provides several options for accessing Fishbowl data remotely. The effort required to configure these options will vary based on your company and IT resources, but in general, the options below are listed in ascending order based on the amount of IT configuration needed.

[[File:Fishbowl Remote Comparison.png|1000px]]

{{Plugin Install|Fishbowl Anywhere|Setup}}

==Setup==

[[File:Fishbowl Anywhere Setup.png|right]] The {{Module|Fishbowl Anywhere}} 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.

# Open the Fishbowl Client, [[#Server address|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 [[#Server address|address]].
# Open the {{Module|Fishbowl Anywhere|Setup}}.
# Select the {{Checkbox|Enable Fishbowl Anywhere|1}}.
# Enter a portal password and confirm the password.
# Click the {{Button|Save}}.
# 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 {{Module|Fishbowl Anywhere}}. 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. Accessing Fishbowl from outside the local network requires [[#Server address|additional configuration]]. 

# Click the link at the top of the {{Module|Fishbowl Anywhere}}, or enter the [[#Server address|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 [[#Server address|address]].
# Enter '''fishbowl''' as the user name and the portal password selected during [[#Setup|setup]]. The password will be '''fishbowl''' until a new password is created. Click '''Sign in'''.<br>[[File:Fishbowl Anywhere Portal Login.png]]
# Select the Fishbowl Client or [[Fishbowl Checkout]].<br>[[File:Fishbowl Anywhere Select Application.png]]
# Enter the credentials of any Fishbowl user and then click '''Login'''.<br>[[File: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 [[#Server address|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.<br>[[File: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 [[Fishbowl_for_Mac#Troubleshooting|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==

[[File:Login dialog.png|right]]The link at the top of the {{Module|Fishbowl Anywhere}} 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 {{Module|Fishbowl Anywhere}} of a computer other than the Fishbowl Server computer, or by clicking the {{Icon Button|Search|Find Fishbowl Servers}} in the client login dialog.

These example URLs must be modified to match the actual Fishbowl Server address. The [[#Setup|default HTTP port]] is 28182, and the [[#Setup|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: {{PlainURL|MyServerComputerName:28182}}
** Local IP address: {{PlainURL|192.168.2{{dot}}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 (ISP), 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 ISP, whereas there are free solutions for dynamic DNS.<br>'''Fishbowl recommends consulting with an IT professional to ensure that everything is configured properly and securely.'''
** Static IP address: {{PlainURL|173.194.115{{dot}}1:28282}}
** Domain name: {{PlainURL|my-domain-name{{dot}}com:28282}}
** Dynamic DNS: {{PlainURL|my-dynamic-dns-name{{dot}}com:28282}}
=Troubleshooting=
* Assistance from a network specialist is highly recommended throughout the setup process.
* Fishbowl Anywhere works best with a VPN or Static IP setup, 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 Fishbowl Anywhere: iOS devices and resource-poor computers (e.g., 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 Fishbowl 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 Fishbowl Directory (C:\Program Files\Fishbowl) and reinstall Fishbowl. This is usually a result of corrupted files.
* If the system has a variable configured to point at its own Java installation rather than program-specific Java versions, it can cause issues. Advanced System Settings may have a variable configured that does this, which can be turned off.
* Effectively restarting Fishbowl 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 who are having issues with browser certificates, a third-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.
*  Changing your password in the portal may require restarting your computer before it will take effect.

{{Plugin Release Notes}}