Original Publishing Date: 2020-01-22 Symptoms Task 'updating upgrade relations for APS packages of application' for a new version of application fails with this error: system exception, ID 'IDL:omg.org/CORBA/UNKNOWN:1.0' TAO exception, minor code = 0 (unhandled c++ exception in server side; unspecified errno), completed = MAYBE Cause In POA 5.5.1 the upgrade declaration syntax has changed, now RQL should be used before: POA 5.5.1+: Resolution Cancel this task, repackage the same version of application with correct syntax and upload the package again. Internal content

Original Publishing Date: 2020-01-22 Problem In APS1 it was possible to get FTP settings using this environmental variables: FTP__HOST – FQDN or IP address of FTP server. FTP__PORT – port number of FTP server. FTP__PATH – URL path to FTP folder. FTP__LOGIN – login of user with full access to FTP folder. FTP__PASSWORD – password of user with full access to FTP folder. How it can be done in APS2? Resolution Here is instructions how to get all values from APS controller: Host: extract urls property from website websites the application is installed to: GET "/aps/2/resources/" + website_id Port for now it is not possible to get port, it should be assumed that ftp port is default Path extract path property from website websites the application is installed to: GET "/aps/2/resources/" + website_id Login get list of all users created for this website (see getUsers at Website Types documentation page): GET "/aps/2/resources/" + website_id + "/users/ftp" example from php-runtime: $users = \APS\Request::getController()->getIo()->sendRequest("GET", "/aps/2/resources/".$this->test_website->resource->aps->id."/users/ftp"); Password it is not possible to get passwords of existing users for security reasons, it's needed to create separate user for application and save his password (see addUser at [Website Types](http://dev.apsstandard.org/doc/spec/types/web/website.html "Website Types") documentation page) examples from php-runtime: create: \APS\Request::getController()->getIo()->sendRequest("POST", "/aps/2/resources/".$this->test_website->resource->aps->id."/users/ftp", '{ "name": "user", "password": "pass"}'); modify: \APS\Request::getController()->getIo()->sendRequest("PUT", "/aps/2/resources/".$this->test_website->resource->aps->id."/users/ftp/someuser", '{"password": "pass"}'); If you use php-runtime, the easiest way is to introduce separate property to hold an array of all web settings, you can then access any of them by using this pattern: $this->LINK_NAME->PROPERTY_NAME For example, if you have link to environment/web: # Webspace information /** * @link("http://aps-standard.org/types/infrastructure/environment/web/1.0")1; * */ public $webenv; to access host and path: $this->webenv->urls[0] $this->webenv->path Internal content

Original Publishing Date: 2020-01-22 Symptoms I placed a order, subscription was created, then i canceled the order, now the subscription is still available, but disabled. However, i'd like to remove the subscription. How can i do this? Cause Resolution Open PBA. Cancel subscription. Wait while cancellation order will be processed (usually it happens within 5 minutes) Destroy subscription. Note: Do NOT remove subscription directly from POA to prevent problems with synchronization. Internal content

Original Publishing Date: 2020-01-22 Symptoms I'm starting to design my APS2 application but cannot find resource class 'Application' to create resource type for my package, did something change in terms of configuration? Resolution In APS1 each customer had an instance of 'Application', now there is only one instance of 'Application' under provider that implements global settings, end-users receive only sub-services. So workflow is: Create instance of service that implements http://www.aps-standard.org/ui/application in Provider Control Panel Create 'Application Service Reference' resource type based on this intance Create resources that should be available to customers based on 'Application Service' resource type. Add all these resources to a Service Template Internal content

Original Publishing Date: 2020-01-22 Symptoms I have defined restrictions on upgrade in my package but the upgrade from restricted version still seems to be possible according to POA CCP UI: 5.7 ... Here, you can see that applciation version 5.5 is provisioned but upgrade to 5.7 is available despite . Cause This is the intended behavior, because there most likely exists a bridge package between the incompatible versions. In this case, POA detects it and makes the upgrade available. If the upgrade is requested, it is performed step-by-step from the first to the last version. There may be more than 1 bridge package. Resolution Example: You have 3 packages with the same ID: Version: 5.5. Version: 5.6. Version: 5.7, upgrade match: version > '5.5'. With these directives, you intend to restrict straight upgrade from 5.5 to 5.7 (for whatever reason). However, after uploading all 3 packages and provisioning version 5.5, you notice that upgrade to 5.7 is available from CCP. This is because version 5.6 is also available and POA detected that 5.5 to 5.6 to 5.7 upgrade scenario is possible. When you request an upgrade, it will schedule upgrade from 5.5 to 5.6 first and then from 5.6 to 5.7 effectively meeting the requirements specified in the packages. Note: this will happen even if you disable version 5.6 (bridge) from PCP (make it unavailable to customers). This can only be prevented by removing version 5.6 from POA altogether. aps_packages_upgrade_relations table will look like this: plesk=> select * from aps_packages_upgrade_relations; app_id | src_ver | tgt_ver | rel_type --------+----------+---------+---------- 100 | 5.5-1 | 5.6-1 | u 100 | 5.5-1 | 5.7-1 | s 100 | 5.6-1 | 5.7-1 | u Removing version 5.6 will cause all 3 records (and upgrade possibility) to disappear (as there are no upgrade relations for the package if bridge package is unavailable). Internal content

Original Publishing Date: 2020-01-22 Symptoms The following error is shown when running apsconnect init-cluster command while installing APS Connector: 2017-09-21 01:34:28,765 ERROR Certificate did not match expected hostname: 192.168.1.1 Certificate: {'subjectAltName': (('DNS', 'kubernetes'), ('DNS', 'kubernetes.default'), ('DNS', 'kubernetes.default.svc'), ('DNS', 'kubernetes.default.svc.cluster.local'), ('IP Address', '192.168.1.1'), ('IP Address', '192.168.1.1')), 'notBefore': u'Aug 29 12:06:40 2017 GMT', 'serialNumber': u'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'notAfter': 'Aug 28 12:06:40 2022 GMT', 'version': 3L, 'subject': ((('commonName', u'192.168.1.1'),),), 'issuer': ((('commonName', u'xxxxxx-xxxx-xxxx-xxxx-xxxxxxx),),)} Python 2.7.5 is installed on the host where apsconnect is executed. Cause Most likely you are using old version of openssl linked with python. Resolution In case of python 2.7.5 it is necessary to run the following commands before installing apsconnect: yum install python-setuptools easy_install pip pip install -U setuptools pip install -U backports.ssl-match-hostname After that install apsconnect: pip install apsconnectcli Internal content Link on internal Article

Original Publishing Date: 2020-01-22 Question Is the userlogin API method required? I noticed on https://help.aps.odin.com/api/user-login it's set as required, where as on https://help.aps.odin.com/api it is not. If we don't implement this method, does that hide the log in to service button users see in the CCP dashboard? Answer If you plan to support user in APS Connector (i.e. if User integration if ON at Model page), then this API is required, it will be checked during validation. If User integration is OFF, then this API is not required, only adminlogin API will be used in APS Connector. Internal content

Original Publishing Date: 2020-01-22 Question How do you deal with companies that are both Service Vendor and Service Provider? E.g. if I am Service Provider and I will also create my own APS connectors? Is it possible for one company to be both Service Vendor and Provider in APS Connect Portal? Answer By design APS Connect Portal does not allow one company to be both Service Vendor and Provider. Separate accounts should be created for that purposes. However, one user can be a member of both a Service Vendor and Provider companies and thus can login to both Vendor and Provider portals. Internal content Link on internal Article

Original Publishing Date: 2020-01-22 Question Service Vendor has completed the development of APS Connector. How to generate an invitation link and invite Provider to review APS Connector? Answer To generate this link please do the following steps: login to APS Connect Portal click the desired connector go to Operations > Providers > Invite Provider Enter some company name and click Generate Invitation Link send the generated link to Provider Internal content

Original Publishing Date: 2020-01-22 Symptoms The following error is shown when trying to run the preview via APS Connect Portal in Development Mode: Request POST /app returned code 404 Error: ApplicationUnknownError Message: Tunnel e81c6397.ngrok.io not found Cause Such error is shown if your tunnel has been expired or closed. Resolution Please make sure that ngrok tunnel is up and running, and the external link is accessible. Internal content