Table of Contents
Apporto provides full service for software installation, image creation, and deployment as a part of your subscription. However, if you want to manage these tasks in house, we provide tools that enable you to do so. Contact email@example.com if you’d like us to enable server access.
The Servers screen lets you access servers in the cloud for which you have administrative rights. You can install applications and configure desktops on a selected server, usually a TEST server. This will become the base image which can be deployed to the production environment.
This short guide will show you how to:
View Servers Screen
Using your preferred web browser, navigate to the URL for your Apporto system, for example, “mycompany.apporto.com”, and log in to the system using your credentials.
Click the Servers icon in the Navigation Panel.
The ‘Servers’ screen displays.
The Servers screen shows a list of servers you have access to and provides the following information:
LOCAL NAME: User-defined name of the server (editable field)
SERVER NAME: The unique name for the server
STATE: The current operational state of the server
IMAGE DATE: The date when the latest image was created
To start a server, go to the ACTIONS menu and click Start.
Wait about 30 seconds (AWS) to 2 minutes (Azure) for the server to start.
Once started, the STATE will change from stopped to running. Also, the menu option will change from Start to Launch.
Create an Image
Find the desired TEST server, go to the ACTIONS menu and click Launch. The desktop opens in a new browser tab.
You can install software and configure the desktop. Common changes include installing software, adding desktop shortcuts, changing the time zone, and setting the default browser and/or landing page.
You must have Windows Administrative permissions in order to make changes. Contact firstname.lastname@example.org to grant permissions.
When you have completed configuring the desktop, you may create a base image and deploy it to the production servers.
To create a base image, locate the TEST server and select Create image in the ACTIONS menu.
A confirmation dialog displays. Depending on the image size, this process can take up to 2 hours. You may not start or launch the TEST server during this time.
Click Confirm to proceed.
A notification displays when the image creation process starts and completes. Click the bell icon to view notifications.
When the image has been created, a new date and time will display in the IMAGE DATE column. You may need to refresh the Servers screen to see this.
Deploy an Image
Find the desired TEST server, go to the ACTIONS menu and click Deploy.
The ‘Calendar’ opens.
Scroll to the desired date, then double click in the cell to select a time. Even though deployment (replication of the base image to all production servers) typically takes 30 minutes, the outage is scheduled in 1 hour blocks to provide time for testing.
A ‘Deploy Image’ dialog displays.
Check the Schedule downtime checkbox if you want users to see a series of three warning messages in the desktop. The messages warn users at 30, 10, and 5 minutes prior to the outage so they have time to finish and save their work. Servers are stopped and active sessions are ended when the deployment starts.
Click OK to proceed.
The calendar will refresh to show your scheduled event and a success message.
The page refreshes to take you back to the Servers screen.
Email notifications are sent when the deployment process starts and completes.
System notifications are also provided in the notification center. Click on the bell icon to view notifications.
To test your changes, go to the Servers screen, then locate and Launch one of the production servers.
Contact email@example.com if you encounter any issues or may need to rollback changes.
Cancel or Reschedule Downtime
Click on the Calendar icon in the left menu.
The ‘Calendar’ displays.
Click on the Maintenance tab.
Scroll to the date and time when the event is scheduled for.
To cancel an event, click x in the event box.
To reschedule an event, drag and drop it to a new time.
The calendar will refresh to show your changes.